Grid 栅格
布局组件
栅格 — Chaos UI 的布局组件,用于组织页面区域结构。
何时使用
需要栅格功能时使用本组件。
代码示例
基础用法
tsx
import { Grid } from "@/components/ui/grid"
export function Basic() {
return <Grid>Default</Grid>
}样式变体
columns
| columns | 说明 | 默认 |
|---|---|---|
1 | ✓ | |
2 | ||
3 | ||
4 | ||
5 | ||
6 | ||
12 |
gap
| gap | 说明 | 默认 |
|---|---|---|
none | ||
xs | ||
sm | ||
md | ✓ | |
lg | ||
xl |
对齐
| align | 说明 | 默认 |
|---|---|---|
start | ||
center | ||
end | ||
stretch | ✓ |
主轴对齐
| justify | 说明 | 默认 |
|---|---|---|
start | ✓ | |
center | ||
end | ||
between | ||
around |
API / Props
Grid
| Prop | Type | Default | 说明 |
|---|---|---|---|
className | string | — | 自定义样式类名 |
| ...rest | React.ComponentProps<"div"> | — | 透传 <div> 原生属性 |
注意事项
- CVA 变体: 通过
class-variance-authority管理样式变体,类型安全。变体对象可导出复用。 - 原生属性: 继承所有
<div>原生 HTML 属性。
📘 完整交互式示例与控件属性请查看 Storybook 文档。