展示地址信息列表。
通过以下方式来全局注册组件,更多注册方式请参考组件注册。
import { createApp } from "vue";
import { AddressList } from "vant";
const app = createApp();
app.use(AddressList);
<van-address-list
v-model="chosenAddressId"
:list="list"
:disabled-list="disabledList"
disabled-text="以下地址超出配送范围"
default-tag-text="默认"
@add="onAdd"
@edit="onEdit"
/>
import { ref } from "vue";
import { showToast } from "vant";
export default {
setup() {
const chosenAddressId = ref("1");
const list = [
{
id: "1",
name: "张三",
tel: "13000000000",
address: "浙江省杭州市西湖区文三路 138 号东方通信大厦 7 楼 501 室",
isDefault: true,
},
{
id: "2",
name: "李四",
tel: "1310000000",
address: "浙江省杭州市拱墅区莫干山路 50 号",
},
];
const disabledList = [
{
id: "3",
name: "王五",
tel: "1320000000",
address: "浙江省杭州市滨江区江南大道 15 号",
},
];
const onAdd = () => showToast("新增地址");
const onEdit = (item, index) => showToast("编辑地址:" + index);
return {
list,
onAdd,
onEdit,
disabledList,
chosenAddressId,
};
},
};
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
v-model | 当前选中地址的 id | string | - |
list | 地址列表 | AddressListAddress[] | []
|
disabled-list | 不可配送地址列表 | AddressListAddress[] | []
|
disabled-text | 不可配送提示文案 | string | - |
switchable | 是否允许切换地址 | boolean | true
|
add-button-text | 底部按钮文字 | string | 新增地址
|
default-tag-text | 默认地址标签文字 | string | - |
事件名 | 说明 | 回调参数 |
---|---|---|
add | 点击新增按钮时触发 | - |
edit | 点击编辑按钮时触发 | item: AddressListAddress, index: number |
select | 切换选中的地址时触发 | item: AddressListAddress, index: number |
edit-disabled | 编辑不可配送的地址时触发 | item: AddressListAddress, index: number |
select-disabled | 选中不可配送的地址时触发 | item: AddressListAddress, index: number |
click-item | 点击任意地址时触发 | item: AddressListAddress, index: number |
键名 | 说明 | 类型 |
---|---|---|
id | 每条地址的唯一标识 | number | string |
name | 姓名 | string |
tel | 手机号 | number | string |
address | 详细地址 | string |
isDefault | 是否为默认地址 | boolean |
名称 | 说明 | 参数 |
---|---|---|
default | 在列表下方插入内容 | - |
top | 在顶部插入内容 | - |
item-bottom | 在列表项底部插入内容 | item: AddressListAddress |
tag v3.0.9
|
自定义列表项标签内容 | item: AddressListAddress |
组件导出以下类型定义:
import type { AddressListProps, AddressListAddress } from "vant";
组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件。
名称 | 默认值 | 描述 |
---|---|---|
--van-address-list-padding | var(--van-padding-sm) var(--van-padding-sm) 80px | - |
--van-address-list-disabled-text-color | var(--van-text-color-2) | - |
--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-text-color-3) | - |
--van-address-list-item-font-size | 13px | - |
--van-address-list-item-line-height | var(--van-line-height-sm) | - |
--van-address-list-radio-color | var(--van-primary-color) | - |
--van-address-list-edit-icon-size | 20px | - |
介绍Sticky 组件与 CSS 中position: sticky属性实现的效果一致,当组件在屏幕范围内时,会按照正常的布局排列,当组件滚出屏幕范...
介绍用于提供下拉刷新的交互操作。实例演示引入通过以下方式来全局注册组件,更多注册方式请参考组件注册。import { createApp }...
引入ImagePreview和其他组件不同,不是通过HTML结构的方式来使用,而是通过函数调用的方式。使用前需要先引入它。import Vue fro...
介绍Sticky 组件与 CSS 中position: sticky属性实现的效果一致,当组件在屏幕范围内时,会按照正常的布局排列,当组件滚出屏幕范...
用于展示多条结构类似的数据,可对数据进行排序、筛选、对比或其他自定义操作。基础表格基础的表格展示用法。当Table元素中注入d...