Skip to content

Grid 栅格 ​

简介 ​

24 栅格系统,使用方式和接口同 element-plus Layout,但响应式断点是相对于容器宽度,而非视口大小。

代码演示 ​

基础使用 ​

使用列创建基础网格布局。

通过 row 和 col 组件,并通过 col 组件的 span 属性我们就可以自由地组合布局。

分栏间隔 ​

支持列间距。

行提供 gutter 属性来指定列之间的间距,其默认值为0。

混合布局 ​

通过基础的 1/24 分栏任意扩展组合形成较为复杂的混合布局。

列偏移 ​

您可以指定列偏移量。

通过制定 col 组件的 offset 属性可以指定分栏偏移的栏数。

对齐方式 ​

默认使用 flex 布局来对分栏进行灵活的对齐。

您可以通过 justify 属性来定义子元素的排版方式,其取值为 start、center、end、space-between、space-around或space-evenly。

响应式布局 ​

参照了 Bootstrap 的 响应式设计,预设了六个响应尺寸:xs、sm、md、lg、xl 和 xxl。

自定义断点 ​

默认断点为 [576, 768, 992, 1200, 1600], 可通过 breakpoints 属性设置其他断点。

API ​

RowProps ​

属性描述类型默认值
tag自定义元素标签string'div'
gutter列之间的间距number0
justifyflex 布局下的水平排列方式'start' | 'center' | 'end' | 'space-around' | 'space-between' | 'space-evenly'—
alignflex 布局下的垂直排列方式'top' | 'middle' | 'bottom'—
breakpoints自定义断点,用于计算响应式尺寸number[][576, 768, 992, 1200, 1600]

RowSlots ​

插槽描述属性
default自定义默认内容-

ColProps ​

属性描述类型默认值
tag自定义元素标签string'div'
span栅格占据的列数number24
offset栅格左侧的间隔格数number0
push栅格向右移动格数number0
pull栅格向左移动格数number0
xs容器宽度小于 576px 时的栅格配置number | ColSizeObject—
sm容器宽度不小于 576px 时的栅格配置number | ColSizeObject—
md容器宽度不小于 768px 时的栅格配置number | ColSizeObject—
lg容器宽度不小于 992px 时的栅格配置number | ColSizeObject—
xl容器宽度不小于 1200px 时的栅格配置number | ColSizeObject—
xxl容器宽度不小于 1600px 时的栅格配置number | ColSizeObject—

响应式属性传入 number 时表示该尺寸下的 span;传入对象时可精确指定各项数值。某个尺寸未设置时,会沿用比它小的最近一个已设置的尺寸。断点由 row 的 breakpoints 属性决定,测量的是 row 容器的宽度而非视口宽度。

ColSizeObject ​

属性描述类型默认值
span栅格占据的列数number—
offset栅格左侧的间隔格数number—
push栅格向右移动格数number—
pull栅格向左移动格数number—

ColSlots ​

插槽描述属性
default自定义默认内容-

基于 MIT 许可发布