Skip to content

ThemeSwitcher 主题切换器

现成的主题切换 UI:4 配色家族 + 明/暗/跟随系统。内部使用 useTheme,无任何 props。

用法

点下面这个试试——整个文档站会跟着换肤(导航栏右上角那个就是它):

行为契约

  • 把选择写到 <html>data-theme / data-mode 属性
  • 持久化到 localStoragelx-theme(JSON:{ family, mode }
  • auto 档跟随系统 prefers-color-scheme
  • 首帧状态依赖 localStorage:挂在会被服务端渲染的位置时包 <ClientOnly>(或等效 mounted 守卫)避免注水不匹配

API

无 props / events / slots。配合 themeBootScript 防首屏闪烁。