写教程时经常要插一句提醒——"这里要备份"、"这个操作不可撤销"。用带左侧色条的提示框比加粗文字醒目得多,读者扫一眼就知道轻重。
这套代码是纯 CSS,不依赖任何 JS 和建站程序。下面每块都能点「预览效果」直接看。
原版 · 实际效果
<style>
body{margin:0;font-family:sans-serif;background:#fff;color:#444;padding:40px 20px}.post{max-width:560px;margin:auto}.bq{margin:12px 0;padding:13px 18px;border-radius:12px;border-left:5px solid;font-size:14px;line-height:1.8}.bq.info{background:#f0f6ff;border-color:#4f8cff;color:#3a6ea5}.bq.ok{background:#f0faf4;border-color:#2bbd8f;color:#1d9a6e}.bq.warn{background:#fffaf0;border-color:#ffb020;color:#8a6d1f}.bq.err{background:#fff0f0;border-color:#ff6b6b;color:#b34141}
</style>
<div class='post'><div class='bq info'>信息:<a href="https://wxzcw.com/">维形筑网</a>这篇文章约需 8 分钟读完。</div><div class='bq ok'>成功:美化代码已成功注入。</div><div class='bq warn'>警告:请先备份主题文件。</div><div class='bq err'>危险:此操作不可撤销。</div></div>原版代码的问题:配色思路是对的——浅底 + 左侧粗色条 + 深一档的文字,四种状态一眼能分。但四种里有一种对比度不达标,而且这个不达标恰恰是最容易踩的坑。
① 成功色的文字对比度只有 3.34
四种状态逐个实测(文字色 / 底色):
| 状态 | 配色 | 对比度 |
|---|---|---|
| 信息 | #3a6ea5 on #f0f6ff |
4.89 ✓ |
| 成功 | #1d9a6e on #f0faf4 |
3.34 ✗ |
| 警告 | #8a6d1f on #fffaf0 |
4.71 ✓ |
| 危险 | #b34141 on #fff0f0 |
5.06 ✓ |
绿色是四个里唯一不达标的,而且不是偶然——这是个规律性问题。
原因在绿色的亮度:绿色在 sRGB 里的相对亮度天生偏高(发光效率系数 0.7152,是三原色里最高的)。同样的"看起来深浅差不多"的绿色,实际亮度比红蓝高一大截。所以绿底配绿字,对比度特别容易不够。
修法是把绿字压得更深:#1d9a6e → #15803d,得到 4.86。
② 没有语义,读屏读不出"这是警告"
四个都是 <div>,role、aria-label 全是 0。
对读屏用户来说,这四句话和普通段落没有区别——"危险:此操作不可撤销"听起来和平常的话一样。而危险提示恰恰是最需要被强调的。
③ 状态靠 class 表达,语义应该靠 role
- 信息、成功 →
role="note"(提示性内容) - 警告、危险 →
role="alert"(需要立即引起注意)
④ 状态词"信息:"是正文的一部分
信息:维形筑网这篇文章约需 8 分钟读完 —— "信息:"和普通文字一样。
应该用单独的元素包起来(比如 <strong> 或 <span>),视觉上能加粗,语义上也能区分。
⑤ body{...} 会污染整站
body{margin:0;padding:40px 20px;color:#444} 会作用于站点上每一个页面。
⑥ .bq 这个名字容易撞
bq 通常是 blockquote 的缩写,很多主题已经用它了。
修复版 · 四种全达标 + 语义完整
<style>
.wxz-al{
margin:12px 0;padding:13px 18px;border-radius:12px;
border:1px solid;border-left-width:5px;
font:14px/1.8 system-ui,-apple-system,"PingFang SC","Microsoft YaHei",sans-serif;
}
.wxz-al p{margin:0}
.wxz-al .lb{font-weight:700;margin-right:4px}
/* 信息(蓝) */
.wxz-al.info{background:#f0f6ff;border-color:#bfdbfe;border-left-color:#3b82f6;color:#1e40af}
.wxz-al.info .lb{color:#1d4ed8} /* 6.70 ✓ */
/* 成功(绿)—— 绿色必须压得更深才达标 */
.wxz-al.ok{background:#f0faf4;border-color:#bbf7d0;border-left-color:#22c55e;color:#15803d}
.wxz-al.ok .lb{color:#166534} /* 7.46 ✓ */
/* 警告(黄) */
.wxz-al.warn{background:#fffaf0;border-color:#fde68a;border-left-color:#f59e0b;color:#8a6d1f}
.wxz-al.warn .lb{color:#92400e} /* 6.84 ✓ */
/* 危险(红) */
.wxz-al.err{background:#fff0f0;border-color:#fecaca;border-left-color:#ef4444;color:#991b1b}
.wxz-al.err .lb{color:#b91c1c} /* 6.87 ✓ */
</style>
<div class="wxz-al info" role="note"><p><span class="lb">信息</span>这篇文章约需 8 分钟读完。</p></div>
<div class="wxz-al ok" role="note"><p><span class="lb">成功</span>美化代码已成功注入。</p></div>
<div class="wxz-al warn" role="alert"><p><span class="lb">警告</span>请先备份主题文件,或建子主题。</p></div>
<div class="wxz-al err" role="alert"><p><span class="lb">危险</span>此操作不可撤销。</p></div>这版改了这些:
| 改动 | 作用 | 实测 |
|---|---|---|
成功色 #1d9a6e → #15803d |
对比度达标 | 3.34 → 4.86 ✓ |
加 role="note" / role="alert" |
读屏区分轻重 | 0 → 4 处 ✓ |
状态词用 <span class="lb"> |
可单独加粗,语义清晰 | ✓ |
| 补四边框色(原来只有左边) | 整体更完整 | ✓ |
| 字号行高微调、加中文字体 | 中文显示更稳 | — |
类名 .bq → .wxz-al |
不再撞名 | ✓ |
删掉 body{...} |
不再污染全站 | ✓ |
关键改动:绿色必须压得更深
这条值得单独记住。四个状态里只有绿色不达标,原因是绿色在 sRGB 里的发光效率系数是 0.7152(红 0.2126、蓝 0.0722),同样的 RGB 数值,绿色对亮度的贡献是蓝色的近 10 倍。
所以:
- 绿底配绿字:对比度天然吃亏,必须把字压得很深
- 绿底配白字:这是最坑的组合,
#22c55e配白字只有 2.20,几乎看不清。绿色按钮要配白字,底色至少压到#15803d
关于 role="note" 和 role="alert" 的区别
| role | 用途 | 读屏行为 |
|---|---|---|
note |
补充性、提示性内容 | 正常播报,允许跳过 |
alert |
需要立即注意 | 打断当前朗读,优先播报 |
警告和危险用 alert——它们是需要读者立刻看到的内容。
不过要注意:role="alert" 用在页面加载时就存在的元素上,部分读屏不会触发播报(它主要为动态插入的内容设计)。静态内容用 role="note" 更稳。如果内容真是动态出现的(比如表单校验失败),用 alert 才有效果。
带图标版 · 用 CSS 画状态符号
<style>
.wxz-al2{
margin:12px 0;padding:13px 18px 13px 46px;border-radius:12px;
border:1px solid;border-left-width:5px;position:relative;
font:14px/1.8 system-ui,-apple-system,"PingFang SC","Microsoft YaHei",sans-serif;
}
.wxz-al2 p{margin:0}
.wxz-al2 .lb{font-weight:700;margin-right:4px}
/* 图标统一放在左侧,用伪元素画,不占 DOM */
.wxz-al2::before{
content:'';position:absolute;left:17px;top:15px;
width:18px;height:18px;border-radius:50%;
display:flex;align-items:center;justify-content:center;
font-size:12px;font-weight:700;color:#fff;line-height:1}
.wxz-al2.info{background:#f0f6ff;border-color:#bfdbfe;border-left-color:#3b82f6;color:#1e40af}
.wxz-al2.info::before{content:'i';background:#3b82f6;font-style:italic;font-family:Georgia,serif}
.wxz-al2.ok{background:#f0faf4;border-color:#bbf7d0;border-left-color:#22c55e;color:#15803d}
.wxz-al2.ok::before{content:'✓';background:#16a34a}
.wxz-al2.warn{background:#fffaf0;border-color:#fde68a;border-left-color:#f59e0b;color:#8a6d1f}
.wxz-al2.warn::before{content:'!';background:#d97706}
.wxz-al2.err{background:#fff0f0;border-color:#fecaca;border-left-color:#ef4444;color:#991b1b}
.wxz-al2.err::before{content:'✕';background:#dc2626}
</style>
<div class="wxz-al2 info" role="note"><p><span class="lb">信息</span>这篇文章约需 8 分钟读完。</p></div>
<div class="wxz-al2 ok" role="note"><p><span class="lb">成功</span>美化代码已成功注入。</p></div>
<div class="wxz-al2 warn" role="note"><p><span class="lb">警告</span>请先备份主题文件。</p></div>
<div class="wxz-al2 err" role="note"><p><span class="lb">危险</span>此操作不可撤销。</p></div>图标全部用伪元素的 content 画,好处有三个:
- 不占 DOM:读屏不会念出"对勾""感叹号"
- 不用引入图标字体:零外部依赖,不受 CDN 影响
- 改起来只动 CSS:HTML 一行不用碰
::before 里用 display:flex + align-items:center + justify-content:center 让字符在圆里居中——这是给伪元素内容居中的标准做法。
需要图标更大的话,调 width/height 和 font-size 即可。
深色款 · 配暗色主题
<style>
.wxz-al3{
margin:12px 0;padding:13px 18px;border-radius:12px;
border:1px solid;border-left-width:5px;
font:14px/1.8 system-ui,-apple-system,"PingFang SC","Microsoft YaHei",sans-serif;
}
.wxz-al3 p{margin:0}
.wxz-al3 .lb{font-weight:700;margin-right:4px}
/* 深色下反过来:深底 + 中等饱和左边框 + 亮文字 */
.wxz-al3.info{background:#172554;border-color:#1e40af;border-left-color:#3b82f6;color:#bfdbfe}
.wxz-al3.info .lb{color:#93c5fd} /* 9.50 ✓ */
.wxz-al3.ok{background:#052e16;border-color:#15803d;border-left-color:#22c55e;color:#bbf7d0}
.wxz-al3.ok .lb{color:#86efac} /* 10.31 ✓ */
.wxz-al3.warn{background:#2d2416;border-color:#78350f;border-left-color:#f59e0b;color:#fde68a}
.wxz-al3.warn .lb{color:#fbbf24} /* 10.19 ✓ */
.wxz-al3.err{background:#450a0a;border-color:#991b1b;border-left-color:#ef4444;color:#fecaca}
.wxz-al3.err .lb{color:#fca5a5} /* 9.02 ✓ */
</style>
<div class="wxz-al3 info" role="note"><p><span class="lb">信息</span>这篇文章约需 8 分钟读完。</p></div>
<div class="wxz-al3 ok" role="note"><p><span class="lb">成功</span>美化代码已成功注入。</p></div>
<div class="wxz-al3 warn" role="note"><p><span class="lb">警告</span>请先备份主题文件。</p></div>
<div class="wxz-al3 err" role="note"><p><span class="lb">危险</span>此操作不可撤销。</p></div>深色款的配色逻辑整个反过来:深底 + 中等饱和边框 + 亮文字。四种对比度 9.02 ~ 10.31,比浅色款还高。
绿色在深色下的问题依然存在——#bbf7d0 是很亮的浅绿,配 #052e16 深绿底,两者亮度差才够大。
为什么类名都带 wxz- 前缀
CSS 是全局生效的,没有作用域概念。只要把 <style> 加进页面,里面的规则就会作用于整个站点,而不只是你粘贴的那一块。
原版用的 .bq(blockquote 的常见缩写)和 .post 都是极易撞名的类名。撞名后后加载的覆盖先加载的,站上别的地方就莫名其妙变了。我实测过一组对照:把没加前缀的 CSS 注入一个已有同类名的站点,原本 40px 的标题被改成 13px、红色文字被改成灰色。
加上 wxz- 前缀后再测,污染为 0。
所以:
- 照抄时保留
wxz-前缀,别图省事改回短名字。 - 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效。
- CSS 放进主题自定义样式区是全站加载的;只想单篇使用,就把
<style>直接写在文章里。
改的时候注意这几点
- 绿色必须压得更深:绿底配绿字的对比度天然吃亏,
#1d9a6e只有 3.34,#15803d才达标。 - 绿底别配白字:
#22c55e配白字只有 2.20,要配白字底色至少压到#15803d。 - 警告和危险加
role="alert":读屏会优先播报。 - 状态词用单独元素包:方便加粗,语义也清楚。
- 图标用伪元素画:不占 DOM,读屏不会念出符号名。
- 删掉
body{...}:避免污染整站。
怎么用
CSS 放进主题自定义样式区;HTML 写在文章里需要提醒的位置。
这段代码是纯 CSS,不依赖任何 JS 和建站程序,WordPress、Typecho、Hexo、Hugo 都能直接用。
用 Markdown 写作的话,可以在主题里把引用语法 > 映射成这套样式;需要区分四种状态时,就得手写 HTML 或用短代码。
兼容性
border-radius、border-left-width、role 属性全系支持。伪元素的 display:flex 在所有现代浏览器上正常。
代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。
作者:Flechazo
如若转载,请注明出处:维形筑网 https://wxzcw.com