Contact 联系人

介绍

通过 Contact 组件可以实现联系人的展示、选择、编辑等功能。

引入

  1. import Vue from 'vue';
  2. import { ContactCard, ContactList, ContactEdit } from 'vant';
  3. Vue.use(ContactCard);
  4. Vue.use(ContactList);
  5. Vue.use(ContactEdit);

代码演示

基础用法

  1. <!-- 联系人卡片 -->
  2. <van-contact-card
  3. :type="cardType"
  4. :name="currentContact.name"
  5. :tel="currentContact.tel"
  6. @click="showList = true"
  7. />
  8. <!-- 联系人列表 -->
  9. <van-popup v-model="showList" position="bottom">
  10. <van-contact-list
  11. v-model="chosenContactId"
  12. :list="list"
  13. @add="onAdd"
  14. @edit="onEdit"
  15. @select="onSelect"
  16. />
  17. </van-popup>
  18. <!-- 联系人编辑 -->
  19. <van-popup v-model="showEdit" position="bottom">
  20. <van-contact-edit
  21. :contact-info="editingContact"
  22. :is-edit="isEdit"
  23. @save="onSave"
  24. @delete="onDelete"
  25. />
  26. </van-popup>
  1. export default {
  2. data() {
  3. return {
  4. chosenContactId: null,
  5. editingContact: {},
  6. showList: false,
  7. showEdit: false,
  8. isEdit: false,
  9. list: [
  10. {
  11. name: '张三',
  12. tel: '13000000000',
  13. id: 0,
  14. },
  15. ],
  16. };
  17. },
  18. computed: {
  19. cardType() {
  20. return this.chosenContactId !== null ? 'edit' : 'add';
  21. },
  22. currentContact() {
  23. const id = this.chosenContactId;
  24. return id !== null ? this.list.filter((item) => item.id === id)[0] : {};
  25. },
  26. },
  27. methods: {
  28. // 添加联系人
  29. onAdd() {
  30. this.editingContact = { id: this.list.length };
  31. this.isEdit = false;
  32. this.showEdit = true;
  33. },
  34. // 编辑联系人
  35. onEdit(item) {
  36. this.isEdit = true;
  37. this.showEdit = true;
  38. this.editingContact = item;
  39. },
  40. // 选中联系人
  41. onSelect() {
  42. this.showList = false;
  43. },
  44. // 保存联系人
  45. onSave(info) {
  46. this.showEdit = false;
  47. this.showList = false;
  48. if (this.isEdit) {
  49. this.list = this.list.map((item) =>
  50. item.id === info.id ? info : item
  51. );
  52. } else {
  53. this.list.push(info);
  54. }
  55. this.chosenContactId = info.id;
  56. },
  57. // 删除联系人
  58. onDelete(info) {
  59. this.showEdit = false;
  60. this.list = this.list.filter((item) => item.id !== info.id);
  61. if (this.chosenContactId === info.id) {
  62. this.chosenContactId = null;
  63. }
  64. },
  65. },
  66. };

不可编辑

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

API

ContactCard Props

参数说明类型默认值
type类型,可选值为 add editstringadd
name联系人姓名string-
tel联系人手机号string-
add-text添加时的文案提示string添加订单联系人信息

ContactCard Events

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

ContactList Props

参数说明类型默认值
v-model当前选中联系人的 idnumber | string-
list联系人列表Contact[][]
add-text新建按钮文案string新建联系人
default-tag-text v2.3.0默认联系人标签文案string-

ContactList Events

事件名说明回调参数
add点击新增按钮时触发-
edit点击编辑按钮时触发item: 当前联系人对象,index: 索引
select切换选中的联系人时触发item: 当前联系人对象,index: 索引

ContactEdit Props

参数说明类型默认值
contact-info联系人信息object[]
is-edit是否为编辑联系人booleanfalse
is-saving是否显示保存按钮加载动画booleanfalse
is-deleting是否显示删除按钮加载动画booleanfalse
tel-validator手机号格式校验函数(tel: string) => boolean-
show-set-default v2.3.0是否显示默认联系人栏booleanfalse
set-default-label v2.3.0默认联系人栏文案string-

ContactEdit Events

事件名说明回调参数
save点击保存按钮时触发content:表单内容
delete点击删除按钮时触发content:表单内容

Contact 数据结构

键名说明类型
id每位联系人的唯一标识number | string
name联系人姓名string
tel联系人手机号number | string
isDefault是否为默认联系人boolean

Contact 联系人 - 图1