7.5 KiB
title, description
| title | description |
|---|---|
| 灵动岛设计令牌 | 本地经典/自定义岛的几何、外观与动画入口。 |
灵动岛设计令牌
经典岛以 WinIsland 的连续圆角和形变为设计参考,自定义组件行以 ClassIsland 为参考。 当前数值与行为以本仓库 shared 常量和渲染实现为准;本页不把上游音乐/歌词/媒体功能列为 ClassHelper 功能。
经典几何与外观
| 来源 | 内容 |
|---|---|
| shared/src/constants.ts 的 DEFAULT_ISLAND_APPEARANCE | 默认宽 268、高 44、圆角 20、字号 13、边距 8,顶部居中 |
| shared/src/constants.ts 的 CLASSISLAND_TOKENS | 岛层颜色、字体、字号、圆角、间距、阴影、层级与 DPI 的 TypeScript 来源 |
| ISLAND_APPEARANCE_RANGES | 滑块与主进程归一化共用的范围 |
| ISLAND_SIZE_DELTA | 展开、紧急与叫人相对尺寸 |
| ISLAND_SHADOW_PAD | 窗口边界的透明留白 |
| ISLAND_LIST_METRICS / islandListLayout | 主进程和渲染层共用列表度量,控制行数与工作区高度 |
| desktop-client/src/island/squircle.ts | 超椭圆路径 |
| desktop-client/src/island/classic-island.css | 经典底色、文字、图形与状态样式 |
| ui/src/tokens.css | --ci-* 亮/暗两套 CSS 变量,以及五级文字工具类 |
classic 的 black/glass/tinted 是本地 CSS 外观;glass 使用半透明色,不采样桌面模糊。 不要对透明岛调用 setBackgroundMaterial:系统材质作用于整窗矩形,可能破坏逐像素透明。 投影常驻,只随形态改参数,避免切换 filter 创建合成表面的闪帧。 默认停靠中线不受左右边距影响,只有左/右停靠使用水平边距。
自定义常驻行
CLASSISLAND_ISLAND_METRICS 位于 shared/src/island-layout.ts:
| 参数 | 本地值 |
|---|---|
| 单行基准高度 / 水平留白 | 40 / 12 px |
| 次要/正文/强调/大字号 | 14 / 16 / 18 / 20 px |
| 默认缩放 / 范围 | 1 / 0.75–2.5 |
| 默认圆角 / 最大 | 8 / 20 px |
| 默认不透明度 / 行距 | 0.5 / 5 px |
| 鼠标避让淡化比例 | 0.05 |
方案有常态 rows 和无通知展开 expandedRows,运行时由 CustomIslandRuntime.vue 测量自然内容, 再按屏幕工作区与方案缩放适配。字体与外观覆盖按组件契约生效,不能拿经典固定宽高解释自定义内容尺寸。
自定义岛默认使用 CSS border-radius;经典岛继续保留连续圆角。圆角同时作用于自绘背景与内容裁切,
默认 8px、范围 0–20px、步进 0.5px。背景色只通过 --resident-background 派生,背景 alpha 与整行
opacity 分开计算,避免整行不透明度连带淡化投影和覆盖层。
ClassIsland token 层
CLASSISLAND_TOKENS 与 --ci-* 一一对应,应用外壳继续使用 --ch-* / --ch-ui-*。
ClassIsland 源值中的颜色采用 Avalonia AARRGGBB,写入 CSS 时统一转换为
RRGGBBAA,alpha 数值不变。
| 类别 | 关键值 |
|---|---|
| 强调色 | PrimaryColor / DeepSkyBlue、SecondaryColor / Aquamarine、DodgerBlue 兜底 |
| 五级前景 | 100% / 85.5% / 77.3% / 52.9% / 36.5%,开启自定义前景时写进颜色 alpha |
| 四档字号 | 14 / 16 / 18 / 20px,设置范围 1–40px,步进 0.5px |
| 字重 | 100–900 逐值映射,默认 500;其他值回落 400 |
| 圆角 | 岛 8、弹窗 6、卡片与控件 4、抽屉 8 8 0 0、胶囊 999px |
| 间距 | 行高 40、左右 12、组件间距 12、行距 5、进度条 3px |
| 层级 | 遮罩/拖拽 1、抽屉 10、时间轴装饰 9999、哨兵 2147483647 |
| DPI | 96 DPI 基准、缩放 0.75–2.5、Fluent 竖直安全区 20px |
四档字号可写在组件自身、单个行或方案根元素。行级与组件级都通过 CSS 变量覆盖;关闭覆盖时删除
对应内联变量并回落到方案或 :root。自定义前景关闭时同样删除行内五级变量,由 html.dark 切换
主题默认值。
强调色来源严格区分自定义、壁纸调色板、跟随系统与屏幕调色板;主进程输出 resolvedAccent,设置页
仍保留用户选择的 accent,避免切换来源时覆盖原自定义色。主题切换通过岛桥接的 island:theme
事件实时同步 html.dark,不依赖主窗口的 DOM。
主界面对照
| ClassIsland 概念 | ClassHelper 实体 |
|---|---|
| MainWindow | 独立 island.html + 主进程透明 BrowserWindow |
| MainWindowLine | CustomIslandRuntime.vue 的 .layout-row 与行级 CSS 变量 |
| ComponentPresenter | ComponentNode.vue 根节点的宽高、透明度、隐藏与裁剪 |
| 日期/时钟/天气/课程组件 | ComponentNode.vue、WeatherBrief.vue 等共享组件 |
| Fluent/Classic 主题 | custom-runtime.css / custom-island.css / classic-island.css |
| 编辑模式视图 | 主窗口 IslandEditorView.vue、IslandEditorNode.vue 与右侧检查器 |
| 提醒宿主 | ClassicNotifications.vue,嵌入自定义岛或经典岛 |
动画与命中
经典与自定义岛的形变都使用 src/island/spring.ts 的 SpringValue;默认 stiffness=0.10、damping=0.68, 换向保留部分动量,按剩余距离限速并钳制过冲。不同用途可能覆盖 snapThreshold 等参数,以调用点为准。 这是独立的帧积分,不等同于主窗口 shared/motion.ts 的 CSS 弹簧。 应用内动画开关、原生窗口可见性与文档可见性控制运行时动画和静止落定。
鼠标模式按光标命中控制穿透;触摸模式处理贴合、输入区域与失焦宽限,自定义常驻模式还维护独立交互入口和窗口形状。 几何改变时同步实际窗口、命中矩形和测量,不在动画中反推自然尺寸。 视觉验收必须显式 --visual;本页数值不代表本次已完成像素验收。
修改入口
外观范围改 shared,经典样式改 classic-island.css,自定义样式改 custom-runtime.css 和 custom-island.css,
原生窗口与命中改 main/island.ts。组件结构/设置改 shared/island-layout.ts 并同步编辑器和运行时。
改 token 后运行 pnpm check:design-tokens,它会校验亮/暗键集合、必备 token、kebab-case 与岛内裸颜色。
展示行为见灵动岛,测试见验收与测试。