Apq/semi-design: 快速搭建美观的 React 应用。由抖音前端与 UED 团队维护。 @ fix/scss_compiler_localSCSS_support

localeCode: zh-CN order: 9 category: 基础 title: Grid 布局 icon: doc-grid dir: column

brief: 24 栅格系统。

概述

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

弹性布局

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

代码演示

如何引入

import { Col, Row } from '@douyinfe/semi-ui';

基础使用

从堆叠到水平排列。

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

import React from 'react';
import { Col, Row } from '@douyinfe/semi-ui';

() => (
  <div className="grid">
      <Row>
          <Col span={24}><div className="col-content">col-24</div></Col>
      </Row>
      <br/>
      <Row>
          <Col span={12}><div className="col-content">col-12</div></Col>
          <Col span={12}><div className="col-content">col-12</div></Col>
      </Row>
      <br/>
      <Row>
          <Col span={8}><div className="col-content">col-8</div></Col>
          <Col span={8}><div className="col-content">col-8</div></Col>
          <Col span={8}><div className="col-content">col-8</div></Col>
      </Row>
      <br/>
      <Row>
          <Col span={6}><div className="col-content">col-6</div></Col>
          <Col span={6}><div className="col-content">col-6</div></Col>
          <Col span={6}><div className="col-content">col-6</div></Col>
          <Col span={6}><div className="col-content">col-6</div></Col>
      </Row>
  </div>
)

Gutter 间隔

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

垂直间隔可以使用数组形式，数组第一项为横向间隔，第二项为垂直间隔。

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

从1.11.0版本起支持数组形式的垂直间隔

深色为内容物区域，浅色为间隔

import React from 'react';
import { Col, Row } from '@douyinfe/semi-ui';

() => (
  <div className="grid grid-gutter">
    <p>horizontal</p>
    <hr />
    <Row gutter={16}>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
    </Row>
    <p>vertical</p>
    <hr />
    <Row gutter={[16, 24]}>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6}>
        <div className="col-content">col-6</div>
      </Col>
    </Row>
  </div>
)

Offset 偏移

import React from 'react';
import { Col, Row } from '@douyinfe/semi-ui';

() => (
  <div className="grid">
    <Row>
      <Col span={8}><div className="col-content">col-8</div></Col>
      <Col span={8} offset={8}>
        <div className="col-content">col-8</div>
      </Col>
    </Row>
    <br/>
    <Row>
      <Col span={6} offset={6}>
        <div className="col-content">col-6</div>
      </Col>
      <Col span={6} offset={6}>
        <div className="col-content">col-6</div>
      </Col>
    </Row>
    <br/>
    <Row>
      <Col span={12} offset={6}>
        <div className="col-content">col-12</div>
      </Col>
    </Row>
  </div>
)

Flex 布局

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

import React from 'react';
import { Col, Row } from '@douyinfe/semi-ui';

() => (
  <div className="grid">
    <p>sub-element align left</p>
    <Row type="flex" justify="start">
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
    </Row>

    <p>sub-element align center</p>
    <Row type="flex" justify="center">
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
    </Row>

    <p>sub-element align right</p>
    <Row type="flex" justify="end">
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
    </Row>

    <p>sub-element monospaced arrangement</p>
    <Row type="flex" justify="space-between">
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
    </Row>

    <p>sub-element align full</p>
    <Row type="flex" justify="space-around">
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
        <Col span={4}><div className="col-content">col-4</div></Col>
    </Row>
  </div>
)

Flex 子元素垂直对齐

import React from 'react';
import { Col, Row } from '@douyinfe/semi-ui';

