README

此包不再维护，请使用 super-eggs/dcat-distpicker.

dcat-admin extension

Distpicker是一个中国省市区三级联动选择组件，这个包是基于Distpicker的dcat-admin扩展，用来将Distpicker集成进dcat-admin的表单中，本包参考了laravel-admin-extensions/china-distpicker

截图

安装

首先

composer require super-eggs/dcat-admin-extensions-distpicker

然后

php artisan admin:import dcat-admin-extensions-distpicker

开启扩展

后台开启

使用

表单中使用

比如在表中有三个字段province_id, city_id, district_id, 在form表单中使用它：

$form->distpicker(['province_id', 'city_id', 'district_id']);

设置默认值

$form->distpicker([
    'province_id' => '省份',
    'city_id' => '市',
    'district_id' => '区'
], '地域选择')->default([
    'province' => 130000,
    'city'     => 130200,
    'district' => 130203,
]);

可以设置每个字段的placeholder

$form->distpicker([
    'province_id' => '省',
    'city_id'     => '市',
    'district_id' => '区'
]);

设置label

$form->distpicker(['province_id', 'city_id', 'district_id'], '请选择区域');

设置自动选择, 可以设置1,2,3 表示自动选择到第几级

$form->distpicker(['province_id', 'city_id', 'district_id'])->autoselect(1);

表格筛选中使用

$filter->distpicker('province_id', 'city_id', 'district_id', '地域选择');

地区编码数据

Distpicker所使用的地域编码是基于国家统计局发布的数据, 数据字典为china_area.sql文件.

下一步开发计划

可以自定义调整为一级、二级；