• Grid 栅格
    • 设计理念
    • 概述
    • Flex 布局
    • 代码演示
      • 基础栅格
      • Flex 对齐
      • Flex 排序
      • Flex 布局
      • 区块间隔
      • 左右偏移
      • 其他属性的响应式
      • 响应式布局
      • 栅格排序
      • 栅格配置器
  • API
    • Row
    • Col

    Grid 栅格

    24 栅格系统。

    设计理念

    Grid 栅格 - 图1

    在多数业务情况下，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 栅格 - 图2

    基础栅格

    从堆叠到水平排列。使用单一的一组 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 栅格 - 图3

    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 栅格 - 图4

    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 栅格 - 图5

    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 栅格 - 图6

    区块间隔

    栅格常常需要和间隔进行配合，你可以使用 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 栅格 - 图7

    左右偏移

    列偏移。使用 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 栅格 - 图8

    其他属性的响应式

    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 栅格 - 图9

    响应式布局

    参照 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 栅格 - 图10

    栅格排序

    列排序。通过使用 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 栅格 - 图11

    栅格配置器

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

    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
    27.         v-for="(item, index) in colCounts[colCountKey]"
    28.         :key="item.toString()"
    29.         :span="24/colCounts[colCountKey]"
    30.       >
    31.         <div>Column</div>
    32.       </a-col>
    33.     </a-row>
    34.     <pre v-text="rowColHtml"></pre>
    35.   </div>
    36. </template>
    37. <script>
    38.   export default {
    39.     data() {
    40.       const gutters = {};
    41.       const arr = [8, 16, 24, 32, 40, 48];
    42.       arr.forEach((value, i) => {
    43.         gutters[i] = value;
    44.       });
    45.       const colCounts = {};
    46.       const arr1 = [2, 3, 4, 6, 8, 12];
    47.       arr1.forEach((value, i) => {
    48.         colCounts[i] = value;
    49.       });
    50.       return {
    51.         gutterKey: 1,
    52.         colCountKey: 2,
    53.         colCounts,
    54.         gutters,
    55.       };
    56.     },
    57.     computed: {
    58.       rowColHtml() {
    59.         const colCount = this.colCounts[this.colCountKey];
    60.         const getter = this.gutters[this.gutterKey];
    61.         let colCode = '<Row :gutter="' + getter + '">\n';
    62.         for (let i = 0; i < colCount; i++) {
    63.           const spanNum = 24 / colCount;
    64.           colCode += '  <Col :span="' + spanNum + '"/>\n';
    65.         }
    66.         colCode += '</Row>';
    67.         return colCode;
    68.       },
    69.     },
    70.   };
    71. </script>
    72. <style scoped>
    73.   #components-grid-demo-playground [class^='ant-col-'] {
    74.     background: transparent;
    75.     border: 0;
    76.   }
    77.   #components-grid-demo-playground [class^='ant-col-'] > div {
    78.     background: #00a0e9;
    79.     height: 120px;
    80.     line-height: 120px;
    81.     font-size: 13px;
    82.   }
    83.   #components-grid-demo-playground pre {
    84.     background: #f9f9f9;
    85.     border-radius: 6px;
    86.     font-size: 13px;
    87.     padding: 8px 16px;
    88.   }
    89. </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 的部分)。