服务与运行时
组件册收录有解剖、有部件、可放置在页面上的组件。另有一类能力不是组件,却同样由本库对外提供:应用级配置、一次调用即弹出的对话框、把流式文本转换为节点的内核。它们没有 data-part,因此不进入组件册,本册收录这些能力。
| 本册 | 内容 | 对应的包 |
|---|---|---|
| 全局配置 | 应用级注入一次,语言与内建文案的默认值 | @xihan-ui/vue |
| 命令式服务 | confirm() / toast.success() 这类一次调用即出结果的入口 | @xihan-ui/vue |
| 流式 Markdown | 传入截至当前的全文,返回一组带稳定 key 的已渲染块 | @xihan-ui/markdown |
| 代码着色 | 零依赖的粗粒度词法着色,也是一个可替换的端口 | @xihan-ui/code-highlight |
不在组件册中的原因
组件册每一页固定给出解剖、部件、状态机、connect API 与键盘规格,因为组件的契约即这几项。本册四项均不适用:全局配置是一个 provide 函数,命令式服务返回一个对象,Markdown 渲染器产出数据而不是 DOM。放入组件册只会使该册的页内结构失去意义。
但能力清单应当完整。按其他组件库的习惯查找对应能力时(Element Plus 的 ElMessageBox、Ant Design 的 App.useApp()、Naive UI 的 useDialog、Semi Design 的 Markdown 渲染器),它们在本册,不在组件册。
