Blame view

node_modules/uview-ui/components/u-checkbox-group/u-checkbox-group.vue 3.77 KB
c7add6cf   “wangming”   初始版本开发完毕
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
  <template>
  	<view
  	    class="u-checkbox-group"
  	    :class="bemClass"
  	>
  		<slot></slot>
  	</view>
  </template>
  
  <script>
  	import props from './props.js';
  	/**
  	 * checkboxGroup 复选框组
  	 * @description 复选框组件一般用于需要多个选择的场景,该组件功能完整,使用方便
  	 * @tutorial https://www.uviewui.com/components/checkbox.html
  	 * @property {String}			name			标识符 
  	 * @property {Array}			value			绑定的值
  	 * @property {String}			shape			形状,circle-圆形,square-方形 (默认 'square' 
  	 * @property {Boolean}			disabled		是否禁用全部checkbox (默认 false 
  	 * @property {String}			activeColor		选中状态下的颜色,如设置此值,将会覆盖parentactiveColor (默认 '#2979ff' 
  	 * @property {String}			inactiveColor	未选中的颜色 (默认 '#c8c9cc' 
  	 * @property {String | Number}	size			整个组件的尺寸 单位px (默认 18 
  	 * @property {String}			placement		布局方式,row-横向,column-纵向 (默认 'row' 
  	 * @property {String | Number}	labelSize		label的字体大小,px单位  (默认 14 
  	 * @property {String}			labelColor		label的字体颜色 (默认 '#303133' 
  	 * @property {Boolean}			labelDisabled	是否禁止点击文本操作 (默认 false )
  	 * @property {String}			iconColor		图标颜色 (默认 '#ffffff' 
  	 * @property {String | Number}	iconSize		图标的大小,单位px (默认 12 
  	 * @property {String}			iconPlacement	勾选图标的对齐方式,left-左边,right-右边  (默认 'left' 
  	 * @property {Boolean}			borderBottom	placementrow时,是否显示下边框 (默认 false 
  	 * @event {Function}	change	任一个checkbox状态发生变化时触发,回调为一个对象
  	 * @event {Function}	input	修改通过v-model绑定的值时触发,回调为一个对象
  	 * @example <u-checkbox-group></u-checkbox-group>
  	 */
  	export default {
  		name: 'u-checkbox-group',
  		mixins: [uni.$u.mpMixin, uni.$u.mixin,props],
  		computed: {
  			// 这里computed的变量,都是子组件u-checkbox需要用到的,由于头条小程序的兼容性差异,子组件无法实时监听父组件参数的变化
  			// 所以需要手动通知子组件,这里返回一个parentData变量,供watch监听,在其中去通知每一个子组件重新从父组件(u-checkbox-group)
  			// 拉取父组件新的变化后的参数
  			parentData() {
  				return [this.value, this.disabled, this.inactiveColor, this.activeColor, this.size, this.labelDisabled, this.shape,
  					this.iconSize, this.borderBottom, this.placement
  				]
  			},
  			bemClass() {
  				// this.bem为一个computed变量,在mixin中
  				return this.bem('checkbox-group', ['placement'])
  			},
  		},
  		watch: {
  			// 当父组件需要子组件需要共享的参数发生了变化,手动通知子组件
  			parentData() {
  				if (this.children.length) {
  					this.children.map(child => {
  						// 判断子组件(u-checkbox)如果有init方法的话,就就执行(执行的结果是子组件重新从父组件拉取了最新的值)
  						typeof(child.init) === 'function' && child.init()
  					})
  				}
  			},
  		},
  		data() {
  			return {
  
  			}
  		},
  		created() {
  			this.children = []
  		},
  		methods: {
  			// 将其他的checkbox设置为未选中的状态
  			unCheckedOther(childInstance) {
  				const values = []
  				this.children.map(child => {
  					// 将被选中的checkbox,放到数组中返回
  					if (child.isChecked) {
  						values.push(child.name)
  					}
  				})
  				// 发出事件
  				this.$emit('change', values)
  				// 修改通过v-model绑定的值
  				this.$emit('input', values)
  			},
  		}
  	}
  </script>
  
  <style lang="scss" scoped>
  	@import "../../libs/css/components.scss";
  
  	.u-checkbox-group {
  
  		&--row {
  			@include flex;
  		}
  
  		&--column {
  			@include flex(column);
  		}
  	}
  </style>