主题变量参考

本页由主题变量定义自动生成,共 292 个变量。作用范围和使用方式见主题编写指南。修改变量后运行 pnpm theme:generate;文档构建会检查生成结果是否同步。

下载 JSON Schema

。在 v2 主题 JSON 顶层加入 "$schema": "https://aino.md/schemas/appearance-theme.v2.zh-cn.schema.json",支持 JSON Schema 的编辑器即可提供字段补全与结构检查。Schema 检查变量名、类型和基本字面量语法;颜色函数、阴影等字符串内部的数值范围仍以 Aino 导入校验为准。离线时可下载 Schema,改用本地相对路径。

Schema 说明支持全部 9 种界面语言。除英文使用默认地址外,其他语言在文件名中加入语言代码,例如 appearance-theme.v2.ja.schema.json。支持的语言代码:zh-cnzh-twjadefresptar

所有变量值均为字符串。示例只展示一种有效写法,不代表默认值。

变量分组类型示例
--accent-primary强调色颜色#abc
--accent-secondary强调色颜色#abc
--accent-soft强调色颜色#abc
--accent-strong强调色颜色#abc
--accent-tertiary强调色颜色#abc
--button-backgroundAino 按钮颜色#abc
--button-background-activeAino 按钮颜色#abc
--button-background-hoverAino 按钮颜色#abc
--button-border-colorAino 按钮颜色#abc
--button-border-color-hoverAino 按钮颜色#abc
--button-colorAino 按钮颜色#abc
--button-color-hoverAino 按钮颜色#abc
--button-font-weightAino 按钮字重normal
--button-radiusAino 按钮圆角0
--button-shadowAino 按钮阴影none
--card-backgroundAino 卡片颜色#abc
--card-background-hoverAino 卡片颜色#abc
--card-border-colorAino 卡片颜色#abc
--card-border-widthAino 卡片长度0
--card-radiusAino 卡片圆角0
--card-shadowAino 卡片阴影none
--input-backgroundAino 输入框颜色#abc
--input-background-hoverAino 输入框颜色#abc
--input-border-colorAino 输入框颜色#abc
--input-border-color-focusAino 输入框颜色#abc
--input-colorAino 输入框颜色#abc
--input-placeholder-colorAino 输入框颜色#abc
--input-shadowAino 输入框阴影none
--modal-backdrop-blurAino 材质长度0
--modal-backdrop-saturationAino 材质比率0
--toast-backdrop-blurAino 提示消息长度0
--toast-backdrop-saturationAino 提示消息比率0
--toast-backgroundAino 提示消息颜色#abc
--toast-border-colorAino 提示消息颜色#abc
--toast-border-widthAino 提示消息长度0
--toast-radiusAino 提示消息圆角0
--toast-shadowAino 提示消息阴影none
--toolbar-backdrop-blurAino 工具栏长度0
--toolbar-backdrop-saturationAino 工具栏比率0
--toolbar-backgroundAino 工具栏颜色#abc
--toolbar-border-colorAino 工具栏颜色#abc
--toolbar-shadowAino 工具栏阴影none
--border-color边框颜色#abc
--border-color-strong边框颜色#abc
--border-color-subtle边框颜色#abc
--editor-border-color编辑器颜色#abc
--editor-surface-primary编辑器颜色#abc
--editor-surface-secondary编辑器颜色#abc
--editor-surface-tertiary编辑器颜色#abc
--focus-ring-shadow阴影与焦点阴影none
--shadow-glow阴影与焦点阴影none
--shadow-lg阴影与焦点阴影none
--shadow-md阴影与焦点阴影none
--shadow-sm阴影与焦点阴影none
--clickable-icon-radius图标圆角0
--icon-color图标颜色#abc
--icon-color-active图标颜色#abc
--icon-color-hover图标颜色#abc
--icon-opacity图标不透明度0
--icon-opacity-hover图标不透明度0
--icon-size图标长度0
--icon-stroke图标比率0
--editor-link-color链接颜色#abc
--editor-link-hover-color链接颜色#abc
--link-color链接颜色#abc
--link-hover-color链接颜色#abc
--menu-background菜单颜色#abc
--menu-border-color菜单颜色#abc
--menu-item-background-hover菜单颜色#abc
--menu-item-color菜单颜色#abc
--menu-item-color-hover菜单颜色#abc
--menu-item-padding-x菜单长度0
--menu-item-padding-y菜单长度0
--menu-radius菜单圆角0
--menu-shadow菜单阴影none
--motion-curve-emphasis动效缓动linear
--motion-curve-soft动效缓动linear
--motion-duration-fast动效时长0ms
--motion-duration-normal动效时长0ms
--motion-duration-slow动效时长0ms
--blockquote-background-color引用颜色#abc
--blockquote-border-color引用颜色#abc
--blockquote-border-thickness引用长度0
--blockquote-color引用颜色#abc
--blockquote-font-style引用字形normal
--checkbox-border-color任务复选框颜色#abc
--checkbox-border-color-hover任务复选框颜色#abc
--checkbox-color任务复选框颜色#abc
--checkbox-color-hover任务复选框颜色#abc
--checkbox-marker-color任务复选框颜色#abc
--code-background代码颜色#abc
--code-comment代码颜色#abc
--code-function代码颜色#abc
--code-important代码颜色#abc
--code-keyword代码颜色#abc
--code-normal代码颜色#abc
--code-operator代码颜色#abc
--code-property代码颜色#abc
--code-punctuation代码颜色#abc
--code-size代码字号18px
--code-string代码颜色#abc
--code-tag代码颜色#abc
--code-value代码颜色#abc
--hr-color编辑器颜色#abc
--hr-thickness编辑器长度0
--background-modifier-active-hover基础变量颜色#abc
--background-modifier-border基础变量颜色#abc
--background-modifier-border-focus基础变量颜色#abc
--background-modifier-border-hover基础变量颜色#abc
--background-modifier-hover基础变量颜色#abc
--background-primary基础变量颜色#abc
--background-primary-alt基础变量颜色#abc
--background-secondary基础变量颜色#abc
--background-secondary-alt基础变量颜色#abc
--caret-color基础变量颜色#abc
--color-accent基础变量颜色#abc
--color-accent-1基础变量颜色#abc
--color-accent-2基础变量颜色#abc
--interactive-accent基础变量颜色#abc
--interactive-accent-hover基础变量颜色#abc
--interactive-hover基础变量颜色#abc
--interactive-normal基础变量颜色#abc
--radius-l基础变量圆角0
--radius-m基础变量圆角0
--radius-s基础变量圆角0
--text-accent基础变量颜色#abc
--text-accent-hover基础变量颜色#abc
--text-error基础变量颜色#abc
--text-faint基础变量颜色#abc
--text-highlight-bg基础变量颜色#abc
--text-normal基础变量颜色#abc
--text-on-accent基础变量颜色#abc
--text-on-accent-inverted基础变量颜色#abc
--text-selection基础变量颜色#abc
--text-success基础变量颜色#abc
--text-warning基础变量颜色#abc
--h1-color标题颜色#abc
--h1-size标题字号18px
--h1-weight标题字重normal
--h2-color标题颜色#abc
--h2-size标题字号18px
--h2-weight标题字重normal
--h3-color标题颜色#abc
--h3-size标题字号18px
--h3-weight标题字重normal
--h4-color标题颜色#abc
--h4-size标题字号18px
--h4-weight标题字重normal
--h5-color标题颜色#abc
--h5-size标题字号18px
--h5-weight标题字重normal
--h6-color标题颜色#abc
--h6-size标题字号18px
--h6-weight标题字重normal
--heading-formatting标题颜色#abc
--input-border-width输入框长度0
--input-font-weight输入框字重normal
--input-radius输入框圆角0
--link-color-hover链接颜色#abc
--link-external-color链接颜色#abc
--link-external-color-hover链接颜色#abc
--link-unresolved-color链接颜色#abc
--list-indent列表长度0
--list-marker-color列表颜色#abc
--list-marker-color-hover列表颜色#abc
--list-spacing列表长度0
--modal-background弹窗颜色#abc
--modal-border-color弹窗颜色#abc
--modal-border-width弹窗长度0
--modal-radius弹窗圆角0
--nav-collapse-icon-color导航颜色#abc
--nav-collapse-icon-color-collapsed导航颜色#abc
--nav-indentation-guide-color导航颜色#abc
--nav-indentation-guide-width导航长度0
--nav-item-background-active导航颜色#abc
--nav-item-background-hover导航颜色#abc
--nav-item-background-selected导航颜色#abc
--nav-item-color导航颜色#abc
--nav-item-color-active导航颜色#abc
--nav-item-color-highlighted导航颜色#abc
--nav-item-color-hover导航颜色#abc
--nav-item-color-selected导航颜色#abc
--nav-item-weight导航字重normal
--nav-item-weight-active导航字重normal
--nav-item-weight-hover导航字重normal
--color-blue调色板颜色#abc
--color-cyan调色板颜色#abc
--color-green调色板颜色#abc
--color-orange调色板颜色#abc
--color-pink调色板颜色#abc
--color-purple调色板颜色#abc
--color-red调色板颜色#abc
--color-yellow调色板颜色#abc
--table-background表格颜色#abc
--table-border-color表格颜色#abc
--table-border-width表格长度0
--table-header-background表格颜色#abc
--table-header-border-color表格颜色#abc
--table-header-color表格颜色#abc
--table-header-weight表格字重normal
--table-row-alt-background表格颜色#abc
--table-row-background-hover表格颜色#abc
--table-selection表格颜色#abc
--table-text-color表格颜色#abc
--tab-background-active页签颜色#abc
--tab-container-background页签颜色#abc
--tab-divider-color页签颜色#abc
--tab-font-size页签字号18px
--tab-font-weight页签字重normal
--tab-radius页签圆角0
--tab-radius-active页签圆角0
--tab-text-color页签颜色#abc
--tab-text-color-active页签颜色#abc
--tag-background标签颜色#abc
--tag-background-hover标签颜色#abc
--tag-border-color标签颜色#abc
--tag-border-color-hover标签颜色#abc
--tag-border-width标签长度0
--tag-color标签颜色#abc
--tag-color-hover标签颜色#abc
--tag-radius标签圆角0
--tag-size标签字号18px
--tag-weight标签字重normal
--bold-color排版颜色#abc
--italic-color排版颜色#abc
--scrollbar-active-thumb-bg滚动条颜色#abc
--scrollbar-bg滚动条颜色#abc
--scrollbar-thumb-bg滚动条颜色#abc
--radius-lg形状圆角0
--radius-md形状圆角0
--radius-sm形状圆角0
--radius-xl形状圆角0
--radius-xs形状圆角0
--sidebar-blur侧栏长度0
--sidebar-opacity侧栏不透明度0
--sidebar-panel-background侧栏颜色#abc
--sidebar-panel-background-active侧栏颜色#abc
--sidebar-panel-background-hover侧栏颜色#abc
--sidebar-panel-background-raised侧栏颜色#abc
--sidebar-panel-border-color侧栏颜色#abc
--sidebar-saturation侧栏比率0
--surface-sidebar侧栏颜色#abc
--slider-thumb-border-color滑动条颜色#abc
--slider-thumb-border-width滑动条长度0
--slider-thumb-color滑动条颜色#abc
--slider-thumb-height滑动条长度0
--slider-thumb-radius滑动条圆角0
--slider-thumb-width滑动条长度0
--slider-track-background滑动条颜色#abc
--slider-track-height滑动条长度0
--error状态颜色#abc
--success状态颜色#abc
--warning状态颜色#abc
--surface-accent-soft区域背景颜色#abc
--surface-accent-soft-strong区域背景颜色#abc
--surface-canvas区域背景颜色#abc
--surface-danger-soft区域背景颜色#abc
--surface-elevated区域背景颜色#abc
--surface-muted区域背景颜色#abc
--surface-muted-strong区域背景颜色#abc
--surface-panel区域背景颜色#abc
--surface-success-soft区域背景颜色#abc
--surface-toolbar区域背景颜色#abc
--surface-warning-soft区域背景颜色#abc
--text-inverse文字颜色#abc
--text-muted文字颜色#abc
--text-primary文字颜色#abc
--text-secondary文字颜色#abc
--toggle-background开关颜色#abc
--toggle-background-active开关颜色#abc
--toggle-radius开关圆角0
--toggle-thumb-color开关颜色#abc
--toggle-thumb-height开关长度0
--toggle-thumb-radius开关圆角0
--toggle-thumb-width开关长度0
--toggle-width开关长度0
--tooltip-background提示框颜色#abc
--tooltip-color提示框颜色#abc
--tooltip-font-size提示框字号18px
--tooltip-radius提示框圆角0
--tooltip-shadow提示框阴影none
--font-interface-theme排版字体栈'Noto Serif SC', Georgia, serif
--font-monospace-theme排版字体栈'Noto Serif SC', Georgia, serif
--font-text-size排版字号18px
--font-text-theme排版字体栈'Noto Serif SC', Georgia, serif
--font-ui-large排版字号18px
--font-ui-medium排版字号18px
--font-ui-small排版字号18px
--heading-spacing排版长度0
--line-height-normal排版行高1
--line-height-tight排版行高1
--p-spacing排版长度0

