mirror of
https://gitee.com/vant-contrib/vant.git
synced 2025-11-05 21:22:09 +08:00
Card
Intro
Used to display product pictures, prices and other information.
Install
Register component globally via app.use, refer to Component Registration for more registration ways.
import { createApp } from 'vue';
import { Card } from 'vant';
const app = createApp();
app.use(Card);
Usage
Basic Usage
<van-card
num="2"
price="2.00"
title="Title"
desc="Description"
thumb="https://img.yzcdn.cn/vant/ipad.jpeg"
/>
Discount Info
<van-card
num="2"
tag="Tag"
price="2.00"
title="Title"
desc="Description"
origin-price="10.00"
thumb="https://img.yzcdn.cn/vant/ipad.jpeg"
/>
Custom Content
Use slot to custom content.
<van-card
num="2"
title="Title"
desc="Description"
price="2.00"
thumb="https://img.yzcdn.cn/vant/ipad.jpeg"
>
<template #tags>
<van-tag plain type="danger">Tag</van-tag>
<van-tag plain type="danger">Tag</van-tag>
</template>
<template #footer>
<van-button size="mini">Button</van-button>
<van-button size="mini">Button</van-button>
</template>
</van-card>
API
Props
| Attribute | Description | Type | Default |
|---|---|---|---|
| thumb | Left thumb image URL | string | - |
| title | Title | string | - |
| desc | Description | string | - |
| tag | Tag | string | - |
| num | number | number | string | - |
| price | Price | number | string | - |
| origin-price | Origin price | number | string | - |
| centered | Whether content vertical centered | boolean | false |
| currency | Currency symbol | string | ¥ |
| thumb-link | Thumb link URL | string | - |
| lazy-load | Whether to enable thumb lazy load,should register Lazyload component | boolean | false |
Events
| Event | Description | Arguments |
|---|---|---|
| click | Emitted when component is clicked | event: MouseEvent |
| click-thumb | Emitted when thumb is clicked | event: MouseEvent |
Slots
| Name | Description |
|---|---|
| title | Custom title |
| desc | Custom description |
| num | Custom num |
| price | Custom price |
| origin-price | Custom origin price |
| price-top | Custom price top |
| bottom | Custom price bottom |
| thumb | Custom thumb |
| tag | Custom thumb tag |
| tags | Custom tags |
| footer | Custom footer |
Less Variables
How to use: Custom Theme.
| Name | Default Value | Description |
|---|---|---|
| @card-padding | @padding-xs @padding-md |
- |
| @card-font-size | @font-size-sm |
- |
| @card-text-color | @text-color |
- |
| @card-background-color | @background-color-light |
- |
| @card-thumb-size | 88px |
- |
| @card-thumb-border-radius | @border-radius-lg |
- |
| @card-title-line-height | 16px |
- |
| @card-desc-color | @gray-7 |
- |
| @card-desc-line-height | @line-height-md |
- |
| @card-price-color | @gray-8 |
- |
| @card-origin-price-color | @gray-6 |
- |
| @card-num-color | @gray-6 |
- |
| @card-origin-price-font-size | @font-size-xs |
- |
| @card-price-font-size | @font-size-sm |
- |
| @card-price-integer-font-size | @font-size-lg |
- |
| @card-price-font-family | @price-integer-font-family |
- |