4 Star 43 Fork 11

wanmianji / 基于layui的中国省市复选框组件

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

基于layui的中国省市复选框组件

介绍

基于layui的省市多选解决方案

更新日志

  • 2022-04-17
  1. 修复父元素包含layui-form类时无法正常渲染的问题
  • 2021-09-20
  1. 调整数据结构,支持复选框选项值自定义
  • 2021-03-11
  1. 支持字符串赋值,多个值用“,”隔开
  • 2021-02-26
  1. 新增动态赋值方法val()
  2. 新增支持实例化多个
  3. 新增重载方法
  4. 优化代码

参数列表

参数 类型 说明 示例值
elem String 指定容器的选择器,必填 #demo
name String checkbox name属性值 region
data Array 设置checkbox选项值和显示的文字,不设置则使用预设选项 参考region.json和demo页
all Array 全选框值和显示的文字,默认['所有地域', '所有地域'],若为null则不显示全选框 ['all', '全部']
value Array/String 赋初始值 ['北京', '云南-昆明']/'北京,云南-昆明'
width String 容器宽度,默认550px 400px
border Boolean 是否显示边框,默认true false

回调

方法名 备注
ready: function(){} 渲染完成时触发
change: function(result){} 点击复选框时触发

基础方法

方法名 备注
var regionTest = regionCheckBox.render(options) 渲染
regionTest.val(value) 赋值
regionTest.reload(options) 重载

使用示例

        <div id="regionTest"></div>
        layui.config({
		  base: '../../../layui_exts/' //配置组件存放的基础目录
		}).extend({
		  regionCheckBox: 'regionCheckBox/regionCheckBox' //定义组件模块名
		}).use(['regionCheckBox'], function(){
		  var $ = layui.$;
		  var regionCheckBox = layui.regionCheckBox;
		  
		  //执行实例
		  var regionTest = regionCheckBox.render({
			elem: '#regionTest',
			name: 'region', // 对应input name
			value: ['北京', '内蒙古', '江西-九江'], // 赋初始值,'北京,内蒙古,江西-九江'也可以
			width: '550px', // 默认550px
			border: true, // 默认true
			// 初始化完成时执行
			ready: function(){
				// 做些什么
			},
			// 点击复选框时执行
			change: function(result){
				// 做些什么
			}
		  });		  
		});

效果截图

输入图片说明 输入图片说明 输入图片说明

MIT License Copyright (c) 2020 wanmianji Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

基于layui的省市多选解决方案 展开 收起
JavaScript 等 3 种语言
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
JavaScript
1
https://gitee.com/youyoudanshui/layui-regionCheckBox.git
git@gitee.com:youyoudanshui/layui-regionCheckBox.git
youyoudanshui
layui-regionCheckBox
基于layui的中国省市复选框组件
master

搜索帮助