左右交错的时间轴是很常见的"大事记"写法。这段代码视觉上完成度挺高——卡片、小三角、圆点、渐变轴线都有。但它有个肉眼很难发现、量一下才发现的问题:那些圆点根本没落在中轴线上。
我实测了一下,中轴线在 x=195,而圆点中心在 212 和 194——左边的偏右 17px,右边的偏左 1px,两边还不对称。看上去"差不多",实际是歪的。
下面每块都能点「预览效果」直接看。
原版 · 实际效果
<style>
body{margin:0;padding:14px;font:13px/1.6 system-ui;background:#f8fafc;min-height:220px}
.f1-l{position:relative;padding:4px 0}
.f1-l:before{content:"";position:absolute;left:50%;top:0;bottom:0;width:2px;
background:linear-gradient(#4c6ef5,#cbd5e1);transform:translateX(-50%)}
.f1-i{position:relative;width:50%;padding-right:16px;margin-bottom:14px}
.f1-i.r{margin-left:50%;padding-right:0;padding-left:16px}
.f1-c{background:#fff;border-radius:9px;padding:8px 10px;
box-shadow:0 1px 5px rgba(20,26,36,.05);position:relative}
.f1-c:before{content:"";position:absolute;top:11px;right:-5px;width:9px;height:9px;
background:#fff;transform:rotate(45deg)}
.f1-i.r .f1-c:before{right:auto;left:-5px}
.f1-d{position:absolute;right:-5px;top:12px;width:8px;height:8px;border-radius:50%;
background:#4c6ef5;box-shadow:0 0 0 2px #fff,0 0 0 4px #dbe4ff}
.f1-i.r .f1-d{right:auto;left:-5px}
.f1-c b{display:block;font-size:10.5px;color:#141a24}
.f1-c span{font-size:9px;color:#94a3b8}
</style>
<div class="f1">
<div class="f1-l">
<div class="f1-i"><div class="f1-c"><b>2024 · 迁移 Hugo</b>
<span>全站构建从 40s 降到 1.2s</span></div><span class="f1-d"></span></div>
<div class="f1-i r"><div class="f1-c"><b>2025 · 组件库重构</b>
<span>包体积下降 38%</span></div><span class="f1-d"></span></div>
<div class="f1-i"><div class="f1-c"><b>2026 · 暗色主题</b>
<span>支持系统偏好跟随</span></div><span class="f1-d"></span></div>
<div class="f1-i r"><div class="f1-c"><b>2026 · 全站改版</b>
<span>新版首页与阅读体验优化</span></div><span class="f1-d"></span></div>
</div>
</div>原版代码的问题:这是原版在浏览器里的真实表现,不是我们写错了。圆点没落在轴线上,这是原版 CSS 的算法导致的。下面逐条说明。
① 圆点偏离中轴线,而且左右不对称
实测数据(390px 宽,容器左边缘 x=14):
| 中轴线 x | 圆点中心 x | 偏移 | |
|---|---|---|---|
| 左侧卡片 | 195 | 212 | +17 |
| 右侧卡片 | 195 | 194 | -1 |
两侧偏差不一致,视觉上就是"轴线上挂着一串歪的珠子"。
根因是 box-sizing。CSS 默认是 content-box,所以:
.f1-i{width:50%;padding-right:16px}
这一句得到的盒子实际宽度是 50% + 16px(实测 197px,而不是 181px)——padding 是往外撑的,不是从 50% 里面扣的。
作者想要的是"卡片离轴线留 16px 空隙",实际发生的是:
- 卡片右边缘停在 x=195,正好压在中轴线上,一点空隙都没有
- 多出来的 16px 把整行撑宽,右侧卡片右边缘到 392,超出容器 2px(实测横向溢出:392 vs 390)
- 圆点的
right:-5px是相对 padding box 算的,起点跟着错了
修法两行:加 box-sizing:border-box,圆点改用 right:0 + transform:translateX(50%) 定位到盒子边缘的中点。
② 开启系统高对比后,时间轴彻底散架
这条最隐蔽,但在 Windows 高对比主题下一定会出现。实测:
| 元素 | 正常 | 强制高对比 |
|---|---|---|
| 中轴线 | 蓝色渐变 | background-image:none,背景透明 |
| 圆点 | 蓝点 + 白边 | background:白色 |
| 卡片底 | 白 | 白 |
两个结果:轴线整条消失,圆点变成白点贴在白卡片上看不见。原本有顺序的一条时间轴,变成四张散落的卡片,读者完全看不出先后。
原因:轴线用的是 linear-gradient(属于 background-image),强制高对比会把它移除;圆点的 background-color 被系统接管成白色,而它又没有边框,于是彻底隐形。
修法:轴线改用纯色 background-color,圆点加 border;再补一段 @media (forced-colors:active),把轴线和圆点都换成系统色关键字 CanvasText(文字色,在任何高对比主题下都可见)。
③ 副文字 9px,对比度 2.56
| 元素 | 字号 | 对比度 |
|---|---|---|
| 标题 | 10.5px | 17.46 ✓ |
| 说明文字 | 9px | 2.56 |
9px 的中文在手机上已经接近不可读,再配上 2.56 的对比度(纯白底白字是 1.0),基本等于隐身。
④ 语义全空:读屏听不出这是"按时间排列的四件事"
实测 ol / li / time / role / aria-hidden 全部为 0。
视觉上是"1、2、3、4 按顺序排列",但对读屏来说这只是四个孤立的 div,没有任何顺序信息,也不知道 2024、2025、2026 是日期。
⑤ 双列在手机上太挤
320px 宽时每列只有 146px,扣掉卡片内边距只剩 126px。说明文字稍长一点就要折行,卡片高度参差不齐。
修复版
<style>
.wxz-tl2{--bd:#e5e9f0;--mut:#64748b;--ac:#3b5bdb;--line:#cbd5e1;
box-sizing:border-box;max-width:560px;margin:0 auto;padding:14px}
.wxz-tl2-l{position:relative;list-style:none;margin:0;padding:4px 0}
.wxz-tl2-l::before{content:"";position:absolute;left:50%;top:0;bottom:0;width:2px;
background:var(--line);transform:translateX(-50%)}
.wxz-tl2-i{position:relative;box-sizing:border-box;width:50%;
padding-right:26px;margin-bottom:16px}
.wxz-tl2-i:nth-child(even){margin-left:50%;padding-right:0;padding-left:26px}
.wxz-tl2-c{background:#fff;border:1px solid var(--bd);border-radius:10px;padding:10px 12px}
.wxz-tl2-c b{display:block;font-size:14px;color:#1f2937;line-height:1.5}
.wxz-tl2-c span{display:block;margin-top:3px;font-size:13px;color:var(--mut);line-height:1.7}
.wxz-tl2-d{position:absolute;right:0;top:16px;transform:translateX(50%);
width:10px;height:10px;border-radius:50%;background:var(--ac);
border:2px solid #fff;box-shadow:0 0 0 3px #dbe4ff}
.wxz-tl2-i:nth-child(even) .wxz-tl2-d{right:auto;left:0;transform:translateX(-50%)}
@media (max-width:560px){
.wxz-tl2-l::before{left:7px;transform:none}
.wxz-tl2-i,.wxz-tl2-i:nth-child(even){width:100%;margin-left:0;
padding-right:0;padding-left:30px}
.wxz-tl2-d,.wxz-tl2-i:nth-child(even) .wxz-tl2-d{left:7px;right:auto;transform:translateX(-50%)}
}
@media (forced-colors:active){
.wxz-tl2-l::before{background:CanvasText}
.wxz-tl2-d{background:CanvasText;border-color:Canvas;box-shadow:none}
.wxz-tl2-c{border-color:CanvasText}
}
@media (prefers-contrast:more){
.wxz-tl2-c b,.wxz-tl2-c span{color:#000}
}
</style>
<section class="wxz-tl2">
<h3 style="margin:0 0 10px;font-size:14px;color:#1f2937">维形筑网 · 更新记录</h3>
<ol class="wxz-tl2-l">
<li class="wxz-tl2-i"><div class="wxz-tl2-c"><b><time datetime="2024-05">2024 · 站点上线</time></b>
<span>从零搭建,第一批网站美化代码发布</span></div><span class="wxz-tl2-d" aria-hidden="true"></span></li>
<li class="wxz-tl2-i"><div class="wxz-tl2-c"><b><time datetime="2025-03">2025 · 分类整理</time></b>
<span>按用途拆分为前端特效与 CSS 代码两类</span></div><span class="wxz-tl2-d" aria-hidden="true"></span></li>
<li class="wxz-tl2-i"><div class="wxz-tl2-c"><b><time datetime="2026-02">2026 · 暗色适配</time></b>
<span>全站配色改为变量,跟随系统深浅偏好</span></div><span class="wxz-tl2-d" aria-hidden="true"></span></li>
<li class="wxz-tl2-i"><div class="wxz-tl2-c"><b><time datetime="2026-09">2026 · 沙箱预览</time></b>
<span>每篇文章内置可运行的效果预览</span></div><span class="wxz-tl2-d" aria-hidden="true"></span></li>
</ol>
</section>这版改了这些(600px 宽实测):
| 原版 | 修复版 | |
|---|---|---|
| 圆点中心 vs 轴线 | 212 / 194(偏 17 / -1) | 全部 300 = 轴线 ✓ |
| 卡片离轴线空隙 | 0(压在线上) | 26px ✓ |
| 横向溢出 | 2px | 0 ✓ |
| 强制高对比 | 轴线消失、圆点变白 | 轴线黑、圆点黑框 ✓ |
| 说明文字 | 9px / 2.56 | 13px / 4.83 ✓ |
ol / li / time |
0 / 0 / 0 | 1 / 4 / 4 ✓ |
具体做法:
- 加
box-sizing:border-box:width:50%变成真正的"一半",padding从里面扣,卡片自然离轴线留出空隙 - 圆点用
transform归位:right:0让圆点外缘贴住盒子边缘,再translateX(50%)把它推到那条边上,中心自然落在轴线上。左侧右侧用nth-child(even)切换,不用再写.r类 nth-child(even)代替手写.r:原版每条都要手动加class="... r",插一条新的就得重新数一遍。改成偶数选择器后加删条目完全不用碰 HTML- 窄屏自动变单列(≤560px):轴线移到左边 7px,所有卡片统一左对齐。手机上双列本来就挤,单列反而更好读
- 轴线改纯色、圆点加边框,再补
forced-colors媒体查询 - 语义结构:
<ol>+<li>+<time datetime="...">,读屏会播报"列表,共 4 项"
深色款
<style>
.wxz-tl3{--bd:#3f3f46;--mut:#a1a1aa;--ac:#60a5fa;--line:#52525b;
box-sizing:border-box;max-width:560px;margin:0 auto;padding:14px}
.wxz-tl3 h3{margin:0 0 10px;font-size:14px;color:#f4f4f5}
.wxz-tl3-l{position:relative;list-style:none;margin:0;padding:4px 0}
.wxz-tl3-l::before{content:"";position:absolute;left:50%;top:0;bottom:0;width:2px;
background:var(--line);transform:translateX(-50%)}
.wxz-tl3-i{position:relative;box-sizing:border-box;width:50%;padding-right:26px;margin-bottom:16px}
.wxz-tl3-i:nth-child(even){margin-left:50%;padding-right:0;padding-left:26px}
.wxz-tl3-c{background:#27272a;border:1px solid var(--bd);border-radius:10px;padding:10px 12px}
.wxz-tl3-c b{display:block;font-size:14px;color:#f4f4f5;line-height:1.5}
.wxz-tl3-c span{display:block;margin-top:3px;font-size:13px;color:var(--mut);line-height:1.7}
.wxz-tl3-d{position:absolute;right:0;top:16px;transform:translateX(50%);
width:10px;height:10px;border-radius:50%;background:var(--ac);
border:2px solid #27272a;box-shadow:0 0 0 3px #1e3a8a}
.wxz-tl3-i:nth-child(even) .wxz-tl3-d{right:auto;left:0;transform:translateX(-50%)}
@media (max-width:560px){
.wxz-tl3-l::before{left:7px;transform:none}
.wxz-tl3-i,.wxz-tl3-i:nth-child(even){width:100%;margin-left:0;padding-right:0;padding-left:30px}
.wxz-tl3-d,.wxz-tl3-i:nth-child(even) .wxz-tl3-d{left:7px;right:auto;transform:translateX(-50%)}
}
@media (forced-colors:active){
.wxz-tl3-l::before{background:CanvasText}
.wxz-tl3-d{background:CanvasText;border-color:Canvas;box-shadow:none}
}
</style>
<section class="wxz-tl3">
<h3>维形筑网 · 更新记录</h3>
<ol class="wxz-tl3-l">
<li class="wxz-tl3-i"><div class="wxz-tl3-c"><b><time datetime="2024-05">2024 · 站点上线</time></b>
<span>从零搭建,第一批网站美化代码发布</span></div><span class="wxz-tl3-d" aria-hidden="true"></span></li>
<li class="wxz-tl3-i"><div class="wxz-tl3-c"><b><time datetime="2025-03">2025 · 分类整理</time></b>
<span>按用途拆分为前端特效与 CSS 代码两类</span></div><span class="wxz-tl3-d" aria-hidden="true"></span></li>
<li class="wxz-tl3-i"><div class="wxz-tl3-c"><b><time datetime="2026-02">2026 · 暗色适配</time></b>
<span>全站配色改为变量,跟随系统深浅偏好</span></div><span class="wxz-tl3-d" aria-hidden="true"></span></li>
<li class="wxz-tl3-i"><div class="wxz-tl3-c"><b><time datetime="2026-09">2026 · 沙箱预览</time></b>
<span>每篇文章内置可运行的效果预览</span></div><span class="wxz-tl3-d" aria-hidden="true"></span></li>
</ol>
</section>深色款:炭底 #27272a 配浅字,实测对比度 17.18 / 13.55 / 5.81,都远超标准。
圆点周围那圈光晕在深色上换成了深蓝 #1e3a8a(浅色版是浅蓝 #dbe4ff)——深色底上用浅色光晕会糊成一团,反过来压暗才能看出发光感。
站点更新记录(自动读文章)
<style>
.wxz-tl4{--bd:#e5e9f0;--mut:#64748b;--ac:#3b5bdb;--line:#cbd5e1;
box-sizing:border-box;max-width:560px;padding:14px}
.wxz-tl4-h{margin:0 0 10px;font-size:14px;color:#1f2937}
.wxz-tl4-l{position:relative;list-style:none;margin:0;padding:2px 0 2px 30px}
.wxz-tl4-l::before{content:"";position:absolute;left:7px;top:0;bottom:0;width:2px;background:var(--line)}
.wxz-tl4-i{position:relative;margin-bottom:14px}
.wxz-tl4-d{position:absolute;left:-30px;top:6px;width:10px;height:10px;border-radius:50%;
background:var(--ac);border:2px solid #fff;box-shadow:0 0 0 3px #dbe4ff}
.wxz-tl4-c{background:#fff;border:1px solid var(--bd);border-radius:10px;padding:10px 12px}
.wxz-tl4-c b{display:block;font-size:12.5px;color:var(--mut);font-weight:400}
.wxz-tl4-t{display:block;margin-top:2px;font-size:14px;color:#1f2937;text-decoration:none;line-height:1.5}
.wxz-tl4-t:hover{color:var(--ac);text-decoration:underline}
.wxz-tl4-t:focus-visible{outline:3px solid #93a5f5;outline-offset:2px;border-radius:4px}
.wxz-tl4-y{display:inline-block;margin-top:4px;font-size:12px;color:var(--ac);
background:#eff6ff;padding:1px 8px;border-radius:20px}
@media (forced-colors:active){
.wxz-tl4-l::before{background:CanvasText}
.wxz-tl4-d{background:CanvasText;border-color:Canvas;box-shadow:none}
.wxz-tl4-c{border-color:CanvasText}
}
@media (prefers-contrast:more){.wxz-tl4-h,.wxz-tl4-t,.wxz-tl4-c b{color:#000}}
</style>
<?php
$q = new WP_Query(array(
'post_type' => 'post',
'posts_per_page' => 12,
'orderby' => 'date',
'order' => 'DESC',
'no_found_rows' => true,
));
if ($q->have_posts()) :
$year = 0;
?>
<section class="wxz-tl4">
<h3 class="wxz-tl4-h"><?php echo esc_html__('站点更新记录', 'wxzcw'); ?></h3>
<ol class="wxz-tl4-l">
<?php while ($q->have_posts()) : $q->the_post();
$y = (int) get_the_date('Y');
$new = ($y !== $year); $year = $y; ?>
<li class="wxz-tl4-i">
<span class="wxz-tl4-d" aria-hidden="true"></span>
<div class="wxz-tl4-c">
<b><time datetime="<?php echo esc_attr(get_the_date('c')); ?>">
<?php echo esc_html(get_the_date('Y-m-d')); ?></time></b>
<a class="wxz-tl4-t" href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
<?php if ($new) : ?><span class="wxz-tl4-y"><?php echo esc_html($y); ?></span><?php endif; ?>
</div>
</li>
<?php endwhile; ?>
</ol>
</section>
<?php wp_reset_postdata(); endif; ?>动态版:如果你想让时间轴自动跟着文章更新,用这个版本。它读出最近 12 篇文章,按日期倒序排列,跨年时自动加一个年份标签。
几个 WordPress 上的讲究:
no_found_rows => true:我们只要前 12 条,不需要总数。不加这句 WordPress 会额外跑一次SELECT COUNT(*),文章多了会明显变慢wp_reset_postdata():这是最容易忘也最容易出事的一句。自定义查询跑完后,不重置的话后面侧边栏、相关文章拿到的都是这个循环里的数据esc_attr()/esc_html()全部转义:标题和日期都来自数据库,不转义会留下 XSS 口子the_permalink()与the_title():这两个函数内部已自带转义,不用再包一层
CSS 里那条 .wxz-tl4-t:focus-visible 别忘了——标题是真链接,键盘 Tab 过去要有明确的焦点框。
为什么类名都带 wxz- 前缀
CSS 没有作用域,一个 <style> 进页面就是全站生效。这段代码的类名像 .f1-i、.f1-c、.f1-d 极短,撞名概率非常高。
实测对照(把未加前缀的 CSS 注入一个已有同类名的站点):
| 站点原本的样式 | 被改成 |
|---|---|
.title 40px |
13px |
.meta 红色 |
#64748b |
.item 无边框、红底 |
多了边框、变白底 |
加上 wxz- 前缀后再测,污染为 0。
所以:
- 照抄时保留
wxz-前缀,别图省事改回短名字 - 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效
- 如果你的主题里恰好也有
wxz-开头的类(极少见),换成你自己的前缀即可 - 放进「额外 CSS」是全站加载的,只想在单篇文章用就把
<style>写在那篇文章里
怎么用
CSS 放进「外观 → 自定义 → 额外 CSS」;HTML 结构写在文章的「自定义 HTML」区块里。修复版和深色款是纯 CSS代码 加结构,不依赖任何建站程序,WordPress、Typecho、Hexo 都能直接用。
动态版(第 4 块)是 WordPress 专用,放进主题的 single.php 或做成短代码都行。
关于 box-sizing,再多说一句:很多主题会在开头写一句 * { box-sizing: border-box }。如果你的主题已经这么做了,那第 ① 条的问题会自动消失——但不能指望这个,自己显式写上才稳。
兼容性
forced-colors 媒体查询与 CanvasText 系统色:Chromium 与 Firefox 支持,Safari 目前不支持(但 Safari 也没有强制配色模式,不受影响)。nth-child 全系支持。:focus-visible 需要 Chrome 86+ / Firefox 85+ / Safari 15.4+。
代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。
作者:Flechazo
如若转载,请注明出处:维形筑网 https://wxzcw.com