Components / Choice box

Choice Box

Selectable card-style control for settings, plans, and preference groups.

Checkbox Mode

Use as a boolean card with title and description.

Radio Mode

Use value + same name to build premium option pickers.

MayaChoiceBox Props API

Prop / EventTypeDefaultDescription
modelValueChoiceValue | ChoiceValue[] | nullfalseThe selected state or value array. Used with v-model.
valueChoiceValuetrueThe value to associate with this specific box.
typeString"checkbox"The input type: "checkbox" or "radio".
nameStringundefinedNative input name attribute for grouping.
titleString""Primary title text.
descriptionString""Secondary descriptive text.
disabledBooleanfalseWhether the choice box is disabled.
@update:modelValueEventEmitted when selection changes.
@changeEventEmitted with the checked boolean.
#titleSlotSlot for custom title rendering.
#descriptionSlotSlot for custom description rendering.
#defaultSlotDefault slot for extra inner content.