Vant3 AddressList 地址列表

2021-09-14 11:04 更新

介紹

展示收貨地址列表。

實(shí)例演示

引入

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

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

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

代碼演示

基礎(chǔ)用法

<van-address-list
  v-model="chosenAddressId"
  :list="list"
  :disabled-list="disabledList"
  disabled-text="以下地址超出配送范圍"
  default-tag-text="默認(rèn)"
  @add="onAdd"
  @edit="onEdit"
/>
import { ref } from 'vue';
import { Toast } from 'vant';

export default {
  setup() {
    const chosenAddressId = ref('1');
    const list = [
      {
        id: '1',
        name: '張三',
        tel: '13000000000',
        address: '浙江省杭州市西湖區(qū)文三路 138 號(hào)東方通信大廈 7 樓 501 室',
        isDefault: true,
      },
      {
        id: '2',
        name: '李四',
        tel: '1310000000',
        address: '浙江省杭州市拱墅區(qū)莫干山路 50 號(hào)',
      },
    ];
    const disabledList = [
      {
        id: '3',
        name: '王五',
        tel: '1320000000',
        address: '浙江省杭州市濱江區(qū)江南大道 15 號(hào)',
      },
    ];

    const onAdd = () => Toast('新增地址');
    const onEdit = (item, index) => Toast('編輯地址:' + index);

    return {
      list,
      onAdd,
      onEdit,
      disabledList,
      chosenAddressId,
    };
  },
};

API

Props

參數(shù) 說(shuō)明 類型 默認(rèn)值
v-model 當(dāng)前選中地址的 id string -
list 地址列表 Address[] []
disabled-list 不可配送地址列表 Address[] []
disabled-text 不可配送提示文案 string -
switchable 是否允許切換地址 boolean true
add-button-text 底部按鈕文字 string 新增地址
default-tag-text 默認(rèn)地址標(biāo)簽文字 string -

Events

事件名 說(shuō)明 回調(diào)參數(shù)
add 點(diǎn)擊新增按鈕時(shí)觸發(fā) -
edit 點(diǎn)擊編輯按鈕時(shí)觸發(fā) item: Address, index: number
select 切換選中的地址時(shí)觸發(fā) item: Address, index: number
edit-disabled 編輯不可配送的地址時(shí)觸發(fā) item: Address, index: number
select-disabled 選中不可配送的地址時(shí)觸發(fā) item: Address, index: number
click-item 點(diǎn)擊任意地址時(shí)觸發(fā) item: Address, index: number

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

鍵名 說(shuō)明 類型
id 每條地址的唯一標(biāo)識(shí) number | string
name 收貨人姓名 string
tel 收貨人手機(jī)號(hào) number | string
address 收貨地址 string
isDefault 是否為默認(rèn)地址 boolean

Slots

名稱 說(shuō)明 參數(shù)
default 在列表下方插入內(nèi)容 -
top 在頂部插入內(nèi)容 -
item-bottom 在列表項(xiàng)底部插入內(nèi)容 item: Address
tag v3.0.9 自定義列表項(xiàng)標(biāo)簽內(nèi)容 item: Address

樣式變量

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

名稱 默認(rèn)值 描述
--van-address-list-padding var(--van-padding-sm) var(--van-padding-sm) 80px -
--van-address-list-disabled-text-color var(--van-gray-6) -
--van-address-list-disabled-text-padding var(--van-padding-base) * 5 0 var(--van-padding-md) -
--van-address-list-disabled-text-font-size var(--van-font-size-md) -
--van-address-list-disabled-text-line-height var(--van-line-height-md) -
--van-address-list-add-button-z-index 999 -
--van-address-list-item-padding var(--van-padding-sm) -
--van-address-list-item-text-color var(--van-text-color) -
--van-address-list-item-disabled-text-color var(--van-gray-5) -
--van-address-list-item-font-size 13px -
--van-address-list-item-line-height var(--van-line-height-sm) -
--van-address-list-item-radio-icon-color var(--van-danger-color) -
--van-address-list-edit-icon-size 20px -


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

掃描二維碼

下載編程獅App

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

編程獅公眾號(hào)