vant/src/col

Layout

Intro

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

Install

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

const app = createApp();
app.use(Col);
app.use(Row);

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>

Justify Content

<van-row 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 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 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 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
gutter	Grid spacing（px）	number | string	-
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
span	number of column the grid spans	number | string	-
offset	number of spacing on the left side of the grid	number | string	-
tag	Custom element tag	string	div

Row Events

Event	Description	Arguments
click	Emitted when the row is clicked	event: MouseEvent

Col Events

Event	Description	Arguments
click	Emitted when the col is clicked	event: MouseEvent