uiUI 组件系统
对比

THE UI COLLECTION v0.1

组件图鉴

73 个组件。直接操作预览,或打开文档复制用法。

开始构建

全部组件

73 个条目

目录视图

输入与选择

把意图变成清晰、可校验的输入。

已执行 0 次,仅本地计数

点击执行,立即显示计数

按钮

Button

把一个可执行动作呈现为明确的点击目标。

交互 设计

最多 5 个标签,每个最多 12 字

Enter 添加,移除后可撤销

标签与多值输入

Tags Input / Token Field

把用户录入的多个值变成可浏览、编辑和移除的独立项。

填写后提交,空值会触发校验

表单与字段

Form / Field

把有结构的用户输入与标签、校验和提交组织起来。

单行文字,可直接编辑

直接编辑字段内容

收集一条简短、连续的文本值。

默认展示方式
每次只选择一项

单选框组

Radio Group

让用户从互斥选项中选择一个值。

可换行,最多 160 字

输入或换行

多行文本

Textarea

让用户输入需要换行的较长文本。

你想先了解哪类组件?

选择并确认

多选与追问

Questionnaire / Clarification

用单选、多选或自由回答补足 Agent 尚不明确的需求。

选择文本样式

可同时选中多个选项

可同时切换多个样式

分段选择与工具切换

Segmented Control / Toggle Group

把少量互斥值或可切换工具并排展示。

包含哪些内容?
勾选或取消多个选项

复选框

Checkbox

在独立选项中选择零个、一个或多个。

本轮可用工具(示例)

启用工具不等于批准每一次执行。

勾选本轮可用工具

工具选择与提及

Tool Picker / Mentions

在发送消息前指定工具或引用一个有身份的对象。

0%100%
拖动滑块或用方向键调整

滑块与范围

Slider / Range Slider

通过位置选择连续或离散范围中的数值。

可以从这些问题开始

点击建议,观察选择结果

建议提示与后续问题

Suggested Prompts / Follow-ups

用可点击的例子帮助用户开始,或接着当前结果继续探索。

点击开关或整行标签

开关

Switch

控制一个立即生效的二元设置。

选择控件,不在此切换真实模型。

选择其他示例模型

模型与思考强度选择

Model / Effort Selector

让用户选择本次任务使用的模型或推理强度。

这份说明有多清楚?
选择分值

评分输入

Rating / Rating Group

把有限评分尺度呈现为可读、可选择的值。

2026 年 11 月
一二三四五六日

已选择 2026-11-02

选择日期、切换月份

日历网格

Calendar

把日期按月或日期范围排列,支持就地浏览与选择。

原生日期控件,可键入或打开日历

键入日期或打开原生日历

日期选择器

Date Picker

把日期输入与日历选择放在一个字段交互里。

文件由应用通过事件接收,不自动上传。

选择真实本地文件,仅显示名称

上传与附件

Upload / File Picker

选择文件,并清楚呈现传输进度和失败恢复。

范围 1–20,可键入或使用原生步进器

键入数字或用上下方向键调整

数字输入

Number Input / Spinbutton

让数值以可验证的格式输入,并可按步长增减。

仅本地演示

输入内容后发送

提示输入

Prompt Input / Composer

把文本、附件和发送动作放在一个明确的输入区域。

打开选项,选择其他生态

从固定的选项集合中选择一个或多个值。

打开原生颜色面板

颜色选择

Color Picker

同时支持色彩空间选择和可表达的颜色值。

原生 datalist,允许自由输入

输入文字或选择浏览器建议

组合输入与自动补全

Combobox / Autocomplete

把可编辑文本和建议列表放在同一交互中。

导航与查找

找到页面、对象和下一步操作。

先观察组件怎样回应用户。
点击标签或用左右方向键切换

在同一上下文中切换互斥的内容面板。

示例条目 1–3

第 1 页,共 2 页

点击页码翻页

分页

Pagination

把可定位的数据集合分成明确的页。

目录:输入组件、导航组件
内容:保留两侧上下文

拖动或使用左右方向键调整

拖动分隔条,或聚焦后按方向键

可调分栏

Splitter / Resizable Panels

允许用户调节相邻工作区域的空间分配。

今天

  • 刚刚
  • 09:30
  • 昨天

搜索、复制、重命名、删除后撤销

历史与搜索

Thread History / Search

让用户找回过去的会话,并知道当前处在哪个上下文。

