laravel-admin-ext / china-distpicker
Distpicker extension for laravel-admin
Installs: 41 852
Dependents: 0
Suggesters: 0
Security: 0
Stars: 131
Watchers: 6
Forks: 71
Open Issues: 17
Requires
- php: >=7.0.0
- encore/laravel-admin: ~1.6
Requires (Dev)
- phpunit/phpunit: ~6.0
README
Distpicker是一个中国省市区三级联动选择组件,这个包是基于Distpicker
的laravel-admin
扩展,用来将Distpicker
集成进laravel-admin
的表单中
截图
安装
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']);
设置默认值
$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
文件.
支持
如果觉得这个项目帮你节约了时间,不妨支持一下;)
License
Licensed under The MIT License (MIT).