Skip to content

CheckboxButtons

基础用法

html

<pa-checkbox-btns v-model="selectedValue" :options="getData(6)" />
ts

import { ref } from 'vue'

const selectedValue = ref<number>(0)

const getData = (count: number) => {
  return new Array(count).fill(0).map((_item, index) => {
    return {
      label: `选项${index}`,
      value: index,
    }
  })
}

多选

html

<pa-checkbox-btns v-model="selectedValue" :options="getData(6)" multiple />
ts

import { ref } from 'vue'

const selectedValue = ref<number[]>([0, 1])

const getData = (count: number) => {
  return new Array(count).fill(0).map((_item, index) => {
    return {
      label: `选项${index}`,
      value: index,
    }
  })
}

自定义布局

html

<pa-checkbox-btns v-model="selectedValue" :options="getData(8)" :column="4" gap="10" round />
ts

import { ref } from 'vue'

const selectedValue = ref<number>()

const getData = (count: number) => {
  return new Array(count).fill(0).map((_item, index) => {
    return {
      label: `选项${index}`,
      value: index,
    }
  })
}

自定义内容

html

<pa-checkbox-btns v-model="selectedValue" :options="getData(8)">
  <template #default="{ item, index }">
    <pa-icon :name="index % 2 === 0 ? 'success' : 'close'" />
    <text>{{ item.label }}</text>
  </template>
</pa-checkbox-btns>
ts

import { ref } from 'vue'

const selectedValue = ref<number>()

const getData = (count: number) => {
  return new Array(count).fill(0).map((_item, index) => {
    return {
      label: `选项${index}`,
      value: index,
    }
  })
}

CheckboxButtons Props

参数说明类型默认值
column列数number3
gap间隔string | number20
modelValue选中值CheckboxButtonValue|CheckboxButtonValue[]-
options选项列表CheckboxItem[]() => []
labelKey标题对应字段名string'label'
valueKey内容对应字段名string'value'
multiple是否多选booleanfalse
bgColor背景色string-
round圆角大小, 值为true时半圆角boolean | string'4rpx'
inverse是否支持反选booleantrue

CheckboxButtons Event

事件名参数
update:modelValue(value: CheckboxButtonValue | CheckboxButtonValue[])
change(item: CheckboxItem | CheckboxItem[], index: number)

CheckboxButtons Slot

名称说明
default-

样式变量

名称默认值
--pa-checkbox-btns-font-size14px
--pa-checkbox-btns-colorvar(--pa-color-black)
--pa-checkbox-btns-backgroundvar(--pa-color-gray)
--pa-checkbox-btns-border-colorvar(--pa-color-gray)
--pa-checkbox-btns-padding7px 4px
--pa-checkbox-btns-border-width2rpx
--pa-checkbox-btns-active-colorvar(--pa-color-primary)
--pa-checkbox-btns-active-backgroundrgba(0, 156, 93, 0.1
--pa-checkbox-btns-active-border-colorvar(--pa-color-primary)