Pular para o conteúdo principal

Switch


Componente Switch


📘 Modo de Uso

O componente Switch é ideal para situações onde o usuário precisa alternar rapidamente entre dois estados opostos, como ligado/desligado ou ativado/desativado.
Ele deve ser utilizado quando a ação é imediata e não requer confirmação adicional (ex.: ativar notificações, habilitar modo escuro, permitir acesso a dados).


🧩 Anatomia

Anatomia


📋 Propriedades

Propriedades


⌨️ Código

  • opl.selectionControl.component.switch

🎨 Variantes

Estados

Variante de Estado

Tamanhos

Variante de Tamanho

Opções

Variante de Opções


🛡️ Boas Práticas e Acessibilidade

  • Use labels claros e objetivos próximos ao switch para indicar o estado atual e sua função.
  • Evite usar switch para ações irreversíveis ou críticas (use checkbox ou botão de confirmação nesses casos).
  • Certifique-se de que o estado inicial está correto e não causa efeitos inesperados ao usuário.
  • Garanta que o switch seja acessível via teclado e compatível com leitores de tela (WCAG 2.1: 1.3.1 e 4.1.2).