状态提示框:信息 / 成功 / 警告 / 危险四种色

写教程时经常要插一句提醒——"这里要备份"、"这个操作不可撤销"。用带左侧色条的提示框比加粗文字醒目得多,读者扫一眼就知道轻重。

这套代码是纯 CSS,不依赖任何 JS 和建站程序。下面每块都能点「预览效果」直接看。

原版 · 实际效果

HTML状态提示框 · 原版实际效果
<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 的缩写,很多主题已经用它了。

修复版 · 四种全达标 + 语义完整

HTML状态提示框 · 修复版
<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 画状态符号

HTML状态提示框 · 带图标版
<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 即可。

深色款 · 配暗色主题

HTML状态提示框 · 深色款
<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

赞 (0)
图文混排:让文字环绕图片的浮动布局
上一篇 2026年10月30日 下午5:55
渐变分割线:一条彩色的分隔条
下一篇 2026年10月30日 下午5:57

相关推荐

维 形 筑 网