Sapper SSR添加mode-dark类及布局preload不执行问题咨询
问题1:preload函数不运行的常见原因
- 版本API废弃:
preload是旧版Sapper/预览版SvelteKit的专属API,SvelteKit v1正式版发布后已经完全废弃该API,替换为load函数,且load函数不能写在+layout.svelte的module脚本中,需要单独在同级目录新建+layout.js/+layout.ts文件导出才会被框架识别执行。 - 命名约定不符:如果使用的是支持
preload的旧版本框架,需要确认布局文件放在src/routes根目录,且命名为_layout.svelte才会被识别为全局布局,子路由下的局部布局仅作用于对应子路由范围。 - 代码运行报错:你的原有
preload逻辑中直接调用了window.matchMedia,该API仅在客户端环境存在,SSR阶段服务端执行时会抛出window is not defined错误,直接中断函数执行,你可以查看服务端控制台确认是否存在该类报错。 - 预渲染配置冲突:如果项目开启了全量静态预渲染
prerender = true或者关闭了SSR功能,部分旧版本框架会跳过布局preload的执行逻辑。
问题2:SSR阶段给页面添加.mode-dark类的方案
SSR阶段不存在document对象,不能直接操作DOM,需要通过修改服务端返回的HTML字符串实现类名注入,推荐方案如下:
方案:通过服务端钩子修改响应HTML
以SvelteKit为例,在src/hooks.server.js中通过handle钩子的transformPageChunk方法,读取请求携带的暗黑模式cookie,动态替换body标签的类属性:
// src/hooks.server.js export async function handle({ event, resolve }) { // 从请求cookie中读取用户暗色模式偏好,无cookie时可默认设为false const isDark = event.cookies.get('isDark') === 'true'; return resolve(event, { transformPageChunk: ({ html }) => { // 给body标签注入mode-dark类 return html.replace('<body', `<body class="${isDark ? 'mode-dark' : ''}"`); } }); }
注意事项
- 服务端无法直接获取用户系统的颜色偏好,首次访问无cookie时,可通过读取请求头
Sec-CH-Prefers-Color-Scheme获取系统偏好(需要客户端支持该客户端提示头),或者默认返回浅色模式,等客户端水化后再通过window.matchMedia判断调整。 - 原有的颜色模式判断逻辑需要做环境拆分:服务端仅读取cookie/请求头,客户端才可以调用
window.matchMedia获取系统偏好。
内容的提问来源于stack exchange,提问作者Daniel
相关产品推荐
相关产品推荐

