Ant Design

⌘ K

5.27.5

Grid
栅格

24 栅格系统。

使用import { Grid } from "antd";

反馈

components/grid 提交问题待解决

文档

编辑此页

文档贡献者

Flex弹性布局 Layout布局

Ant Design

⌘ K

5.27.5

Grid
栅格

24 栅格系统。

使用import { Grid } from "antd";

反馈

components/grid 提交问题待解决

文档

编辑此页

文档贡献者

Flex弹性布局 Layout布局

设计理念

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

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

概述

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

通过 row 在水平方向建立一组 column（简写 col）。
你的内容应当放置于 col 内，并且，只有 col 可以作为 row 的直接元素。
栅格系统中的列是指 1 到 24 的值来表示其跨越的范围。例如，三个等宽的列可以使用 <Col span={8} /> 来创建。
如果一个 row 中的 col 总和超过 24，那么多余的 col 会作为一个整体另起一行排列。

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

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

代码演示

API

通用属性参考：通用属性

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

Row

参数	说明	类型	默认值	版本
align	垂直对齐方式	`top` \| `middle` \| `bottom` \| `stretch` \| `{[key in 'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'xxl']: 'top' \| 'middle' \| 'bottom' \| 'stretch'}`	`top`	object: 4.24.0
gutter	栅格间隔，可以写成字符串CSS单位或支持响应式的对象写法来设置水平间隔 { xs: 8, sm: 16, md: 24}。或者使用数组形式同时设置 `[水平间距, 垂直间距]`	number \| string \| object \| array	0	string: 5.28.0
justify	水平排列方式	`start` \| `end` \| `center` \| `space-around` \| `space-between` \| `space-evenly` \| `{[key in 'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'xxl']: 'start' \| 'end' \| 'center' \| 'space-around' \| 'space-between' \| 'space-evenly'}`	`start`	object: 4.24.0
wrap	是否自动换行	boolean	true	4.8.0

Col

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

您可以使用主题定制修改 screen[XS|SM|MD|LG|XL|XXL] 来修改断点值（自 5.1.0 起，codesandbox demo）。

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

主题变量（Design Token）

设计理念

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

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

概述

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

通过 row 在水平方向建立一组 column（简写 col）。
你的内容应当放置于 col 内，并且，只有 col 可以作为 row 的直接元素。
栅格系统中的列是指 1 到 24 的值来表示其跨越的范围。例如，三个等宽的列可以使用 <Col span={8} /> 来创建。
如果一个 row 中的 col 总和超过 24，那么多余的 col 会作为一个整体另起一行排列。

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

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

代码演示

col

col-12

col-8

col-6

基础栅格

从堆叠到水平排列。

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

Horizontal

col-6

Responsive

col-6

Vertical

col-6

Gutter(string)

col-6

区块间隔

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

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

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

Row 的 gutter 属性可以设置为字符串CSS单位，例如：px、rem、vw、vh 等。

数组形式垂直间距在 3.24.0 之后支持。string 类型在 5.28.0 之后支持。

col-8

col-6 col-offset-6

col-12 col-offset-6

左右偏移

列偏移。

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

col-18 col-push-6

col-6 col-pull-18

栅格排序

列排序。

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

sub-element align left

col-4

sub-element align center

col-4

sub-element align right

col-4

sub-element monospaced arrangement

col-4

sub-element align full

col-4

sub-element align evenly

col-4

排版

布局基础。

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

Align Top

col-4

Align Middle

col-4

Align Bottom

col-4

对齐

子元素垂直对齐。

Normal

1 col-order-4

2 col-order-3

3 col-order-2

4 col-order-1

Responsive

1 col-order-responsive

2 col-order-responsive

3 col-order-responsive

4 col-order-responsive

排序

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

Percentage columns

2 / 5

3 / 5

Fill rest

100px

Fill Rest

Raw flex style

1 1 200px

0 1 300px

none

auto with no-wrap

Flex 填充

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

Col

响应式布局

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

Col

Flex 响应式布局

支持更灵活的响应式下的任意 flex 比例，该功能需要浏览器支持 CSS Variables。

5.14.0

Col

其他属性的响应式

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

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

Horizontal Gutter (px):

81624324048

Vertical Gutter (px):

81624324048

Column Count:

2346812

Column

