AddressList 地址列表

引入

  1. import Vue from 'vue';
  2. import { AddressList } from 'vant';
  3. Vue.use(AddressList);

代码演示

基础用法

  1. <van-address-list
  2. v-model="chosenAddressId"
  3. :list="list"
  4. :disabled-list="disabledList"
  5. disabled-text="以下地址超出配送范围"
  6. default-tag-text="默认"
  7. @add="onAdd"
  8. @edit="onEdit"
  9. />
  1. import { Toast } from 'vant';
  2. export default {
  3. data() {
  4. return {
  5. chosenAddressId: '1',
  6. list: [
  7. {
  8. id: '1',
  9. name: '张三',
  10. tel: '13000000000',
  11. address: '浙江省杭州市西湖区文三路 138 号东方通信大厦 7 楼 501 室'
  12. },
  13. {
  14. id: '2',
  15. name: '李四',
  16. tel: '1310000000',
  17. address: '浙江省杭州市拱墅区莫干山路 50 号'
  18. }
  19. ],
  20. disabledList: [
  21. {
  22. id: '3',
  23. name: '王五',
  24. tel: '1320000000',
  25. address: '浙江省杭州市滨江区江南大道 15 号'
  26. }
  27. ]
  28. }
  29. },
  30. methods: {
  31. onAdd() {
  32. Toast('新增地址');
  33. },
  34. onEdit(item, index) {
  35. Toast('编辑地址:' + index);
  36. }
  37. }
  38. }

API

Props

参数说明类型默认值
v-model当前选中地址的 idstring-
list地址列表Address[][]
disabled-list不可配送地址列表Address[][]
disabled-text不可配送提示文案string-
switchable是否允许切换地址booleantrue
add-button-text底部按钮文字string新增地址
default-tag-text v2.3.0默认地址标签文字string-

Events

事件名说明回调参数
add点击新增按钮时触发-
edit点击编辑按钮时触发item: 地址对象,index: 索引
select切换选中的地址时触发item: 地址对象,index: 索引
edit-disabled编辑不可配送的地址时触发item: 地址对象,index: 索引
select-disabled选中不可配送的地址时触发item: 地址对象,index: 索引
click-item点击任意地址时触发item: 地址对象,index: 索引

Address 数据结构

键名说明类型
id每条地址的唯一标识string | number
name收货人姓名string
tel收货人手机号string | number
address收货地址string
isDefault是否为默认地址boolean

Slots

名称说明
default在列表下方插入内容
top在顶部插入内容

AddressList 地址列表 - 图1