SuperAPI AI 工具集

astrofy-themes

通用与其它

查看项目

更新于 10-16 03:49

技能介绍

用途:为 Astro 站点实现浅色、深色与跟随系统的主题切换,并持久保存用户偏好。

主要能力:读取持久化偏好并限定为 light、dark、system,未知值归一化为默认;用 matchMedia('(prefers-color-scheme: dark)') 解析 system,显式偏好优先于系统结果;在首次绘制前把主题类或属性写到 html 元素上,并遵守现有 CSP;选择器更新视觉状态、偏好与 CSS 使用的属性;localStorage 失败不得中断本页切换;监听 matchMedia 的 change,仅在偏好为 system 时更新主题,并在导航重建时移除旧监听。

使用方式:先读初始主题脚本、选择器、localStorage、暗色 CSS 和各模式资源;路径以 .astrofy/config/paths.json 为准。应用在线文档 API 前核对 lockfile 与 node_modules 中的版本。保持 system 偏好与已解析模式分离,沿用现有 class 或 data-theme 约定,不要新增第二个控制器。若站点使用 ClientRouter 或页面转场,需确认导航后主题属性重新初始化。

验证与限制:可在存储不可用时确认不抛错、页面其余部分仍可用;选择 dark 后刷新应保持主题与 logo;检查两种模式下 logo 与计算样式;执行 astrofy check --category theme。资料未提供具体代码示例、支持版本范围与更多配置细节。