站点有话要说——暗黑模式上线、新增了哪个栏目——放一条醒目的公告条最有效。黄底橙边的配色天然有"注意看"的暗示,又不像红色那么紧张。
这套代码是纯 CSS,不依赖任何 JS 和建站程序。下面每块都能点「预览效果」直接看。
原版 · 实际效果
<style>
.notice{background:#fffbeb;border:1px solid #fde68a;border-left:4px solid #f59e0b;
border-radius:8px;padding:12px 14px;font-family:sans-serif;font-size:13px;
color:#92400e;line-height:1.6}
.notice b{color:#b45309}
</style>
<div class="notice"><b>公告</b>:<a href="https://wxzcw.com/">维形筑网</a>已启用暗黑模式,欢迎体验!网站美化代码持续更新中。</div>原版代码的问题:这一条配色做得其实不错——我实测正文对比度 6.84、加粗的"公告"两字 4.84,都达标。它是这批代码里少见的颜色没翻车的。剩下的问题在语义和无障碍上。
① 没有 role,读屏不知道这是公告
我实测:role、aria-live、aria-label 全是 0。
对读屏软件来说,这就是一个普通的 div。而"公告"恰恰是最需要被主动播报的内容——视障用户浏览页面时,公告应该被优先读到,而不是混在正文里等他翻到。
正确做法是加 role="note"(或 role="status"),让辅助技术识别为"提示性内容"。
② 元素用 div,文本层级不明确
公告是一段完整的话,用 <p> 更合适;如果它是页面级的公告,语义上甚至可以放在 <aside> 里。
③ 边框对比度 1.20,只作装饰
#fde68a 边框配 #fffbeb 底,对比度只有 1.20。
不过边框属于纯装饰,WCAG 对非文本元素的要求是 3.0,而这里边框的作用是"划分区域"而非"传达信息",且左侧 4px 的橙色 #f59e0b 已经足够标示边界,所以浅色边框不算问题。
想更清晰的话可以加深边框色,但不改也没关系。
④ <b> 承载"公告"两字
<b> 的语义是"重要性强调"。这里"公告"是标签名,不是强调。用 <strong> 或 <span> 加 CSS 更合适。
⑤ 两个小问题
- 字号 13px 偏小:公告是想让人看的,13px 在手机上有点吃力。
font-family:sans-serif:等于用浏览器默认无衬线字体,中文环境下通常是西文字体优先,中文会回退到系统默认。应该显式写上中文字体。
修复版 · 语义完整 + 字号加大
<style>
.wxz-nt{
background:#fffbeb;border:1px solid #fde68a;border-left:4px solid #f59e0b;
border-radius:8px;padding:12px 14px;
font:13.5px/1.75 system-ui,-apple-system,"PingFang SC",sans-serif;
color:#7c4a03; /* 8.42 ✓(比原版更深) */
}
.wxz-nt .lb{
font-weight:700;color:#92400e;margin-right:6px; /* 6.84 ✓ */
}
.wxz-nt p{margin:0}
/* 想加图标的话用伪元素,不占 DOM */
.wxz-nt.ico{padding-left:38px;position:relative}
.wxz-nt.ico::before{content:"📢";position:absolute;left:14px;top:12px;font-size:15px}
</style>
<p class="wxz-nt" role="note" aria-label="站点公告">
<span class="lb">公告</span>维形筑网已启用暗黑模式,欢迎体验!网站美化代码持续更新中。
</p>
<p class="wxz-nt ico" role="note" aria-label="站点公告">
<span class="lb">新栏目</span>「鼠标特效」已上线,点击跟随、粒子动画类代码都归到这里了。
</p>这版改了这些:
| 改动 | 作用 | 实测 |
|---|---|---|
加 role="note" + aria-label |
读屏识别为提示性内容 | 0 → 2 处 ✓ |
div → <p> |
文本语义正确 | — |
正文 #92400e → #7c4a03 |
对比度更高 | 6.84 → 8.42 ✓ |
<b> → <span class="lb"> |
去掉错误语义 | — |
| 字号 13 → 13.5px、行高 1.6 → 1.75 | 更好读 | — |
font-family 显式写中文字体 |
中文显示更稳 | — |
| 图标改伪元素 | 不占 DOM,读屏不会念出来 | 第二块示例 ✓ |
关键改动:role="note"
这是无障碍上最实在的一步。role="note" 告诉辅助技术"这是一段补充/提示性内容",读屏遇到它会用相应的方式处理(比如允许跳过、或标记为注释)。
如果公告是动态更新的(比如用 JS 定时换内容),应该用 role="status" 或加 aria-live="polite",这样内容变化时会主动播报。静态公告用 role="note" 就够了。
关于图标用伪元素:
```css
.wxz-nt.ico::before{content:"📢";...}
```
emoji 放在伪元素里有两个好处:不占 DOM(读屏不会念出"扬声器表情"),不用额外 HTML。缺点是 content 里的内容无法被选中——不过装饰性图标本来也不需要。
四种状态 · 公告 / 提示 / 成功 / 警告
<style>
.wxz-nt2{border-radius:8px;padding:12px 14px;margin-bottom:10px;
font:13.5px/1.75 system-ui,-apple-system,"PingFang SC",sans-serif;
border:1px solid;border-left-width:4px}
.wxz-nt2 p{margin:0}
.wxz-nt2 .lb{font-weight:700;margin-right:6px}
/* 公告(黄) */
.wxz-nt2.n{background:#fffbeb;border-color:#fde68a;border-left-color:#f59e0b;color:#7c4a03}
.wxz-nt2.n .lb{color:#92400e} /* 6.84 ✓ */
/* 提示(蓝) */
.wxz-nt2.i{background:#eff6ff;border-color:#bfdbfe;border-left-color:#3b82f6;color:#1e40af}
.wxz-nt2.i .lb{color:#1d4ed8} /* 6.70 ✓ */
/* 成功(绿) */
.wxz-nt2.s{background:#f0fdf4;border-color:#bbf7d0;border-left-color:#22c55e;color:#15803d}
.wxz-nt2.s .lb{color:#166534} /* 7.46 ✓ */
/* 警告(红) */
.wxz-nt2.w{background:#fef2f2;border-color:#fecaca;border-left-color:#ef4444;color:#991b1b}
.wxz-nt2.w .lb{color:#b91c1c} /* 6.87 ✓ */
</style>
<div class="wxz-nt2 n" role="note"><p><span class="lb">公告</span>维形筑网已启用暗黑模式,欢迎体验!</p></div>
<div class="wxz-nt2 i" role="note"><p><span class="lb">提示</span>本站所有代码均可直接复制,无需登录。</p></div>
<div class="wxz-nt2 s" role="note"><p><span class="lb">已完成</span>「鼠标特效」栏目已上线,收录 6 篇。</p></div>
<div class="wxz-nt2 w" role="note"><p><span class="lb">注意</span>修改主题文件前请先备份,或建子主题。</p></div>四种状态的对比度:公告 6.84、提示 6.70、成功 7.46、警告 6.87,全部达标。
配色规律:浅色底 + 同色系边框 + 深一档的左边框 + 更深的文字。左边框压深是为了"立住"边界感,文字压深是为了可读。
深色款 · 配暗色主题
<style>
.wxz-nt3{border-radius:8px;padding:12px 14px;margin-bottom:10px;
font:13.5px/1.75 system-ui,-apple-system,"PingFang SC",sans-serif;
border:1px solid;border-left-width:4px}
.wxz-nt3 p{margin:0}
.wxz-nt3 .lb{font-weight:700;margin-right:6px}
/* 深色下反过来:深色底 + 中等饱和边框 + 亮文字 */
.wxz-nt3.n{background:#2d2416;border-color:#78350f;border-left-color:#f59e0b;color:#fde68a}
.wxz-nt3.n .lb{color:#fbbf24} /* 10.19 ✓ */
.wxz-nt3.i{background:#172554;border-color:#1e40af;border-left-color:#3b82f6;color:#bfdbfe}
.wxz-nt3.i .lb{color:#93c5fd} /* 9.50 ✓ */
</style>
<div class="wxz-nt3 n" role="note"><p><span class="lb">公告</span>维形筑网已启用暗黑模式,欢迎体验!</p></div>
<div class="wxz-nt3 i" role="note"><p><span class="lb">提示</span>本站所有代码均可直接复制,无需登录。</p></div>深色款的配色逻辑反过来:深底 + 中等饱和边框 + 亮文字。深色下浅底会太刺眼,深底配亮字更舒服。对比度 9.50 ~ 10.19。
为什么类名都带 wxz- 前缀
CSS 是全局生效的,没有作用域概念。只要把 <style> 加进页面,里面的规则就会作用于整个站点,而不只是你粘贴的那一块。
这个组件用的类名如果不加前缀,写成 .notice、.n、.i、.s、.w 这类短名,主题或插件里极可能已经有同名的类——.notice 是重灾区(很多主题的通知插件就用它)。一旦撞名,后加载的 CSS 会覆盖先加载的,站上别的地方就莫名其妙变了。我实测过一组对照——把没加前缀的 CSS 注入一个已有同类名的站点:
| 站点原本的样式 | 被改成 |
|---|---|
.title 40px |
13px |
.meta 红色 |
#64748b |
.item 无边框、红底 |
多了边框、变白底 |
加上 wxz- 前缀后再测,污染为 0。
所以:
- 照抄时保留
wxz-前缀,别图省事改回短名字。 - 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效。
- 另外提醒:放进主题的自定义样式区是全站加载的。
改的时候注意这几点
- 加
role="note":公告最需要被读屏优先识别。动态更新的公告用role="status"。 - 用
<p>承载公告文本:别用裸div。 - 配色规律:浅底 + 深左边框 + 更深文字:三者拉开层次才好看又清晰。
- 别用
<b>承载标签名:它是语义标签(强调),改用span+ CSS。 - 字号别低于 13px:公告是要人读的。
font-family显式写中文字体:只写sans-serif中文会回退到系统默认,不同平台差异大。- 图标放伪元素:不占 DOM,读屏不会念出来。
- 边框对比度不用苛求:它只作划分,左侧粗边框已经承担了标示作用。
怎么用
CSS 放进主题自定义样式区;HTML 写在需要的位置(文章开头、侧栏、页头都行)。
这段代码是纯 CSS,不依赖任何 JS 和建站程序,WordPress、Typecho、Hexo、Hugo 都能直接用。
想让公告只在首页显示或者定时消失,需要配合几行 JS 或后端判断——那属于另一类需求,这里不做展开。
兼容性
border-radius、border-left-width、role 属性全系支持。system-ui 字体需要较新浏览器(不支持时回退到后面的字体栈)。
代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。
作者:Flechazo
如若转载,请注明出处:维形筑网 https://wxzcw.com