跳至内容

组合

组合公开组件部件,同时保留原生上下文、属性与焦点行为。

复合组件

使用同一组件系列导出的根部和部件。例如,对话框通过 Modal.Root 连接触发器、背景与内容。UI SDK 管理原生顶层,无需 Portal 部件:

import { Modal } from "@lenso/ui";

export function Example() {
  return (
    <Modal.Root>
      <Modal.Trigger>打开对话框</Modal.Trigger>
      <Modal.Backdrop />
      <Modal.Content>
        <Modal.Title>账户设置</Modal.Title>
        <Modal.Description>管理账户偏好。</Modal.Description>
        <Modal.Close>关闭</Modal.Close>
      </Modal.Content>
    </Modal.Root>
  );
}

根部协调展开状态与焦点恢复,标题和描述为弹出内容提供标签。调整内容布局时应保留这些关系。

交互边界

UI SDK 管理普通原生控件、导航和覆盖层。Lenso 使用组件专属 StyleX 映射组合具体原生部件,不通过通用兼容包装将所有系列转换成另一套 API。

ListBox 使用原生 UI SDK 的标量或数组值及选择回调。TagGroup 和 Table 保留 Lenso 独立的集合模型:稳定 key、Set 选择、项目注册和集合焦点管理。它们不是 React Aria 集合包装。应阅读各系列签名,不假设这些集合契约可以互换。

日期、时间和颜色系列保留国际化值模型,并组合原生 UI SDK 控件。日期分段、日历网格或颜色输入区域不能仅因外观相似就放入不相关的 UI SDK 字段。

原生 HTML 管理非交互结构。卡片、文本表面和布局区域不会仅因添加样式就获得键盘行为。

公开契约

React 公开导出决定组件系列清单。原生属性、ref、状态属性、render 组合与回调签名保持可观察。本地变体添加展示样式,不创建 onPress 适配器,也不把所有值统一成 DOM 事件。

复合系列应组合属于同一上下文的部件。生成 API 标明实际导出与声明来源;导入的历史片段不是可执行契约证据。

样式交付

@lenso/tokens 提供主题和可供编译器读取的 StyleX 声明。官方 StyleX 集成统一编译库与应用的声明。每个渲染文档都应导入主题 CSS;编译工具不会进入浏览器 JavaScript。

文档投影

公开文档与不可变参考归档分开编写。一个版本化索引结合 authored 指南、当前原生 API 和本地运行示例的位置。渲染、导航、搜索、站点地图、复制 Markdown 和示例验证计划使用同一索引。

参考归档是经过完整性校验的来源输入,不是公开发布历史或迁移指南。移除公开归档页面不能丢弃仍维护的示例场景:这些场景应放在对应 Lenso 组件页面。

证据边界

导出证明可用性,注册本地模块证明存在运行位置。它们都不证明视觉一致性、键盘可访问性或 WCAG 合规。参考颜色存在已知普通文本对比度问题,应如实报告,不宣称认证。