用途 Aura Design Tokens 面向使用 PrimeVue Aura 主题与 Quasar 的前端项目,目标是在两套组件体系与自定义 CSS 之间保持颜色、表面层级、边框、圆角和暗色模式的一致性。它通过一层 CSS 自定义属性做“令牌桥接”,让组件只引用应用级变量,从而避免在单个组件里重复定义调色板。
主要能力
- 在 PrimeVue Aura 令牌(--p-)、Quasar 令牌(--q-)与应用角色令牌(--app-*)之间建立映射。
- 提供明暗两套表面层级变量,覆盖背景、卡片表面、边框、主文本与弱化文本。
- 将品牌主色同步到 Quasar 的 --q-primary 与 --q-secondary。
- 提供基础样式重置,页面背景与文字颜色均引用变量。
- 回退值只写在桥接文件内部,保证 Aura 变量缺失时仍能正常绘制。
使用方式 将令牌桥接代码放入主样式表(如 src/assets/design-tokens.css),并在 src/main.js 中于 PrimeVue 初始化之后导入,确保读取时 --p-* 已存在。同时应在 Quasar 与 PrimeVue 之后导入该文件。暗色模式通过在祖先元素上添加或移除 .dark-mode 类切换,与 PrimeVue 的 darkModeSelector: '.dark-mode' 保持一致。自定义 CSS 需要使用圆角或阴影时,优先引用 Aura 提供的变量(如 var(--p-border-radius-md)、var(--p-content-border-radius)),而不是在每个组件里另设数值刻度。如果存在品牌展示字体方向,可设置 --app-font-display,正文仍使用预设字体栈,除非需求指定了其他 UI 字族。
适用场景 适用于同时使用 PrimeVue Aura 与 Quasar 的 Vue 项目;需要统一主题色、表面层级与暗色模式;需要把组件内的原始十六进制颜色或内联颜色替换为语义变量;需要在自定义 CSS 中复用主题令牌。
限制与约束 不使用 Tailwind 工具类,也不应引入 Tailwind、OpenProps 或并行的十六进制色阶;若项目已依赖 open-props 可保留,但新表面仍使用 --app-*。品牌方向若由其他环节给出,应在此记录角色变量,不要在组件里另造第二套调色板。任务完成后,可按资料建议运行 python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill aura-design-tokens --project-root . 获取下一步建议。