默认用法

不传任何属性:默认跟随系统,选择写入 localStorage,页面上的多个开关互相同步。

background / foreground 随主题翻转

自定义文案 · labels / triggerLabel

labels 覆盖菜单项文本(国际化),triggerLabel 覆盖触发按钮的 aria-label。

自定义图标 · icons

只覆盖 light 与 dark,system 仍回落到默认的 lucide Monitor 图标 —— icons 是 Partial。

不提供“跟随系统” · enableSystem

enableSystem={false} 时菜单只剩浅色与深色两项,适合只提供两套主题的应用。

菜单中不再出现 System

受控用法 · value / onValueChange

传入 value 后由父组件持有状态:组件仍然应用主题,但不再写入存储、不再同步其他开关。

样式定制 · className / classNames

className 作用于触发按钮,classNames 逐个覆盖 trigger / content / item / icon。

独立存储键 · storageKey

换一个 storageKey 就持久化到自己的 localStorage 项;同页面的开关仍会实时互相同步。

写入 localStorage.hammer-theme

保留过渡 · disableTransitionOnChange

默认 true:切换瞬间关掉 CSS 过渡,避免整页颜色拖影;设为 false 则平滑过渡。

切换时颜色平滑过渡