Grid栅格

24 栅格系统。

设计理念

在多数业务情况下，Ant Design 需要在设计区域内解决大量信息收纳的问题，因此在 12 栅格系统的基础上，我们将整个设计建议区域按照 24 等分的原则进行划分。

划分之后的信息区块我们称之为『盒子』。建议横向排列的盒子数量最多四个，最少一个。『盒子』在整个屏幕上占比见上图。设计部分基于盒子的单位定制盒子内部的排版规则，以保证视觉层面的舒适感。

概述

布局的栅格化系统，我们是基于行（row）和列（col）来定义信息区块的外部框架，以保证页面的每个区域能够稳健地排布起来。下面简单介绍一下它的工作原理：

  • 通过 row 在水平方向建立一组 column（简写 col）。

  • 你的内容应当放置于 col 内，并且，只有 col 可以作为 row 的直接元素。

  • 栅格系统中的列是指 1 到 24 的值来表示其跨越的范围。例如，三个等宽的列可以使用 <Col span={8} /> 来创建。

  • 如果一个 row 中的 col 总和超过 24，那么多余的 col 会作为一个整体另起一行排列。

我们的栅格化系统基于 Flex 布局，允许子元素在父节点内的水平对齐方式 - 居左、居中、居右、等宽排列、分散排列。子元素与子元素之间，支持顶部对齐、垂直居中对齐、底部对齐的方式。同时，支持使用 order 来定义元素的排列顺序。

布局是基于 24 栅格来定义每一个『盒子』的宽度，但不拘泥于栅格。

代码演示

Grid栅格 - 图1

基础栅格

从堆叠到水平排列。

使用单一的一组 Row 和 Col 栅格组件，就可以创建一个基本的栅格系统，所有列（Col）必须放在 Row 内。

  1. import { Row, Col } from 'antd';
  3. ReactDOM.render(
  4.   <>
  5.     <Row>
  6.       <Col span={24}>col</Col>
  7.     </Row>
  8.     <Row>
  9.       <Col span={12}>col-12</Col>
  10.       <Col span={12}>col-12</Col>
  11.     </Row>
  12.     <Row>
  13.       <Col span={8}>col-8</Col>
  14.       <Col span={8}>col-8</Col>
  15.       <Col span={8}>col-8</Col>
  16.     </Row>
  17.     <Row>
  18.       <Col span={6}>col-6</Col>
  19.       <Col span={6}>col-6</Col>
  20.       <Col span={6}>col-6</Col>
  21.       <Col span={6}>col-6</Col>
  22.     </Row>
  23.   </>,
  24.   mountNode,
  25. );

Grid栅格 - 图2

区块间隔

栅格常常需要和间隔进行配合，你可以使用 Row 的 gutter 属性，我们推荐使用 (16+8n)px 作为栅格间隔(n 是自然数)。

如果要支持响应式，可以写成 { xs: 8, sm: 16, md: 24, lg: 32 }。

如果需要垂直间距，可以写成数组形式 [水平间距, 垂直间距] [16, { xs: 8, sm: 16, md: 24, lg: 32 }]。

数组形式垂直间距在 3.24.0 之后支持。

  1. import { Row, Col, Divider } from 'antd';
  3. const style = { background: '#0092ff', padding: '8px 0' };
  5. ReactDOM.render(
  6.   <>
  7.     <Divider orientation="left">Horizontal</Divider>
  8.     <Row gutter={16}>
  9.       <Col className="gutter-row" span={6}>
  10.         <div style={style}>col-6</div>
  11.       </Col>
  12.       <Col className="gutter-row" span={6}>
  13.         <div style={style}>col-6</div>
  14.       </Col>
  15.       <Col className="gutter-row" span={6}>
  16.         <div style={style}>col-6</div>
  17.       </Col>
  18.       <Col className="gutter-row" span={6}>
  19.         <div style={style}>col-6</div>
  20.       </Col>
  21.     </Row>
  22.     <Divider orientation="left">Responsive</Divider>
  23.     <Row gutter={{ xs: 8, sm: 16, md: 24, lg: 32 }}>
  24.       <Col className="gutter-row" span={6}>
  25.         <div style={style}>col-6</div>
  26.       </Col>
  27.       <Col className="gutter-row" span={6}>
  28.         <div style={style}>col-6</div>
  29.       </Col>
  30.       <Col className="gutter-row" span={6}>
  31.         <div style={style}>col-6</div>
  32.       </Col>
  33.       <Col className="gutter-row" span={6}>
  34.         <div style={style}>col-6</div>
  35.       </Col>
  36.     </Row>
  37.     <Divider orientation="left">Vertical</Divider>
  38.     <Row gutter={[16, 24]}>
  39.       <Col className="gutter-row" span={6}>
  40.         <div style={style}>col-6</div>
  41.       </Col>
  42.       <Col className="gutter-row" span={6}>
  43.         <div style={style}>col-6</div>
  44.       </Col>
  45.       <Col className="gutter-row" span={6}>
  46.         <div style={style}>col-6</div>
  47.       </Col>
  48.       <Col className="gutter-row" span={6}>
  49.         <div style={style}>col-6</div>
  50.       </Col>
  51.       <Col className="gutter-row" span={6}>
  52.         <div style={style}>col-6</div>
  53.       </Col>
  54.       <Col className="gutter-row" span={6}>
  55.         <div style={style}>col-6</div>
  56.       </Col>
  57.       <Col className="gutter-row" span={6}>
  58.         <div style={style}>col-6</div>
  59.       </Col>
  60.       <Col className="gutter-row" span={6}>
  61.         <div style={style}>col-6</div>
  62.       </Col>
  63.     </Row>
  64.   </>,
  65.   mountNode,
  66. );
  1. .gutter-box {
  2.   padding: 8px 0;
  3.   background: #00a0e9;
  4. }

