#主題變數參考
本頁由主題變數定義自動生成,共 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-cn、zh-tw、ja、de、fr、es、pt、ar。
所有變數值均為字串。示例只展示一種有效寫法,不代表預設值。
| 變數 | 分組 | 型別 | 示例 |
|---|---|---|---|
--accent-primary | 強調色 | 顏色 | #abc |
--accent-secondary | 強調色 | 顏色 | #abc |
--accent-soft | 強調色 | 顏色 | #abc |
--accent-strong | 強調色 | 顏色 | #abc |
--accent-tertiary | 強調色 | 顏色 | #abc |
--button-background | Aino 按鈕 | 顏色 | #abc |
--button-background-active | Aino 按鈕 | 顏色 | #abc |
--button-background-hover | Aino 按鈕 | 顏色 | #abc |
--button-border-color | Aino 按鈕 | 顏色 | #abc |
--button-border-color-hover | Aino 按鈕 | 顏色 | #abc |
--button-color | Aino 按鈕 | 顏色 | #abc |
--button-color-hover | Aino 按鈕 | 顏色 | #abc |
--button-font-weight | Aino 按鈕 | 字重 | normal |
--button-radius | Aino 按鈕 | 圓角 | 0 |
--button-shadow | Aino 按鈕 | 陰影 | none |
--card-background | Aino 卡片 | 顏色 | #abc |
--card-background-hover | Aino 卡片 | 顏色 | #abc |
--card-border-color | Aino 卡片 | 顏色 | #abc |
--card-border-width | Aino 卡片 | 長度 | 0 |
--card-radius | Aino 卡片 | 圓角 | 0 |
--card-shadow | Aino 卡片 | 陰影 | none |
--input-background | Aino 輸入框 | 顏色 | #abc |
--input-background-hover | Aino 輸入框 | 顏色 | #abc |
--input-border-color | Aino 輸入框 | 顏色 | #abc |
--input-border-color-focus | Aino 輸入框 | 顏色 | #abc |
--input-color | Aino 輸入框 | 顏色 | #abc |
--input-placeholder-color | Aino 輸入框 | 顏色 | #abc |
--input-shadow | Aino 輸入框 | 陰影 | none |
--modal-backdrop-blur | Aino 材質 | 長度 | 0 |
--modal-backdrop-saturation | Aino 材質 | 比率 | 0 |
--toast-backdrop-blur | Aino 提示訊息 | 長度 | 0 |
--toast-backdrop-saturation | Aino 提示訊息 | 比率 | 0 |
--toast-background | Aino 提示訊息 | 顏色 | #abc |
--toast-border-color | Aino 提示訊息 | 顏色 | #abc |
--toast-border-width | Aino 提示訊息 | 長度 | 0 |
--toast-radius | Aino 提示訊息 | 圓角 | 0 |
--toast-shadow | Aino 提示訊息 | 陰影 | none |
--toolbar-backdrop-blur | Aino 工具欄 | 長度 | 0 |
--toolbar-backdrop-saturation | Aino 工具欄 | 比率 | 0 |
--toolbar-background | Aino 工具欄 | 顏色 | #abc |
--toolbar-border-color | Aino 工具欄 | 顏色 | #abc |
--toolbar-shadow | Aino 工具欄 | 陰影 | 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。模糊不能為負數。 |