/china-distpicker

**省/市/区(县)三级级联选择器

Primary LanguagePHPMIT LicenseMIT

Distpicker extension for laravel-admin

Distpicker是一个**省市区三级联动选择组件,这个包是基于Distpickerlaravel-admin扩展,用来将Distpicker集成进laravel-admin的表单中

截图

wx20180905-212332

安装

composer require laravel-admin-ext/china-distpicker

然后

php artisan vendor:publish --tag=laravel-admin-china-distpicker

配置

config/admin.php文件的extensions配置部分,加上属于这个扩展的配置

    'extensions' => [

        'china-distpicker' => [
        
            // 如果要关掉这个扩展,设置为false
            'enable' => true,
        ]
    ]

使用

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

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

可以设置每个字段的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);

表单提交的时候,默认是使用地域名称作为表单值提交,如果你要提交地域编码,使用下面的方法:

$form->distpicker(['province_id', 'city_id', 'district_id'])->attribute('data-value-type', 'code');

地区编码数据

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

支持

如果觉得这个项目帮你节约了时间,不妨支持一下;)

-1

License

Licensed under The MIT License (MIT).