Grid栅格 - 图3

左右偏移

列偏移。

使用 offset 可以将列向右侧偏。例如，offset={4} 将元素向右侧偏移了 4 个列（column）的宽度。

  1. import { Row, Col } from 'antd';
  3. ReactDOM.render(
  4.   <>
  5.     <Row>
  6.       <Col span={8}>col-8</Col>
  7.       <Col span={8} offset={8}>
  8.         col-8
  9.       </Col>
  10.     </Row>
  11.     <Row>
  12.       <Col span={6} offset={6}>
  13.         col-6 col-offset-6
  14.       </Col>
  15.       <Col span={6} offset={6}>
  16.         col-6 col-offset-6
  17.       </Col>
  18.     </Row>
  19.     <Row>
  20.       <Col span={12} offset={6}>
  21.         col-12 col-offset-6
  22.       </Col>
  23.     </Row>
  24.   </>,
  25.   mountNode,
  26. );

Grid栅格 - 图4

栅格排序

列排序。

通过使用 push 和 pull 类就可以很容易的改变列（column）的顺序。

  1. import { Row, Col } from 'antd';
  3. ReactDOM.render(
  4.   <Row>
  5.     <Col span={18} push={6}>
  6.       col-18 col-push-6
  7.     </Col>
  8.     <Col span={6} pull={18}>
  9.       col-6 col-pull-18
  10.     </Col>
  11.   </Row>,
  12.   mountNode,
  13. );

Grid栅格 - 图5

排版

布局基础。

子元素根据不同的值 start,center,end,space-between,space-around，分别定义其在父节点里面的排版方式。

  1. import { Row, Col, Divider } from 'antd';
  3. ReactDOM.render(
  4.   <>
  5.     <Divider orientation="left">sub-element align left</Divider>
  6.     <Row justify="start">
  7.       <Col span={4}>col-4</Col>
  8.       <Col span={4}>col-4</Col>
  9.       <Col span={4}>col-4</Col>
  10.       <Col span={4}>col-4</Col>
  11.     </Row>
  13.     <Divider orientation="left">sub-element align center</Divider>
  14.     <Row justify="center">
  15.       <Col span={4}>col-4</Col>
  16.       <Col span={4}>col-4</Col>
  17.       <Col span={4}>col-4</Col>
  18.       <Col span={4}>col-4</Col>
  19.     </Row>
  21.     <Divider orientation="left">sub-element align right</Divider>
  22.     <Row justify="end">
  23.       <Col span={4}>col-4</Col>
  24.       <Col span={4}>col-4</Col>
  25.       <Col span={4}>col-4</Col>
  26.       <Col span={4}>col-4</Col>
  27.     </Row>
  29.     <Divider orientation="left">sub-element monospaced arrangement</Divider>
  30.     <Row justify="space-between">
  31.       <Col span={4}>col-4</Col>
  32.       <Col span={4}>col-4</Col>
  33.       <Col span={4}>col-4</Col>
  34.       <Col span={4}>col-4</Col>
  35.     </Row>
  37.     <Divider orientation="left">sub-element align full</Divider>
  38.     <Row justify="space-around">
  39.       <Col span={4}>col-4</Col>
  40.       <Col span={4}>col-4</Col>
  41.       <Col span={4}>col-4</Col>
  42.       <Col span={4}>col-4</Col>
  43.     </Row>
  44.   </>,
  45.   mountNode,
  46. );
  1. #components-grid-demo-flex [class~='ant-row'] {
  2.   background: rgba(128, 128, 128, 0.08);
  3. }

