跳转到内容

组件共同契约

23 种组件的 Props 直接声明以下五个字段,不存在需要嵌套的公共 Props 包装器。

字段用途、默认与限制示例
Key string默认空,以同父级的类型/位置匹配;非空时用稳定且同级唯一业务键。跨父级不保留身份。状态与身份
Style Style零值选默认;局部尺寸、间距和绘制属性。样式
Token ComponentToken默认组件主题项;显式值选另一个已定义主题项。主题
States StateStyles给真实状态提供绘制补丁;不产生状态,不修改布局。状态覆盖
Pointer PointerBehaviorPointerAuto 默认;PointerNone 排除整个子树的指针参与。不是通用 Disabled。布局命中

所有构造函数返回不可变 View,不返回可变控件对象。View.WithKey(string)View.WithStyle(Style) 返回独立描述;后者替换完整 Style。零 View 作为根或子项是错误,空 Box 则有效。

事件在 UI 线程执行;nil 回调允许存在,其交互含义由组件决定,不能直接推导为 Disabled。悬停、焦点、按压、编辑组合、弹层活动和非受控滚动由运行时拥有。业务值如 Value/Checked/Open 由应用拥有。具体矩阵与示例

结构体、枚举和函数的完整声明见组件 API;共有 Style 和主题结构见样式声明