JQuery实现省市联动 address-picker

address-picker

一个jquery地址选择器，使用很简单。 A jQuery plugin for picking districts of China,css and js files are only 8KB,just try it.

将dist文件夹下的三个文件夹放进项目（注意不要改变css或js文件的相对位置）

 

在html中引入js文件

    <script src="https://cdn.bootcss.com/jquery/3.4.1/jquery.min.js" type="text/javascript"></script>  

   <script src="js/address-picker.js" type="text/javascript"></script> 

 

 

想让弹出地址面板展示在哪个页面元素下，就传入该元素的id，可以是任意元素(比如div/span/button...之类的)

下方以一个span举例:

    <span id="address_picker_text">选择地址</span> 

 

精简方式

  

 var addressPicker1 = new addressPicker("address_picker_text");//默认展示三级联动

 

自定义参数方式

 var addressPicker1 = new addressPicker({
        id:"address_picker_text",                     //想要展示在哪个页面元素下
        level:3,                                      //设置几级联动，默认3，可支持1-5
        levelDesc:["省份","城市","区县","乡镇","社区"], //每级联动标题展示文字,默认如左显示
        index:"996",                                  //浮动面板的z-index，默认`996`
        separator:" / ",                              //选择后返回的文字值分隔符，例如`四川省 / 成都市 / 武侯区`,默认` / `
        isInitClick:true,                             //是否为元素id自动绑定点击事件,默认`true`
        isWithMouse:false,                            //浮动面板是否跟随鼠标点击时坐标展示(而不是根据元素id的坐标).默认`false`
        offsetX:0,                                    //浮动面板x坐标偏移量，默认`0`
        offsetY:0,                                    //浮动面板y坐标偏移量,默认`0`
        emptyText:"暂无数据",                          //数据为空时展示文字,默认'暂无数据'
        color:"#56b4f8",                              //主题颜色，默认#56b4f8
        fontSize:'14px',                              //字体大小，默认14px
        isAsync:false,                                //是否异步加载数据，默认false，如果设置true的话asyncUrl必传
        asyncUrl:"",                                  //异步加载url，data数据将无效
        btnConfig:[],                                 //面板下方展示的自定义按钮组，格式见后面说明。默认不传
        data:""                                       //┌──未指定isAsync的时候以data为准，一次性加载所有数据
                                                      //├──可不传,默认使用`data`文件夹下的三级数据json文件
    });                                               //└──支持传入json文件路径(数据类型为string)或是数据本身(数据类型为object)

 

事件方法

show()显示面板
hide()隐藏面板
refreshData(data) 重新载入地址data
on(type,function) 绑定地址选择面板事件
getCurrentObject() 获取当前点击节点数据
getTotalValueAsText() 获取所有选择节点的文本字符串
getTotalValueAsArray() 获取所有选择节点的数组结构
clearSelectedData() 清除所有选中值
setSelectedData(arr) 设置选中值
下方是一些代码示例:
addressPicker1.show();  //显示面板
addressPicker1.hide();  //隐藏面板
addressPicker1.on("click", function () {
    //业务逻辑do whaterver you want ...
    console.log(addressPicker1.getCurrentObject());    //{code: 1101, text: "市辖区", level: 2}
    console.log(addressPicker1.getTotalValueAsText()); //北京市 / 市辖区
    console.log(addressPicker1.getTotalValueAsArray());//{code:['11','1101'],text:['北京市','市辖区']}
    $('#address_picker_text').text(addressPicker1.getTotalValueAsText());
});

//重新载入地址data
var new_data = [{name:'名字1',code:'110',children:[{name:'名字1的儿子',code:'1101'}]},
    {name:'名字2',code:'111'}];
address_picker.refreshData(new_data);
address_picker.show();

//设置选中值
address_picker.setSelectedData([11,1101,110105]);//注意此处要传完整路径
$("#address_picker_text").text(address_picker.getTotalValueAsText());

//清除所有选中
address_picker.clearSelectedData();
$("#address_picker_text").text("选择地区");

 https://github.com/huchuanfu/address-picker

下载

https://files.cnblogs.com/files/mqingqing123/address-picker-master.zip