Grid栅格 - 图6

对齐

子元素垂直对齐。

  1. import { Row, Col, Divider } from 'antd';
  3. const DemoBox = props => <p className={`height-${props.value}`}>{props.children}</p>;
  5. ReactDOM.render(
  6.   <>
  7.     <Divider orientation="left">Align Top</Divider>
  8.     <Row justify="center" align="top">
  9.       <Col span={4}>
  10.         <DemoBox value={100}>col-4</DemoBox>
  11.       </Col>
  12.       <Col span={4}>
  13.         <DemoBox value={50}>col-4</DemoBox>
  14.       </Col>
  15.       <Col span={4}>
  16.         <DemoBox value={120}>col-4</DemoBox>
  17.       </Col>
  18.       <Col span={4}>
  19.         <DemoBox value={80}>col-4</DemoBox>
  20.       </Col>
  21.     </Row>
  23.     <Divider orientation="left">Align Middle</Divider>
  24.     <Row justify="space-around" align="middle">
  25.       <Col span={4}>
  26.         <DemoBox value={100}>col-4</DemoBox>
  27.       </Col>
  28.       <Col span={4}>
  29.         <DemoBox value={50}>col-4</DemoBox>
  30.       </Col>
  31.       <Col span={4}>
  32.         <DemoBox value={120}>col-4</DemoBox>
  33.       </Col>
  34.       <Col span={4}>
  35.         <DemoBox value={80}>col-4</DemoBox>
  36.       </Col>
  37.     </Row>
  39.     <Divider orientation="left">Align Bottom</Divider>
  40.     <Row justify="space-between" align="bottom">
  41.       <Col span={4}>
  42.         <DemoBox value={100}>col-4</DemoBox>
  43.       </Col>
  44.       <Col span={4}>
  45.         <DemoBox value={50}>col-4</DemoBox>
  46.       </Col>
  47.       <Col span={4}>
  48.         <DemoBox value={120}>col-4</DemoBox>
  49.       </Col>
  50.       <Col span={4}>
  51.         <DemoBox value={80}>col-4</DemoBox>
  52.       </Col>
  53.     </Row>
  54.   </>,
  55.   mountNode,
  56. );
  1. #components-grid-demo-flex-align [class~='ant-row'] {
  2.   background: rgba(128, 128, 128, 0.08);
  3. }

Grid栅格 - 图7

排序

通过 order 来改变元素的排序。

  1. import { Row, Col, Divider } from 'antd';
  3. ReactDOM.render(
  4.   <>
  5.     <Divider orientation="left">Normal</Divider>
  6.     <Row>
  7.       <Col span={6} order={4}>
  8.         1 col-order-4
  9.       </Col>
  10.       <Col span={6} order={3}>
  11.         2 col-order-3
  12.       </Col>
  13.       <Col span={6} order={2}>
  14.         3 col-order-2
  15.       </Col>
  16.       <Col span={6} order={1}>
  17.         4 col-order-1
  18.       </Col>
  19.     </Row>
  20.     <Divider orientation="left">Responsive</Divider>
  21.     <Row>
  22.       <Col span={6} xs={{ order: 1 }} sm={{ order: 2 }} md={{ order: 3 }} lg={{ order: 4 }}>
  23.         1 col-order-responsive
  24.       </Col>
  25.       <Col span={6} xs={{ order: 2 }} sm={{ order: 1 }} md={{ order: 4 }} lg={{ order: 3 }}>
  26.         2 col-order-responsive
  27.       </Col>
  28.       <Col span={6} xs={{ order: 3 }} sm={{ order: 4 }} md={{ order: 2 }} lg={{ order: 1 }}>
  29.         3 col-order-responsive
  30.       </Col>
  31.       <Col span={6} xs={{ order: 4 }} sm={{ order: 3 }} md={{ order: 1 }} lg={{ order: 2 }}>
  32.         4 col-order-responsive
  33.       </Col>
  34.     </Row>
  35.   </>,
  36.   mountNode,
  37. );
  1. #components-grid-demo-flex-order [class~='ant-row'] {
  2.   background: rgba(128, 128, 128, 0.08);
  3. }

Grid栅格 - 图8

Flex 填充

