124 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			Vue
		
	
	
	
		
		
			
		
	
	
			124 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			Vue
		
	
	
	
| 
								 | 
							
								<template>
							 | 
						|||
| 
								 | 
							
									<view class="u-checkbox-group u-clearfix">
							 | 
						|||
| 
								 | 
							
										<slot></slot>
							 | 
						|||
| 
								 | 
							
									</view>
							 | 
						|||
| 
								 | 
							
								</template>
							 | 
						|||
| 
								 | 
							
								
							 | 
						|||
| 
								 | 
							
								<script>
							 | 
						|||
| 
								 | 
							
									import Emitter from '../../libs/util/emitter.js';
							 | 
						|||
| 
								 | 
							
									/**
							 | 
						|||
| 
								 | 
							
									 * checkboxGroup 开关选择器父组件Group
							 | 
						|||
| 
								 | 
							
									 * @description 复选框组件一般用于需要多个选择的场景,该组件功能完整,使用方便
							 | 
						|||
| 
								 | 
							
									 * @tutorial https://www.uviewui.com/components/checkbox.html
							 | 
						|||
| 
								 | 
							
									 * @property {String Number} max 最多能选中多少个checkbox(默认999)
							 | 
						|||
| 
								 | 
							
									 * @property {String Number} size 组件整体的大小,单位rpx(默认40)
							 | 
						|||
| 
								 | 
							
									 * @property {Boolean} disabled 是否禁用所有checkbox(默认false)
							 | 
						|||
| 
								 | 
							
									 * @property {String Number} icon-size 图标大小,单位rpx(默认20)
							 | 
						|||
| 
								 | 
							
									 * @property {Boolean} label-disabled 是否禁止点击文本操作checkbox(默认false)
							 | 
						|||
| 
								 | 
							
									 * @property {String} width 宽度,需带单位
							 | 
						|||
| 
								 | 
							
									 * @property {String} width 宽度,需带单位
							 | 
						|||
| 
								 | 
							
									 * @property {String} shape 外观形状,shape-方形,circle-圆形(默认circle)
							 | 
						|||
| 
								 | 
							
									 * @property {Boolean} wrap 是否每个checkbox都换行(默认false)
							 | 
						|||
| 
								 | 
							
									 * @property {String} active-color 选中时的颜色,应用到所有子Checkbox组件(默认#2979ff)
							 | 
						|||
| 
								 | 
							
									 * @event {Function} change 任一个checkbox状态发生变化时触发,回调为一个对象
							 | 
						|||
| 
								 | 
							
									 * @example <u-checkbox-group></u-checkbox-group>
							 | 
						|||
| 
								 | 
							
									 */
							 | 
						|||
