vant-weapp/packages/col

Layout 布局

介绍

Layout 提供了van-row和van-col两个组件来进行行列布局。

引入

在app.json或index.json中引入组件，详细介绍见快速上手。

"usingComponents": {
  "van-row": "@vant/weapp/row/index",
  "van-col": "@vant/weapp/col/index"
}

代码演示

基本用法

Layout 组件提供了24列栅格，通过在Col上添加span属性设置列所占的宽度百分比。此外，添加offset属性可以设置列的偏移宽度，计算方式与 span 相同。

<van-row>
  <van-col span="8">span: 8</van-col>
  <van-col span="8">span: 8</van-col>
  <van-col span="8">span: 8</van-col>
</van-row>

<van-row>
  <van-col span="4">span: 4</van-col>
  <van-col span="10" offset="4">offset: 4, span: 10</van-col>
</van-row>

<van-row>
  <van-col offset="12" span="12">offset: 12, span: 12</van-col>
</van-row>

设置列元素间距

通过gutter属性可以设置列元素之间的间距，默认间距为 0。

<van-row gutter="20">
  <van-col span="8">span: 8</van-col>
  <van-col span="8">span: 8</van-col>
  <van-col span="8">span: 8</van-col>
</van-row>

API

Row Props

参数	说明	类型	默认值
gutter	列元素之间的间距（单位为 px）	string | number	-

Col Props

参数	说明	类型	默认值
span	列元素宽度	string | number	-
offset	列元素偏移距离	string | number	-

外部样式类

类名	说明
custom-class	根节点样式类