Grid 栅格

24 栅格系统。

设计理念

100%

25%

25%

25%

25%

33.33%

33.33%

33.33%

50%

50%

66.66%

33.33%

在多数业务情况下，Ant Design需要在设计区域内解决大量信息收纳的问题，因此在 12 栅格系统的基础上，我们将整个设计建议区域按照 24 等分的原则进行划分。划分之后的信息区块我们称之为『盒子』。建议横向排列的盒子数量最多四个，最少一个。『盒子』在整个屏幕上占比见上图。设计部分基于盒子的单位定制盒子内部的排版规则，以保证视觉层面的舒适感。

概述

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

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

Flex 布局

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

代码演示

Grid栅格 - 图1

基础栅格

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

  1. <template>
  2.   <div>
  3.     <a-row>
  4.       <a-col :span="12">col-12</a-col>
  5.       <a-col :span="12">col-12</a-col>
  6.     </a-row>
  7.     <a-row>
  8.       <a-col :span="8">col-8</a-col>
  9.       <a-col :span="8">col-8</a-col>
  10.       <a-col :span="8">col-8</a-col>
  11.     </a-row>
  12.     <a-row>
  13.       <a-col :span="6">col-6</a-col>
  14.       <a-col :span="6">col-6</a-col>
  15.       <a-col :span="6">col-6</a-col>
  16.       <a-col :span="6">col-6</a-col>
  17.     </a-row>
  18.   </div>
  19. </template>

Grid栅格 - 图2

Flex 对齐

Flex 子元素垂直对齐。

  1. <template>
  2.   <div>
  3.     <p>Align Top</p>
  4.     <a-row type="flex" justify="center" align="top">
  5.       <a-col :span="4"><p class="height-100">col-4</p></a-col>
  6.       <a-col :span="4"><p class="height-50">col-4</p></a-col>
  7.       <a-col :span="4"><p class="height-120">col-4</p></a-col>
  8.       <a-col :span="4"><p class="height-80">col-4</p></a-col>
  9.     </a-row>
  11.     <p>Align Center</p>
  12.     <a-row type="flex" justify="space-around" align="middle">
  13.       <a-col :span="4"><p class="height-100">col-4</p></a-col>
  14.       <a-col :span="4"><p class="height-50">col-4</p></a-col>
  15.       <a-col :span="4"><p class="height-120">col-4</p></a-col>
  16.       <a-col :span="4"><p class="height-80">col-4</p></a-col>
  17.     </a-row>
  19.     <p>Align Bottom</p>
  20.     <a-row type="flex" justify="space-between" align="bottom">
  21.       <a-col :span="4"><p class="height-100">col-4</p></a-col>
  22.       <a-col :span="4"><p class="height-50">col-4</p></a-col>
  23.       <a-col :span="4"><p class="height-120">col-4</p></a-col>
  24.       <a-col :span="4"><p class="height-80">col-4</p></a-col>
  25.     </a-row>
  26.   </div>
  27. </template>

Grid栅格 - 图3

Flex 排序

从堆叠到水平排列。通过 Flex 布局的 Order 来改变元素的排序。

  1. <template>
  2.   <div>
  3.     <a-row type="flex">
  4.       <a-col :span="6" :order="4">1 col-order-4</a-col>
  5.       <a-col :span="6" :order="3">2 col-order-3</a-col>
  6.       <a-col :span="6" :order="2">3 col-order-2</a-col>
  7.       <a-col :span="6" :order="1">4 col-order-1</a-col>
  8.     </a-row>
  9.   </div>
  10. </template>

Grid栅格 - 图4

Flex 布局

