DirectSurface UIDirectSurface UI
开始使用

FRAMEWORK ARCHITECTURE

从业务状态到像素输出,
每一层都有明确边界。

八张可响应式重排的工程架构图,覆盖系统全景、模块依赖、单帧管线、输入路由、生命周期、企业集成、虚拟化与弹层。图中节点可继续进入正式文档。

01 / SYSTEM PANORAMA

DirectSurface UI 系统全景架构

宿主应用组合框架并注入业务服务;状态形成 Render Tree,运行时最终绘制到浏览器 Canvas 2D。

DEEP DIVE / 深入阅读

架构文档索引

图示负责建立全局认知,正式文档提供 API、约束和完整行为说明。

核心概念

RenderObject 基础

本文中的业务组件示例使用:

阅读全文
核心概念

布局与约束

DirectSurface UI 的布局采用约束传递模型。父组件决定子组件能用多大空间,子组件在约束范围内返回自己的尺寸,父组件再决定子组件的位置。

阅读全文
核心概念

绘制与命中测试

绘制和命中测试共同决定用户看到什么,以及指针事件会落到哪个组件上。

阅读全文
核心概念

事件路由

事件路由负责把浏览器输入转换为框架内的组件事件。它连接命中测试、焦点、手势和组件交互。

阅读全文
核心概念

焦点与输入

焦点决定键盘输入落到哪个组件。输入体系负责处理普通键入、中文组合输入、粘贴和文本编辑会话。

阅读全文
性能与调试

渲染管线

DirectSurface UI 的运行时管线由事件、状态变更、layout、paint、composite 几个阶段组成。性能排查时要先判断卡顿发生在哪个阶段,而不是直接猜测某个组件慢。

阅读全文
性能与调试

虚拟化

虚拟化用于让大数据组件只处理可视窗口附近的项目。它不是一种视觉效果,而是一种数据到视窗的映射策略。

阅读全文
企业架构

复杂业务架构

复杂业务系统通常不是“一个页面加几个组件”,而是由工作台、页面生命周期、权限、上下文、数据服务、审计、诊断和高性能组件共同组成。DirectSurface UI 的职责是提供这些能力的承载结构,不定义医院、患者、订单、病历等业务模型。

阅读全文
企业架构

模块组织

大型项目需要把框架依赖、业务页面、服务、模型和静态资源分开。框架能力统一从 ds-ui 包入口导入,业务代码只在自己的模块中组合。

阅读全文
企业架构

服务与状态

DirectSurface UI 不限制业务状态管理方案。它提供的基础能力是上下文、组件状态、命令刷新和生命周期释放。复杂业务可以在这个基础上接入自己的 store、接口服务、缓存服务和审计服务。

阅读全文