# Layout 布局

### 介绍

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

### 引入

在`index.config.js中引入组件

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

## 代码演示

### 基本用法

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

```html
<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

```html
<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
### 注:属性应用在组件上需要统一使用驼峰式命名，如custom-class应变为
```html
<van-button type="primary" customClass='myClass' size="large">大号按钮</van-button>
```
### 注:事件应用在组件上需要统一使用驼峰式命名，如bind:click/bind:search/bind:before-enter应变为
```html
<van-button type="primary" onClick={()=>this.onClick()}>大号按钮</van-button>
<van-search type="primary" onSearch={()=>this.onSearch()}>大号按钮</van-search>
<van-transition type="primary" onBeforeEnter={()=>this.onBeforeEnter()}>大号按钮</van-transition>
```
### Row Props

| 参数   | 说明                          | 类型               | 默认值 | 版本 |
| ------ | ----------------------------- | ------------------ | ------ | ---- |
| gutter | 列元素之间的间距（单位为 px） | _string \| number_ | -      | -    |

### Col Props

| 参数   | 说明           | 类型               | 默认值 | 版本 |
| ------ | -------------- | ------------------ | ------ | ---- |
| span   | 列元素宽度     | _string \| number_ | -      | -    |
| offset | 列元素偏移距离 | _string \| number_ | -      | -    |

### 外部样式类

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