import{o as a,a as n,y as t}from"./vue-libs.b44bc779.js";const l={class:"van-doc-markdown-body"},p=t(`
Quickly and easily create layouts with van-row
and van-col
.
Register component globally via app.use
, refer to Component Registration for more registration ways.
import { createApp } from 'vue';
import { Col, Row } from 'vant';
const app = createApp();
app.use(Col);
app.use(Row);
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>
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>
<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>
Attribute | Description | Type | Default |
---|---|---|---|
gutter | Grid spacing\uFF08px\uFF09 | 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 |
wrap v3.0.11 | Whether to wrap | boolean | true |
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 |
Event | Description | Arguments |
---|---|---|
click | Emitted when the row is clicked | event: MouseEvent |
Event | Description | Arguments |
---|---|---|
click | Emitted when the col is clicked | event: MouseEvent |
The component exports the following type definitions:
import type { ColProps, RowProps, RowAlign, RowJustify } from 'vant';