Vant AddressEdit 地址編輯

2022-05-31 13:40 更新

引入

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

Vue.use(AddressEdit);

代碼演示

基礎(chǔ)用法

<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 { Toast } from 'vant';

export default {
  data() {
    return {
      areaList,
      searchResult: []
    }
  },
  methods: {
    onSave() {
      Toast('save');
    },
    onDelete() {
      Toast('delete');
    },
    onChangeDetail(val) {
      if (val) {
        this.searchResult = [{
          name: '黃龍萬科中心',
          address: '杭州市西湖區(qū)'
        }];
      } else {
        this.searchResult = [];
      }
    }
  }
}

API

Props

參數(shù)說明類型默認(rèn)值
area-list地區(qū)列表object-
area-columns-placeholder v2.2.5地區(qū)選擇列占位提示文字string[][]
address-info收貨人信息初始值AddressInfo{}
search-result詳細(xì)地址搜索結(jié)果SearchResult[][]
show-postal是否顯示郵政編碼booleanfalse
show-delete是否顯示刪除按鈕booleanfalse
show-set-default是否顯示默認(rèn)地址欄booleanfalse
show-search-result是否顯示搜索結(jié)果booleanfalse
save-button-text保存按鈕文字string保存
delete-button-text刪除按鈕文字string刪除
detail-rows詳細(xì)地址輸入框行數(shù)number | string1
detail-maxlength v2.0.4詳細(xì)地址最大長度number | string200
is-saving是否顯示保存按鈕加載動畫booleanfalse
is-deleting是否顯示刪除按鈕加載動畫booleanfalse
tel-validator手機(jī)號格式校驗(yàn)函數(shù)string => boolean-
postal-validator v2.1.2郵政編碼格式校驗(yàn)函數(shù)string => boolean-
validator自定義校驗(yàn)函數(shù)(key, val) => string-

Events

事件名說明回調(diào)參數(shù)
save點(diǎn)擊保存按鈕時觸發(fā)content:表單內(nèi)容
focus輸入框聚焦時觸發(fā)key: 聚焦的輸入框?qū)?yīng)的 key
delete確認(rèn)刪除地址時觸發(fā)content:表單內(nèi)容
cancel-delete取消刪除地址時觸發(fā)content:表單內(nèi)容
select-search選中搜索結(jié)果時觸發(fā)value: 搜索結(jié)果
change-area修改收件地區(qū)時觸發(fā)values: 地區(qū)信息
change-detail修改詳細(xì)地址時觸發(fā)value: 詳細(xì)地址內(nèi)容
change-default切換是否使用默認(rèn)地址時觸發(fā)value: 是否選中

Slots

名稱說明
default在郵政編碼下方插入內(nèi)容

方法

通過 ref 可以獲取到 AddressEdit 實(shí)例并調(diào)用實(shí)例方法,詳見 組件實(shí)例方法

方法名說明參數(shù)返回值
setAddressDetail設(shè)置詳細(xì)地址addressDetail: string-

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

注意:AddressInfo 僅作為初始值傳入,表單最終內(nèi)容可以在 save 事件中獲取

key說明類型
id每條地址的唯一標(biāo)識number | string
name收貨人姓名string
tel收貨人手機(jī)號string
province省份string
city城市string
county區(qū)縣string
addressDetail詳細(xì)地址string
areaCode地區(qū)編碼,通過省市區(qū)選擇獲?。ū靥睿?/td>string
postalCode郵政編碼string
isDefault是否為默認(rèn)地址boolean

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

key說明類型
name地名string
address詳細(xì)地址string

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

請參考 Area 組件。


實(shí)例演示

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號