1 Star 9 Fork 1

dcat-phper/dcat-distpicker

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

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);

使用code筛选

$filter->distpicker(['province_name', 'city_name', 'district_name'], '地域选择')->type('code');
# 只进行省市筛选
$filter->distpicker(['province_name', 'city_name', 'district_name'], '地域选择')->level(2)->type('code');

地区编码数据

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

Todo

  • 可以自定义是否返回code或者name
  • Grid filter扩展
  • 数据库文件

空文件

简介

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

发行版 (2)

全部
4年前

贡献者 (1)

全部

语言

近期动态

3年前创建了任务 #I52LG7 select2 在 2.0版本下有问题
3年多前更改了任务 #I4FC78 筛选不支持使用代码吗? 的状态为已完成
3年多前强推了提交到 master 分支,e2fed81...ca17df0
3年多前推送了新的 1.0.10 标签
3年多前推送了新的 1.0.9 标签
加载更多
不能加载更多了
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
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

搜索帮助