diff --git a/docs/components/forms/checkbox-group.md b/docs/components/forms/checkbox-group.md index dc8e4ccb..fb080fdd 100644 --- a/docs/components/forms/checkbox-group.md +++ b/docs/components/forms/checkbox-group.md @@ -3,21 +3,27 @@ CheckboxGroups são componentes de formulário que permitem seleções binárias e múltiplas. --- +
## Quando usar: + - Quando precisar de um componente de formulário para seleções binárias com várias opções.
## Quando não usar: -- Quando for preciso que o efeito da interação com o Checkbox seja imediato. Checkboxes devem ser usados sempre em conjunto com um botão de submissão. Para contornar casos como esse, use Switches. +- Quando for preciso que o efeito da interação com o Checkbox seja imediato. Checkboxes devem ser usados sempre em conjunto com um botão de submissão. Para contornar casos como esse, use Switches. --- ## Uso +### Customização com Slot de Escopo (Scoped Slot) +O `CheckboxGroup` expõe um único slot com escopo chamado `#append`. Ele permite customizar a área à direita de cada checkbox individual do grupo usando o objeto `option` atual. + +#### Exemplo 1: Exibindo um elemento padrão em todas as opções ```js +> + + +``` + +#### Exemplo 2: Renderização condicional para opções específicas +Para customizar de forma exclusiva apenas determinados checkboxes, você pode utilizar a renderização condicional baseada na propriedade `option.value`: + +```js + + + ``` --- @@ -70,6 +115,14 @@ CheckboxGroups são componentes de formulário que permitem seleções binárias />
+## Slots + + +
+