用途:指导在 Vue 3 项目中安装、配置并使用 OpenDesign 组件库搭建页面,并配合 Pixso MCP 设计稿节点识别,将设计稿映射到对应组件。组件库面向 openEuler 生态,对应 @opensig/opendesign v1.2.6(最低依赖 ≥1.2.6),提供约 59 个可复用 UI 组件;具体组件的 API 引入、变更、废弃版本需查 ReleaseNote。
主要能力:覆盖按钮、输入、表单、表格、对话框、卡片、图标、滑块、步骤条、轻提示等常用组件,并为每个组件提供 visual(视觉识别)、usage(API 与代码模板)、style(CSS 变量与响应式)三类参考文档。主题方面提供六套独立主题(openEuler、Ascend、Kunpeng、MindSpore、Gauss、UBMC),项目初始化时选定一套,运行时只切换 dark/light。
使用方式:安装依赖 pnpm add @opensig/opendesign @opensig/opendesign-token(或 npm install 同包),在 main.ts 引入样式 import '@opensig/opendesign/es/index.css',再按社区引入对应 token 文件(如 e.dark.token.css、e.light.token.css),通过 <html>/<body> 上的 data-o-theme 属性切换深浅色,例如 document.documentElement.setAttribute('data-o-theme', 'e.dark')。可用 initRound('pill') 全局设置圆角,import '@opensig/opendesign-token/fonts/css' 引入鸿蒙字体。组件统一从 @opensig/opendesign 导入(如 OButton、OInput、OCard)。
编码原则与限制:已有组件能力必须通过 props/slots/events 实现,扩展优先用 slot 或公开 CSS 变量覆盖,最后才自定义;禁止在 scoped 样式中用 :deep 修改组件内部样式,应改用全局 CSS 或父元素覆盖公开 CSS 变量;响应式与 hover 需通过 respond、hover、hoverable、x-hover 等 mixin,并在构建工具(Vite/Nuxt)中通过 additionalData 全局注入 mixin。Pixso 设计稿识别按图层名称关键词、视觉结构特征、歧义辨别、属性映射的顺序匹配组件。
未提供信息:组件 API 的具体参数明细、各版本变更记录、组件数量在资料中同时出现 46 与 59 两种表述,安装最低版本与价格、授权、平台支持等细节暂未提供。