取值约束

以下约束与应用内 AI 提示词来自同一份定义,长度按单位分别限制。

类型约束
颜色颜色:#RGB、#RGBA、#RRGGBB、#RRGGBBAA、transparent,或用逗号分隔参数的 rgb()/rgba()/hsl()/hsla()。统一保存为六位或八位十六进制,保留透明度。
圆角圆角:0 或非负长度。各单位上限:32px / 2rem / 2em。
长度长度:0 或非负长度。各单位上限:256px / 16rem / 16em。
字号字号:0 或非负长度。各单位上限:64px / 4rem / 4em。
字重字重:normal, bold, 100, 200, 300, 400, 500, 600, 700, 800, 900。
字形字形:normal, italic, oblique。
字体栈字体栈:最多 8 个已安装字体、500 个字符。不包含或下载字体文件。
不透明度不透明度:0 到 1 的无单位数值。
比率比率:0 到 3 的无单位数值。
行高行高:1 到 3 的无单位数值。
时长时长:使用 ms 或 s 的非负数值,最多 2000 ms。
缓动缓动:linear, ease, ease-in, ease-out, ease-in-out,或 cubic-bezier(x1, y1, x2, y2)。x 的范围为 0–1,y 的范围为 -3–3。
阴影阴影:none,或最多 4 层、500 个字符。每层依次为可选的 inset、x、y、可选的模糊和扩展长度、颜色。长度绝对值的各单位上限:256px / 16rem / 16em。模糊不能为负数。