() => (
  <div className="grid grid-flex">
      <p>Align Top</p>
      <Row type="flex" justify="center" align="top">
          <Col span={4}><div className="col-content" value={100}>col-4</div></Col>
          <Col span={4}><div className="col-content" value={50}>col-4</div></Col>
          <Col span={4}><div className="col-content" value={120}>col-4</div></Col>
          <Col span={4}><div className="col-content" value={80}>col-4</div></Col>
      </Row>

      <p>Align Center</p>
      <Row type="flex" justify="space-around" align="middle">
          <Col span={4}><div className="col-content" value={100}>col-4</div></Col>
          <Col span={4}><div className="col-content" value={50}>col-4</div></Col>
          <Col span={4}><div className="col-content" value={120}>col-4</div></Col>
          <Col span={4}><div className="col-content" value={80}>col-4</div></Col>
      </Row>

      <p>Align Bottom</p>
      <Row type="flex" justify="space-between" align="bottom">
          <Col span={4}><div className="col-content" value={100}>col-4</div></Col>
          <Col span={4}><div className="col-content" value={50}>col-4</div></Col>
          <Col span={4}><div className="col-content" value={120}>col-4</div></Col>
          <Col span={4}><div className="col-content" value={80}>col-4</div></Col>
      </Row>
  </div>
)

Flex 元素排序

通过 Flex 布局的 Order 来改变元素的排序。

import React from 'react';
import { Col, Row } from '@douyinfe/semi-ui';

() => (
  <div className="grid">
    <Row type="flex">
      <Col span={6} order={4}><div className="col-content">col-4</div></Col>
      <Col span={6} order={3}><div className="col-content">col-3</div></Col>
      <Col span={6} order={2}><div className="col-content">col-2</div></Col>
      <Col span={6} order={1}><div className="col-content">col-1</div></Col>
    </Row>
  </div>
)

响应式

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

import React from 'react';
import { Col, Row } from '@douyinfe/semi-ui';

() => (
 <div className="grid">
    <Row gutter={{xs:16,sm:16,md:16,lg:24,xl:24,xxl:24}}>
        <Col xs={2} sm={4} md={6} lg={8} xl={10}><div className="col-content">Col</div></Col>
        <Col xs={20} sm={16} md={12} lg={8} xl={4}><div className="col-content">Col</div></Col>
        <Col xs={2} sm={4} md={6} lg={8} xl={10}><div className="col-content">Col</div></Col>
    </Row>
    <br/>
    <Row>
        <Col xs={{ span: 5, offset: 1 }} lg={{ span: 6, offset: 2 }}><div className="col-content">Col</div></Col>
        <Col xs={{ span: 11, offset: 1 }} lg={{ span: 6, offset: 2 }}><div className="col-content">Col</div></Col>
        <Col xs={{ span: 5, offset: 1 }} lg={{ span: 6, offset: 2 }}><div className="col-content">Col</div></Col>
    </Row>
  </div>
)

API 参考

Row

| 属性 | 说明 | 类型 | 默认值 | | -- | -- | -- | -- | | align | flex 布局下的垂直对齐方式：top middle bottom | string | | | className | 类名 | string| | | gutter | 栅格间隔，可以写成像素值或支持响应式的对象写法 { xs: 8, sm: 16, md: 24}
从1.11.0版本起支持垂直间隔 | number|object|Array | | | justify | flex 布局下的水平排列方式：start end center space-around space-between | string | start | | style | 自定义样式 | CSSProperties | | | type | 布局模式，可选 flex，现代浏览器下有效 | string | |

Col

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

index.md 11 KB

永久链接 文件历史 原始文件

brief: 24 栅格系统。

概述

弹性布局

代码演示

如何引入

基础使用

Gutter 间隔

Offset 偏移

Flex 布局

Flex 子元素垂直对齐

Flex 元素排序

响应式

API 参考

Row

Col

设计变量

index.md 11 KB 永久链接 文件历史 原始文件

brief: 24 栅格系统。

概述

弹性布局

代码演示

如何引入

基础使用

Gutter 间隔

Offset 偏移

Flex 布局

Flex 子元素垂直对齐

Flex 元素排序

响应式

API 参考

Row

Col

设计变量

index.md 11 KB

永久链接文件历史原始文件