城市选择

FastAdmin中集成了强大的city-picker城市选择插件,可以很方便的选择省份和城市。

常规示例

我们只需要简单的为input元素添加一个data-toggle="city-picker"属性即可自动渲染相应的城市选择组件,如下:

<div class='control-relative'>
    <input id="c-city" class="form-control" data-toggle="city-picker" name="row[city]" type="text" value="" />
</div>

常用属性

我们还可以通过添加以下属性来扩展城市选择组件的功能

属性描述示例
data-level选择城市的级别,支持province/city/district,默认为districtdata-level="city"
data-simple使用简单的地址,比如使用内蒙古替代内蒙古自治区,默认为falsedata-simple="true"
data-responsive是否为自适应,默认为falsedata-responsive="true"
placeholder默认提示的文字placeholder="请选择省/市"

事件捕获

city-picker组件默认选择后渲染的是中文城市信息,我们可以通过在JS中监听city-picker更新后的事件来获取省份城市地区对应的code值。代码如下:

$("#city-picker").on("cp:updated", function() {
  var citypicker = $(this).data("citypicker");
  var code = citypicker.getCode("district") || citypicker.getCode("city") || citypicker.getCode("province");
  $("#code").val(code);
});

如果我们数据库中存放的是地区的code值,在显示时我们则需要把对应的code通过读取数据库转换成我们的地区中文,然后再设定inputvalue值即可。

数据源

该组件数据源使用本地数据源,数据源位于public/assets/libs/fastadmin-citypicker/dist/js/city-picker.data.js

更多的使用方法请参考city-picker官方教程
文档最后更新时间:2023-07-31 08:12:06
著作权归应用插件开发者所有,未经许可,禁止转载、复制此文档的任何内容。