seam-react
v0.13.0
Published
基于 seam-hooks 与 Motion 的 Fluid React 组件库
Maintainers
Readme
seam-react
基于 seam-hooks 的 React 组件库,内置可访问性与主题 token。
安装
包发布在 npm,安装不需要访问令牌:
pnpm add seam-react
# 或
npm install seam-react使用
import {
Button,
Tabs,
Dialog,
Sidebar,
ToastStack,
useToast,
} from "seam-react";
import { SeamStyles } from "seam-react/styles";
export function Root() {
return (
<>
<SeamStyles />
<Button>保存</Button>
</>
);
}组件包含:Button、Input、Form、Switch、Tabs、Dialog、Toast、Tooltip、Sidebar。
- Tabs 支持方向键切换、ARIA 关联与 fluid 指示器。
- Switch 支持点击、键盘和拖拽 spring。
- Dialog 提供 Root / Trigger / Content 与语义化内容层,自带 Motion 进出场、焦点陷阱、Esc 关闭与滚动锁定。
- Toast 提供
useToast状态队列与ToastStack呈现层,支持六向定位、自动关闭、状态图标、操作和拖拽关闭。 - Tooltip 提供延迟显示、键盘与触屏访问、视口翻转/避让,以及可让相邻触发器共享并连续移动表面的 Group / Item 组合。
- Form 提供组合式字段、同步/异步规则、服务端错误和失败聚焦;安装
valibot后可通过seam-react/valibot接入 schema 校验。 - Sidebar 提供可折叠 Group、可配置分组间距,以及互斥的轨道与背景 hover 模式。
完整文档:chenhaojie9527.github.io/ui-kit
License
MIT
