跳转到内容
Proto UI

搜索

正在加载搜索…
Toggle theme

Base 原型库

无默认样式的基础原型库总览与交互预览。

Base 不规定默认视觉，只提供可测试、可跨宿主迁移的交互语义。下方每张卡片只展示该原型的一个基础 Demo，用于快速了解当前覆盖范围与行为边界；这里不重复 API 文档或代码示例。

当前 catalog 中的 Base 原型仍处于 draft 生命周期，以下是现阶段可交互的官方预览，不代表已冻结的稳定 API 保证。

已发布的 0.2 family inventory

Section titled “已发布的 0.2 family inventory”

稳定版 0.2.0 package 导出了 16 个有意纳入文档的 component families：Button、Toggle、Switch、Tabs、Checkbox、Dialog、Dropdown Menu、Select、Hover Card、Tooltip、Transition、Separator、Scroll Area、Textarea、Live Region 与 Async Region。非组件的 behaviors 和 tools exports 属于 library utilities，不要求 component detail route。

Package exports 与 CLI registry 是相关但不完全相同的 inventory。CLI 把 package 的 dropdown family 称为 base-dropdown；当前 base-tabs facade 没有包含可选 Indicator authoring surface；CLI 也没有 base-scroll-area facade，而是提供完整的 brutalist-scroll-area projection。这些差异会在相应 detail page 中明确说明，而不是被隐藏或误判为缺失 protocol。

对于交互 family，Base 原型应停在可广泛复用的语义边界。以 Dropdown Menu 为例，目前边界是：

  • 浮层开合协作
  • collection 顺序与 item snapshot
  • active item、roving focus、typeahead
  • 收敛的 commit-close 与 open-entry 策略面（closeOnItemCommit / closeOnCommit、openEntry / openEntryValue）

它在这一层不定义持久 selection，不内建 checkbox/radio item 语义，也不预先承诺 submenu anatomy。瞬时的 active 导航状态目前保持为内部实现，不作为 root 的正式公开 API。这些应当由上层原型库通过组合来补，而不是在 base 中先行固化。

select 是当前用来验证另一条边界的探针：它仍然保持 protocol-first，但会把 value 呈现部件明确留在 family 内部。这个部件用于验证 Proto UI 在 value 类组件上的当前路径，也就是“选中值文本由原型自身定义，并通过显式 update 驱动重渲染”，而不是完全把值展示下放给宿主应用。

radio-group 用来验证组级单选所有权，而不是复用 Checkbox 的 item-local toggle 所有权，也不提前声明原生表单行为。Root 保留空值与无法匹配的值；Collection 与 Focus Roving 协作完成 selected-or-first 入口和循环键盘移动；Item 派生 radio 状态；Indicator 只作为视觉后代。

textarea 用来验证 host-mediated native-control 边界：Root 拥有一个 logical multiline editor，renderer 保持 contentless，由 adapter 选择物理宿主目标。当前 Web profile 在 Web Component、React 与 Vue 中使用一个原生 textarea。它维持稳定的受控/非受控所有权，归一化 input/change/IME signal，保留 active editing session，在 composition 结束后恢复未被接纳的受控提案，并投影 property、focus 与 accessibility；它不声明 form submission、rich text、auto-resize、系统 editing chrome 或 live-region 语义。

Draft implementation slices

Section titled “Draft implementation slices”

Base Table 已有 draft passive-structure protocol、host-neutral Table Structure Module、五个 Base identities 与有界的 Web Component ARIA projection 证据。它不属于已发布的 0.2 package inventory、CLI facades 或交互 preview。React、Vue、Vue 2、CLI 与 design-language 工作仍为 planned；当前切片不构成 stable 或 cross-Adapter conformance 声明。

18 个可预览原型 示例将在接近视口时加载
基础 Demo

Toggle

查看详情

拥有持久 active 状态的 button-like control。

基础 Demo

Radio Group

查看详情

组级单选值、roving focus 与派生 Indicator。

基础 Demo

Dropdown Menu

查看详情

集合导航、输入查找与提交关闭。

基础 Demo

Scroll Area

查看详情

Viewport 拥有、由宿主投射的滚动域。