(null);
const [status, setStatus] = useState('Idle');
return (
);
}
export default function Example() {
return (
);
}
```
### 带操作与倒计时的通知
duration 单位为秒。showProgress 展示自动关闭倒计时,默认悬停时暂停。
```tsx preview="iframe-follow"
import { App, Button, Stack } from '@rockshin/tao-ui';
function Actions() {
const { notification } = App.useApp();
return (
notification.info({
title: 'Review needed',
description: 'This notification stays open until dismissed.',
duration: 0,
placement: 'bottomRight',
})
}
>
Persistent notification
);
}
export default function Example() {
return (
);
}
```
### 等待确认结果
确认时结果为 true,取消时为 false。此例只修改本地状态。
```tsx preview="iframe-follow"
import { useState } from 'react';
import { App, Button, Stack } from '@rockshin/tao-ui';
function Actions() {
const { modal } = App.useApp();
const [status, setStatus] = useState('Project is active');
return (
{
const accepted = await modal.confirm({
title: 'Archive this project?',
content: 'You can restore it from archived projects.',
okText: 'Archive',
cancelText: 'Keep project',
});
setStatus(
accepted ? 'Project archived in this demo' : 'Project is active',
);
}}
>
Archive project
);
}
export default function Example() {
return (
);
}
```
### 异步确认与重试
返回 Promise 时操作保持加载状态;拒绝会保留弹窗。此本地模拟第一次失败,第二次成功。
```tsx preview="iframe-follow"
import { App, Button } from '@rockshin/tao-ui';
function Actions() {
const { modal } = App.useApp();
return (
{
let attempts = 0;
const dialog = modal.confirm({
title: 'Save sample changes?',
content:
'The first attempt demonstrates an error. Try again to finish.',
onOk: async () => {
await new Promise((resolve) => window.setTimeout(resolve, 700));
attempts += 1;
if (attempts === 1) {
dialog.update({
content: 'The simulated save failed. Choose OK to retry.',
});
throw new Error('Simulated save failure');
}
},
});
}}
>
Try async confirmation
);
}
export default function Example() {
return (
);
}
```
### 更新与销毁弹窗
返回句柄可更新内容或关闭弹窗。自定义页脚可保留提供的 OkBtn 与 CancelBtn。
```tsx preview="iframe-follow"
import { App, Button, Stack } from '@rockshin/tao-ui';
function Actions() {
const { modal } = App.useApp();
return (
{
const dialog = modal.info({
title: 'Preview version 1',
content: 'Review the current draft.',
footer: (_, { OkBtn }) => (
dialog.update({
title: 'Preview version 2',
content: 'The draft has been updated.',
})
}
>
Update
dialog.destroy()}>
Close
),
});
}}
>
Open editable preview
);
}
export default function Example() {
return (
);
}
```
### 主题、语言与自定义上下文
反馈浮层保留 Provider 主题变量和 React 上下文,语言配置提供默认确认、取消与关闭文字。
```tsx preview="iframe-follow"
import { createContext, useContext } from 'react';
import { App, Button, Stack, TaoProvider, zhCN } from '@rockshin/tao-ui';
const Workspace = createContext('');
function Details() {
return Workspace: {useContext(Workspace)};
}
function Actions() {
const { notification, modal } = App.useApp();
return (
notification.info({
title: 'Workspace context',
description: ,
})
}
>
Show notification
modal.confirm({ title: 'Continue?', content: })
}
>
Show confirmation
);
}
export default function Example() {
return (
);
}
```
### 独立作用域与自定义根节点
两个 App 实例分别管理消息。component 可替换根元素,component={false} 仅省略包装元素。
```tsx preview="iframe-follow"
import { App, Button, Stack } from '@rockshin/tao-ui';
function Actions({ name }: { name: string }) {
const { message } = App.useApp();
return (
message.info({
key: 'status',
content: `${name} workspace ready`,
duration: 0,
})
}
>
Show {name}
message.destroy()}>
Clear {name}
);
}
export default function Example() {
return (
);
}
```
## API
### [#](#app)App
| 属性 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
| className | 节点类名 | `string | undefined` | `-` |
| style | 节点样式 | `CSSProperties | undefined` | `-` |
---
url: https://rickyshin93.github.io/tao-ui/zh/components/tao-provider.md
---
> For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt.
# TaoProvider
配置`@rockshin/tao-ui`
[代码演示](#代码演示)[API](#api)
为组件树提供主题 seed、组件 token、尺寸、密度与禁用状态。
## 何时使用
应用或局部区域需要统一配置 tao-ui 组件时使用 TaoProvider。
**推荐**
- 在应用根部只设置稳定的全局 seed。
- 局部覆盖使用嵌套 Provider。
- Portal 内容应继承同一主题作用域。
**避免**
- 不要在每个组件外重复创建 Provider。
## 代码演示
### 基础用法
```tsx preview
import { Button, Input, Stack, TaoProvider } from '@rockshin/tao-ui';
function TaoProviderExample() {
return (
Inherited button
);
}
export default TaoProviderExample;
```
### 全局尺寸
```tsx preview
import { Button, Input, Stack, TaoProvider } from '@rockshin/tao-ui';
function ProviderSizes() {
return (
{(['small', 'medium', 'large'] as const).map((size) => (
{size} button
))}
);
}
export default ProviderSizes;
```
### 品牌 Token 与组件 Token
```tsx preview
import { Button, Stack, TaoProvider } from '@rockshin/tao-ui';
function ProviderTokens() {
return (
Branded primary
Secondary
);
}
export default ProviderTokens;
```
### 深色模式、紧凑密度与隔离
```tsx preview
import { Button, Input, Stack, TaoProvider } from '@rockshin/tao-ui';
function ProviderModes() {
return (
Compact
Dark mode
);
}
export default ProviderModes;
```
### 全局外观
统一设置表单控件的外观,再按需要局部覆盖。
```tsx preview
import { FormField, Input, Stack, TaoProvider } from '@rockshin/tao-ui';
export default function ProviderGlobalVariant() {
return (
);
}
```
### 品牌色
在同一套组件中切换品牌色,保持状态色与对比关系。
```tsx preview
import {
Button,
Checkbox,
Input,
Select,
Stack,
Switch,
Tag,
TaoProvider,
} from '@rockshin/tao-ui';
import { type CSSProperties } from 'react';
const swatchLabel: CSSProperties = {
fontSize: 12,
color: 'var(--tao-color-text-tertiary)',
minWidth: 72,
fontFamily: 'var(--tao-font-family-code)',
};
function ControlRow({
label,
selectOptions = [
{ value: '1', label: 'Option 1' },
{ value: '2', label: 'Option 2' },
],
}: {
label: string;
selectOptions?: { value: string; label: string }[];
}) {
return (
{label}
Primary
Secondary
Check
Tag
);
}
const BRAND_PALETTES = [
{ name: 'Default (Anthropic-neutral)', color: 'oklch(0.205 0.01 70)' },
{ name: 'Vercel Black', color: 'oklch(0.145 0 0)' },
{ name: 'Linear Indigo', color: 'oklch(0.52 0.19 275)' },
{ name: 'Stripe Purple', color: 'oklch(0.55 0.22 300)' },
{ name: 'Supabase Green', color: 'oklch(0.62 0.17 155)' },
{ name: 'Notion Orange', color: 'oklch(0.68 0.17 45)' },
];
export default function ProviderBrandColors() {
return (
{BRAND_PALETTES.map((p) => (
{p.name}
))}
);
}
```
### 语义颜色
分别配置成功、警告、错误等语义颜色,避免复用同一种颜色表达所有状态。
```tsx preview
import {
Button,
FormField,
Input,
Stack,
Tag,
TaoProvider,
} from '@rockshin/tao-ui';
import { type CSSProperties } from 'react';
const swatchLabel: CSSProperties = {
fontSize: 12,
color: 'var(--tao-color-text-tertiary)',
minWidth: 72,
fontFamily: 'var(--tao-font-family-code)',
};
export default function ProviderSemanticColors() {
return (
success
Deployed
Passed
Ready
warning
Degraded
Preview
Draft
error
Failed
Blocked
Broken
Delete
);
}
```
### 圆角尺度
根圆角会派生不同尺寸的圆角,比较整组控件的变化。
```tsx preview
import {
Button,
Checkbox,
Input,
Select,
Stack,
Switch,
Tag,
TaoProvider,
} from '@rockshin/tao-ui';
import { type CSSProperties } from 'react';
const swatchLabel: CSSProperties = {
fontSize: 12,
color: 'var(--tao-color-text-tertiary)',
minWidth: 72,
fontFamily: 'var(--tao-font-family-code)',
};
function ControlRow({
label,
selectOptions = [
{ value: '1', label: 'Option 1' },
{ value: '2', label: 'Option 2' },
],
}: {
label: string;
selectOptions?: { value: string; label: string }[];
}) {
return (
{label}
Primary
Secondary
Check
Tag
);
}
const RADIUS_STEPS = [
{ name: 'sharp', value: 2 },
{ name: 'default (10)', value: 10 },
{ name: 'rounded', value: 16 },
{ name: 'pill-ish', value: 24 },
];
export default function ProviderRadiusScale() {
return (
{RADIUS_STEPS.map((r) => (
{r.name} · {r.value}px
))}
);
}
```
### 嵌套与隔离
嵌套 Provider 可继承或重置主题,局部配置不会影响外层。
```tsx preview
import {
Button,
Checkbox,
Input,
Select,
Stack,
Switch,
Tag,
TaoProvider,
} from '@rockshin/tao-ui';
import { type CSSProperties } from 'react';
const swatchLabel: CSSProperties = {
fontSize: 12,
color: 'var(--tao-color-text-tertiary)',
minWidth: 72,
fontFamily: 'var(--tao-font-family-code)',
};
function ControlRow({
label,
selectOptions = [
{ value: '1', label: 'Option 1' },
{ value: '2', label: 'Option 2' },
],
}: {
label: string;
selectOptions?: { value: string; label: string }[];
}) {
return (
{label}
Primary
Secondary
Check
Tag
);
}
export default function ProviderNestedIsolation() {
return (
outer · purple / large
inner · orange, size inherited (large)
{/* only size, no token override: color stays purple, size collapses to small */}
inner · color inherited (purple), size=small
);
}
```
### 弹层主题继承
打开下拉弹层,确认通过 Portal 渲染的内容仍使用所属 Provider 的主题。
```tsx preview
import { FormField, Select, Stack, TaoProvider } from '@rockshin/tao-ui';
import { type CSSProperties } from 'react';
const swatchLabel: CSSProperties = {
fontSize: 12,
color: 'var(--tao-color-text-tertiary)',
minWidth: 72,
fontFamily: 'var(--tao-font-family-code)',
};
export default function ProviderPortalTheming() {
return (
Select popup portals to body but still reads the closest TaoProvider —
both dropdowns below should match their parent primary.
);
}
```
### 动态切换主题
通过状态切换主题参数,真实控件与弹层即时响应。
```tsx preview
import {
Button,
Checkbox,
Input,
Select,
Stack,
Switch,
Tag,
TaoProvider,
} from '@rockshin/tao-ui';
import { type CSSProperties, useState } from 'react';
const swatchLabel: CSSProperties = {
fontSize: 12,
color: 'var(--tao-color-text-tertiary)',
minWidth: 72,
fontFamily: 'var(--tao-font-family-code)',
};
function ControlRow({
label,
selectOptions = [
{ value: '1', label: 'Option 1' },
{ value: '2', label: 'Option 2' },
],
}: {
label: string;
selectOptions?: { value: string; label: string }[];
}) {
return (
{label}
Primary
Secondary
Check
Tag
);
}
const BRAND_PALETTES = [
{ name: 'Default (Anthropic-neutral)', color: 'oklch(0.205 0.01 70)' },
{ name: 'Vercel Black', color: 'oklch(0.145 0 0)' },
{ name: 'Linear Indigo', color: 'oklch(0.52 0.19 275)' },
{ name: 'Stripe Purple', color: 'oklch(0.55 0.22 300)' },
{ name: 'Supabase Green', color: 'oklch(0.62 0.17 155)' },
{ name: 'Notion Orange', color: 'oklch(0.68 0.17 45)' },
];
export default function ProviderDynamicSwitching() {
function Demo() {
const [idx, setIdx] = useState(0);
const current = BRAND_PALETTES[idx];
return (
{BRAND_PALETTES.map((p, i) => (
setIdx(i)}
>
{p.name.split(' ')[0]}
))}
active · {current.name}
);
}
return ;
}
```
### 布局透明
Provider 不额外改变布局结构,组件仍按父容器的布局规则排列。
```tsx preview
import { Button, Stack, TaoProvider } from '@rockshin/tao-ui';
import { type CSSProperties } from 'react';
const swatchLabel: CSSProperties = {
fontSize: 12,
color: 'var(--tao-color-text-tertiary)',
minWidth: 72,
fontFamily: 'var(--tao-font-family-code)',
};
export default function ProviderLayoutTransparent() {
return (
Children of a single TaoProvider must land in separate grid columns. If
the wrapper collapsed layout, both cards would stack in column 1.
Main
col 2 · 1fr — buttons below should feel indigo
Primary
Secondary
);
}
```
### 组件级 Token
只覆盖目标组件的 Token,其他组件继续使用全局主题。
```tsx preview
import { Button, Stack, TaoProvider } from '@rockshin/tao-ui';
export default function ProviderComponentTokens() {
return (
theme.components.Button — pill radius + custom padding/font weight
Pill Primary
Pill Secondary
);
}
```
### 紧凑密度
紧凑模式调整间距与控件密度,字体保持主题定义的字号。
```tsx preview
import { Button, Input, Stack, TaoProvider } from '@rockshin/tao-ui';
export default function ProviderCompactDensity() {
return (
theme.compact: control height 32→28, paddings one notch tighter
Default
Button
Compact
Button
);
}
```
### 从右到左布局
通过 TaoProvider 的 `direction="rtl"` 或外围 HTML 元素的 `dir="rtl"` 设置方向。组件继承局部方向,弹层挂载到 Portal 后仍沿用触发区域的方向。组件显式 `direction` 或嵌套 Provider 可以覆盖继承值;Carousel 使用已有的 `rtl` 属性。语言与方向独立设置,`bottomLeft` 等显式弹层位置仍表示物理左侧。
```tsx preview
import { Select, Stack, TaoProvider } from '@rockshin/tao-ui';
export default function DirectionExample() {
return (
);
}
```
### 17 种语言与地区格式
切换语言可更新组件默认文案、日期与数字格式。日期默认仍使用原有 ISO 格式;此例用 `format="L"` 显式选择地区格式。数字输入回调始终返回规范 ASCII 十进制字符串。调用方提供的业务标签由应用自行翻译。
```tsx preview
import { useState } from 'react';
import dayjs from 'dayjs';
import {
DatePicker, Empty, InputNumber, Pagination, Select, Stack, Statistic, TaoProvider, Upload,
enUS, zhCN, zhTW, jaJP, koKR, frFR, deDE, esES, itIT, ptBR, ruRU, arEG, hiIN, trTR, idID, thTH, viVN,
} from '@rockshin/tao-ui';
const languages = [
{ value: 'enUS', label: 'English', locale: enUS },
{ value: 'zhCN', label: '简体中文', locale: zhCN },
{ value: 'zhTW', label: '繁體中文', locale: zhTW },
{ value: 'jaJP', label: '日本語', locale: jaJP },
{ value: 'koKR', label: '한국어', locale: koKR },
{ value: 'frFR', label: 'Français', locale: frFR },
{ value: 'deDE', label: 'Deutsch', locale: deDE },
{ value: 'esES', label: 'Español', locale: esES },
{ value: 'itIT', label: 'Italiano', locale: itIT },
{ value: 'ptBR', label: 'Português (Brasil)', locale: ptBR },
{ value: 'ruRU', label: 'Русский', locale: ruRU },
{ value: 'arEG', label: 'العربية', locale: arEG },
{ value: 'hiIN', label: 'हिन्दी', locale: hiIN },
{ value: 'trTR', label: 'Türkçe', locale: trTR },
{ value: 'idID', label: 'Bahasa Indonesia', locale: idID },
{ value: 'thTH', label: 'ไทย', locale: thTH },
{ value: 'viVN', label: 'Tiếng Việt', locale: viVN },
];
export default function LocaleExample() {
const [language, setLanguage] = useState('frFR');
const selected = languages.find((item) => item.value === language)!;
return (
);
}
```
## API
### [#](#usetaointernalconfig)useTaoInternalConfig
**Internal component access for token propagation through third-party portals.**
| 属性 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
### [#](#usetaodirection)useTaoDirection
**Resolve DOM inheritance at a component's source, before it creates portals.**
| 属性 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
### [#](#usetaotoken)useTaoToken
**antd `theme.useToken` counterpart, zero-runtime edition: returns every
design token as a `var(--tao-*)` reference string, so custom components can
stay visually consistent with tao-ui and still resolve in the browser
against the live theme (dark mode, seed overrides, compact density):
````
const { token } = useTaoToken();
```**
|属性|说明|类型|默认值|
|:---:|:---:|:---:|:---:|
### TaoPortalScope
**Re-establishes the theme token scope inside a portal. Floating components
portal their popup to document.body, escaping the `[data-tao-provider]`
element that carries custom token overrides; wrapping the portal content in
this component re-applies those overrides so colors/sizes stay consistent.
With `asChild`, merges the tokens onto the immediate child (via Radix Slot)
instead of adding a wrapper div. Prefer `asChild` inside portals whose Radix
primitive does NOT Presence-gate its Portal (notably `@radix-ui/react-select`
— see `SelectPortal` in `node_modules/@radix-ui/react-select`): the wrapper
div would otherwise render even while the popup is closed, leaving a ghost
`` in the body for every mounted-but-closed Select.**
|属性|说明|类型|默认值|
|:---:|:---:|:---:|:---:|
|style|节点样式|`CSSProperties \| undefined`|`-`|
### TaoProvider
|属性|说明|类型|默认值|
|:---:|:---:|:---:|:---:|
|direction|Text and interaction direction. Defaults to the surrounding DOM direction.|`TaoDirection \| undefined`|`-`|
|locale|Component text and regional settings; omitted keys inherit from the parent.|`Partial \| undefined`|`-`|
|disabled|是否禁用|`boolean \| undefined`|`-`|
### BuiltinTaoLocale
**Complete dictionaries shipped by tao-ui; custom TaoLocale values stay compatible.**
|属性|说明|类型|默认值|
|:---:|:---:|:---:|:---:|
### TaoLocale
**Built-in Select and date-picker text. Arrays use calendar order (Monday first).**
|属性|说明|类型|默认值|
|:---:|:---:|:---:|:---:|
````
---
url: https://rickyshin93.github.io/tao-ui/zh/components/util.md
---
> For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt.
# Util
配置`@rockshin/tao-ui`
从组件与公开属性推导 TypeScript 类型,不需要运行时工具。
## GetProps
获取组件的 props 类型,也支持 Context 值与普通属性对象。
```tsx preview
import { Button, type GetProps } from '@rockshin/tao-ui';
const props: GetProps = {
variant: 'secondary',
children: 'Typed button',
};
export default function Demo() {
return ;
}
```
## GetProp
获取某个非空属性的类型;第三个参数 Return 可提取函数属性的返回值。
```tsx preview
import { Select, type GetProp } from '@rockshin/tao-ui';
const options: GetProp = [
{ value: 'design', label: 'Design' },
{ value: 'engineering', label: 'Engineering' },
];
export default function Demo() {
return ;
}
```
```tsx
import type { GetProp } from '@rockshin/tao-ui';
type SearchProps = { onSearch?: (query: string) => Promise };
type SearchResult = GetProp; // Promise
```
## GetRef
推导组件 ref 指向的公开实例,直接用于 useRef。
```tsx preview
import { Input, Button, Stack, type GetRef } from '@rockshin/tao-ui';
import { useRef } from 'react';
export default function Demo() {
const input = useRef>(null);
return (
input.current?.focus()}>Focus input
);
}
```
## 按需导入
```tsx
import type { GetProps, GetProp, GetRef } from '@rockshin/tao-ui/util';
```
这些导出只存在于类型系统,不会增加浏览器运行时代码。
---
url: https://rickyshin93.github.io/tao-ui/zh/showcase/commerce.md
---
> For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt.
[← 返回示例](/tao-ui/zh/showcase)[English](/tao-ui/showcase/commerce)
拂晓蓝翠绿洋红朱红活力橙墨
浅色深色
紧凑
青禾商城
概览订单8客户商品财务报表
组织
团队安全设置
本月订单额度
72%
升级套餐
1. 工作台
1.
1. 概览
⌘K
林
2026.11.08 · 经营日报
## 早上好,林知夏
这是今天的经营情况。
双十二大促
-
营收 · 30 天
¥1,588,000
+12.4%较上期
7 天30 天12 个月
10/1010/1510/2010/2510/3011/411/8
订单数3,842+8.1%客单价¥334.35-2.3%退款率1.8%-0.4%
渠道分布
- **官网¥590,898**46%**
- **小程序¥359,677**28%**
- **线下门店¥205,530**16%**
- **分销伙伴¥128,456**10%**
本月目标
**80%**已完成 ¥1.28M / ¥1.6M
公告
**结算周期调整**
自 12 月起改为每周结算一次。
了解更多
**新版商品编辑器上线**
支持分步填写、定时上架和团队 @ 通知。
了解更多
**双十二活动报名开启**
11 月 20 日前提交报名可获得首页推荐位。
了解更多
**结算周期调整**
自 12 月起改为每周结算一次。
了解更多
**新版商品编辑器上线**
支持分步填写、定时上架和团队 @ 通知。
了解更多
- 1
- 2
- 3
日程
2026年
11月
月年
| 一 | 二 | 三 | 四 | 五 | 六 | 日 |
| --- | --- | --- | --- | --- | --- | --- |
| 26 | 27 | 28 | 29 | 30 | 31 | 01 |
| 02 | 03 | 04 | 05 | 06 | 07 | 08 |
| 09 | 10 | 11 | 12 | 13 | 14 | 15 |
| 16 | 17 | 18 | 19 | 20 | 21 | 22 |
| 23 | 24 | 25 | 26 | 27 | 28 | 29 |
| 30 | 01 | 02 | 03 | 04 | 05 | 06 |
动态
1. 16:40
林知夏 下单 ¥1,280
1. 15:53
周屿 发起退款
1. 15:06
陈一禾 留下 5 星评价
1. 14:19
许南星 注册成为会员
1. 13:32
沈默 下单 ¥1,280
1. 12:45
顾清 发起退款
1. 11:58
江晚 留下 5 星评价
1. 11:11
陆远 注册成为会员
---
url: https://rickyshin93.github.io/tao-ui/zh/showcase.md
---
> For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt.
# 用 tao-ui 构建的示例
探索可交互的完整案例,看看组件如何组合成真实产品。
**********
****
****
*¥ 1.28M**3,842**¥ 334**1.8%*
****
运营后台
## 青禾商城
从订单、商品到团队与安全设置,体验完整的电商运营工作台。
[查看示例 ](/tao-ui/zh/showcase/commerce)
## 商城示例使用的组件68
- [Affix](/tao-ui/zh/components/affix)
- [Alert](/tao-ui/zh/components/alert)
- [AutoComplete](/tao-ui/zh/components/auto-complete)
- [Avatar](/tao-ui/zh/components/avatar)
- [Badge](/tao-ui/zh/components/badge)
- [BorderBeam](/tao-ui/zh/components/border-beam)
- [Breadcrumb](/tao-ui/zh/components/breadcrumb)
- [Button](/tao-ui/zh/components/button)
- [Calendar](/tao-ui/zh/components/calendar)
- [Card](/tao-ui/zh/components/card)
- [Carousel](/tao-ui/zh/components/carousel)
- [Cascader](/tao-ui/zh/components/cascader)
- [Checkbox](/tao-ui/zh/components/checkbox)
- [Collapse](/tao-ui/zh/components/collapse)
- [ColorPicker](/tao-ui/zh/components/color-picker)
- [ContextMenu](/tao-ui/zh/components/context-menu)
- [DatePicker](/tao-ui/zh/components/date-picker)
- [Descriptions](/tao-ui/zh/components/descriptions)
- [Divider](/tao-ui/zh/components/divider)
- [Drawer](/tao-ui/zh/components/drawer)
- [Dropdown](/tao-ui/zh/components/dropdown)
- [Empty](/tao-ui/zh/components/empty)
- [FloatButton](/tao-ui/zh/components/float-button)
- [Form](/tao-ui/zh/components/form)
- [FormActions](/tao-ui/zh/components/form-actions)
- [FormField](/tao-ui/zh/components/form-field)
- [FormSection](/tao-ui/zh/components/form-section)
- [Image](/tao-ui/zh/components/image)
- [Input](/tao-ui/zh/components/input)
- [InputNumber](/tao-ui/zh/components/input-number)
- [List](/tao-ui/zh/components/list)
- [Listy](/tao-ui/zh/components/listy)
- [Masonry](/tao-ui/zh/components/masonry)
- [Mentions](/tao-ui/zh/components/mentions)
- [Modal](/tao-ui/zh/components/modal)
- [Popconfirm](/tao-ui/zh/components/popconfirm)
- [Popover](/tao-ui/zh/components/popover)
- [Progress](/tao-ui/zh/components/progress)
- [QRCode](/tao-ui/zh/components/qr-code)
- [Radio](/tao-ui/zh/components/radio)
- [RangePicker](/tao-ui/zh/components/range-picker)
- [Rate](/tao-ui/zh/components/rate)
- [Result](/tao-ui/zh/components/result)
- [ScrollArea](/tao-ui/zh/components/scroll-area)
- [Segmented](/tao-ui/zh/components/segmented)
- [Select](/tao-ui/zh/components/select)
- [Skeleton](/tao-ui/zh/components/skeleton)
- [Slider](/tao-ui/zh/components/slider)
- [Sonner](/tao-ui/zh/components/sonner)
- [Spinner](/tao-ui/zh/components/spinner)
- [Splitter](/tao-ui/zh/components/splitter)
- [Statistic](/tao-ui/zh/components/statistic)
- [Steps](/tao-ui/zh/components/steps)
- [Switch](/tao-ui/zh/components/switch)
- [Table](/tao-ui/zh/components/table)
- [Tabs](/tao-ui/zh/components/tabs)
- [Tag](/tao-ui/zh/components/tag)
- [TaoProvider](/tao-ui/zh/components/tao-provider)
- [Textarea](/tao-ui/zh/components/textarea)
- [TimePicker](/tao-ui/zh/components/time-picker)
- [Timeline](/tao-ui/zh/components/timeline)
- [Tooltip](/tao-ui/zh/components/tooltip)
- [Tour](/tao-ui/zh/components/tour)
- [Transfer](/tao-ui/zh/components/transfer)
- [Tree](/tao-ui/zh/components/tree)
- [TreeSelect](/tao-ui/zh/components/tree-select)
- [Upload](/tao-ui/zh/components/upload)
- [Watermark](/tao-ui/zh/components/watermark)
## 商城示例使用的图标62
- Activity
- ArrowLeft
- ArrowRight
- Bell
- ChartColumn
- CheckCheck
- CheckCircle
- ChevronsUpDown
- Clock
- Coins
- Compass
- Copy
- CreditCard
- Download
- Edit
- Eye
- FileText
- FilterClear
- Gift
- Globe
- HelpCircle
- ImagePlus
- Laptop
- Layers
- LayoutDashboard
- LogOut
- Mail
- MapPin
- Megaphone
- MessageCircle
- MessageSquare
- Moon
- MoreHorizontal
- PackageCheck
- Package
- Phone
- Plus
- Printer
- Receipt
- RefreshCw
- Rocket
- RotateCcw
- Save
- Search
- Send
- Settings
- ShieldCheck
- Smartphone
- Sparkles
- Star
- Store
- Sun
- TrendingDown
- TrendingUp
- Trophy
- Truck
- Upload
- UserGroup
- User
- UserPlus
- Users
- Wallet
[浏览全部 2,126 枚图标 →](/tao-ui/zh/components/icons)
---
url: https://rickyshin93.github.io/tao-ui/zh/index.md
---
> For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt.
# tao-ui
让好想法,
长成好界面。
> 一套可定制的 React 组件库。从第一个按钮到完整产品,让灵感轻松落地,让界面鲜活起来。
[快速开始](https://rickyshin93.github.io/tao-ui/zh/guide/getting-started) | [浏览组件](https://rickyshin93.github.io/tao-ui/zh/components/button)
## Package contract
- @rockshin/tao-ui 0.0.57 · MIT
- React: ^18.2.0 || ^19.0.0; React DOM: ^18.2.0 || ^19.0.0
- npm install @rockshin/tao-ui
- [AI Agent 接入指南](https://rickyshin93.github.io/tao-ui/zh/guide/agents.md)
- [JSON discovery](https://rickyshin93.github.io/tao-ui/agent-manifest.json)