Skip to content

Toggle Group

Grupo de botões de alternância para seleção única ou múltipla.

Uso

vue
<script setup lang="ts">
import { ToggleGroup } from '@halfbyte/maka'
import { ref } from 'vue'

const alinhamento = ref(['left'])

const items = [
  { value: 'left',   label: 'Esq' },
  { value: 'center', label: 'Centro' },
  { value: 'right',  label: 'Dir' },
]
</script>

<template>
  <ToggleGroup v-model="alinhamento" :items="items" />
</template>

Exemplos

vue
<!-- Múltipla seleção -->
<ToggleGroup :items="items" :multiple="true" v-model="vals" />

<!-- Vertical -->
<ToggleGroup :items="items" orientation="vertical" v-model="val" />

Props

PropTipoPadrão
itemsToggleGroupItem[]obrigatório
modelValuestring | string[]
multiplebooleanfalse
disabledbooleanfalse
orientation"horizontal" | "vertical""horizontal"
size"sm" | "md" | "lg""md"

ToggleGroupItem

CampoTipoDescrição
valuestringIdentificador único
labelstringTexto exibido (opcional)
disabledbooleanDesabilita o item (opcional)

Slots

SlotDescrição
{value}Conteúdo customizado para o item de dado valor

Events

EventoPayloadDescrição
update:modelValuestring[]Emitido ao alterar a seleção