介紹
展示收貨地址列表。
實(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
|
- |
更多建議: