第一版的响应式是标准的 @media (max-width: 768px) 三档断点,也能用。但我越用越别扭:手机和桌面共用一套 DOM,只是缩放,形态差异做不出来。
具体痛点是:文档模式在手机上需要「侧栏变抽屉」,在平板上需要「侧栏变折叠面板」,在桌面上才是常驻三栏。这三件事用宽度断点写,会变成一堆互相打架的 @media 补丁。
于是我改成了自适应式响应(adaptive):先识别设备档位,再交付该档专属布局。
一、两种思路的本质区别
| 响应式 Responsive | 自适应 Adaptive | |
|---|---|---|
| DOM | 一套 | 一套 |
| 布局 | 随宽度连续缩放 | 按档位跳变 |
| 实现 | @media (max-width: …) |
html[data-tier="mobile"] { … } |
| 产物 | 断点写在 CSS 里 | 断点由配置生成,可整档禁用组件 |
| 适合 | 内容型页面、排版微调 | 形态差异大的应用型界面 |
响应式回答「多宽」,自适应回答「是什么设备」。三模式主题的形态差异属于后者。
改造后的硬约束:产物里不允许出现宽度 @media(adaptive.css 只保留打印样式和 prefers-reduced-motion)。这条约束倒逼所有形态判断走档位。
二、配置:把档位写进 _config.yml
1 | adaptive: |
disable 是我最喜欢的一项:整档不渲染某个组件(手机档不渲染右侧目录列)。用 @media 只能 display: none,而它们是不同的——不渲染意味着连 HTML 都不生成,DOM 更干净。
三、定档:四级判定链,同步执行
adaptive-boot.ejs 放在 <head> 最前面同步执行,顺序是:
1 | URL ?__tier=mobile → localStorage(remember) → UA 指纹 → 视口宽度 → default_tier |
1 | function resolve() { |
判定结果写进 <html>:
1 | <html lang="zh-CN" data-mode="docs" data-tier="mobile" data-tier-strategy="adaptive" |
跨档时派发事件,让 JS 侧跟着切形态:
1 | document.documentElement.dispatchEvent(new CustomEvent('xfm:tierchange', { |
异步或放在 body 末尾,会先按桌面上档渲染再跳变——用户会看到一帧错版。这就是「首屏闪烁」最常见的来源,不是性能问题,是执行时机问题。
顺带说一个细节:构建期会先把 default_tier 写进 data-tier,boot 脚本随后纠正为真实档位。这样即使 JS 被禁用,页面也有一个可用的档位样式。
四、出样式:配置翻译成档位规则
adaptive-style.ejs 在构建期把配置翻译成 CSS,每档一整套令牌:
1 | /* 由 adaptive 配置生成,非手写 */ |
注意 tablet 的 --toc-w: 0px:把宽度变量置零,比给每个组件写 display: none 干净得多。
块里还有形态规则和禁用规则:
1 | html[data-tier="mobile"] .toc-column { display: none ; } /* disable: [toc-column] */ |
档位相关的值全部由配置生成,CSS 源文件里不写断点。 想改手机档的间距,改配置即可,不用碰 CSS。
五、唯一来源:xfm_adaptive() helper
档位信息有三个消费方:boot 脚本、样式生成器、layout.ejs。如果各自解析一遍配置,迟早不一致。所以做一个 helper 当唯一来源,它负责:
- 补默认值;
- 边界纠正:
mobile.max_width必须小于tablet.max_width,用户写反了自动纠正; - 变体白名单校验(如
sidebar: offcanvas | inline | hide); - 输出组件选择器表,供样式生成器使用。
1 | <% const __A = xfm_adaptive(); %> |
老版本用的是 responsive: 配置节。改造时如果无脑做「responsive → adaptive」推导,主题自带的 adaptive 默认值会被旧值覆盖,导致用户什么都没配却拿到了响应式默认值。
正确做法是:只有「站点显式写过 responsive」时才启用推导(判断 hexo.config.theme_config.responsive 是否存在),否则直接用 adaptive 默认值。
这个坑的本质是:无法区分「用户显式写的默认值」和「压根没写」。凡是做配置迁移,都要处理这个二义性。
六、实测档位时的一个陷阱
我用无头 Chrome 按 UA + 窗口尺寸实测档位,一度以为移动端布局溢出了——其实是截图伪影:
- 本机系统 DPI 缩放使
--screenshot的布局视口 =--window-size × 0.75。想要 414 视口得传--window-size=552,1173; --dump-dom不受这个系数影响,显式传--window-size就是实际视口;- 两者语义不同,不能互相推断。
判断溢出要用设备宽度而非 innerWidth(移动端页面被撑大时 innerWidth 会变大,掩盖真实的横向溢出)。
如果你的主题只有博客形态、手机和桌面的差异只是「栏数从 2 变 1」,那 @media 完全够用,不要为了架构好看引入档位系统。自适应解决的是「形态差异」,不是「尺寸差异」。
系列导航
系列总入口 · 上一篇:三模式外壳的形态分发 · 下一篇:标签插件与内容过滤器
评论