1. 程式人生 > >三級聯動外掛distpicker

三級聯動外掛distpicker

外掛描述:distpicker是一款可以實現中國省市區地址三級聯動jQuery外掛。它使用簡單,簡單設定即可完成中國省市區地址聯動效果。

簡要教程

安裝

可以通過npm或bower來安裝該三級聯動外掛。

  • npm install distpicker

  • bower install distpicker                  

使用方法

HTML結構

基本的HTML結構是使用一個<div>容器來包裹一組<select>元素。

1

2

3

4

5

<div><!-- container -->

<select></select><!-- 省 -->

<select></select><!-- 市 -->

<select></select><!-- 區 -->

</div>

你可以直接通過data-toggle="distpicker"實現來進行初始化。

1

2

3

4

5

<div data-toggle="distpicker"><!-- container -->

<select></select><!-- 省 -->

<select></select><!-- 市 -->

<select></select><!-- 區 -->

</div>

也可以顯示佔位文字。

1

2

3

4

5

<div data-toggle="distpicker">

<select data-province="---- 選擇省 ----"

></select>

<select data-city="---- 選擇市 ----"></select>

<select data-district="---- 選擇區 ----"></select>

</div>

或者自定義省市區。

1

2

3

4

5

<div data-toggle="distpicker">

<select data-province="浙江省"></select>

<select data-city="杭州市"></select>

<select data-district="西湖區"></select>

</div>

初始化外掛

在頁面DOM元素載入完畢之後,可以通過distpicker()方法來初始化該地址聯動外掛。

1

$('#target').distpicker();

自定義佔位文字:

1

2

3

4

5

$('#target').distpicker({

province: '---- 所在省 ----',

city: '---- 所在市 ----',

district: '---- 所在區 ----'

});

自定義省市區。

1

2

3

4

5

$('#target').distpicker({

province: '浙江省',

city: '杭州市',

district: '西湖區'

});

配置引數

可以通過以下程式碼來修改預設的配置引數,

1

$().distpicker(options)

通過以下程式碼來修改全域性預設引數。

1

$.fn.distpicker.setDefaults(options)

1

2

3

4

5

autoSelect:型別:Boolean,預設值:true。是否當省改變時自動選擇市和區。

placeholder:型別:Boolean,預設值:true。是否顯示佔位文字。

province:型別:String,預設值:―― 省 ――。定義省份的初始值。如果在distpicker.data.js檔案中存在該省份,將會被選擇,否則顯示佔位文字。

city:型別:String,預設值:―― 市 ――。定義市的初始值。如果在distpicker.data.js檔案中存在該市,將會被選擇,否則顯示佔位文字。

district:型別:String,預設值:―― 區 ――。定義區的初始值。如果在distpicker.data.js檔案中存在該區,將會被選擇,否則顯示佔位文字。

方法

  • reset([deep]):重置select為初始狀態。

  • deep (optional):型別:Boolean,預設值:false。重置select為初始狀態。

例如:

1

2

3

$().distpicker('reset');

$().distpicker('reset'true);

destroy():銷燬外掛例項。