u-radio-group.vue 3.8 KB

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