Vant Contact 聯(lián)系人

2022-05-31 13:40 更新

介紹

通過 Contact 組件可以實(shí)現(xiàn)聯(lián)系人的展示、選擇、編輯等功能。

引入

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

Vue.use(ContactCard);
Vue.use(ContactList);
Vue.use(ContactEdit);

代碼演示

基礎(chǔ)用法

<!-- 聯(lián)系人卡片 -->
<van-contact-card
  :type="cardType"
  :name="currentContact.name"
  :tel="currentContact.tel"
  @click="showList = true"
/>

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

<!-- 聯(lián)系人編輯 -->
<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: {
    // 添加聯(lián)系人
    onAdd() {
      this.editingContact = { id: this.list.length };
      this.isEdit = false;
      this.showEdit = true;
    },

    // 編輯聯(lián)系人
    onEdit(item) {
      this.isEdit = true;      
      this.showEdit = true;
      this.editingContact = item;
    },

    // 選中聯(lián)系人
    onSelect() {
      this.showList = false;
    },

    // 保存聯(lián)系人
    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;
    },

    // 刪除聯(lián)系人
    onDelete(info) {
      this.showEdit = false;
      this.list = this.list.filter(item => item.id !== info.id);
      if (this.chosenContactId === info.id) {
        this.chosenContactId = null;
      }
    }
  }
};

不可編輯

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

API

ContactCard Props

參數(shù)說明類型默認(rèn)值
type類型,可選值為 add editstringadd
name聯(lián)系人姓名string-
tel聯(lián)系人手機(jī)號(hào)string-
add-text添加時(shí)的文案提示string添加訂單聯(lián)系人信息

ContactCard Events

事件名說明回調(diào)參數(shù)
click點(diǎn)擊時(shí)觸發(fā)event: Event

ContactList Props

參數(shù)說明類型默認(rèn)值
v-model當(dāng)前選中聯(lián)系人的 idnumber | string-
list聯(lián)系人列表Contact[][]
add-text新建按鈕文案string新建聯(lián)系人
default-tag-text v2.3.0默認(rèn)聯(lián)系人標(biāo)簽文案string-

ContactList Events

事件名說明回調(diào)參數(shù)
add點(diǎn)擊新增按鈕時(shí)觸發(fā)-
edit點(diǎn)擊編輯按鈕時(shí)觸發(fā)item: 當(dāng)前聯(lián)系人對(duì)象,index: 索引
select切換選中的聯(lián)系人時(shí)觸發(fā)item: 當(dāng)前聯(lián)系人對(duì)象,index: 索引

ContactEdit Props

參數(shù)說明類型默認(rèn)值
contact-info聯(lián)系人信息object[]
is-edit是否為編輯聯(lián)系人booleanfalse
is-saving是否顯示保存按鈕加載動(dòng)畫booleanfalse
is-deleting是否顯示刪除按鈕加載動(dòng)畫booleanfalse
tel-validator手機(jī)號(hào)格式校驗(yàn)函數(shù)(tel: string) => boolean-
show-set-default v2.3.0是否顯示默認(rèn)聯(lián)系人欄booleanfalse
set-default-label v2.3.0默認(rèn)聯(lián)系人欄文案string-

ContactEdit Events

事件名說明回調(diào)參數(shù)
save點(diǎn)擊保存按鈕時(shí)觸發(fā)content:表單內(nèi)容
delete點(diǎn)擊刪除按鈕時(shí)觸發(fā)content:表單內(nèi)容

Contact 數(shù)據(jù)結(jié)構(gòu)

鍵名說明類型
id每位聯(lián)系人的唯一標(biāo)識(shí)number | string
name聯(lián)系人姓名string
tel聯(lián)系人手機(jī)號(hào)number | string
isDefault是否為默認(rèn)聯(lián)系人boolean


實(shí)例演示

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)