Back to components
Components

Checkbox

Standalone checkbox control for capturing boolean input, usable independently or within custom form layouts.

Component

Props

Props Required Default Type
idtrue — string
modelValue — falseboolean
disabled — falseboolean
size — ControlFieldSize.MDControlFieldSize

Usage

id

Sets the id of the underlying native checkbox input.

 <template>
    <Checkbox id="my-checkbox" />
</template>
 
  • Type: string
  • Required: true

modelValue

Controls the checked state of the checkbox. Use v-model for two-way binding.

 <template>
    <Checkbox id="my-checkbox" v-model="isChecked" />
</template>
<script setup lang="ts">
const isChecked = ref(false)
</script>
 
  • Type: boolean
  • Default: false

disabled

Sets the disabled state of the checkbox. When disabled, clicks are ignored and the checkbox appearance reflects the inactive state.

 <template>
    <Checkbox id="my-checkbox" disabled />
</template>
 
  • Type: boolean
  • Default: false

size

Sets the size of the checkbox. It uses the ControlFieldSize enum.

 <template>
    <Checkbox id="my-checkbox" :size="ControlFieldSize.LG" />
</template>
 
  • Type: ControlFieldSize
  • Default: ControlFieldSize.MD

Options

Value Description
XS

Extra Small

SM

Small

MD

Medium

LG

Large