技术文章最怕一种情况:读者照着做,做出来不对,回头才发现这篇是两年前写的、API 早就变了。与其默默让内容过期,不如在文章开头挂一条提醒——写于多久前、什么时候最后改过、要不要去看新版的做法。
这段代码把这件事做得很像样:琥珀色警告条、左侧沙漏图标、右侧一个「我知道了」可以关掉。但实测下来有个很尴尬的问题——那个关闭按钮点了根本没反应,整段代码里连一行 JS 都没有。而提示文字里的「960 天前」是写死的数字,明天就应该是 961 天了,页面却还显示 960。
这几个版本都是纯前端特效,不依赖任何建站程序,WordPress、Typecho、Hexo 都能直接用。下面每块都能点「预览效果」直接看。
原版 · 实际效果
<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)后,背景被刷成纯白、边框被刷成黑色,浅橙底彻底没了——它看起来就跟一段普通文字一样了。
修复版
<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 宽
自动算天数 · 不用每篇手动改
<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 的搜索页。读者点进去就能找到新版,比干巴巴说一句「可能已过时」有用得多。
深色款
<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