示例库总览
本文中的最小组合使用:
import { RenderButton, RenderStackPanel, RenderText } from 'ds-ui'
示例库面向业务开发者,目标是把前面章节中的组件、布局、上下文、命令和性能规则组合成可落地的页面模式。这里不把 demo 页面类当作公共 API,而是描述可复用的业务结构。
示例分类
当前示例库覆盖这些场景:
- 简单表单:录入、校验、提交。
- 查询表格:查询条件、工具栏、表格。
- 主从页面:左侧列表、右侧详情。
- 可编辑表格:行内编辑、校验、提交。
- 树表维护:树形目录和明细维护。
- 仪表盘:统计卡片、图表、列表。
- 命令权限页面:按钮、菜单、快捷键统一控制。
- 应用上下文页面:应用、页面、弹窗上下文传递。
- Markdown 文档中心:文档树、目录、搜索、正文阅读。
- 大文本编辑器:几十万行文本查看和编辑。
- 病历模板浏览:树形模板、文档加载、病历编辑器。
- 住院医生站组件 Showcase:在患者工作台中组合大数据 Grid、Lookup、树、Masonry、抽屉和病历编辑器。
如何阅读
如果你正在搭业务页面,建议先看最接近的示例,再回到对应组件文档补 API 细节。
如果页面还没有明确归类,先看 常用业务场景组合,它按复杂工作台、查询表格、表单编辑、主从维护、上下文分层和弹窗编辑解释页面拆法。
先看示例结构
确认页面应该怎么拆
再看组件手册
确认参数、事件、状态
最后看性能和生命周期
确认大数据、释放和诊断策略
示例文档中的页面结构是推荐样板,不是唯一做法。真正项目中可以根据业务复杂度裁剪。
示例约束
为了长期维护,示例应遵守这些规则:
- 框架能力从包入口导入。
- 页面状态和服务由业务自己定义。
- demo-only 类型不能出现在正式文档中。
- 复杂业务对象只作为示意,不固化为框架模型。
- 大数据页面必须说明虚拟化或增量策略。
- 有命令的页面优先使用统一命令系统。
最小组合
很多业务页面都可以从下面结构开始:
const page = new RenderStackPanel({ orientation: 'vertical', spacing: 8, crossAxisAlignment: 'stretch',}) page.addChild(new RenderText('业务页面'))page.addChild(new RenderButton({ label: '刷新', onClick: reload }))
随着页面变复杂,再逐步引入表单、表格、命令范围、上下文范围和诊断能力。