Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/laravel-admin-extensions/china-distpicker
中国省/市/区（县）三级级联选择器
https://github.com/laravel-admin-extensions/china-distpicker
distpicker laravel laravel-admin
Last synced: about 1 month ago
JSON representation
中国省/市/区（县）三级级联选择器
- Host: GitHub
- URL: https://github.com/laravel-admin-extensions/china-distpicker
- Owner: laravel-admin-extensions
- License: mit
- Created: 2018-09-05T13:24:11.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-10-11T10:08:17.000Z (about 3 years ago)
- Last Synced: 2024-11-02T07:08:00.381Z (about 1 month ago)
- Topics: distpicker, laravel, laravel-admin
- Language: PHP
- Homepage:
- Size: 178 KB
- Stars: 131
- Watchers: 6
- Forks: 71
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-laravel-admin - china-distpicker - 基于 Distpicker 的中国省市区三级联动选择组件 (扩展包 / 字段类扩展包)
README
Distpicker extension for laravel-admin
======
[Distpicker](https://github.com/fengyuanchen/distpicker)是一个中国省市区三级联动选择组件，这个包是基于`Distpicker`的`laravel-admin`扩展，用来将`Distpicker`集成进`laravel-admin`的表单中
## 截图
## 安装
```bash
composer require laravel-admin-ext/china-distpicker
```
然后
```bash
php artisan vendor:publish --tag=laravel-admin-china-distpicker
```
## 配置
在`config/admin.php`文件的`extensions`配置部分，加上属于这个扩展的配置
```php
'extensions' => [
'china-distpicker' => [
// 如果要关掉这个扩展，设置为false
'enable' => true,
]
]
```
## 使用
### 表单中使用
比如在表中有三个字段`province_id`, `city_id`, `district_id`, 在form表单中使用它：
```php
$form->distpicker(['province_id', 'city_id', 'district_id']);
```
设置默认值
```php
$form->distpicker([
'province_id' => '省份',
'city_id' => '市',
'district_id' => '区'
], '地域选择')->default([
'province' => 130000,
'city' => 130200,
'district' => 130203,
]);
```
可以设置每个字段的placeholder
```php
$form->distpicker([
'province_id' => '省',
'city_id' => '市',
'district_id' => '区'
]);
```
设置label
```php
$form->distpicker(['province_id', 'city_id', 'district_id'], '请选择区域');
```
设置自动选择, 可以设置1,2,3 表示自动选择到第几级
```php
$form->distpicker(['province_id', 'city_id', 'district_id'])->autoselect(1);
```
### 表格筛选中使用
```php
$filter->distpicker('province_id', 'city_id', 'district_id', '地域选择');
```
## 地区编码数据
[Distpicker](https://github.com/fengyuanchen/distpicker)所使用的地域编码是基于国家统计局发布的数据, 数据字典为`china_area.sql`文件.
## 支持
如果觉得这个项目帮你节约了时间，不妨支持一下;)
License
------------
Licensed under [The MIT License (MIT)](LICENSE).