bug
jiangping
2023-11-07 64b432916af9c9218ab3f3eca614e26c542142ae
minipro_standard/uni_modules/uview-ui/components/u-checkbox-group/u-checkbox-group.vue
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,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      é€‰ä¸­çŠ¶æ€ä¸‹çš„é¢œè‰²ï¼Œå¦‚è®¾ç½®æ­¤å€¼ï¼Œå°†ä¼šè¦†ç›–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 <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>