ant-design-vue/components/grid/index.zh-CN.md
果冻橙 f265a7bb02
fix docs dark theme & add docs coverDark (#6367)
* fix docs dark theme & add docs coverDark

* fix theme Editor edit
2023-03-20 11:15:02 +08:00

4.4 KiB
Raw Blame History

category subtitle type cols title cover coverDark
Components 栅格 布局 1 Grid https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*mfJeS6cqZrEAAAAAAAAAAAAADrJ8AQ/original https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*DLUwQ4B2_zQAAAAAAAAAAAAADrJ8AQ/original

24 栅格系统。

设计理念

grid design

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

概述

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

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

Flex 布局

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

API

Row

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

Col

成员 说明 类型 默认值 版本
flex flex 布局填充 string|number -
offset 栅格左侧的间隔格数,间隔内不可以有栅格 number 0
order 栅格顺序,flex 布局模式下有效 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 -
xxxl ≥2000px 响应式栅格,可为栅格数或一个包含其他属性的对象 number|object - 3.0

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