生态产品多个设计器现已发布候选版本

查看生态总览
跳转到内容

服务与运行时 ​

组件册收录有解剖、有部件、可放置在页面上的组件。另有一类能力不是组件,却同样由本库对外提供:应用级配置、一次调用即弹出的对话框、把流式文本转换为节点的内核、模板里写公式与条件用的表达式语言、结构化的富文本模型、把 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 渲染器),它们在本册,不在组件册。

Released under The MIT License