vant/src/col

Layout

Intro

Quickly and easily create layouts with van-row and van-col

Install

import Vue from 'vue';
import { Row, Col } from 'vant';

Vue.use(Row).use(Col);

Usage

Basic Usage

Layout are based on 24-column. The attribute span in Col means the number of column the grid spans. Of course, You can use offset attribute to set number of spacing on the left side of the grid.

<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-col span="6">span: 6</van-col>
</van-row>

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

Column Spacing

Set grid spacing using gutter attribute. The default value is 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>

Flex Layout

Setting type to flex to enable flex layout

<van-row type="flex">
  <van-col span="6">span: 6</van-col>
  <van-col span="6">span: 6</van-col>
  <van-col span="6">span: 6</van-col>
</van-row>

<van-row type="flex" justify="center">
  <van-col span="6">span: 6</van-col>
  <van-col span="6">span: 6</van-col>
  <van-col span="6">span: 6</van-col>
</van-row>

<van-row type="flex" justify="end">
  <van-col span="6">span: 6</van-col>
  <van-col span="6">span: 6</van-col>
  <van-col span="6">span: 6</van-col>
</van-row>

<van-row type="flex" justify="space-between">
  <van-col span="6">span: 6</van-col>
  <van-col span="6">span: 6</van-col>
  <van-col span="6">span: 6</van-col>
</van-row>

<van-row type="flex" justify="space-around">
  <van-col span="6">span: 6</van-col>
  <van-col span="6">span: 6</van-col>
  <van-col span="6">span: 6</van-col>
</van-row>

API

Row Props

Attribute	Description	Type	Default	Version
type	Layout type, can be set to flex	string	-	-
gutter	Grid spacing（px）	string | number	-	-
tag	Custom element tag	string	div	-
justify	Flex main axis，can be set to end/center/space-around/space-between	string	start	-
align	Flex cross axis, be set to center/bottom	string	top	-

Col Props

Attribute	Description	Type	Default	Version
span	number of column the grid spans	string | number	-	-
offset	number of spacing on the left side of the grid	string | number	-	-
tag	Custom element tag	string	div	-

Row Events

Event	Description	Arguments
click	Triggered when click row	event: Event

Col Events

Event	Description	Arguments
click	Triggered when click col	event: Event