指南
设计理念
One UI 沿用 TSone 的纯 TypeScript 类组件模型,以清晰的小型组件构建界面。
轻量级运行时
组件库保持零运行时依赖;TSone 作为 peer dependency 提供 Component、VNode 与渲染生命周期。
类组件与组合
每个组件只负责一种 UI 行为,并通过 props、事件和插槽协作。组合优于额外继承,避免为了复用少量视图逻辑增加类层级。
可访问性
- 使用原生 button、input 和语义化 section 元素。
- 将 disabled、required、readonly 与 aria-* 状态映射到 DOM。
- 为键盘用户保留清晰的 focus-visible 焦点样式。
CSS Variables
组件通过 --one-* CSS Variables 接受全局或局部主题覆盖,同时为每个公开 token 保留稳定回退值。