Flex 布局基础。使用 row-flex 定义 flex 布局，其子元素根据不同的值 start,center,end,space-between,space-around，分别定义其在父节点里面的排版方式。

  1. <template>
  2.   <div>
  3.     <p>sub-element align left</p>
  4.     <a-row type="flex" justify="start">
  5.       <a-col :span="4">col-4</a-col>
  6.       <a-col :span="4">col-4</a-col>
  7.       <a-col :span="4">col-4</a-col>
  8.       <a-col :span="4">col-4</a-col>
  9.     </a-row>
  11.     <p>sub-element align center</p>
  12.     <a-row type="flex" justify="center">
  13.       <a-col :span="4">col-4</a-col>
  14.       <a-col :span="4">col-4</a-col>
  15.       <a-col :span="4">col-4</a-col>
  16.       <a-col :span="4">col-4</a-col>
  17.     </a-row>
  19.     <p>sub-element align right</p>
  20.     <a-row type="flex" justify="end">
  21.       <a-col :span="4">col-4</a-col>
  22.       <a-col :span="4">col-4</a-col>
  23.       <a-col :span="4">col-4</a-col>
  24.       <a-col :span="4">col-4</a-col>
  25.     </a-row>
  27.     <p>sub-element monospaced arrangement</p>
  28.     <a-row type="flex" justify="space-between">
  29.       <a-col :span="4">col-4</a-col>
  30.       <a-col :span="4">col-4</a-col>
  31.       <a-col :span="4">col-4</a-col>
  32.       <a-col :span="4">col-4</a-col>
  33.     </a-row>
  35.     <p>sub-element align full</p>
  36.     <a-row type="flex" justify="space-around">
  37.       <a-col :span="4">col-4</a-col>
  38.       <a-col :span="4">col-4</a-col>
  39.       <a-col :span="4">col-4</a-col>
  40.       <a-col :span="4">col-4</a-col>
  41.     </a-row>
  42.   </div>
  43. </template>

Grid栅格 - 图5

区块间隔

栅格常常需要和间隔进行配合，你可以使用 Row 的 gutter 属性，我们推荐使用 (16+8n)px 作为栅格间隔。(n 是自然数)如果要支持响应式，可以写成 { xs: 8, sm: 16, md: 24, lg: 32 }。

  1. <template>
  2.   <div class="gutter-example">
  3.     <a-row :gutter="16">
  4.       <a-col class="gutter-row" :span="6">
  5.         <div class="gutter-box">col-6</div>
  6.       </a-col>
  7.       <a-col class="gutter-row" :span="6">
  8.         <div class="gutter-box">col-6</div>
  9.       </a-col>
  10.       <a-col class="gutter-row" :span="6">
  11.         <div class="gutter-box">col-6</div>
  12.       </a-col>
  13.       <a-col class="gutter-row" :span="6">
  14.         <div class="gutter-box">col-6</div>
  15.       </a-col>
  16.     </a-row>
  17.   </div>
  18. </template>
  19. <style scoped>
  20. .gutter-example >>> .ant-row > div {
  21.   background: transparent;
  22.   border: 0;
  23. }
  24. .gutter-box {
  25.   background: #00A0E9;
  26.   padding: 5px 0;
  27. }
  28. </style>

Grid栅格 - 图6

左右偏移

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

  1. <template>
  2.   <div>
  3.     <a-row>
  4.       <a-col :span="8">col-8</a-col>
  5.       <a-col :span="8" :offset="8">col-8</a-col>
  6.     </a-row>
  7.     <a-row>
  8.       <a-col :span="6" :offset="6">col-6 col-offset-6</a-col>
  9.       <a-col :span="6" :offset="6">col-6 col-offset-6</a-col>
  10.     </a-row>
  11.     <a-row>
  12.       <a-col :span="12" :offset="6">col-12 col-offset-6</a-col>
  13.     </a-row>
  14.   </div>
  15. </template>

Grid栅格 - 图7

其他属性的响应式

span pull push offset order 属性可以通过内嵌到 xs sm md lg xl xxl 属性中来使用。其中 :xs="6" 相当于 :xs="{ span: 6 }"。

  1. <template>
  2.   <a-row>
  3.     <a-col :xs="{ span: 5, offset: 1 }" :lg="{ span: 6, offset: 2 }">Col</a-col>
  4.     <a-col :xs="{ span: 11, offset: 1 }" :lg="{ span: 6, offset: 2 }">Col</a-col>
  5.     <a-col :xs="{ span: 5, offset: 1 }" :lg="{ span: 6, offset: 2 }">Col</a-col>
  6.   </a-row>
  7. </template>

Grid栅格 - 图8

