On this page

把散落的展示规则收回组件

This post is not available in English yet. Showing the original Chinese version.

同一个标记,被四个页面各写一遍,最后就会长成四种样子。

症状:一个符号,四种写法

标签前要加 #。博客列表里它是链接,Footer 里它也是链接,时间轴和动态里却只是普通文本;有的带下划线,有的没有。原文语言要加 ·,但博客列表曾经把它做成一个带边框的 pill,时间轴和动态的间距又各不相同。日期也一样:列表、文章页、时间轴月份和动态各自 new 一个 Intl.DateTimeFormat,格式参数分散在四个文件里。

这些都不是 bug,但都让“保持一致”变成一件靠记忆维护的事。

标签:先决定它是不是链接

抽出的 Tag 组件只做一件事:显示一个标签,并在需要时变成标签页链接。

<Tag tag={tagId} lang={lang} />
<Tag tag={tagId} lang={lang} interactive />

interactive 不是样式开关,而是语义开关。博客列表和 Footer 需要可点击,时间轴和动态只是元信息;链接地址也收进组件,统一走当前语言的 /tag/<id>/,调用方不再自己拼路径。

标签筛选和标签页标题同样复用这个组件。前者把 Tag 放进筛选 chip,后者直接放进 h1,# 只在一个地方定义。

原文语言:只留一个 ·

回退语言标记统一成 ·Language,例如 ·Chinese。当内容语言和界面语言一致时,组件直接不渲染,调用方不必再到处写 lang !== currentLang。pill 样式删掉,语言的强调交回给文字本身。

实现完第一眼发现 · 和语言名贴得太近。分隔符是前缀,应该和后面的词形成一点呼吸;最后在伪元素上加了 margin-inline-end,而不是在模板里塞空格。这样间距是组件的一部分,复制文本时也不会多出一个看不见的空隙。

日期时间:格式只写一次

DateTime 接收 date 和 format。date 用于列表和文章元信息,datetime 给动态,month 给时间轴的分组标题;动态再加一个 tabular,让数字等宽。

<DateTime date={pubDate} />
<DateTime date={momentDate(moment)} format="datetime" tabular />
<DateTime date={month.date} format="month" />

调用方不再关心 locale 是 zh-CN 还是 en-US,也不再各自拼 year、month、day。日期的写法只有一个入口,以后调整格式或补时区处理,都只需要改一个文件。

统一不等于全都一样

统一的是标记和格式,不是交互。时间轴的标签不可点击,因为读者此刻在读时间线;博客列表和 Footer 的标签可点击,因为它们是导航入口。同一个 Tag 组件根据 interactive 渲染成 <span> 或 <a>,两边共享前缀和路由,但保留各自的行为。

日期也一样。等宽数字只在动态里开启,因为那里时间戳按列排列;文章页不需要为了“统一”而牺牲排版。组件给出一致的默认值,页面仍然可以决定自己需要哪一种。

最后

这类重构的收益不在代码行数,而在下一次改样式时不用再搜一遍全站。组件把“怎么写”收走,页面只回答“这里是什么”。标记不再靠自觉维持一致,而是被结构保证。