用途:该技能用于在 Vue 3 项目中以 PrimeVue 的 Aura 预设实现高密度数据展示与复杂交互界面,包括数据网格、排序、行展开、虚拟滚动、列筛选,多级菜单、树形下拉、级联选择、日期时间范围选择,以及应用内模态框、浮动提示和弹出层等需要精细样式的浮层。资料明确说明不使用 Tailwind,应用框架、抽屉与原生外壳归 @quasar-foundation 负责,设计令牌归 @aura-design-tokens,动效归 @motion-physics。
主要能力:资料将组件职责划分为四类。数据展示使用 <DataTable>、<Column>、<TreeTable>,适合高密度布局、虚拟滚动、多列排序和类似 Excel 的筛选;复杂选择器使用 <MultiSelect>、<TreeSelect>、<CascadeSelect>,支持标签徽章、分组层级和行内搜索过滤;上下文控件使用 <TieredMenu>、<ContextMenu>、<Breadcrumb>,适合带子菜单飞出效果的桌面端菜单;状态与指标徽章使用 <Tag>、<Badge>、<ProgressBar>,提供一致的排版与语义色调。数据密集界面中的表单字段(InputText、Select、DatePicker、Password)在不是 Quasar 外壳原生控件时也使用 PrimeVue,且不再用 Tailwind 重新设置样式,也不在 PrimeVue 已占用字段时再包裹 Quasar q-input。卡片正文内容放入 <template #content>。
使用方式:安装命令为 npm install primevue @primevue/themes primeicons。混合方案要求 Quasar 的 CSS 重置先加载,PrimeVue Aura 后加载以保持组件样式。资料提供 vite.config.js 配置示例,使用 @vitejs/plugin-vue 与 @quasar/vite-plugin,并设置 sassVariables 指向 src/quasar-variables.sass;在 src/main.js 中依次引入 Quasar 核心与图标资源、PrimeVue 与 Aura 预设、primeicons 样式以及 MotionPlugin,然后注册 Quasar 的 Dialog、Notify 插件和 PrimeVue(主题 preset 为 Aura,options 包含 prefix: 'p'、darkModeSelector: '.dark-mode'、cssLayer: false)。资料强调 cssLayer: false 是必需的,以便 Aura 在 PrimeVue 组件上覆盖 Quasar 重置样式;深色模式使用来自 @aura-design-tokens 的 .dark-mode 类。组件应从 primevue/<name> 以 PascalCase 路径导入,不使用无样式入口;若连接 PrimeVue MCP 服务器,应先在该处确认 props 再自行发明;视图完成后加载 @motion-physics 处理行与对话框入场,不要为空间移动添加 PrimeVue 默认 CSS 过渡;界面与文本使用来自 @aura-design-tokens 的 var(--app-) 变量,这些变量读取 --p-。
适用场景:需要在 Vue 3 中同时使用 Quasar 外壳与 PrimeVue 组件的项目,尤其是后台管理、数据分析台、复杂表单页与带多级菜单的桌面式界面。
限制:资料未提供该技能的性能数据、兼容版本范围、浏览器支持细节或收费信息。技能完成后需运行 python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill primevue-aura --project-root . 并将脚本的 ### Next step 区块放入最终回复。