u-radio-group

854 阅读1分钟
<template>
  <view class="u-radio-group u-clearfix">
    <slot></slot>
  </view>
</template>

<script>
import Emitter from '../../libs/util/emitter.js'
/**
 * radioRroup 单选框父组件
 * @description 单选框用于有一个选择,用户只能选择其中一个的场景。搭配u-radio使用
 * @tutorial https://www.uviewui.com/components/radio.html
 * @property {Boolean} disabled 是否禁用所有radio(默认false)
 * @property {String} active-color 选中时的颜色,应用到所有子Radio组件(默认#2979ff)
 * @event {Function} change 任一个radio状态发生变化时触发
 * @property {String} width 宽度,需带单位
 * @property {Boolean} wrap 是否每个radio都换行(默认false)
 * @example <u-radio-group v-model="value"></u-radio-group>
 */
export default {
  name: 'u-radio-group',
  mixins: [Emitter],
  props: {
    // 是否禁用所有单选框
    disabled: {
      type: Boolean,
      default: false
    },
    // 匹配某一个radio组件,如果某个radio的name值等于此值,那么这个radio就被会选中
    value: {
      type: [String, Number],
      default: ''
    },
    // 选中状态下的颜色
    activeColor: {
      type: String,
      default: '#2979ff'
    },
    // 组件的整体大小
    size: {
      type: [String, Number],
      default: 17
    },
    // 每个checkbox占u-checkbox-group的宽度
    width: {
      type: String,
      default: 'auto'
    },
    // 是否每个checkbox都换行
    wrap: {
      type: Boolean,
      default: false
    }
  },
  provide() {
    return {
      radioGroup: this
    }
  },
  methods: {
    // 该方法有子组件radio调用,当一个radio被选中的时候,给父组件设置value值(props传递的value)
    setValue(val) {
      // 通过emit事件,设置父组件通过v-model双向绑定的值
      this.$emit('input', val)
      // 等待下一个周期再执行,因为this.$emit('input')作用于父组件,再反馈到子组件内部,需要时间
      this.$nextTick(function() {
        this.$emit('change', this.value)
        // 发出事件,用于在表单组件中嵌入checkbox的情况,进行验证
        // 将当前的值发送到 u-form-item 进行校验
        this.dispatch('u-form-item', 'on-form-change', this.value)
      })
    }
  }
}
</script>

<style lang="scss" scoped>
@import '../../libs/css/style.components.scss';

.u-radio-group {
  /* #ifndef MP */
  display: inline-flex;
  flex-wrap: wrap;
  /* #endif */
}
</style>