认识 Leaf UI
为什么选择 Leaf UI
安静克制
白与浅灰的表面、细边框和轻阴影构成层次;悬停和按下只改变颜色,不抬起、不回弹。开箱即用,内容始终是主角。
品牌色与明暗外观
通过 ConfigProvider 接入品牌色、明暗外观和紧凑密度,相关状态自动派生,结构保持一致。支持嵌套区域主题,浮层与消息沿用所在区域的配置。
熟悉的 React 用法
提供 TypeScript 类型,保留原生 HTML 属性与 DOM ref。支持受控与非受控用法,表单仍可使用原生提交和 FormData。
日常所需,保持一致
从按钮、输入框到日期选择、表格、导航和反馈,使用一致的尺寸与交互规则。图标采用 Lucide,也支持传入自己的图标节点。
面向不同语言
内置多种语言资源,支持自定义翻译、语言回退与 RTL 方向。组件文案由配置管理,业务标题和字段标签由应用自行翻译。
照顾每一次交互
键盘操作、可见焦点、禁用与加载状态贯穿组件,并响应减少动态效果的系统偏好。为仅含图标的按钮提供 aria-label,即可补充可访问名称。
环境支持
支持 React 18 / 19,提供 ESM / CommonJS 入口与服务端渲染用法。推荐使用现代浏览器当前或上一代稳定版。
Chrome≥ 109
Edge≥ 109
Firefox≥ 121
Safari≥ 16.4
以上为最低支持目标,实际验证范围与降级策略见浏览器兼容性。Next.js、TanStack Start 等框架的接入见服务端渲染。
从一个组件开始
在已有 React 项目中安装:
直接导入组件即可使用,浏览器构建会自动加载所需样式,无需安装 Sass。试着点击下面的按钮:
getting-started.tsx