| 
								 | 
							
									export default {
							 | 
						|||
| 
								 | 
							
										name: 'u-checkbox-group',
							 | 
						|||
| 
								 | 
							
										mixins: [Emitter],
							 | 
						|||
| 
								 | 
							
										props: {
							 | 
						|||
| 
								 | 
							
											// 最多能选中多少个checkbox
							 | 
						|||
| 
								 | 
							
											max: {
							 | 
						|||
| 
								 | 
							
												type: [Number, String],
							 | 
						|||
| 
								 | 
							
												default: 999
							 | 
						|||
| 
								 | 
							
											},
							 | 
						|||
| 
								 | 
							
											// 所有选中项的 name
							 | 
						|||
| 
								 | 
							
											// value: {
							 | 
						|||
| 
								 | 
							
											// 	default: Array,
							 | 
						|||
| 
								 | 
							
											// 	default() {
							 | 
						|||
| 
								 | 
							
											// 		return []
							 | 
						|||
| 
								 | 
							
											// 	}
							 | 
						|||
| 
								 | 
							
											// },
							 | 
						|||
| 
								 | 
							
											// 是否禁用所有复选框
							 | 
						|||
| 
								 | 
							
											disabled: {
							 | 
						|||
| 
								 | 
							
												type: Boolean,
							 | 
						|||
| 
								 | 
							
												default: false
							 | 
						|||
| 
								 | 
							
											},
							 | 
						|||
| 
								 | 
							
											// 在表单内提交时的标识符
							 | 
						|||
| 
								 | 
							
											name: {
							 | 
						|||
| 
								 | 
							
												type: [Boolean, String],
							 | 
						|||
| 
								 | 
							
												default: ''
							 | 
						|||
| 
								 | 
							
											},
							 | 
						|||
| 
								 | 
							
											// 是否禁止点击提示语选中复选框
							 | 
						|||
| 
								 | 
							
											labelDisabled: {
							 | 
						|||
| 
								 | 
							
												type: Boolean,
							 | 
						|||
| 
								 | 
							
												default: false
							 | 
						|||
| 
								 | 
							
											},
							 | 
						|||
| 
								 | 
							
											// 形状,square为方形,circle为原型
							 | 
						|||
| 
								 | 
							
											shape: {
							 | 
						|||
| 
								 | 
							
												type: String,
							 | 
						|||
| 
								 | 
							
												default: 'square'
							 | 
						|||
| 
								 | 
							
											},
							 | 
						|||
| 
								 | 
							
											// 选中状态下的颜色
							 | 
						|||
| 
								 | 
							
											activeColor: {
							 | 
						|||
| 
								 | 
							
												type: String,
							 | 
						|||
| 
								 | 
							
												default: '#2979ff'
							 | 
						|||
| 
								 | 
							
											},
							 | 
						|||
| 
								 | 
							
											// 组件的整体大小
							 | 
						|||
| 
								 | 
							
											size: {
							 | 
						|||
| 
								 | 
							
												type: [String, Number],
							 | 
						|||
| 
								 | 
							
												default: 34
							 | 
						|||
| 
								 | 
							
											},
							 | 
						|||
| 
								 | 
							
											// 每个checkbox占u-checkbox-group的宽度
							 | 
						|||
| 
								 | 
							
											width: {
							 | 
						|||
| 
								 | 
							
												type: String,
							 | 
						|||
| 
								 | 
							
												default: 'auto'
							 | 
						|||
| 
								 | 
							
											},
							 | 
						|||
| 
								 | 
							
											// 是否每个checkbox都换行
							 | 
						|||
| 
								 | 
							
											wrap: { 
							 | 
						|||
| 
								 | 
							
												type: Boolean,
							 | 
						|||
| 
								 | 
							
												default: false
							 | 
						|||
| 
								 | 
							
											},
							 | 
						|||
| 
								 | 
							
											// 图标的大小,单位rpx
							 | 
						|||
| 
								 | 
							
											iconSize: {
							 | 
						|||
| 
								 | 
							
												type: [String, Number],
							 | 
						|||
| 
								 | 
							
												default: 20
							 | 
						|||
| 
								 | 
							
											},
							 | 
						|||
| 
								 | 
							
										},
							 | 
						|||
| 
								 | 
							
										data() {
							 | 
						|||
| 
								 | 
							
											return {
							 | 
						|||
| 
								 | 
							
											}
							 | 
						|||
| 
								 | 
							
										},
							 | 
						|||
| 
								 | 
							
										created() {
							 | 
						|||
| 
								 | 
							
											// 如果将children定义在data中,在微信小程序会造成循环引用而报错
							 | 
						|||
| 
								 | 
							
											this.children = [];
							 | 
						|||
| 
								 | 
							
										},
							 | 
						|||
| 
								 | 
							
										methods: {
							 | 
						|||
| 
								 | 
							
											emitEvent() {
							 | 
						|||
| 
								 | 
							
												let values = [];
							 | 
						|||
| 
								 | 
							
												this.children.map(val => {
							 | 
						|||
| 
								 | 
							
													if(val.value) values.push(val.name);
							 | 
						|||
| 
								 | 
							
												})
							 | 
						|||
| 
								 | 
							
												this.$emit('change', values);
							 | 
						|||
| 
								 | 
							
												// 发出事件,用于在表单组件中嵌入checkbox的情况,进行验证
							 | 
						|||
| 
								 | 
							
												// 由于头条小程序执行迟钝,故需要用几十毫秒的延时
							 | 
						|||
| 
								 | 
							
												setTimeout(() => {
							 | 
						|||
| 
								 | 
							
													// 将当前的值发送到 u-form-item 进行校验
							 | 
						|||
| 
								 | 
							
													this.dispatch('u-form-item', 'on-form-change', values);
							 | 
						|||
| 
								 | 
							
												}, 60)
							 | 
						|||
| 
								 | 
							
											}
							 | 
						|||
| 
								 | 
							
										}
							 | 
						|||
| 
								 | 
							
									}
							 | 
						|||
| 
								 | 
							
								</script>
							 | 
						|||
| 
								 | 
							
								
							 | 
						|||
| 
								 | 
							
								<style lang="scss" scoped>
							 | 
						|||
| 
								 | 
							
									@import "../../libs/css/style.components.scss";
							 | 
						|||
| 
								 | 
							
								
							 | 
						|||
| 
								 | 
							
									.u-checkbox-group {
							 | 
						|||
| 
								 | 
							
										/* #ifndef MP || APP-NVUE */
							 | 
						|||
| 
								 | 
							
										display: inline-flex;
							 | 
						|||
| 
								 | 
							
										flex-wrap: wrap;
							 | 
						|||
| 
								 | 
							
										/* #endif */
							 | 
						|||
| 
								 | 
							
									}
							 | 
						|||
| 
								 | 
							
								</style>
							 |