输入关键词,再选择结果

命令入口

Command Palette / Menu

通过搜索快速找到功能、对象或操作。

右键、Shift+F10 或点击打开操作菜单

点击、右键或 Shift+F10 打开

上下文菜单

Context Menu

为某个对象显示就地相关的操作。

什么时候使用?

让用户按需展开次要信息。

什么时候避免?

重要结论不应只藏在折叠项里。

展开或折叠说明

折叠面板

Accordion

把可展开的相关内容组织成一列标题。

数据与结果

浏览结构化信息和可回看的产物。

组件选型笔记草稿

让用户理解下一步

先呈现计划,再显示每一步的结果。

下载示例笔记
下载当前示例文件

产物预览

Artifact / Generated Output

把文档、代码或图表作为可独立查看的成果。

example.js
const result = await agent.run({
  task: "让过程可以理解"
});

复制会写入系统剪贴板

代码块

Code Block

让代码与普通文本分离,便于阅读和复制。

已核验
切换状态和计数

徽标与计数

Badge / Status Badge

在对象旁压缩表达状态、类别或未读数量。

可编辑组件状态
Button已核验1.2
Input待核验2.0

方向键移动,双击或 Enter 编辑,Escape 取消。

点击表头排序,双击单元格编辑

在行列中进行排序、筛选、选择或编辑等密集操作。

横向滚动,或聚焦后按方向键

让一组相关内容在有限空间中逐项浏览。

打开详情或切换卡片内容

把一个可独立理解的对象和相关动作组织在一起。

  1. 需求已记录09:00
  2. 资料已核对09:30
  3. 图鉴已整理10:00
追加一个时间节点

时间线与执行记录

Timeline / Activity

按时间保留已经发生的事件和结果。

核对官方来源

状态:已完成(示例)

从明确注册的组件与属性渲染,不执行生成的代码。
从已注册的视图中切换

受限生成式界面

Generative UI / Component Registry

把结构化结果映射成已注册的卡片、图表或表单。

输入与选择
导航与布局
展开分支并选择节点

树形浏览

Tree / Tree View

展示可展开的父子关系,并允许定位节点。

组件状态
组件类型来源
Tool组合模式shadcn/ui
Dialog现成组件MUI
Upload现成组件Ant Design
切换数据集,表格保留原生语义

用行列关系比较结构化数据。

林周+2
添加成员,观察头像组变化

为用户或实体提供快速识别的视觉入口。

切换图形、尺寸与线宽;完整套装见图标页

图标

Icon / Lucide

用统一笔触的矢量符号表达操作、对象与状态。

产品使用趋势

最近六个月的活跃使用

面积图单位:次

左右键浏览数据点,上下键切换系列,Enter 选择。也可展开下方数据表读取全部数据。

图表进入视野后加载,也可以展开数据表。

查看数据表
产品使用趋势(次)
分类工作区
五月128
六月176
七月158
八月240
九月286
十月352
悬停读数、切换图例,或展开原始数据

图表

Chart / Data Visualization

用可交互的图形比较数值、观察趋势,并随时核对原始数据。

窗口中的条目1–9 / 10000
条目 1
条目 2
条目 3
条目 4
条目 5
条目 6
条目 7
条目 8
条目 9

只渲染可见窗口,支持滚动和键盘

滚动查看,方向键也可操作

虚拟列表

Virtualized List

只渲染可见条目,减少长列表的页面节点。

反馈与弹层

理解状态,处理异常,完成确认。

组件详情抽屉

当前页面保留在背景中。这个抽屉只展示本地示例内容。

打开侧栏,再关闭回到原处

抽屉与侧边面板

Drawer / Sheet

从屏幕边缘展开任务或对象详情。

请求没有完成

连接已中断,之前的内容仍然保留。

重试并观察结果

错误、重试与中断

Error / Retry / Stop

说明哪一步失败、哪些结果保留,以及用户可以如何恢复。

示例:草稿已保存

这不是实际保存结果

关闭提示后可再次显示

短暂通知

Toast / Snackbar

在不打断当前任务的情况下提示异步结果。

加载中
切换加载内容的形状

骨架占位

Skeleton

在内容加载时预示将出现的结构。

还没有会话

发起一个问题,第一段对话就从这里开始。

切换无数据和无结果场景

空状态

Empty State

解释为什么没有内容,以及用户可以做什么。