Another Row:

Column

<Row gutter={[16, 16]}>
  <Col span={6} />
  <Col span={6} />
  <Col span={6} />
  <Col span={6} />

  <Col span={6} />
  <Col span={6} />
  <Col span={6} />
  <Col span={6} />
</Row>

<Row gutter={[16, 16]}>
  <Col span={6} />
  <Col span={6} />
  <Col span={6} />
  <Col span={6} />
</Row>

栅格配置器

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

Current break point:

useBreakpoint Hook

使用 useBreakpoint Hook 个性化布局，其中 xs 仅当满足最小宽度时生效。

API

通用属性参考：通用属性

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

Row

参数	说明	类型	默认值	版本
align	垂直对齐方式	`top` \| `middle` \| `bottom` \| `stretch` \| `{[key in 'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'xxl']: 'top' \| 'middle' \| 'bottom' \| 'stretch'}`	`top`	object: 4.24.0
gutter	栅格间隔，可以写成字符串CSS单位或支持响应式的对象写法来设置水平间隔 { xs: 8, sm: 16, md: 24}。或者使用数组形式同时设置 `[水平间距, 垂直间距]`	number \| string \| object \| array	0	string: 5.28.0
justify	水平排列方式	`start` \| `end` \| `center` \| `space-around` \| `space-between` \| `space-evenly` \| `{[key in 'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'xxl']: 'start' \| 'end' \| 'center' \| 'space-around' \| 'space-between' \| 'space-evenly'}`	`start`	object: 4.24.0
wrap	是否自动换行	boolean	true	4.8.0

Col

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

您可以使用主题定制修改 screen[XS|SM|MD|LG|XL|XXL] 来修改断点值（自 5.1.0 起，codesandbox demo）。

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

主题变量（Design Token）

col

col-12

col-8

col-6

基础栅格

从堆叠到水平排列。

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

Horizontal

col-6

Responsive

col-6

Vertical

col-6

Gutter(string)

col-6

区块间隔

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

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

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

Row 的 gutter 属性可以设置为字符串CSS单位，例如：px、rem、vw、vh 等。

数组形式垂直间距在 3.24.0 之后支持。string 类型在 5.28.0 之后支持。

col-8

col-6 col-offset-6

col-12 col-offset-6

左右偏移

列偏移。

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

col-18 col-push-6

col-6 col-pull-18

栅格排序

列排序。

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

sub-element align left

col-4

sub-element align center

col-4

sub-element align right

col-4

sub-element monospaced arrangement

col-4

sub-element align full

col-4

sub-element align evenly

col-4

排版

布局基础。

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

Align Top

col-4

Align Middle

col-4

Align Bottom

col-4

对齐

子元素垂直对齐。

Normal

1 col-order-4

2 col-order-3

3 col-order-2

4 col-order-1

Responsive

1 col-order-responsive

2 col-order-responsive

3 col-order-responsive

4 col-order-responsive

排序

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

Percentage columns

2 / 5

3 / 5

Fill rest

100px

Fill Rest

Raw flex style

1 1 200px

0 1 300px

none

auto with no-wrap

Flex 填充

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

Col

响应式布局

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

Col

Flex 响应式布局

支持更灵活的响应式下的任意 flex 比例，该功能需要浏览器支持 CSS Variables。

5.14.0

Col

其他属性的响应式

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

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

Horizontal Gutter (px):

81624324048

Vertical Gutter (px):

81624324048

Column Count:

2346812

Column

Another Row:

Column

<Row gutter={[16, 16]}>
  <Col span={6} />
  <Col span={6} />
  <Col span={6} />
  <Col span={6} />

  <Col span={6} />
  <Col span={6} />
  <Col span={6} />
  <Col span={6} />
</Row>

<Row gutter={[16, 16]}>
  <Col span={6} />
  <Col span={6} />
  <Col span={6} />
  <Col span={6} />
</Row>

栅格配置器

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

Current break point:

useBreakpoint Hook

使用 useBreakpoint Hook 个性化布局，其中 xs 仅当满足最小宽度时生效。

Grid栅格

Grid栅格

设计理念

概述

代码演示

API

Row

Col

主题变量（Design Token）

设计理念

概述

代码演示

API

Row

Col

主题变量（Design Token）

Grid
栅格

Grid
栅格