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 | string—flex 简写(脱离栅格按 flex 分配)
xs/sm/md/lg/xl/xxlnumber | { span, offset, order, push, pull }—响应式配置

Released under the MIT License.