Checkbox

modelValue is whether the box is checked, bound two-way with v-model.

label is the text beside the box — and the whole of it is clickable, not just the box.

description is secondary text below the label — the place for the caveat that would otherwise make the label too long to scan.

required shows an asterisk after the label. Marking the field is all it does — the validation belongs to the form.

disabled disables interaction with the checkbox.

color is the checked state's color.

variant decides how much surface the row carries. list is a plain row with no box; card wraps the whole row in a tinted surface that fills in when checked, which suits a standalone option toggle.

highlight fills a checked card with its color instead of the neutral fill — the same card, only the colour changes. Unchecked cards stay neutral, and it does nothing to a list checkbox.

indicator sets which side the box sits on, or hidden to drop it entirely.

Every indicator works on a card too. start is the default; end moves the box to the right edge, for when the label should lead; hidden drops it, leaving the card's fill to show which are checked — it stays a real checkbox underneath, so it's still clickable and announced.