Grid 栅格

基本使用

此栅格系统提供了320,480,720, 990,1200,1500等几乎所有主流分辨率场景的响应规则。 响应式栅格采用24列栅格体系和5分比实现,以满足2,3,4,5,6分比布局等多种情况。 固定栅格采用 20px 宽度作为单位栅格, 推荐使用9,10,12,14,16,18,24,但同时也提供了从1到30的所有栅格,也可根据需求定制固定栅格列。 响应式断点阈值为:xss(320px), xs(480px), s(720px), m(990px), l(1200px), xl(1500px)。 基于Flex实现,对 IE9 通过 display:table; 兼容实现,但 IE9 仅支持基本的响应式布局(详情请参考 API 和 DEMO 的说明)。

基础布局

通过 Col 的 span 属性指定该列宽度占整行宽度24分之几或5分之几。

Loading demo...

APIs

Grid.Row

参数说明类型默认值
children行内容ReactNode-
gutter列间隔String/Number0
wrap列在行中宽度溢出后是否换行Booleanfalse
fixed行在某一断点下宽度是否保持不变(默认行宽度随视口变化而变化)Booleanfalse
fixedWidth固定行的宽度为某一断点的宽度,不受视口影响而变动

可选值:
'xxs'(320px)
'xs'(480px)
's'(720px)
'm'(990px)
'l'(1200px)
'xl'(1500px)
Enum-
align(不支持IE9浏览器)多列垂直方向对齐方式

可选值:
'top'(顶部对齐)
'center'(居中对齐)
'bottom'(底部对齐)
'baseline'(按第一行文字基线对齐)
'stretch'(未设置高度或设为 auto,将占满整个容器的高度)
Enum-
justify(不支持IE9浏览器)行内具有多余空间时的布局方式

可选值:
'start'(左对齐)
'center'(居中对齐)
'end'(右对齐)
'space-between'(两端对齐,列之间间距相等)
'space-around'(每列具有相同的左右间距,行两端间距是列间距的二分之一)
Enum-
hidden行在不同断点下的显示与隐藏

可选值:
true(在所有断点下隐藏)
false(在所有断点下显示)
'xs'(在 xs 断点下隐藏)
['xxs', 'xs', 's', 'm', 'l', 'xl'](在 xxs, xs, s, m, l, xl 断点下隐藏)
Boolean/String/Array-
component指定以何种元素渲染该节点
- 默认为 'div'
String/Function'div'

Grid.Col

参数说明类型默认值
children列内容ReactNode-
span列宽度

可选值:
1, 2, 3, ..., 22, 23, 24
String/Number-
fixedSpan固定列宽度,宽度值为20 * 栅格数

可选值:
1, 2, 3, ..., 28, 29, 30
String/Number-
offset(不支持IE9浏览器)列偏移

可选值:
1, 2, 3, ..., 22, 23, 24
String/Number-
fixedOffset(不支持IE9浏览器)固定列偏移,宽度值为20 * 栅格数

可选值:
1, 2, 3, ..., 28, 29, 30
String/Number-
align(不支持IE9浏览器)多列垂直方向对齐方式,可覆盖Row的align属性

可选值:
'top', 'center', 'bottom', 'baseline', 'stretch'
Enum-
hidden列在不同断点下的显示与隐藏

可选值:
true(在所有断点下隐藏)
false(在所有断点下显示)
'xs'(在 xs 断点下隐藏)
['xxs', 'xs', 's', 'm', 'l', 'xl'](在 xxs, xs, s, m, l, xl 断点下隐藏)
Boolean/String/Array-
xxs>=320px,响应式栅格,可为栅格数(span)或一个包含栅格数(span)和偏移栅格数(offset)对象String/Number/Object-
xs>=480px,响应式栅格,可为栅格数(span)或一个包含栅格数(span)和偏移栅格数(offset)对象String/Number/Object-
s>=720px,响应式栅格,可为栅格数(span)或一个包含栅格数(span)和偏移栅格数(offset)对象String/Number/Object-
m>=990px,响应式栅格,可为栅格数(span)或一个包含栅格数(span)和偏移栅格数(offset)对象String/Number/Object-
l>=1200px,响应式栅格,可为栅格数(span)或一个包含栅格数(span)和偏移栅格数(offset)对象String/Number/Object-
xl>=1500px,响应式栅格,可为栅格数(span)或一个包含栅格数(span)和偏移栅格数(offset)对象String/Number/Object-
component指定以何种元素渲染该节点,默认为 'div'String/Function'div'

Demo

固定宽度列

Loading demo...

通过 Col 的 fixedSpan 属性来指定某列为固定宽度列,其宽度的计算方式为 20 * fixedSpan。

列间距

Loading demo...

列与列间距默认为0,可以通过设置 Row 的 gutter 属性来改变列间距。

溢出后是否换行

Loading demo...

(不支持 IE9 浏览器)默认列在行中宽度溢出后不会换行,如果想自动换行,请为 Row 设置 wrap 为 true。

嵌套布局

Loading demo...

Col 下也可嵌套 Row,以完成更细致的布局。

响应式布局

Loading demo...

显示与隐藏

Loading demo...

提供了强大的响应式的显示与隐藏功能,支持在不同断点下的显示与隐藏。

设置行的宽度

Loading demo...

默认 Row 的宽度被设置为100%,可以通过设置 fixed 属性为 true,来让 Row 的宽度不立刻随着是视口大小变动而变动,而是在某个断点下维持固定的宽度,也可以通过设置 fixedWidth 属性为某一断点值,从而固定 Row 的宽度,不再随着视口大小变动而变动。

偏移

Loading demo...

(不支持 IE9 浏览器)列可以向右偏移一定距离,该距离的计算方式和列所占宽度计算方式相同。

固定宽度偏移

Loading demo...

(不支持 IE9 浏览器)列可以向右偏移一定距离,该距离的计算方式和固定宽度列的宽度相同。

多列垂直方向对齐方式

Loading demo...

(不支持 IE9 浏览器)基于 Flex 的 align-items 和 align-self 属性实现,在 Row 上设置 align 属性,即可控制 Row 下面所有 Col 的垂直方向对齐方式:top(顶部对齐,默认),center(居中对齐),bottom(底部对齐),baseline(第一行文字的基线对齐),stretch(如果未设置高度或设为 auto,将占满整个容器的高度);在 Col 上设置 align 属性,可允许它与其它列不一样的对齐方式,覆盖 Row 的 align 属性。

多列水平方向对齐方式

Loading demo...

(不支持 IE9 浏览器)基于 Flex 的 justify-content 属性实现,在 Row 上设置 justify 属性,即可行内多列水平方向对齐方式:start(左对齐,默认),center(居中对齐),end(右对齐),space-between(两端对齐,项目之间的间隔都相),space-around(两侧的间隔相等,列之间的间隔比列与左右两端的间隔大一倍)。