Col 提供 flex 属性以支持填充。

  1. import { Row, Col, Divider } from 'antd';
  3. ReactDOM.render(
  4.   <>
  5.     <Divider orientation="left">Percentage columns</Divider>
  6.     <Row>
  7.       <Col flex={2}>2 / 5</Col>
  8.       <Col flex={3}>3 / 5</Col>
  9.     </Row>
  10.     <Divider orientation="left">Fill rest</Divider>
  11.     <Row>
  12.       <Col flex="100px">100px</Col>
  13.       <Col flex="auto">Fill Rest</Col>
  14.     </Row>
  15.     <Divider orientation="left">Raw flex style</Divider>
  16.     <Row>
  17.       <Col flex="1 1 200px">1 1 200px</Col>
  18.       <Col flex="0 1 300px">0 1 300px</Col>
  19.     </Row>
  21.     <Row wrap={false}>
  22.       <Col flex="none">
  23.         <div style={{ padding: '0 16px' }}>none</div>
  24.       </Col>
  25.       <Col flex="auto">auto with no-wrap</Col>
  26.     </Row>
  27.   </>,
  28.   mountNode,
  29. );

Grid栅格 - 图9

响应式布局

参照 Bootstrap 的 响应式设计，预设六个响应尺寸：xs sm md lg xl xxl。

  1. import { Row, Col } from 'antd';
  3. ReactDOM.render(
  4.   <Row>
  5.     <Col xs={2} sm={4} md={6} lg={8} xl={10}>
  6.       Col
  7.     </Col>
  8.     <Col xs={20} sm={16} md={12} lg={8} xl={4}>
  9.       Col
  10.     </Col>
  11.     <Col xs={2} sm={4} md={6} lg={8} xl={10}>
  12.       Col
  13.     </Col>
  14.   </Row>,
  15.   mountNode,
  16. );

Grid栅格 - 图10

其他属性的响应式

span pull push offset order 属性可以通过内嵌到 xs sm md lg xl xxl 属性中来使用。

其中 xs={6} 相当于 xs={{ span: 6 }}。

  1. import { Row, Col } from 'antd';
  3. ReactDOM.render(
  4.   <Row>
  5.     <Col xs={{ span: 5, offset: 1 }} lg={{ span: 6, offset: 2 }}>
  6.       Col
  7.     </Col>
  8.     <Col xs={{ span: 11, offset: 1 }} lg={{ span: 6, offset: 2 }}>
  9.       Col
  10.     </Col>
  11.     <Col xs={{ span: 5, offset: 1 }} lg={{ span: 6, offset: 2 }}>
  12.       Col
  13.     </Col>
  14.   </Row>,
  15.   mountNode,
  16. );

Grid栅格 - 图11

栅格配置器

