站点工具

DOCUMENTS / DEVELOP

前台页面与共享组件

用统一页面骨架、Reader 和控件规范扩展网站而不破坏既有体验。

页面结构

一级区域为百科、文章、探索、LABs 和参与共建。页面入口集中在 src/lib/siteFeatures.mjs;不要在首页、页眉和二级页各写一套不同路径。二级页使用共享的 WorkspaceShell、WorkspaceHeader 等组件,返回与主要操作保持固定位置。新增功能先确定所属区域及窄屏布局,再加导航入口。

阅读与内容展示

词条、文章与说明书分别复用 Reader.astro 的合适形态。本说明书页面使用 variant="guide",传入 Markdown 渲染得到的 headings,直接使用原目录与锚点交互。不要用一组相似 CSS 冒充阅读器。首页清晰悬停背景、词条阅读背景、形态选择器图片+名字和分批展开是回归基线;调整共享样式时逐项核对。

操作与动效

跨页导航、视图切换与筛选应表现出不同语义;滑块仅用于有实际切换关系的控件。控件维持清晰焦点、加载、空状态和失败反馈,图片与字体预留尺寸。切换动画可中断,遵守减少动态效果设置;不能通过删除阅读背景或悬停反馈解决抽动。公共控件使用界面中性色,词条主题色只用于对应内容。

复用时先选语义

跨页跳转用文本链接、面包屑或 WorkspaceLinkNavigation;同页互斥视图用 ContentTabs 或有明确当前项的选择组;筛选用搜索和 WorkspaceFilters;加载、无结果与错误使用 WorkspaceState、WorkspaceEmptyState。返回按钮位于标题上方,主要操作在标题右侧,窄屏转到标题下方。不要为了所有页面“统一”而放一排没有真实关系的滑块。

长文用 Reader.astro。百科传 variant="entry" 并保留主题图、侧栏;文章用其文章形态;说明书章节使用 variant="guide" 和渲染器提供的 headings,目录锚点的 slug 必须与正文 id 一致。这个组件已负责目录跟随、窄屏折叠、键盘和减少动态效果,页面不应复制一套相似的目录脚本。

视觉与交互回归

首页条目、歌曲和专辑的清晰悬停背景,阅读器背景与主题色,图片+名字的形态选择、分批展开,都是保留项。新增组件预留图片比例和控件尺寸,首次定位不播放位移动画;快速切换需取消前一个动画。深浅色、键盘焦点、窄屏和减少动态效果都应检查。页面级 CSS 只处理内容布局,不覆盖共享按钮、筛选和弹窗状态。

KAMITSUBAKI WIKI

登录观测站

沿用 AI 助手账号。登录后可在不同设备同步收藏,阅读百科无需登录。

我的空间 →