DirectSurface UIDirectSurface UI
开始使用
文档/示例项目

示例库总览

本文中的最小组合使用:

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 }))

随着页面变复杂,再逐步引入表单、表格、命令范围、上下文范围和诊断能力。