Vant3 ContactList 聯(lián)系人列表

2021-09-14 11:01 更新

介紹

展示聯(lián)系人列表。

實(shí)例演示

引入

通過(guò)以下方式來(lái)全局注冊(cè)組件,更多注冊(cè)方式請(qǐng)參考組件注冊(cè)

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

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

代碼演示

基礎(chǔ)用法

<van-contact-list
  v-model="state.chosenContactId"
  :list="state.list"
  default-tag-text="默認(rèn)"
  @add="onAdd"
  @edit="onEdit"
  @select="onSelect"
/>
import { reactive } from 'vue';
import { Toast } from 'vant';

export default {
  setup() {
    const state = reactive({
      chosenContactId: '1',
      list: [
        {
          id: '1',
          name: '張三',
          tel: '13000000000',
          isDefault: true,
        },
        {
          id: '2',
          name: '李四',
          tel: '1310000000',
        },
      ],
    });

    const onAdd = () => Toast('新增');
    const onEdit = (contact) => Toast('編輯' + contact.id);
    const onSelect = (contact) => Toast('選擇' + contact.id);

    return {
      state,
      onAdd,
      onEdit,
      onSelect,
    };
  },
};

API

Props

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

Events

事件名 說(shuō)明 回調(diào)參數(shù)
add 點(diǎn)擊新增按鈕時(shí)觸發(fā) -
edit 點(diǎn)擊編輯按鈕時(shí)觸發(fā) contact: Contact,index: number
select 切換選中的聯(lián)系人時(shí)觸發(fā) contact: Contact,index: number

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

鍵名 說(shuō)明 類型
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

樣式變量

組件提供了下列 CSS 變量,可用于自定義樣式,使用方法請(qǐng)參考 ConfigProvider 組件

名稱 默認(rèn)值 描述
--van-contact-list-edit-icon-size 16px -
--van-contact-list-add-button-z-index 999 -
--van-contact-list-item-padding var(--van-padding-md) -
--van-contact-list-item-radio-icon-color var(--van-danger-color) -


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

掃描二維碼

下載編程獅App

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

編程獅公眾號(hào)