中国省市区地址三级联动jQuery插件

中国省市区地址三级联动jQuery插件 案例下载

 

distpicker是一款可以实现中国省市区地址三级联动jQuery插件。它使用简单,简单设置即可完成中国省市区地址联动效果。

安装

可以通过npm或bower来安装该三级联动插件。

npm install distpicker
bower install distpicker

使用方法

HTML结构

基本的HTML结构是使用一个<div>容器来包裹一组<select>元素。

<div><!-- container -->
  <select></select><!-- 省 -->
  <select></select><!-- 市 -->
  <select></select><!-- 区 -->
</div>
你可以直接通过data-toggle="distpicker"实现来进行初始化。
<div data-toggle="distpicker" ><!-- container -->
  <select></select><!-- 省 -->
  <select></select><!-- 市 -->
  <select></select><!-- 区 -->
</div>
也可以显示占位文本。

<div data-toggle="distpicker">
    <select data-province="---- 选择省 ----"></select>
    <select data-city="---- 选择市 ----"></select>
    <select data-district="---- 选择区 ----"></select>
</div> 
或者自定义省市区。
<div data-toggle="distpicker">
    <select data-province="浙江省"></select>
    <select data-city="杭州市"></select>
    <select data-district="西湖区"></select>
</div>

初始化插件

在页面DOM元素加载完毕之后,可以通过distpicker()方法来初始化该地址联动插件。

$('#target').distpicker();
自定义占位文本:
$('#target').distpicker({
    province: '---- 所在省 ----',
    city: '---- 所在市 ----',
    district: '---- 所在区 ----'
});
 自定义省市区。
$('#target').distpicker({
    province: '浙江省',
    city: '杭州市',
    district: '西湖区'
});

配置参数

可以通过$().distpicker(options)来修改默认的配置参数,通过$.fn.distpicker.setDefaults(options)来修改全局默认参数。

  • 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为初始状态。

    例如:

$().distpicker('reset');
$().distpicker('reset', true);
  • destroy():销毁插件实例。

distpicker三级地址联动插件的github地址为:https://github.com/fengyuanchen/distpicker

未经允许不得转载:小月博客 » 中国省市区地址三级联动jQuery插件
微信公众号
关注我们,每天及时接收最新的学习资料
12000人已关注
分享到:
赞(1) 打赏

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