jQuery-TWzipcode
在網頁建立多組 3 碼臺灣郵遞區號表單元素的 jQuery Plugin ─ 讀取快速、不需使用資料庫。
* jQuery-TWzipcode v1.5 以後版本需 jQuery v1.6(支援 2.0)
多國語言 i18n
Download: branch v1.6.1
新增參數
language: 'language file path' //預設自動判斷
Example
;
安裝 Install
bower
$bower install jquery-TWzipcode
使用 Usage
HTML
... <!-- Normal --> <!-- OR HTML5 data-* (Version 1.5+) -->
Javascript
;
選項 Options
css (Array)
設置元素的樣式名稱,依序為 ['縣市清單', '鄉鎮市區清單', '郵遞區號輸入框']
googleMapsKey (string)
v1.6.9
Google Maps Geolocation API 金鑰。若您達到 Geocoder 的每日限制用量,可透過購買來提高用量,同時需設置金鑰。
預設值: ''
detect (boolean|Function)
v1.6.7
是否自動偵測用戶位置。不需引入 Google Maps API。
預設值: false
countyName (string)
指定縣市下拉清單元素的表單名稱。 預設值: county
countySel (string)
縣市清單的預設值
districtName (string)
鄉鎮市區下拉清單的表單名稱。 預設值: district
districtSel (string)
鄉鎮市區的預設值
zipcodeName (string)
郵遞區號輸入框的表單名稱。 預設值: zipcode
zipcodeSel (string)
郵遞區號輸入框的預設值(此選項優先於 countySel, districtSel)
zipcodeIntoDistrict (bool)
v1.6.6
是否隱藏郵遞區號輸入框並顯示於鄉鎮市區清單內?
預設值: false
onCountySelect (function)
v1.5
綁定縣市選單 Change 事件。
onDistrictSelect (function)
v1.5
綁定鄉鎮市區選單 Change 事件。
onZipcodeKeyUp (function)
v1.5
綁定郵遞區號輸入框 keyUp 事件(readonly 必須為 false)。
readonly (boolean)
郵遞區號輸入框是否唯讀? 預設值: true
hideCounty (array)
v1.7.9
要隱藏的縣市名稱,例如 ['臺北市', '宜蘭縣'...]
預設值: []
hideDistrict (array)
v1.7.9
要隱藏的鄉鎮市區,可以是名稱或三碼郵遞區號例如 ['大安區', '110'...]
預設值: []
方法 Methods
data
取得已選取縣市的郵遞區號資料
var data = ;console;
destroy
從指定的元素移除 Plugin
;
get
// 取得縣市 county(返回字串)var county = ; // 取得縣市 county 以及鄉鎮市區 district(返回陣列)var result = ; // 以 , 字串傳入var result = ; // 以陣列傳入 // Callback;
set
// 直接設置郵遞區號;// 傳入縣市、鄉鎮市區;
reset
將指定的元素恢復未選狀態
;
serialize
將指定的元素輸出為 URL QueryString。
var qs = ;console;// output:// county=AAA&district=BBB&zipcode=999
範例
加入郵遞區號預設值,並可輸入郵遞區號取得縣市名稱
;
加入縣市預設值
;
指定 CSS 樣式名稱
;
或是直接使用 HTML5 data-* 套用樣式
支援
請拜訪 https://code.essoduke.org/twzipcode/ 取得支援。
授權
v1.6.2 開始採用 MIT License v1.6.1 及更早版本採用 創用 CC 姓名標示-相同方式分享 3.0 台灣授權條款。