跳到正文

Checkbox 复选框 ​

复选框选中指示器,仅渲染选中 / 未选中 / 禁用三种视觉状态,不自带点击逻辑——点击交互由父级行或容器统一控制(原生事件监听会透传到根元素,需要独立点击时直接挂载即可)。

使用方式 ​

组件以 EmCheckbox 为名导出,全局注册后可直接使用:

vue
<script setup lang="ts">
import { ref } from 'vue'

const checked = ref(false)
</script>

<template>
  <em-checkbox :checked="checked" @click="checked = !checked" />
</template>

选中状态 ​

点击交互 ​

API ​

Checkbox API ​

Props ​

属性类型默认值说明
checkedbooleanfalse是否选中 / Checked state
sizenumber20图标尺寸(px),默认 20 / Icon size in px, default 20
disabledbooleanfalse是否禁用(仅视觉半透明;点击交互由父级控制)/ Disabled (visual only; interaction is controlled by parent)