Vant4 ContactCard 联系人卡片
介绍
以卡片的形式展示联系人信息。
引入
通过以下方式来全局注册组件,更多注册方式请参考组件注册。
import { createApp } from 'vue';
import { ContactCard } from 'vant';
const app = createApp();
app.use(ContactCard);
代码演示
添加联系人
<van-contact-card type="add" @click="onAdd" />
import { showToast } from 'vant';
export default {
setup() {
const onAdd = () => showToast('新增');
return {
onAdd,
};
},
};
编辑联系人
<van-contact-card type="edit" :tel="tel" :name="name" @click="onEdit" />
import { ref } from 'vue';
import { showToast } from 'vant';
export default {
setup() {
const tel = ref('13000000000');
const name = ref('张三');
const onEdit = () => showToast('edit');
return {
tel,
name,
onEdit,
};
},
};
不可编辑
<van-contact-card type="edit" name="张三" tel="13000000000" :editable="false" />
API
Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
type | 卡片类型,可选值为 edit
|
string | add
|
name | 联系人姓名 | string | - |
tel | 联系人手机号 | string | - |
add-text | 添加时的文案提示 | string | 添加联系人
|
editable | 是否可以编辑联系人 | boolean | true
|
Events
事件名 | 说明 | 回调参数 |
---|---|---|
click | 点击时触发 | event: MouseEvent |
类型定义
组件导出以下类型定义:
import type { ContactCardType, ContactCardProps } from 'vant';
主题定制
样式变量
组件提供了下列 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-title-line-height | var(--van-line-height-md) | - |