|
|
<template> <view class="u-checkbox cursor-pointer" :style="[checkboxStyle]" @tap.stop="wrapperClickHandler" :class="[`u-checkbox-label--${parentData.iconPlacement}`, parentData.borderBottom && parentData.placement === 'column' && 'u-border-bottom']" > <view class="u-checkbox__icon-wrap cursor-pointer" @tap.stop="iconClickHandler" :class="iconClasses" :style="[iconWrapStyle]" > <slot name="icon"> <u-icon class="u-checkbox__icon-wrap__icon" name="checkbox-mark" :size="elIconSize" :color="elIconColor" /> </slot> </view> <slot name="label" :label="label" :elDisabled="elDisabled"> <text @tap.stop="labelClickHandler" :style="{ color: elDisabled ? elInactiveColor : elLabelColor, fontSize: elLabelSize, lineHeight: elLabelSize }" >{{label}}</text> </slot> </view></template>
<script> import { props } from './props'; import { mpMixin } from '../../libs/mixin/mpMixin'; import { mixin } from '../../libs/mixin/mixin'; import { addStyle, addUnit, deepMerge, formValidate, error } from '../../libs/function/index'; import test from '../../libs/function/test'; /** * checkbox 复选框 * @description 复选框组件一般用于需要多个选择的场景，该组件功能完整，使用方便 * @tutorial https://uview-plus.jiangruyi.com/components/checkbox.html
* @property {String | Number | Boolean} name checkbox组件的标示符 * @property {String} shape 形状，square为方形，circle为圆型 * @property {String | Number} size 整体的大小 * @property {Boolean} checked 是否默认选中 * @property {String | Boolean} disabled 是否禁用 * @property {String} activeColor 选中状态下的颜色，如设置此值，将会覆盖parent的activeColor值 * @property {String} inactiveColor 未选中的颜色 * @property {String | Number} iconSize 图标的大小，单位px * @property {String} iconColor 图标颜色 * @property {String | Number} label label提示文字，因为nvue下，直接slot进来的文字，由于特殊的结构，无法修改样式 * @property {String} labelColor label的颜色 * @property {String | Number} labelSize label的字体大小，px单位 * @property {String | Boolean} labelDisabled 是否禁止点击提示语选中复选框 * @property {Object} customStyle 定义需要用到的外部样式 * * @event {Function} change 任一个checkbox状态发生变化时触发，回调为一个对象 * @example <u-checkbox v-model="checked" :disabled="false">天涯</u-checkbox> */ export default { name: "u-checkbox", mixins: [mpMixin, mixin, props], data() { return { isChecked: false, // 父组件的默认值，因为头条小程序不支持在computed中使用this.parent.shape的形式
// 故只能使用如此方法
parentData: { iconSize: 12, labelDisabled: null, disabled: null, shape: 'square', activeColor: null, inactiveColor: null, size: 18, // #ifdef VUE2
value: null, // #endif
// #ifdef VUE3
modelValue: null, // #endif
iconColor: null, placement: 'row', borderBottom: false, iconPlacement: 'left' } } }, computed: { // 是否禁用，如果父组件u-raios-group禁用的话，将会忽略子组件的配置
elDisabled() { return this.disabled !== '' ? this.disabled : this.parentData.disabled !== null ? this.parentData.disabled : false; }, // 是否禁用label点击
elLabelDisabled() { return this.labelDisabled !== '' ? this.labelDisabled : this.parentData.labelDisabled !== null ? this.parentData.labelDisabled : false; }, // 组件尺寸，对应size的值，默认值为21px
elSize() { return this.size ? this.size : (this.parentData.size ? this.parentData.size : 21); }, // 组件的勾选图标的尺寸，默认12px
elIconSize() { return this.iconSize ? this.iconSize : (this.parentData.iconSize ? this.parentData.iconSize : 12); }, // 组件选中激活时的颜色
elActiveColor() { return this.activeColor ? this.activeColor : (this.parentData.activeColor ? this.parentData.activeColor : '#2979ff'); }, // 组件选未中激活时的颜色
elInactiveColor() { return this.inactiveColor ? this.inactiveColor : (this.parentData.inactiveColor ? this.parentData.inactiveColor : '#c8c9cc'); }, // label的颜色
elLabelColor() { return this.labelColor ? this.labelColor : (this.parentData.labelColor ? this.parentData.labelColor : '#606266') }, // 组件的形状
elShape() { return this.shape ? this.shape : (this.parentData.shape ? this.parentData.shape : 'circle'); }, // label大小
elLabelSize() { return addUnit(this.labelSize ? this.labelSize : (this.parentData.labelSize ? this.parentData.labelSize : '15')) }, elIconColor() { const iconColor = this.iconColor ? this.iconColor : (this.parentData.iconColor ? this.parentData.iconColor : '#ffffff'); // 图标的颜色
if (this.elDisabled) { // disabled状态下，已勾选的checkbox图标改为elInactiveColor
return this.isChecked ? this.elInactiveColor : 'transparent' } else { return this.isChecked ? iconColor : 'transparent' } }, iconClasses() { let classes = [] // 组件的形状
classes.push('u-checkbox__icon-wrap--' + this.elShape) if (this.elDisabled) { classes.push('u-checkbox__icon-wrap--disabled') } if (this.isChecked && this.elDisabled) { classes.push('u-checkbox__icon-wrap--disabled--checked') } // 支付宝，头条小程序无法动态绑定一个数组类名，否则解析出来的结果会带有","，而导致失效
// #ifdef MP-ALIPAY || MP-TOUTIAO
classes = classes.join(' ') // #endif
return classes }, iconWrapStyle() { // checkbox的整体样式
const style = {} style.backgroundColor = this.isChecked && !this.elDisabled ? this.elActiveColor : '#ffffff' style.borderColor = this.isChecked && !this.elDisabled ? this.elActiveColor : this.elInactiveColor style.width = addUnit(this.elSize) style.height = addUnit(this.elSize) // 如果是图标在右边的话，移除它的右边距
if (!this.usedAlone) { if (this.parentData.iconPlacement === 'right') { style.marginRight = 0 } } return style }, checkboxStyle() { const style = {} if (!this.usedAlone) { if (this.parentData.borderBottom && this.parentData.placement === 'row') { error('检测到您将borderBottom设置为true，需要同时将u-checkbox-group的placement设置为column才有效') } // 当父组件设置了显示下边框并且排列形式为纵向时，给内容和边框之间加上一定间隔
if (this.parentData.borderBottom && this.parentData.placement === 'column') { style.paddingBottom = '8px' } } return deepMerge(style, addStyle(this.customStyle)) } }, mounted() { this.init() }, emits: ["change"], methods: { init() { if (!this.usedAlone) { // 支付宝小程序不支持provide/inject，所以使用这个方法获取整个父组件，在created定义，避免循环引用
this.updateParentData() if (!this.parent) { error('u-checkbox必须搭配u-checkbox-group组件使用') } } // #ifdef VUE2
const value = this.parentData.value // #endif
// #ifdef VUE3
const value = this.parentData.modelValue // #endif
// 设置初始化时，是否默认选中的状态，父组件u-checkbox-group的value可能是array，所以额外判断
if (this.checked) { this.isChecked = true } else if (!this.usedAlone && test.array(value)) { // 查找数组是是否存在this.name元素值
this.isChecked = value.some(item => { return item === this.name }) } }, updateParentData() { this.getParentData('u-checkbox-group') }, // 横向两端排列时，点击组件即可触发选中事件
wrapperClickHandler(e) { if (!this.usedAlone) { this.parentData.iconPlacement === 'right' && this.iconClickHandler(e) } else { this.iconClickHandler(e) } }, // 点击图标
iconClickHandler(e) { this.preventEvent(e) // 如果整体被禁用，不允许被点击
if (!this.elDisabled) { this.setRadioCheckedStatus() } }, // 点击label
labelClickHandler(e) { this.preventEvent(e) // 如果按钮整体被禁用或者label被禁用，则不允许点击文字修改状态
if (!this.elLabelDisabled && !this.elDisabled) { this.setRadioCheckedStatus() } }, emitEvent() { this.$emit('change', this.isChecked) // 尝试调用u-form的验证方法，进行一定延迟，否则微信小程序更新可能会不及时
this.$nextTick(() => { formValidate(this, 'change') }) }, // 改变组件选中状态
// 这里的改变的依据是，更改本组件的checked值为true，同时通过父组件遍历所有u-checkbox实例
// 将本组件外的其他u-checkbox的checked都设置为false(都被取消选中状态)，因而只剩下一个为选中状态
setRadioCheckedStatus() { // 将本组件标记为与原来相反的状态
this.isChecked = !this.isChecked this.emitEvent() if (!this.usedAlone) { typeof this.parent.unCheckedOther === 'function' && this.parent.unCheckedOther(this) } } }, watch:{ checked(){ this.isChecked = this.checked } } }</script>
<style lang="scss" scoped> @import "../../libs/css/components.scss"; $u-checkbox-icon-wrap-margin-right:6px !default; $u-checkbox-icon-wrap-font-size:6px !default; $u-checkbox-icon-wrap-border-width:1px !default; $u-checkbox-icon-wrap-border-color:#c8c9cc !default; $u-checkbox-icon-wrap-icon-line-height:0 !default; $u-checkbox-icon-wrap-circle-border-radius:100% !default; $u-checkbox-icon-wrap-square-border-radius:3px !default; $u-checkbox-icon-wrap-checked-color:#fff !default; $u-checkbox-icon-wrap-checked-background-color:red !default; $u-checkbox-icon-wrap-checked-border-color:#2979ff !default; $u-checkbox-icon-wrap-disabled-background-color:#ebedf0 !default; $u-checkbox-icon-wrap-disabled-checked-color:#c8c9cc !default; $u-checkbox-label-margin-left:5px !default; $u-checkbox-label-margin-right:12px !default; $u-checkbox-label-color:$u-content-color !default; $u-checkbox-label-font-size:15px !default; $u-checkbox-label-disabled-color:#c8c9cc !default;
.u-checkbox { /* #ifndef APP-NVUE */ @include flex(row); /* #endif */ overflow: hidden; flex-direction: row; align-items: center; margin-bottom: 5px; margin-top: 5px;
&-label--left { flex-direction: row }
&-label--right { flex-direction: row-reverse; justify-content: space-between }
&__icon-wrap { /* #ifndef APP-NVUE */ box-sizing: border-box; // nvue下，border-color过渡有问题
transition-property: border-color, background-color, color; transition-duration: 0.2s; /* #endif */ color: $u-content-color; @include flex; align-items: center; justify-content: center; color: transparent; text-align: center; margin-right: $u-checkbox-icon-wrap-margin-right;
font-size: $u-checkbox-icon-wrap-font-size; border-width: $u-checkbox-icon-wrap-border-width; border-color: $u-checkbox-icon-wrap-border-color; border-style: solid;
/* #ifdef MP-TOUTIAO */ // 头条小程序兼容性问题，需要设置行高为0，否则图标偏下
&__icon { line-height: $u-checkbox-icon-wrap-icon-line-height; }
/* #endif */
&--circle { border-radius: $u-checkbox-icon-wrap-circle-border-radius; }
&--square { border-radius: $u-checkbox-icon-wrap-square-border-radius; }
&--checked { color: $u-checkbox-icon-wrap-checked-color; background-color: $u-checkbox-icon-wrap-checked-background-color; border-color: $u-checkbox-icon-wrap-checked-border-color; }
&--disabled { background-color: $u-checkbox-icon-wrap-disabled-background-color !important; }
&--disabled--checked { color: $u-checkbox-icon-wrap-disabled-checked-color !important; } }
&__label { /* #ifndef APP-NVUE */ word-wrap: break-word; /* #endif */ margin-left: $u-checkbox-label-margin-left; margin-right: $u-checkbox-label-margin-right; color: $u-checkbox-label-color; font-size: $u-checkbox-label-font-size;
&--disabled { color: $u-checkbox-label-disabled-color; } } }</style>
|
