组件手册总览

组件手册用于查找控件用途、参数、事件、交互行为和性能注意事项。

如果只需要快速确认“有没有这个组件、公开 API 叫什么、对应文档在哪里”，先看组件清单。所有可布局组件共有的尺寸、margin、alignment 和容器 padding 规则见组件通用布局属性。

组合业务页面时，可以先阅读组件设计系统。组件手册说明单个组件如何使用，设计系统说明页面如何选择 token、表达状态并保持交互和视觉一致。

如何选择组件

先按业务结构选择大类，再进入具体组件文档：

如果组件涉及页面级状态、权限、上下文或大数据性能，先看对应指南，再回到组件文档查参数：

所有组件都继承 RenderObject.visible，可由业务直接控制是否出现在布局、绘制、hit test 和焦点顺序中。交互组件按语义提供 disabled，输入或选择控件按语义提供 readonly。

状态	使用场景	组件责任
`visible`	业务权限、页面模式、条件字段决定组件是否出现。	折叠布局、跳过绘制和命中测试、退出焦点顺序。
`disabled`	控件存在但当前不可操作。	阻断鼠标和键盘交互，清理 hover、pressed、popup、菜单、拖拽等临时状态。
`readonly`	值可查看但不可修改。	保持可读展示，阻止编辑或选择变更，按组件语义处理焦点和复制。

业务层负责计算权限和流程状态；组件层负责提供统一 UI 状态。命令入口优先通过命令系统统一映射 visible/enabled，表单和页面局部状态可以直接设置组件属性。