可以简单配置几种等分栅格和间距。

  1. import { Row, Col, Slider } from 'antd';
  3. const gutters = {};
  4. const vgutters = {};
  5. const colCounts = {};
  7. [8, 16, 24, 32, 40, 48].forEach((value, i) => {
  8.   gutters[i] = value;
  9. });
  10. [8, 16, 24, 32, 40, 48].forEach((value, i) => {
  11.   vgutters[i] = value;
  12. });
  13. [2, 3, 4, 6, 8, 12].forEach((value, i) => {
  14.   colCounts[i] = value;
  15. });
  17. class App extends React.Component {
  18.   state = {
  19.     gutterKey: 1,
  20.     vgutterKey: 1,
  21.     colCountKey: 2,
  22.   };
  24.   onGutterChange = gutterKey => {
  25.     this.setState({ gutterKey });
  26.   };
  28.   onVGutterChange = vgutterKey => {
  29.     this.setState({ vgutterKey });
  30.   };
  32.   onColCountChange = colCountKey => {
  33.     this.setState({ colCountKey });
  34.   };
  36.   render() {
  37.     const { gutterKey, vgutterKey, colCountKey } = this.state;
  38.     const cols = [];
  39.     const colCount = colCounts[colCountKey];
  40.     let colCode = '';
  41.     for (let i = 0; i < colCount; i++) {
  42.       cols.push(
  43.         <Col key={i.toString()} span={24 / colCount}>
  44.           <div>Column</div>
  45.         </Col>,
  46.       );
  47.       colCode += `  <Col span={${24 / colCount}} />\n`;
  48.     }
  49.     return (
  50.       <>
  51.         <span>Horizontal Gutter (px): </span>
  52.         <div style={{ width: '50%' }}>
  53.           <Slider
  54.             min={0}
  55.             max={Object.keys(gutters).length - 1}
  56.             value={gutterKey}
  57.             onChange={this.onGutterChange}
  58.             marks={gutters}
  59.             step={null}
  60.             tipFormatter={value => gutters[value]}
  61.           />
  62.         </div>
  63.         <span>Vertical Gutter (px): </span>
  64.         <div style={{ width: '50%' }}>
  65.           <Slider
  66.             min={0}
  67.             max={Object.keys(vgutters).length - 1}
  68.             value={vgutterKey}
  69.             onChange={this.onVGutterChange}
  70.             marks={vgutters}
  71.             step={null}
  72.             tipFormatter={value => vgutters[value]}
  73.           />
  74.         </div>
  75.         <span>Column Count:</span>
  76.         <div style={{ width: '50%', marginBottom: 48 }}>
  77.           <Slider
  78.             min={0}
  79.             max={Object.keys(colCounts).length - 1}
  80.             value={colCountKey}
  81.             onChange={this.onColCountChange}
  82.             marks={colCounts}
  83.             step={null}
  84.             tipFormatter={value => colCounts[value]}
  85.           />
  86.         </div>
  87.         <Row gutter={[gutters[gutterKey], vgutters[vgutterKey]]}>
  88.           {cols}
  89.           {cols}
  90.         </Row>
  91.         Another Row:
  92.         <Row gutter={[gutters[gutterKey], vgutters[vgutterKey]]}>{cols}</Row>
  93.         <pre className="demo-code">{`<Row gutter={[${gutters[gutterKey]}, ${vgutters[vgutterKey]}]}>\n${colCode}\n${colCode}</Row>`}</pre>
  94.         <pre className="demo-code">{`<Row gutter={[${gutters[gutterKey]}, ${vgutters[vgutterKey]}]}>\n${colCode}</Row>`}</pre>
  95.       </>
  96.     );
  97.   }
  98. }
  100. ReactDOM.render(<App />, mountNode);
  1. #components-grid-demo-playground [class~='ant-col'] {
  2.   background: transparent;
  3.   border: 0;
  4. }
  5. #components-grid-demo-playground [class~='ant-col'] > div {
  6.   height: 120px;
  7.   font-size: 14px;
  8.   line-height: 120px;
  9.   background: #0092ff;
  10.   border-radius: 4px;
  11. }
  12. #components-grid-demo-playground pre {
  13.   padding: 8px 16px;
  14.   font-size: 13px;
  15.   background: #f9f9f9;
  16.   border-radius: 6px;
  17. }
  18. #components-grid-demo-playground pre.demo-code {
  19.   direction: ltr;
  20. }
  21. #components-grid-demo-playground .ant-col {
  22.   padding: 0;
  23. }

Grid栅格 - 图12

useBreakpoint Hook

使用 useBreakpoint Hook 个性化布局。

  1. import { Grid, Tag } from 'antd';
  3. const { useBreakpoint } = Grid;
  5. function UseBreakpointDemo() {
  6.   const screens = useBreakpoint();
  7.   return (
  8.     <>
  9.       Current break point:{' '}
  10.       {Object.entries(screens)
  11.         .filter(screen => !!screen[1])
  12.         .map(screen => (
  13.           <Tag color="blue" key={screen[0]}>
  14.             {screen[0]}
  15.           </Tag>
  16.         ))}
  17.     </>
  18.   );
  19. }
  21. ReactDOM.render(<UseBreakpointDemo />, mountNode);

API

Ant Design 的布局组件若不能满足你的需求，你也可以直接使用社区的优秀布局组件：

Row

成员说明类型默认值版本
align垂直对齐方式top | middle | bottomtop
gutter栅格间隔，可以写成像素值或支持响应式的对象写法来设置水平间隔 { xs: 8, sm: 16, md: 24}。或者使用数组形式同时设置 [水平间距, 垂直间距]number | object | array0
justify水平排列方式start | end | center | space-around | space-betweenstart
wrap是否自动换行booleantrue4.8.0

Col

成员说明类型默认值版本
flexflex 布局属性string | number-
offset栅格左侧的间隔格数，间隔内不可以有栅格number0
order栅格顺序number0
pull栅格向左移动格数number0
push栅格向右移动格数number0
span栅格占位格数，为 0 时相当于 display: nonenumber-
xs屏幕 < 576px 响应式栅格，可为栅格数或一个包含其他属性的对象number | object-
sm屏幕 ≥ 576px 响应式栅格，可为栅格数或一个包含其他属性的对象number | object-
md屏幕 ≥ 768px 响应式栅格，可为栅格数或一个包含其他属性的对象number | object-
lg屏幕 ≥ 992px 响应式栅格，可为栅格数或一个包含其他属性的对象number | object-
xl屏幕 ≥ 1200px 响应式栅格，可为栅格数或一个包含其他属性的对象number | object-
xxl屏幕 ≥ 1600px 响应式栅格，可为栅格数或一个包含其他属性的对象number | object-

响应式栅格的断点扩展自 BootStrap 4 的规则（不包含链接里 occasionally 的部分)。