江西小程序管理端
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

103 lines
3.8 KiB

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