vant/docs/examples-docs/en-US/contact.md

<script> export default { data() { return { chosenContactId: null, editingContact: {}, showList: false, showEdit: false, isEdit: false, list: [{ name: '张三', tel: '13000000000', id: 0 }] }; }, computed: { cardType() { return this.chosenContactId !== null ? 'edit' : 'add'; }, currentContact() { const id = this.chosenContactId; return id !== null ? this.list.filter(item => item.id === id)[0] : {}; } }, methods: { onAdd() { this.editingContact = { id: this.list.length }; this.isEdit = false; this.showEdit = true; }, onEdit(item) { this.isEdit = true; this.showEdit = true; this.editingContact = item; }, onSelect() { this.showList = false; }, onSave(info) { this.showEdit = false; this.showList = false; if (this.isEdit) { this.list = this.list.map(item => item.id === info.id ? info : item); } else { this.list.push(info); } this.chosenContactId = info.id; }, onDelete(info) { this.showEdit = false; this.list = this.list.filter(item => item.id !== info.id); if (this.chosenContactId === info.id) { this.chosenContactId = null; } } } }; </script>

Contact

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

Install

import { ContactCard, ContactList, ContactEdit } from 'vant';

Vue.component(ContactCard.name, ContactCard);
Vue.component(ContactList.name, ContactList);
Vue.component(ContactEdit.name, ContactEdit);

Usage

Basic Usage

:::demo Basic Usage

<!-- 联系人卡片 -->
<van-contact-card
  :type="cardType"
  :name="currentContact.name"
  :tel="currentContact.tel"
  @click="showList = true"
></van-contact-card>

<!-- 联系人列表 -->
<van-popup v-model="showList" position="bottom">
  <van-contact-list
    v-model="chosenContactId"
    :list="list"
    @add="onAdd"
    @edit="onEdit"
    @select="onSelect"
  />
</van-popup>

<!-- 联系人编辑 -->
<van-popup v-model="showEdit" position="bottom">
  <van-contact-edit
    :contact-info="editingContact"
    :is-edit="isEdit"
    @save="onSave"
    @delete="onDelete"
  />
</van-popup>

export default {
  data() {
    return {
      chosenContactId: null,
      editingContact: {},
      showList: false,
      showEdit: false,
      isEdit: false,
      list: [{
        name: '张三',
        tel: '13000000000',
        id: 0
      }]
    };
  },

  computed: {
    cardType() {
      return this.chosenContactId !== null ? 'edit' : 'add';
    },

    currentContact() {
      const id = this.chosenContactId;
      return id !== null ? this.list.filter(item => item.id === id)[0] : {};
    }
  },

  methods: {
    // 添加联系人
    onAdd() {
      this.editingContact = { id: this.list.length };
      this.isEdit = false;
      this.showEdit = true;
    },

    // 编辑联系人
    onEdit(item) {
      this.isEdit = true;      
      this.showEdit = true;
      this.editingContact = item;
    },

    // 选中联系人
    onSelect() {
      this.showList = false;
    },

    // 保存联系人
    onSave(info) {
      this.showEdit = false;
      this.showList = false;
      
      if (this.isEdit) {
        this.list = this.list.map(item => item.id === info.id ? info : item);
      } else {
        this.list.push(info);
      }
      this.chosenContactId = info.id;
    },

    // 删除联系人
    onDelete(info) {
      this.showEdit = false;
      this.list = this.list.filter(item => item.id !== info.id);
      if (this.chosenContactId === info.id) {
        this.chosenContactId = null;
      }
    }
  }
};

:::

ContactCard API

Attribute	Description	Type	Default	Accepted Values
type	Type，分为添加和编辑两种样式	String	add	edit
addText	添加时的文案提示	String	添加订单联系人信息	-
name	联系人姓名	String	-	-
tel	联系人手机号	String	-	-

ContactList API

Attribute	Description	Type	Default	Accepted Values
v-model	当前选中联系人的 id	`String	Number`	-
addText	新建按钮文案	String	新建联系人	-
list	联系人列表	Array	[]	-

ContactList Event

Event	Description	Attribute
add	点击新增按钮时触发	-
edit	点击编辑按钮时触发	item: 当前联系人对象，index: 索引
select	切换选中的联系人时触发	item: 当前联系人对象，index: 索引

ContactEdit API

Attribute	Description	Type	Default	Accepted Values
contactInfo	联系人信息	Object	[]	-
isEdit	是否为编辑联系人	Boolean	false	-
isSaving	是否显示保存按钮加载动画	Boolean	false	-
isDeleting	是否显示删除按钮加载动画	Boolean	false	-

ContactEdit Event

Event	Description	Attribute
save	点击保存按钮时触发	content：表单内容
delete	点击删除按钮时触发	content：表单内容

Data Structure

联系人Data Structure

key	Description	Type
id	每位联系人的唯一标识	`String
name	联系人姓名	String
tel	联系人手机号	String