简体中文
服务与运行时
组件册收录有解剖、有部件、可放置在页面上的组件。另有一类能力不是组件,却同样由本库对外提供:应用级配置、一次调用即弹出的对话框、把流式文本转换为节点的内核、模板里写公式与条件用的表达式语言、结构化的富文本模型、把 SVG 导出成文件的工具、画布式设计器共用的编辑内核、把表格写成 Excel 文件的写出器。它们没有 data-part,因此不进入组件册,本册收录这些能力。
| 本册 | 内容 | 对应的包 |
|---|---|---|
| 全局配置 | 应用级注入一次,语言与内建文案的默认值 | @xihan-ui/vue |
| 命令式服务 | confirm() / notify.success() 这类一次调用即出结果的入口 | @xihan-ui/vue |
| 流式 Markdown | 传入截至当前的全文,返回一组带稳定 key 的已渲染块 | @xihan-ui/markdown |
| 代码着色 | 零依赖的粗粒度词法着色,也是一个可替换的端口 | @xihan-ui/code-highlight |
| 受限表达式 | 公式与条件解析成可序列化的语法树,静态检查后按十进制确定性求值 | @xihan-ui/expression |
| 富文本模型 | 结构化的富文本 JSON:HTML 白名单解析、结构检查、转义写出与按模型生成 DOM | @xihan-ui/core |
| SVG 导出 | 把页面上的 SVG 克隆成能单独打开的一份、序列化,并按倍率与底色栅格化成 PNG | @xihan-ui/core |
| 设计器内核 | 撤销重做历史栈、按路径的编辑操作、视口平移缩放、对齐吸附与参考线、对齐分布与框选、文档内唯一 id | @xihan-ui/designer-kit |
| 设计器零件 | 属性面板、标尺与参考线、变换覆盖层、物料面板与拖放、问题列表、小地图、外框与设置对话框,只出 Web Components | @xihan-ui/designer-shell |
| 表格导出 | 带类型的单元格、数字与日期格式、合并单元格与冻结窗格,零依赖写成 xlsx | @xihan-ui/xlsx |
不在组件册中的原因
组件册每一页固定给出解剖、部件、状态机、connect API 与键盘规格,因为组件的契约即这几项。本册各项均不适用:全局配置是一个 provide 函数,命令式服务返回一个对象,Markdown 渲染器、表达式求值、设计器内核与 xlsx 写出产出数据而不是 DOM。放入组件册只会使该册的页内结构失去意义。设计器零件虽是元素,却只出 Web Components、自己生成内部结构,也不走三端组件的契约,同样收在本册。
但能力清单应当完整。按其他组件库的习惯查找对应能力时(Element Plus 的 ElMessageBox、Ant Design 的 App.useApp()、Naive UI 的 useDialog、Semi Design 的 Markdown 渲染器),它们在本册,不在组件册。
