Skip to content

Grid 栅格

24 等分的响应式栅格系统。<c-row> 是行容器,<c-col> 是列;列的 span 之和满 24 即填满一行。

何时使用

  • 需要在多列之间对齐内容。
  • 不同屏幕宽度下要切换列数。

基本使用

gutter 控制列与列的间距(px)。

不等分

不同 span 拼成一行,剩余的列若不足 24 不会拉伸。

偏移与对齐

offset 让列前置留白;justify / align 控制行内对齐方式。

响应式列数

xs / sm / md / lg / xl / xxl 按断点切换列数。

响应式间距

gutter 也支持 [h, v] 二元组或 { xs, sm, md, lg, xl } 对象。

列排序

order 改变列在视觉上的顺序,常用于响应式下"内容前置 / 侧栏后置"。

flex 简写

flex="1" / flex="0 0 200px" 让列脱离 24 栅格,按 flex 行为分配空间。

push / pull 移位

push 把列向右推,pull 把列向左拉。常用「侧栏代码先写 / 视觉右置」之类的反转布局。

嵌套行

Row 可以嵌套:外层切大块,内层在大块里再分。注意嵌套时内 Row 通常也加 gutter,与外层独立。

业务双栏布局

「侧栏 6 / 主内容 18」是后台管理最常见的双栏比例;配合响应式断点,移动端自动堆叠。

关闭换行

wrap="false" 强制 Row 单行展示,超出宽度的列会按 flex 缩压;常用于横向滚动条 / 关键指标条。

响应式对象配置

xs / sm / md / lg / xl / xxl 不仅可以传数字(span 简写),还可以传 { span, offset, order } 完整对象,按断点分别配置。

断点

断点触发宽度(px)
xs0
sm576
md768
lg992
xl1200
xxl1600

API

Row Props

参数类型默认值说明
justify'start' | 'end' | 'center' | 'space-around' | 'space-between' | 'space-evenly''start'水平对齐
align'top' | 'middle' | 'bottom' | 'stretch''top'垂直对齐
gutternumber | [number, number] | Record<Breakpoint, number>0栅格间距
wrapbooleantrue自动换行

Col Props

参数类型默认值说明
spannumber占据的栅格数 0–24
ordernumber排序
offsetnumber左偏移
pushnumber向右推
pullnumber向左拉
flexnumber | stringflex 简写(脱离栅格按 flex 分配)
xs/sm/md/lg/xl/xxlnumber | { span, offset, order, push, pull }响应式配置

Released under the MIT License.