响应式布局

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

  1. <template>
  2.   <a-row>
  3.     <a-col :xs="2" :sm="4" :md="6" :lg="8" :xl="10">Col</a-col>
  4.     <a-col :xs="20" :sm="16" :md="12" :lg="8" :xl="4">Col</a-col>
  5.     <a-col :xs="2" :sm="4" :md="6" :lg="8" :xl="10">Col</a-col>
  6.   </a-row>
  7. </template>

Grid栅格 - 图9

栅格排序

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

  1. <template>
  2.   <div>
  3.     <a-row>
  4.       <a-col :span="18" :push="6">col-18 col-push-6</a-col>
  5.       <a-col :span="6" :pull="18">col-6 col-pull-18</a-col>
  6.     </a-row>
  7.   </div>
  8. </template>

Grid栅格 - 图10

栅格配置器

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

  1. <template>
  2.   <div id="components-grid-demo-playground">
  3.     <div style="marginBottom:16px">
  4.       <span style="marginRight:6px">Gutter (px): </span>
  5.       <div style="width:50%">
  6.         <a-slider
  7.           :min="0"
  8.           :max="Object.keys(gutters).length - 1"
  9.           v-model="gutterKey"
  10.           :marks="this.gutters"
  11.           :step="null"
  12.         />
  13.       </div>
  14.       <span style="marginRight:6px">Column Count:</span>
  15.       <div style="width:50%">
  16.         <a-slider
  17.           :min="0"
  18.           :max="Object.keys(colCounts).length - 1"
  19.           v-model="colCountKey"
  20.           :marks="this.colCounts"
  21.           :step="null"
  22.         />
  23.       </div>
  24.     </div>
  25.     <a-row :gutter="gutters[gutterKey]">
  26.       <a-col v-for="(item, index) in colCounts[colCountKey]" :key="item.toString()" :span="24/colCounts[colCountKey]">
  27.         <div>Column</div>
  28.       </a-col>
  29.     </a-row>
  30.     <pre v-text="rowColHtml">
  31.     </pre>
  32.   </div>
  33. </template>
  34. <script>
  35.   export default {
  36.     data () {
  37.       const gutters = {}
  38.       const arr = [8, 16, 24, 32, 40, 48]
  39.       arr.forEach((value, i) => { gutters[i] = value; })
  40.       const colCounts = {}
  41.       const arr1 = [2, 3, 4, 6, 8, 12]
  42.       arr1.forEach((value, i) => { colCounts[i] = value; })
  43.       return {
  44.         gutterKey: 1,
  45.         colCountKey: 2,
  46.         colCounts,
  47.         gutters,
  48.       }
  49.     },
  50.     computed: {
  51.       rowColHtml() {
  52.         const colCount = this.colCounts[this.colCountKey]
  53.         const getter = this.gutters[this.gutterKey]
  54.         let colCode = '<Row :gutter="' + getter + '">\n'
  55.         for (let i = 0; i < colCount; i++) {
  56.           const spanNum = 24 / colCount
  57.           colCode += '  <Col :span="' + spanNum + '"/>\n'
  58.         }
  59.         colCode += '</Row>'
  60.         return colCode
  61.       }
  62.     },
  63.   }
  64. </script>
  65. <style scoped>
  66.   #components-grid-demo-playground [class^="ant-col-"] {
  67.     background: transparent;
  68.     border: 0;
  69.   }
  70.   #components-grid-demo-playground [class^="ant-col-"] > div {
  71.     background: #00A0E9;
  72.     height: 120px;
  73.     line-height: 120px;
  74.     font-size: 13px;
  75.   }
  76.   #components-grid-demo-playground pre {
  77.     background: #f9f9f9;
  78.     border-radius: 6px;
  79.     font-size: 13px;
  80.     padding: 8px 16px;
  81.   }
  82. </style>

API

Row

成员说明类型默认值
alignflex 布局下的垂直对齐方式：top middle bottomstringtop
gutter栅格间隔，可以写成像素值或支持响应式的对象写法 { xs: 8, sm: 16, md: 24}number/object0
justifyflex 布局下的水平排列方式：start end center space-around space-betweenstringstart
type布局模式，可选 flex，现代浏览器 下有效string

Col

成员说明类型默认值
offset栅格左侧的间隔格数，间隔内不可以有栅格number0
order栅格顺序，flex 布局模式下有效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 的部分)。