Vant3 AddressEdit 地址编辑

介绍

收货地址编辑组件，用于新建、更新、删除收货地址。

实例演示

引入

通过以下方式来全局注册组件，更多注册方式请参考组件注册。

import { createApp } from vue;
import { AddressEdit } from vant;

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

代码演示

基础用法

<van-address-edit
  :area-list="areaList"
  show-postal
  show-delete
  show-set-default
  show-search-result
  :search-result="searchResult"
  :area-columns-placeholder="[请选择, 请选择, 请选择]"
  @save="onSave"
  @delete="onDelete"
  @change-detail="onChangeDetail"
/>

import { ref } from vue;
import { Toast } from vant;

export default {
  setup() {
    const searchResult = ref([]);

    const onSave = () => Toast(save);
    const onDelete = () => Toast(delete);
    const onChangeDetail = (val) => {
      if (val) {
        searchResult.value = [
          {
            name: 黄龙万科中心,
            address: 杭州市西湖区,
          },
        ];
      } else {
        searchResult.value = [];
      }
    };

    return {
      onSave,
      onDelete,
      areaList,
      searchResult,
      onChangeDetail,
    };
  },
};

API

Props

Events

Slots

方法

通过 ref 可以获取到 AddressEdit 实例并调用实例方法，详见组件实例方法。

类型定义

通过 AddressEditInstance 获取 AddressEdit 实例的类型定义。

import { ref } from vue;
import type { AddressEditInstance } from vant;

const addressEditRef = ref<AddressEditInstance>();

addressEditRef.value?.setAddressDetail();

AddressInfo 数据格式

注意：AddressInfo 仅作为初始值传入，表单最终内容可以在 save 事件中获取。

SearchResult 数据格式

省市县列表数据格式

请参考 Area 组件。

样式变量

组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 ConfigProvider 组件。