Vant4 AddressEdit 地址編輯

介紹

地址編輯組件，用于新建、更新、刪除地址信息。

引入

通過以下方式來全局注冊組件，更多注冊方式請參考組件注冊。

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

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

代碼演示

基礎用法

<van-address-edit
  :area-list="areaList"
  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 { showToast } from 'vant';

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

    const onSave = () => showToast('save');
    const onDelete = () => showToast('delete');
    const onChangeDetail = (val) => {
      if (val) {
        searchResult.value = [
          {
            name: '黃龍萬科中心',
            address: '杭州市西湖區(qū)',
          },
        ];
      } else {
        searchResult.value = [];
      }
    };

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

API

Props

Events

Slots

方法

通過 ref 可以獲取到 AddressEdit 實例并調用實例方法，詳見組件實例方法。

類型定義

組件導出以下類型定義：

import type {
  AddressEditInfo,
  AddressEditProps,
  AddressEditInstance,
  AddressEditSearchItem,
} from 'vant';

?AddressEditInstance? 是組件實例的類型，用法如下：

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

const addressEditRef = ref<AddressEditInstance>();

addressEditRef.value?.setAddressDetail('');

AddressEditInfo 數(shù)據(jù)格式

注意：?AddressEditInfo? 僅作為初始值傳入，表單最終內容可以在 save 事件中獲取。

AddressEditSearchItem 數(shù)據(jù)格式

省市縣列表數(shù)據(jù)格式

請參考 Area 省市區(qū)選擇 組件。

主題定制

樣式變量

組件提供了下列 CSS 變量，可用于自定義樣式，使用方法請參考 ConfigProvider 組件。