# tao-ui > React 18.2 and 19 components with machine-readable metadata, semantic DOM contracts, and predictable theming. ## 指南 - [快速开始](https://rickyshin93.github.io/tao-ui/zh/guide/getting-started.md): 在 React 18.2 或 React 19 中安装 tao-ui、接入 TaoProvider,并渲染首个继承主题配置的无障碍组件。 - [与 AI Agent 协作](https://rickyshin93.github.io/tao-ui/zh/guide/agents.md): 通过 JSON、Markdown 和浏览器工具查找 tao-ui 组件导入路径、语义 DOM 契约、完整 API 表及可运行示例。 - [更新日志](https://rickyshin93.github.io/tao-ui/zh/guide/changelog.md): 查看 @rockshin/tao-ui 各版本的更新,包括上传、选择、表单和弹层修复。 ## 组件 - [BorderBeam](https://rickyshin93.github.io/tao-ui/zh/components/border-beam.md): 用沿边框移动的光束突出活动中的区域。 - [Button 按钮](https://rickyshin93.github.io/tao-ui/zh/components/button.md): 触发提交、保存、打开界面等即时操作。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [图标](https://rickyshin93.github.io/tao-ui/zh/components/icons.md): 浏览 tao-icons 图标,按名称或分类搜索并复制 React 导入语句。 - [FloatButton](https://rickyshin93.github.io/tao-ui/zh/components/float-button.md): 提供持续可见的悬浮操作与返回顶部控件。 - [Watermark](https://rickyshin93.github.io/tao-ui/zh/components/watermark.md): 在内容与继承的弹层上重复绘制文字或图片水印。 - [Divider](https://rickyshin93.github.io/tao-ui/zh/components/divider.md): 将内容分为清晰的区块或行内分组。 - [FormLayout](https://rickyshin93.github.io/tao-ui/zh/components/form-layout.md): 为产品级表单提供一致的宽度、区段与操作布局。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Splitter](https://rickyshin93.github.io/tao-ui/zh/components/splitter.md): 通过可拖动分隔条调整相邻面板尺寸。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Stack](https://rickyshin93.github.io/tao-ui/zh/components/stack.md): 以一致间距在行或列中排列子元素。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Affix](https://rickyshin93.github.io/tao-ui/zh/components/affix.md): 在内容越过滚动容器边界时将其固定。 - [Breadcrumb](https://rickyshin93.github.io/tao-ui/zh/components/breadcrumb.md): 展示用户当前所处的页面或视图层级。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [ContextMenu](https://rickyshin93.github.io/tao-ui/zh/components/context-menu.md): 通过右键或长按为对象提供上下文操作菜单。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Dropdown](https://rickyshin93.github.io/tao-ui/zh/components/dropdown.md): 从触发器打开一组相关操作或选项。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Pagination](https://rickyshin93.github.io/tao-ui/zh/components/pagination.md): 在较大数据集合的分页之间导航。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Steps](https://rickyshin93.github.io/tao-ui/zh/components/steps.md): 引导用户按顺序完成多阶段任务的步骤条。页面涵盖适用场景、设计建议、各类型与变体的可运行示例、交互状态与完整 API 参考。 - [Tabs](https://rickyshin93.github.io/tao-ui/zh/components/tabs.md): 在同一上下文中切换多个同级内容面板。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [AutoComplete](https://rickyshin93.github.io/tao-ui/zh/components/auto-complete.md): 为可自由输入的文本提供建议项、分组、键盘补全与自定义输入框。 - [Cascader](https://rickyshin93.github.io/tao-ui/zh/components/cascader.md): 从层级选项中选择路径,支持搜索、独立面板和需要确认多选结果的移动端抽屉。 - [Checkbox](https://rickyshin93.github.io/tao-ui/zh/components/checkbox.md): 选择一个或多个相互独立的布尔选项。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [ColorPicker](https://rickyshin93.github.io/tao-ui/zh/components/color-picker.md): 选择单色或渐变色,提供精度保留的颜色对象、预设与格式转换。 - [DatePicker](https://rickyshin93.github.io/tao-ui/zh/components/date-picker.md): 输入或选择单个日期,并可选择时间。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Form](https://rickyshin93.github.io/tao-ui/zh/components/form.md): 管理表单值、校验规则、提交状态与字段布局。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [FormActions](https://rickyshin93.github.io/tao-ui/zh/components/form-actions.md): 统一排列表单中的提交、取消与次要操作。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [FormField](https://rickyshin93.github.io/tao-ui/zh/components/form-field.md): 组合标签、输入控件、说明、必填标记与错误信息。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [FormSection](https://rickyshin93.github.io/tao-ui/zh/components/form-section.md): 使用标题和说明组织一组相关表单字段。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Input](https://rickyshin93.github.io/tao-ui/zh/components/input.md): Input 输入家族支持清空、计数、密码显隐、搜索、多行输入和验证码,提供双语示例、键盘交互与完整 API 说明。 - [InputNumber](https://rickyshin93.github.io/tao-ui/zh/components/input-number.md): 输入并格式化货币、百分比及其他数值。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Mentions](https://rickyshin93.github.io/tao-ui/zh/components/mentions.md): 在文本域中通过前缀触发建议,支持键盘插入、异步选项与自动高度。 - [Radio](https://rickyshin93.github.io/tao-ui/zh/components/radio.md): 从一组互斥选项中选择一个值。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [RangePicker](https://rickyshin93.github.io/tao-ui/zh/components/range-picker.md): 选择开始与结束日期,支持时间和快捷预设,并提供受控值、清空和本地化示例。 - [Rate](https://rickyshin93.github.io/tao-ui/zh/components/rate.md): 支持整星和半星选择的评分组件。 - [Segmented](https://rickyshin93.github.io/tao-ui/zh/components/segmented.md): 从紧凑选项中选择单个视图或模式。 - [Select 选择器](https://rickyshin93.github.io/tao-ui/zh/components/select.md): 长选项完整换行、单选、多选、标签输入、自动分词、自定义搜索、分组联动、异步加载、渲染定制、弹层控制、移动抽屉与表单提交,附可运行示例和完整 API。 - [Slider](https://rickyshin93.github.io/tao-ui/zh/components/slider.md): 使用指针或键盘选择数值或范围。 - [Switch](https://rickyshin93.github.io/tao-ui/zh/components/switch.md): 立即切换一个布尔设置,并展示当前开关状态。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Textarea](https://rickyshin93.github.io/tao-ui/zh/components/textarea.md): 多行输入框支持自动高度、清空、自定义计数与回车事件,并兼容 Input.TextArea 用法。 - [TimePicker](https://rickyshin93.github.io/tao-ui/zh/components/time-picker.md): 选择时间或时间范围,支持步长、不可选时段、格式和确认流程。 - [Transfer](https://rickyshin93.github.io/tao-ui/zh/components/transfer.md): 在可选列表和已选列表之间移动记录。 - [TreeSelect](https://rickyshin93.github.io/tao-ui/zh/components/tree-select.md): 从层级选项中选择值,支持搜索、多选与父子联动勾选。 - [Upload](https://rickyshin93.github.io/tao-ui/zh/components/upload.md): 选择并管理文件,连接上传接口,在受控文件列表中处理进度、失败和取消。 - [Avatar](https://rickyshin93.github.io/tao-ui/zh/components/avatar.md): 使用图片、文字或图标标识用户与实体。 - [Badge](https://rickyshin93.github.io/tao-ui/zh/components/badge.md): 展示计数、紧凑状态标记与缎带。 - [Calendar](https://rickyshin93.github.io/tao-ui/zh/components/calendar.md): 展示月份或年份,支持日程单元格、自定义页头与可选范围。 - [Card](https://rickyshin93.github.io/tao-ui/zh/components/card.md): 将相关内容、操作和标签视图组合在同一容器内。 - [Carousel](https://rickyshin93.github.io/tao-ui/zh/components/carousel.md): 提供原生箭头与指示点、自动播放、淡入淡出、响应式布局及 ref 控制的轮播。 - [Collapse](https://rickyshin93.github.io/tao-ui/zh/components/collapse.md): 折叠面板,内置标题、展开图标与内容区域;支持独立展开和手风琴。 - [Descriptions](https://rickyshin93.github.io/tao-ui/zh/components/descriptions.md): 以结构化详情展示带标签的字段。 - [Empty](https://rickyshin93.github.io/tao-ui/zh/components/empty.md): 说明集合为空的原因,并提供下一步操作。 - [Image](https://rickyshin93.github.io/tao-ui/zh/components/image.md): 支持全屏预览、图片组切换、缩放旋转、失败回退与进度占位的图片组件。 - [List](https://rickyshin93.github.io/tao-ui/zh/components/list.md): 展示重复记录,支持元信息、操作、分页和响应式网格。 - [Listy](https://rickyshin93.github.io/tao-ui/zh/components/listy.md): 展示可滚动条目,支持分组和可选的虚拟渲染。 - [Masonry](https://rickyshin93.github.io/tao-ui/zh/components/masonry.md): 将不同高度的卡片放入均衡的列中。 - [Popover](https://rickyshin93.github.io/tao-ui/zh/components/popover.md): 在触发器附近展示补充信息或轻量交互内容。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [QRCode](https://rickyshin93.github.io/tao-ui/zh/components/qr-code.md): 生成可扫描的 Canvas 或 SVG 二维码,支持图标、状态和刷新。 - [ScrollArea](https://rickyshin93.github.io/tao-ui/zh/components/scroll-area.md): 为受限区域提供跨浏览器一致的滚动条与阴影提示。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Statistic](https://rickyshin93.github.io/tao-ui/zh/components/statistic.md): 突出展示数值、格式化指标与计时。 - [Table](https://rickyshin93.github.io/tao-ui/zh/components/table.md): 展示结构化数据,支持排序、筛选、分页、响应式列和受控行选择。 - [Tag](https://rickyshin93.github.io/tao-ui/zh/components/tag.md): 使用紧凑标签展示类别、状态或可选择筛选条件。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Timeline](https://rickyshin93.github.io/tao-ui/zh/components/timeline.md): 沿垂直或水平轨道展示事件与里程碑。 - [Tooltip](https://rickyshin93.github.io/tao-ui/zh/components/tooltip.md): 在悬停或键盘聚焦时展示简短补充说明。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Tree](https://rickyshin93.github.io/tao-ui/zh/components/tree.md): 通过层级展开、勾选、异步子节点、拖拽和虚拟滚动浏览树形数据。 - [Alert](https://rickyshin93.github.io/tao-ui/zh/components/alert.md): 用于展示带有明确语义状态的重要上下文反馈信息。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Drawer](https://rickyshin93.github.io/tao-ui/zh/components/drawer.md): 在不离开当前页面的情况下打开侧边任务面板。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Modal](https://rickyshin93.github.io/tao-ui/zh/components/modal.md): 在受保护的焦点上下文中展示需要用户处理的对话框。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Popconfirm](https://rickyshin93.github.io/tao-ui/zh/components/popconfirm.md): 在触发器附近确认一个简短且有风险的操作。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Progress](https://rickyshin93.github.io/tao-ui/zh/components/progress.md): 使用进度条、圆环或仪表盘弧线展示可量化进度。 - [Result](https://rickyshin93.github.io/tao-ui/zh/components/result.md): 展示操作结果,并提供继续或恢复操作。 - [Skeleton](https://rickyshin93.github.io/tao-ui/zh/components/skeleton.md): 在数据加载时保留内容结构。 - [Sonner](https://rickyshin93.github.io/tao-ui/zh/components/sonner.md): 通过命令式 API 展示短暂 toast 通知、异步状态与操作反馈。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Spinner](https://rickyshin93.github.io/tao-ui/zh/components/spinner.md): 展示局部、内容覆盖或全屏加载状态。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Tour](https://rickyshin93.github.io/tao-ui/zh/components/tour.md): 通过目标定位、聚光遮罩、自定义操作和键盘导航组织分步引导。 - [HeadlessInputNumber](https://rickyshin93.github.io/tao-ui/zh/components/headless-input-number.md): 提供数值输入的解析、格式化与约束逻辑,不绑定产品视觉。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [App](https://rickyshin93.github.io/tao-ui/zh/components/app.md): 提供继承应用上下文的 message、notification 和 modal 实例。 - [TaoProvider](https://rickyshin93.github.io/tao-ui/zh/components/tao-provider.md): 为组件树提供主题 seed、组件 token、尺寸、密度与禁用状态。页面涵盖适用场景、设计建议、多组可运行示例、交互状态与完整 API 参考。 - [Util](https://rickyshin93.github.io/tao-ui/zh/components/util.md): 从组件与公开属性推导 TypeScript 类型,不需要运行时工具。 ## 示例 - [运营后台示例](https://rickyshin93.github.io/tao-ui/zh/showcase/commerce.md): 体验基于 tao-ui 和 tao-icons 构建的完整运营后台。 - [示例](https://rickyshin93.github.io/tao-ui/zh/showcase.md): 探索使用 tao-ui 与 tao-icons 构建的可交互产品示例。 ## Package contracts - [Agent discovery index](https://rickyshin93.github.io/tao-ui/agent-manifest.json): @rockshin/tao-ui 0.0.57, imports and bilingual documentation URLs. - [Component metadata](https://rickyshin93.github.io/tao-ui/component-manifest.json): semantic parts, usage guidance and selected props.