Ir para o conteúdo principal
WBC - GovBR-DS
Copiar página como Markdown para IA

SelectOption

Anatomia, uso, comportamento visual e recomendações conceituais são mantidos pelo Padrão Digital de Governo. Esta página documenta a implementação Web Components e sua API executável.

Visão Geral

Design System

Para a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o Design System do GovBR.

Exemplos

Propriedades

active

Atributoactive
DescriçãoMarca a opção como ativa para navegação por teclado.
Tipoboolean
Valor padrãofalse

disabled

Atributodisabled
DescriçãoDesativa a interação da opção.
Tipoboolean
Valor padrãofalse

indeterminate

Atributoindeterminate
DescriçãoIndica o estado intermediário da opção.
Tipoboolean
Valor padrãofalse

label

Atributolabel
DescriçãoRótulo textual exibido para a opção.
Tipostring
Valor padrão---

selected

Atributoselected
DescriçãoIndica se a opção está selecionada.
Tipoboolean
Valor padrãofalse

showCheckbox

Atributoshow-checkbox
DescriçãoExibe o checkbox de seleção ao lado do conteúdo.
Tipoboolean
Valor padrãofalse

value

Atributovalue
DescriçãoValor semântico associado à opção.
Tipostring
Valor padrãoundefined

Eventos

EventoDescriçãoDepreciaçãoPropagação
brSelectOptionPropsChange Componente mantido por compatibilidade; prefira a alternativa indicada na documentação.Evento legado emitido quando as propriedades da opção são alteradas.Use brSelectOptionStateChange.true
brSelectOptionStateChangeEvento emitido quando o estado da opção muda.---true

Métodos

getItemHeight

DescriçãoRetorna a altura efetiva da opção para cálculo de virtual scroll.
AssinaturagetItemHeight() => Promise<number>
Parâmetros---

setFocus

DescriçãoEncaminha o foco para o elemento interativo interno da opção.
AssinaturasetFocus() => Promise<void>
Parâmetros---

setSelectedState

DescriçãoAtualiza programaticamente o estado selecionado da opção.
AssinaturasetSelectedState(selected?: boolean) => Promise<void>
Parâmetrosselected: Estado desejado. Quando omitido, o valor atual é invertido.

Dependências

Componente pai

Usado por

Depende de

Gráfico

Migração: Vue 1.x → Stencil 2.x

Propriedades

🟦 Propriedades renomeadas

Propriedade VuePropriedade StencilDescriçãoTipoPadrão

🟥 Propriedades removidas

PropriedadeDescriçãoTipoPadrão

🟩 Novas propriedades

PropriedadeDescriçãoTipoPadrão

Eventos

🟦 Eventos renomeados

Evento VueEvento StencilDescrição

🟥 Eventos removidos

PropriedadeDescriçãoTipoPadrão

🟩 Novos eventos

EventoDescrição

Slots

🟦 Slots renomeados

Slot VueSlot StencilDescrição

🟥 Eventos removidos

PropriedadeDescriçãoTipoPadrão

🟩 Slots criados

SlotDescrição