文章过时提醒:告诉读者这篇写于多久前,并可一键关闭

技术文章最怕一种情况:读者照着做,做出来不对,回头才发现这篇是两年前写的、API 早就变了。与其默默让内容过期,不如在文章开头挂一条提醒——写于多久前、什么时候最后改过、要不要去看新版的做法。

这段代码把这件事做得很像样:琥珀色警告条、左侧沙漏图标、右侧一个「我知道了」可以关掉。但实测下来有个很尴尬的问题——那个关闭按钮点了根本没反应,整段代码里连一行 JS 都没有。而提示文字里的「960 天前」是写死的数字,明天就应该是 961 天了,页面却还显示 960。

这几个版本都是纯前端特效,不依赖任何建站程序,WordPress、Typecho、Hexo 都能直接用。下面每块都能点「预览效果」直接看。

原版 · 实际效果

HTML文章过时提醒 · 原版实际效果
<style>
body{margin:0;padding:14px;background:#f6f7f9;font-family:-apple-system,"PingFang SC",sans-serif}
.ar-od{display:flex;align-items:flex-start;gap:11px;background:#fffaf0;border:1px solid #feebc8;
  border-radius:12px;padding:12px 14px}
.ar-od-i{font-size:18px}
.ar-od-b{flex:1;min-width:0}
.ar-od-b b{font-size:12.5px;color:#c05621;display:block}
.ar-od-b p{margin:4px 0 0;font-size:11.5px;color:#a0aec0;line-height:1.75}
.ar-od-x{flex:none;border:1px solid #feebc8;background:#fff;border-radius:8px;padding:4px 11px;
  font-size:11px;color:#c05621;cursor:pointer}
.ar-od-x:hover{background:#ed8936;color:#fff}
</style>

<div class="ar-od">
  <span class="ar-od-i">⏳</span>
  <div class="ar-od-b"><b>这篇文章写于 2 年前</b>
    <p>发布于 2024-03-11,最后更新于 2024-03-11(960 天前)。文中涉及的 API 与版本可能已变化,请谨慎参考。</p></div>
  <button class="ar-od-x">我知道了</button>
</div>

原版代码的问题:这是原版代码在浏览器里的真实表现,不是我们写错了——点「我知道了」那条横幅纹丝不动,因为整段代码里 script 标签数为 0。下面逐条说明。

① 关闭按钮点了没反应

整段代码只有 HTML 和 CSS,没有任何 JS。实测点完按钮后横幅的 display 还是 flex,.on 也好、hidden 也好,压根没人去改它。

cursor:pointer 只改光标外观,不会让元素变可点。读者点了一下没反应,只会以为是自己手机卡了。

② 按钮的 type 是 submit

<button> 不写 type 时默认就是 submit。实测把它放进一个 <form> 里点一下:

点完的地址栏
原版 ...?#submitted(表单被提交了)
修复版 地址栏不变 ✓

放在搜索框、订阅框附近,点「我知道了」就直接跳页。

③ 正文颜色只有 2.17

元素 色值 对比度
标题 #c05621 4.39(差 0.11)
正文 #a0aec0 2.17
按钮 #c05621 on 白 4.57
按钮 hover 白字 on #ed8936 2.55

正文那行恰好是最重要的信息(发布于什么时候、多少天前),却是全块最淡的一处。2.17 基本等同于浅灰底上的浅灰字,弱视读者直接看不见。

还有个反直觉的地方:hover 之后反而更糊。静止时 4.57 勉强过关,鼠标一放上去变成橙底白字,掉到 2.55。

④ 按钮只有 26px 高

实测 68 × 26。触控目标的可点击区域建议不小于 44px,26px 在手机上很容易点空。11px 的字也偏小。

⑤ 日期和天数是写死的

「发布于 2024-03-11,最后更新于 2024-03-11(960 天前)」——三个数字全是手写的。

问题有两个:

  • 不会自己更新。今天是 2026-10-30,离 2024-03-11 实际是 963 天,原版写 960 已经差了 3 天;明天应该是 964 天,页面还是 960。
  • 每篇文章都要手算一遍。写一百篇就要算一百次,还容易算错。

另外「最后更新于」和「发布于」是同一天,说明这篇没改过——那这条信息对读者就没意义了。真改过的文章应该显示两个不同的日期。

⑥ 语义为零,图标会被读屏念出来

实测整块 role、time、aria-hidden、aria-label 全是 0。

  • 读屏用户听不出这是一条提示,只会当成普通文字念过去
  • ⏳ 是装饰性图标,没有 aria-hidden,读屏会念成「hourglass not done」之类的内容
  • 日期是纯文本,用 <time datetime="2024-03-11"> 包起来,机器才能识别这是日期

⑦ body{} 会污染全站

老规矩:代码块里的 body{margin:0;padding:14px;background:#f6f7f9;font-family:...} 一旦粘进文章,整站的 body 边距、背景、字体都会被改掉。预览跑在隔离 iframe 里看不出来,上了站才发现。

⑧ 系统高对比下会失去辨识度

这条横幅靠「浅橙底 + 浅橙边框」跟正文区分。实测开启 Windows 高对比(forced-colors)后,背景被刷成纯白、边框被刷成黑色,浅橙底彻底没了——它看起来就跟一段普通文字一样了。

修复版

HTML文章过时提醒 · 修复版
<style>
.wxz-arod{--bd:#fed7aa;--fg:#9a3412;--mut:#6b7280;
  display:flex;align-items:flex-start;gap:12px;background:#fffaf0;border:1px solid var(--bd);
  border-radius:12px;padding:14px 16px;max-width:560px}
.wxz-arod-i{flex:none;font-size:18px;line-height:1.4}
.wxz-arod-b{flex:1;min-width:0}
.wxz-arod-b b{font-size:13.5px;color:var(--fg);display:block}
.wxz-arod-b p{margin:5px 0 0;font-size:13px;color:var(--mut);line-height:1.8}
.wxz-arod-x{flex:none;min-height:44px;padding:0 14px;border:1px solid var(--bd);
  background:#fff;border-radius:9px;font-size:13px;color:var(--fg);cursor:pointer;font-family:inherit}
.wxz-arod-x:hover{background:#c2410c;color:#fff;border-color:#c2410c}
.wxz-arod-x:focus-visible{outline:3px solid #fb923c;outline-offset:2px}
@media (max-width:420px){.wxz-arod{flex-wrap:wrap}.wxz-arod-x{margin:2px 0 0 auto}}
@media (prefers-contrast:more){
  .wxz-arod{border-width:2px}
  .wxz-arod-b b,.wxz-arod-b p{color:#000}
}
@media (forced-colors:active){.wxz-arod{border:2px solid CanvasText}}
</style>

<div class="wxz-arod" role="note">
  <span class="wxz-arod-i" aria-hidden="true">⏳</span>
  <div class="wxz-arod-b">
    <b>这篇文章写于 2 年前</b>
    <p>发布于 <time datetime="2024-03-11">2024-03-11</time>,最后更新于 <time datetime="2024-10-08">2024-10-08</time>。文中涉及的 API 与版本可能已变化,请谨慎参考。</p>
  </div>
  <button type="button" class="wxz-arod-x" aria-label="关闭这条过时提醒">我知道了</button>
</div>

<script>
(function(){
  var box=document.querySelector('.wxz-arod');
  if(!box)return;
  box.querySelector('.wxz-arod-x').addEventListener('click',function(){
    box.hidden=true;
  });
})();
</script>

这版改了这些:

原版 修复版
正文对比度 2.17 4.65 ✓
标题对比度 4.39 7.02 ✓
按钮 hover 2.55 5.18 ✓
按钮高度 26px 44px ✓
按钮 type submit button ✓
点击关闭 无反应 hidden=true ✓
role / time / aria-hidden 0 / 0 / 0 1 / 2 / 1 ✓

具体做法:

  • 补了 8 行 JS:用 addEventListener 绑定,点一下把整块设成 hidden。用 hidden 属性而不是 display:none,读屏也会一并跳过它
  • type="button":放进表单也不会误提交
  • 颜色整体压深一档:正文 #a0aec0 → #6b7280,标题 #c05621 → #9a3412,hover 底色 #ed8936 → #c2410c
  • min-height:44px:触控区域达标
  • role="note" + aria-label:读屏知道这是提示、知道那个按钮是干什么的
  • 图标加 aria-hidden,日期用 <time datetime="..."> 包起来
  • .wxz-arod-x:focus-visible:键盘 Tab 过去有清晰的橙色焦点环
  • 窄屏(≤420px)让按钮换行,实测 360px 下不再把正文挤成 169px 宽

自动算天数 · 不用每篇手动改

HTML文章过时提醒 · 自动算天数版
<style>
.wxz-arod2{--bd:#fed7aa;--fg:#9a3412;--mut:#6b7280;--ac:#c2410c;
  display:flex;align-items:flex-start;gap:12px;background:#fffaf0;border:1px solid var(--bd);
  border-radius:12px;padding:14px 16px;max-width:560px}
.wxz-arod2[hidden]{display:none}
.wxz-arod2-i{flex:none;font-size:18px;line-height:1.4}
.wxz-arod2-b{flex:1;min-width:0}
.wxz-arod2-b b{font-size:13.5px;color:var(--fg);display:block}
.wxz-arod2-b p{margin:5px 0 0;font-size:13px;color:var(--mut);line-height:1.8}
.wxz-arod2-b a{color:var(--ac);font-weight:600}
.wxz-arod2-x{flex:none;min-height:44px;padding:0 14px;border:1px solid var(--bd);background:#fff;
  border-radius:9px;font-size:13px;color:var(--fg);cursor:pointer;font-family:inherit}
.wxz-arod2-x:hover{background:var(--ac);color:#fff;border-color:var(--ac)}
.wxz-arod2-x:focus-visible{outline:3px solid #fb923c;outline-offset:2px}
@media (max-width:420px){.wxz-arod2{flex-wrap:wrap}.wxz-arod2-x{margin:2px 0 0 auto}}
@media (prefers-contrast:more){.wxz-arod2{border-width:2px}.wxz-arod2-b b,.wxz-arod2-b p{color:#000}}
@media (forced-colors:active){.wxz-arod2{border:2px solid CanvasText}}
</style>

<div class="wxz-arod2" id="arod2" role="note" data-pub="2024-03-11" data-mod="2024-10-08" hidden>
  <span class="wxz-arod2-i" aria-hidden="true">⏳</span>
  <div class="wxz-arod2-b"><b></b><p></p></div>
  <button type="button" class="wxz-arod2-x" aria-label="关闭这条过时提醒,本次浏览不再显示">我知道了</button>
</div>

<script>
(function(){
  var box=document.getElementById('arod2');
  if(!box)return;
  var K='wxz-arod-'+box.getAttribute('data-mod');
  try{ if(sessionStorage.getItem(K)==='1'){ return; } }catch(e){}
  /* 用 UTC 零点对齐再相减,避免时区与夏令时导致差一天 */
  function days(a,b){
    var A=Date.UTC(a.getFullYear(),a.getMonth(),a.getDate());
    var B=Date.UTC(b.getFullYear(),b.getMonth(),b.getDate());
    return Math.floor((B-A)/86400000);
  }
  function fmt(d){ return d.getFullYear()+'-'+('0'+(d.getMonth()+1)).slice(-2)+'-'+('0'+d.getDate()).slice(-2); }
  var dPub=new Date(box.getAttribute('data-pub')+'T00:00:00');
  var dMod=new Date(box.getAttribute('data-mod')+'T00:00:00');
  var n=days(dMod,new Date());
  var years=Math.floor(n/365.25);
  box.querySelector('b').textContent = years>=1 ? ('这篇文章写于 '+years+' 年前')
    : (n>=30 ? ('这篇文章写于 '+Math.floor(n/30)+' 个月前') : '这篇文章是不久前写的');
  var p=box.querySelector('p');
  p.textContent='发布于 '+fmt(dPub)+',最后更新于 '+fmt(dMod)+'('+n+' 天前)。'
    +'文中的做法可能已过时,建议先看看<a href="https://wxzcw.com/">维形筑网</a>上的最新版。 ';
  var a=document.createElement('a');
  a.href='https://wxzcw.com/?s=%E7%BD%91%E7%AB%99%E7%BE%8E%E5%8C%96';
  a.textContent='查看最新做法';
  p.appendChild(a);
  box.hidden=false;
  box.querySelector('.wxz-arod2-x').addEventListener('click',function(){
    box.hidden=true;
    try{ sessionStorage.setItem(K,'1'); }catch(e){}
  });
})();
</script>

自动版:日期写在 data-pub 和 data-mod 两个属性里,天数、年数、文案全由 JS 算出来。你每篇文章只要改这两个日期,其余不用管。

实测输出(发布日 2024-03-11、最后更新 2024-10-08):

```

这篇文章写于 2 年前

发布于 2024-03-11,最后更新于 2024-10-08(752 天前)。

文中的做法可能已过时,建议先看看维形筑网上的最新版。 查看最新做法

```

有三个细节值得说:

① 天数要用 UTC 零点对齐再相减

直接 new Date(b) - new Date(a) 再除 86400000,遇到跨时区或夏令时会差一天。稳妥做法是各自取 UTC 零点:

```

var A = Date.UTC(a.getFullYear(), a.getMonth(), a.getDate());

var B = Date.UTC(b.getFullYear(), b.getMonth(), b.getDate());

return Math.floor((B - A) / 86400000);

```

② 年数不能用 365,要用 365.25

四年一闰,用 365 算出来的年数会越久越偏。Math.floor(天数 / 365.25) 更准。不满一年时按月显示,更自然。

③ 关掉之后别再弹出来

光设 hidden 的话,刷新页面它又回来了。这里用 sessionStorage 记一笔,本次浏览期间不再显示(实测:点关闭 → 刷新 → 仍然不显示)。用 sessionStorage 而不是 localStorage,是因为文章可能哪天真的更新了,换浏览器会话时该提醒还是要提醒。

另外补了一个站内链接:提示末尾自动挂一条「查看最新做法」,指向 www.wxzcw.com 的搜索页。读者点进去就能找到新版,比干巴巴说一句「可能已过时」有用得多。

深色款

HTML文章过时提醒 · 深色款
<style>
.wxz-arod3{--bd:#78350f;--fg:#fcd34d;--mut:#d6d3d1;--ac:#fbbf24;
  display:flex;align-items:flex-start;gap:12px;background:#292524;border:1px solid var(--bd);
  border-radius:12px;padding:14px 16px;max-width:560px}
.wxz-arod3-i{flex:none;font-size:18px;line-height:1.4}
.wxz-arod3-b{flex:1;min-width:0}
.wxz-arod3-b b{font-size:13.5px;color:var(--fg);display:block}
.wxz-arod3-b p{margin:5px 0 0;font-size:13px;color:var(--mut);line-height:1.8}
.wxz-arod3-b a{color:var(--ac);font-weight:600}
.wxz-arod3-x{flex:none;min-height:44px;padding:0 14px;border:1px solid var(--bd);background:#1c1917;
  border-radius:9px;font-size:13px;color:var(--fg);cursor:pointer;font-family:inherit}
.wxz-arod3-x:hover{background:#78350f;color:#fff}
.wxz-arod3-x:focus-visible{outline:3px solid var(--ac);outline-offset:2px}
@media (max-width:420px){.wxz-arod3{flex-wrap:wrap}.wxz-arod3-x{margin:2px 0 0 auto}}
@media (prefers-contrast:more){.wxz-arod3{border-width:2px}.wxz-arod3-b b,.wxz-arod3-b p{color:#fff}}
@media (forced-colors:active){.wxz-arod3{border:2px solid CanvasText}}
</style>

<div class="wxz-arod3" role="note">
  <span class="wxz-arod3-i" aria-hidden="true">⏳</span>
  <div class="wxz-arod3-b">
    <b>这篇文章写于 2 年前</b>
    <p>发布于 <time datetime="2024-03-11">2024-03-11</time>,最后更新于 <time datetime="2024-10-08">2024-10-08</time>(752 天前)。文中的做法可能已过时,建议先看看维形筑网上的最新版。</p>
  </div>
  <button type="button" class="wxz-arod3-x" aria-label="关闭这条过时提醒">我知道了</button>
</div>

<script>
(function(){
  var box=document.querySelector('.wxz-arod3');
  if(!box)return;
  box.querySelector('.wxz-arod3-x').addEventListener('click',function(){
    box.hidden=true;
  });
})();
</script>

深色款:给开了暗色模式的站点用——维形筑网上做网站美化时,深色页面上的提示条如果用浅色版会非常突兀。炭黑底 #292524 配琥珀黄 #fcd34d,实测对比度 10.52 / 10.18 / 12.13,三处都远超标准。

配色这块有个规律:暗底上别用纯黄 #ffd700,容易发刺眼;用偏暖的 #fcd34d 会柔和很多,同时对比度反而更高。边框用暗橙 #78350f 而不是亮橙,避免在深色背景上"抢戏"。

为什么类名都带 wxz- 前缀

CSS 没有作用域,一个 <style> 进页面就是全站生效。这段代码的类名像 .ar-od、.ar-od-b 已经算短了,但撞名概率依然不低。

实测对照(把未加前缀的 CSS 注入一个已有同类名的站点):

站点原本的样式 被改成
.title 40px 13px
.meta 红色 #64748b
.item 无边框、红底 多了边框、变白底

加上 wxz- 前缀后再测,污染为 0。

所以:

  • 照抄时保留 wxz- 前缀,别图省事改回短名字
  • 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效
  • 如果你的主题里恰好也有 wxz- 开头的类(极少见),换成你自己的前缀即可
  • 放进「额外 CSS」是全站加载的,只想在单篇文章用就把 <style> 写在那篇文章里

怎么用

整套代码就是一点 CSS代码 加几行 JS,没有外部依赖。CSS 放进「外观 → 自定义 → 额外 CSS」;HTML 结构写在文章的「自定义 HTML」区块里。

JS 建议单独存文件。在子主题目录下建一个 arod.js,内容就是修复版那段脚本,然后在 functions.php 里引入:

```php

function wxz_arod_script() {

if ( is_singular() ) {

wp_enqueue_script(

'wxz-arod',

get_stylesheet_directory_uri() . '/arod.js',

array(),

'1.0',

true

);

}

}

add_action( 'wp_enqueue_scripts', 'wxz_arod_script' );

```

这么绕一圈是有原因的:内联 <script> 会被内容安全策略(CSP)整体拦截。我们实测过,同一份代码只差一个 CSP 响应头:

点击是否生效
无 CSP 生效 ✓
有 CSP 毫无反应 ✗

浏览器报的是 Executing inline script violates Content Security Policy directive。函数明明存在却完全不执行,这类"本地能跑、上线失效"的问题最难查。很多安全插件和 CDN 防护都会加 CSP,所以能外链就外链。

日期怎么填:用自动版的话,把 data-pub 换成发布日期、data-mod 换成最后修改日期就行,格式固定 YYYY-MM-DD。WordPress 里可以直接用模板标签输出:

```php

<div class="wxz-arod2" id="arod2" role="note"

data-pub="<?php echo get_the_date('Y-m-d'); ?>"

data-mod="<?php echo get_the_modified_date('Y-m-d'); ?>" hidden>

```

兼容性

sessionStorage 全系支持(含微信内置浏览器),但在无痕模式下 iOS Safari 写入会抛异常,所以代码里用 try...catch 包了两层——写不进去也不影响横幅正常显示和关闭。<time> 元素全系支持。role="note" 属于 ARIA 1.2,老读屏可能忽略,但不会造成问题。:focus-visible 需要 Chrome 86+ / Firefox 85+ / Safari 15.4+,老浏览器上没有焦点环,不影响使用。forced-colors 只有 Windows 高对比主题会触发,macOS 用 prefers-contrast 那一段。


代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。

作者:Flechazo

如若转载,请注明出处:维形筑网 https://wxzcw.com

赞 (0)
时间轴样式:站点更新记录的竖向时间线
上一篇 2026年10月30日 下午8:24
下载卡片带二维码:桌面扫码、手机直接拿
下一篇 2026年10月30日 下午9:28

相关推荐

维 形 筑 网