You need to enable JavaScript to run this app. Sapper SSR添加mode-dark类及布局preload不执行问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.17 23:15:04