uv-checkbox-group.vue
4.33 KB
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
<template>
<view
class="uv-checkbox-group"
:class="bemClass"
:style="[$uv.addStyle(this.customStyle)]"
>
<slot></slot>
</view>
</template>
<script>
import mpMixin from '@/uni_modules/uv-ui-tools/libs/mixin/mpMixin.js'
import mixin from '@/uni_modules/uv-ui-tools/libs/mixin/mixin.js'
import props from './props.js';
/**
* checkboxGroup 复选框组
* @description 复选框组件一般用于需要多个选择的场景，该组件功能完整，使用方便
* @tutorial https://www.uvui.cn/components/checkbox.html
* @property {String} name 标识符
* @property {Array} value 绑定的值
* @property {String} shape 形状，circle-圆形，square-方形 （默认 'square' ）
* @property {Boolean} disabled 是否禁用全部checkbox （默认 false ）
* @property {String} activeColor 选中状态下的颜色，如设置此值，将会覆盖parent的activeColor值 （默认 '#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 placement为row时，是否显示下边框 （默认 false ）
* @event {Function} change 任一个checkbox状态发生变化时触发，回调为一个对象
* @event {Function} input 修改通过v-model绑定的值时触发，回调为一个对象
* @example <uv-checkbox-group></uv-checkbox-group>
*/
export default {
name: 'uv-checkbox-group',
mixins: [mpMixin, mixin, props],
computed: {
// 这里computed的变量，都是子组件uv-checkbox需要用到的，由于头条小程序的兼容性差异，子组件无法实时监听父组件参数的变化
// 所以需要手动通知子组件，这里返回一个parentData变量，供watch监听，在其中去通知每一个子组件重新从父组件(uv-checkbox-group)
// 拉取父组件新的变化后的参数
parentData() {
let value = [];
if(this.value.length) {
value = this.value;
} else if (this.modelValue.length){
value = this.modelValue;
}
return [value, this.disabled, this.inactiveColor, this.activeColor, this.size, this.labelDisabled, this.shape,
this.iconSize, this.borderBottom, this.placement, this.labelSize, this.labelColor]
},
bemClass() {
// this.bem为一个computed变量，在mixin中
return this.bem('checkbox-group', ['placement'])
},
},
watch: {
// 当父组件需要子组件需要共享的参数发生了变化，手动通知子组件
parentData() {
if (this.children.length) {
this.children.map(child => {
// 判断子组件(uv-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)
}
})
// 修改通过v-model绑定的值
// #ifdef VUE2
this.$emit('input', values)
// #endif
// #ifdef VUE3
this.$emit('update:modelValue',values)
// #endif
// 发出事件
this.$emit('change', values)
}
}
}
</script>
<style lang="scss" scoped>
@import '@/uni_modules/uv-ui-tools/libs/css/components.scss';
@import '@/uni_modules/uv-ui-tools/libs/css/color.scss';
.uv-checkbox-group {
flex: 1;
&--row {
@include flex;
flex-wrap: wrap;
}
&--column {
@include flex(column);
}
}
</style>