1 Star 4 Fork 0

Dcat PHPer / dcat-distpicker

加入 Gitee
与超过 600 万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未指定开源许可证,未经作者的许可,此代码仅用于学习,不能用于其他用途。
克隆/下载
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README.md

dcat-admin extension

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

此扩展参考与引用:

截图

1、安装

composer require sparkinzy/dcat-distpicker

2、Dcat 后台发布资源

install

3、dcat-distpicker 使用方式

code

4、呈现效果

image-usage

表单中使用

比如在表中有三个字段province_name, city_name, district_name, 在form表单中使用它:

$form->distpicker(['province_name', 'city_name', 'district_name']);

设置默认值

$form->distpicker([
    'province_name' => '省份',
    'city_name' => '市',
    'district_name' => '区'
], '地域选择')->default([
    'province' => '黑龙江省',
    'city'     => '双鸭山市',
    'district' => '四方台区',
])->select2();

设置返回值类型

默认 name,可修改返回类型为code,但目前不推荐


$form->distpicker([
    'province_name' => '省份',
    'city_name' => '市',
    'district_name' => '区'
], '地域选择')->type('code');

可以设置每个字段的placeholder

$form->distpicker([
    'province_name' => '省',
    'city_name'     => '市',
    'district_name' => '区'
]);

设置label

$form->distpicker(['province_name', 'city_name', 'district_name'], '请选择区域');

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

$form->distpicker(['province_name', 'city_name', 'district_name'])->autoselect(1);

启用select2进行渲染

$form->distpicker(['province_name', 'city_name', 'district_name']))->select2();

表格筛选中使用

默认展开 省 市 区

# province_name 为字段名
$filter->distpicker(['province_name', 'city_name', 'district_name'], '地域选择');

只展示 省


$filter->distpicker(['province_name', 'city_name', 'district_name'], '地域选择')
->level();

展示 省 市

$filter->distpicker(['province_name', 'city_name', 'district_name'], '地域选择')
->level(2);

地区编码数据

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

Todo

  • 可以自定义是否返回code或者name
  • Grid filter扩展

仓库评论 ( 1 )

你可以在登录后,发表评论

简介

使用2020-10-02的国家统计局地址库数据更新,并做了特定优化处理 展开 收起
PHP 等 2 种语言
取消

发行版 (1)

全部

贡献者

全部

近期动态

加载更多
不能加载更多了
PHP
1
https://gitee.com/dcat-phper/dcat-distpicker.git
git@gitee.com:dcat-phper/dcat-distpicker.git
dcat-phper
dcat-distpicker
dcat-distpicker
master

搜索帮助

141041 ab9339c7 1850385 141043 25c028d5 1850385