介绍

以卡片的形式展示联系人信息。

实例演示

引入

通过以下方式来全局注册组件，更多注册方式请参考组件注册。

import { createApp } from 'vue';
import { ContactCard } from 'vant';

const app = createApp();
app.use(ContactCard);

代码演示

添加联系人

<van-contact-card type="add" @click="onAdd" />

import { Toast } from 'vant';

export default {
  setup() {
    const onAdd = () => Toast('新增');
    return {
      onAdd,
    };
  },
};

编辑联系人

<van-contact-card
  type="edit"
  :name="currentContact.name"
  :tel="currentContact.tel"
  @click="onEdit"
/>

import { reactive } from 'vue';
import { Toast } from 'vant';

export default {
  setup() {
    const currentContact = reactive({
      name: '张三',
      tel: '13000000000',
    });
    const onEdit = () => Toast('edit');

    return {
      onEdit,
      currentContact,
    };
  },
};

不可编辑

<van-contact-card type="edit" name="张三" tel="13000000000" :editable="false" />

API

Props

参数	说明	类型	默认值
type	卡片类型，可选值为 edit	string	add
name	联系人姓名	string	-
tel	联系人手机号	string	-
add-text	添加时的文案提示	string	添加联系人

Events

事件名	说明	回调参数
click	点击时触发	event: MouseEvent

样式变量

组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 ConfigProvider 组件。

名称	默认值	描述
--van-contact-card-padding	var(--van-padding-md)	-
--van-contact-card-add-icon-size	40px	-
--van-contact-card-add-icon-color	var(--van-primary-color)	-
--van-contact-card-value-line-height	var(--van-line-height-md)	-