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, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/zh/index.md.
v0.0.57
  • 简体中文
  • 让好想法,长成好界面。

    一套可定制的 React 组件库。从第一个按钮到完整产品,让灵感轻松落地,让界面鲜活起来。

    npm install @rockshin/tao-ui
    576px 断点
    tao-ui.app/trips/new780px桌面

    拖动窗口右边缘或用方向键调整宽度。越过 576px,同一份代码里的 Select 与 DatePicker 换成底部抽屉。

    • OKLCH 种子主题
    • 深色模式穿透浮层
    • 语义 DOM
    • llms.txt 与组件清单
    • 按组件引入
    • React 18.2 / 19
    • 17 种语言与地区格式
    • 紧凑密度
    • TypeScript
    • Select 移动端抽屉
    • DatePicker 移动端抽屉
    • 多选草稿确认
    • 44px 触控目标

    一处配置,整套主题。

    下面每一种颜色都只来自一个 colorPrimary。悬停、按下、浅底与描边由 CSS 原生派生,没有运行时计算;圆角、尺寸与深浅色也通过 TaoProvider 一起调整。

    种子色colorPrimary
    自动轮播 · 点击接管

    拂晓蓝Daybreak Blue

    oklch(0.599 0.219 259)
    • primary
    • hover
    • active
    • bg
    • border
    色卡
    圆角
    6px
    尺寸
    明暗
    Buttonh32 · r6
    Inputprefix
    @
    SelectshowSearch
    Switchon
    Checkbox1 / 2
    Tagcheckable
    设计开发文档
    Slider64
    Segmentedweek
    <TaoProvider size="medium" theme={{ mode: 'light', token: { colorPrimary: 'oklch(0.599 0.219 259)', borderRadius: 6 } }}>

    每个部件,都有名字。

    用类型化的 classNames 与 styles 定制需要的语义部件。同样的名字写进 component-manifest.json 与 llms.txt,人和智能体读的是同一份契约。

    https://.dev
    <Input  prefix="https://"  suffix=".dev"  classNames={{    root: 'field',    prefix: 'field-prefix',    input: 'field-input',    suffix: 'field-suffix',  }}/>

    那些不起眼,却天天用到的细节。

    深色

    深色模式,一路跟到浮层

    在 Provider 上切换 mode;通过 Portal 渲染的下拉、抽屉与日历也继承同一主题。打开下拉看看。

    17 种语言,一处配置

    locale 驱动内置文案、日历与数字格式;嵌套 Provider 只覆盖你给出的键,日期默认格式与 Day.js 全局语言保持不变。

    紧凑

    紧凑密度

    一个开关,控件高度 32→28,内外边距各降一档;纯 CSS 实现,浮层同样透传。

    import { Button } from '@rockshin/tao-ui/button';import { Select } from '@rockshin/tao-ui/select';import { DatePicker } from '@rockshin/tao-ui/date-picker';import { TaoProvider } from '@rockshin/tao-ui/provider';

    按组件引入,样式自动按需

    组件入口只加载对应组件及其依赖的样式,并自动带上公共主题,无需另外引入 CSS;根入口照常可用。

    键盘就能走完全程

    字段、选择器、浮层与选择都带完整 ARIA 语义和可见焦点;打开、浏览、选择、关闭,不必碰鼠标。

    React 18.2 与 19,类型完整

    两个主版本同跑检查;Props、语义部件与 token 全部导出类型,编辑器即文档。

    同一个组件,到手机上换一种手感。

    1. 视口窄于 576px 时,Select 自动换成底部抽屉:搜索、分组一应俱全,点选即提交并收起。不用写第二套代码。

    2. 多选与标签在抽屉里先记草稿,点「完成」才提交,其他方式关闭则取消;旋转屏幕也不丢草稿、搜索和焦点。

    3. DatePicker 同样落到底部抽屉,选择、确认与清空都在拇指范围内,月份与星期标签跟随 locale。

    4. 粗指针设备上,按钮、表单控件、复选框标签与清除按钮的点击区域扩到 44px,Switch 保留紧凑外观但预留热区;鼠标下尺寸不变。

    真实组件,独立 390px 视口 · 可直接操作

    装上,就能开始。

    npm install @rockshin/tao-ui
    React
    最低 18.2,兼容 19
    主题
    OKLCH 种子 · 纯 CSS 派生 · 深色模式
    开始你的第一个界面

    75 个条目,一页看完。

    每一页都有可运行示例、可复制代码与生成的 API 表。