点击打开,点外部或 Esc 关闭

组件语义

描述用户任务,并映射不同实现。

点击打开,点外部关闭

在触发控件附近打开一块补充内容。

离开这份草稿?

当前演示不会修改任何真实内容。

打开后可用 Esc 关闭

模态对话框

Dialog / Modal

在当前页面上完成聚焦任务或查看补充内容。

切换有进度和已完成状态

任务进度

Progress / Progress Bar

表达任务已完成多少,或说明正在推进。

更改已保存在本地

这是一条持续可见的提示。

切换提示语气

提示与反馈

Alert / Status Message

把当前操作相关的重要状态放在用户能看见的位置。

悬停或聚焦按钮,Esc 关闭提示

为已有控件补充简短说明,不承担主要信息。

Agent 与对话

理解回答、执行过程与需要你决定的事。

search_documents已完成
查看执行记录

输入:组件交互规范

结果:找到 3 条示例记录
展开执行记录

工具调用与结果

Tool Call / Tool Result

说明 Agent 调用了什么,以及实际返回了什么。

如何让工具执行更透明?

把执行过程和最终结果分开展示。用户可以随时回看发生了什么。

查看完整对话

会话与线程

Conversation / Thread

把多轮问答组织成可连续阅读的上下文。

  1. 整理需求已完成
  2. 核对官方实现进行中
  3. 呈现组件图鉴未开始
切换任务进度

计划与步骤

Plan / Stepper

把已知步骤和当前进展放在一起,帮助用户建立预期。

组件图鉴帮助你理解每一种交互。

等待开始
开始、停止,再重新生成

流式与生成状态

Streaming / Generation Status

告诉用户系统是在等待、输出,还是已经停止。

  1. 资料研究 Agent已完成
  2. 界面设计 Agent进行中
  3. 实现核验 Agent等待输入
查看各 Agent 状态

任务与多 Agent

Task / Subagent

说明工作分给了谁,哪些已完成,以及返回了什么。

允许导出这份报告?

确认操作后保留你的决定。

等待你的决定

批准或拒绝,再重置重试

审批与人工接管

Approval / Human-in-the-loop

在动作执行前,把决定和后果清晰交给用户。

执行摘要
  1. 确认问题与约束
  2. 核对来源和冲突
  3. 整理可验证的结论

展示摘要,不暴露隐藏推理。

折叠或展开执行摘要

推理摘要与执行轨迹

Reasoning / Thought Chain

展开可公开的推理摘要或执行步骤,解释任务正在如何推进。

过程结束后,结果仍然可以回看。

复制回答,或选择评价

消息操作栏

Message Actions / Action Bar

在单条回答旁提供复制、反馈、重新生成等操作。

用审批组件呈现执行前的授权决定。

切换不同回答版本

消息分支与重新生成

Branch Picker / Regenerate

保留编辑或重新生成后的多个版本,并在分支间切换。

先让信息有层级

消息里也可以有清晰的结构。

  • 正文解释结论
  • 引用支持判断
切换内容结构

消息与富文本

Message / Rich Response

呈现用户输入,以及包含正文和动作的 Assistant 回答。

语音与多模态

声音输入、播放、转写与实时交互。

波形是声音的形状,不是文字转写。

切换输入采样,波形随之变化

波形与音频可视化

Waveform / Audio Visualizer

展示输入音量或音频随时间变化的形状。

不访问麦克风,仅模拟录音状态。

尚未开始

模拟开始、停止,不访问麦克风

录音与语音输入

Audio Recorder / Dictation

捕获麦克风输入,形成音频附件或可编辑的文字草稿。

本地模拟会话

未连接

不会建立网络或音视频连接。
模拟连接与结束,不建立外部连接

实时语音会话

Realtime Voice Session

管理双向语音对话的连接、静音、打断与结束。

合成示例音频

可播放、暂停和调整音量。

实际播放、暂停本地合成音频

音频播放与进度

Audio Player / Scrub Bar

播放已生成或上传的语音,并控制时间与速度。

可编辑的示例转写

我们先核对组件的来源,再比较它们的使用边界。

文本在本地编辑,不进行语音识别。

在文本中编辑转写内容

转录与同步文本

Transcript / Aligned Text

把语音内容变成可读文字,或将文字与播放时间对应。

直接操作预览,或切换状态比较不同效果。示例在本地运行;语音与 Agent 连接使用明确标注的模拟数据。