Status na matriz: Limitado.
Campos de texto, select, checkbox, radio e switch
Usa apenas classes públicas do Bootstrap (.form-control,
.form-select, .form-label, .form-text,
.form-check, .form-switch)
— nenhuma classe .br-* é necessária (RF-03). Esta página
serve como fixture de teste e como catálogo demonstrativo (RF-07/RF-11).
Ver docs/requisitos.md para a matriz de
compatibilidade.
Campo de texto — label, ajuda e foco
Campo de texto — erro e sucesso
Tamanhos (referência GOV.BR DS: 32 / 40 / 48px de altura, aproximado)
Desabilitado e navegação por teclado
Use Tab para navegar entre os campos e observar o foco visível.
Checkbox e radio
Select
Switch
Como no padrão do GOV.BR DS (rótulo à esquerda), com .form-check-reverse:
Web component (<dsgovbr-campo>)
JS opcional (dsgovbr-bootstrapped-componentes.js) que gera rótulo, controle nativo
(<input>, <select> ou <textarea>), ajuda e feedback, com
for, id, aria-describedby e aria-invalid ligados sozinhos, só com as
classes do Bootstrap acima. O controle é real e fica dentro do <form>: o valor é enviado normalmente e os
eventos input/change e a validação nativa funcionam sem nada a mais.
<script src="dist/dsgovbr-bootstrapped-componentes.js" defer></script>
...
<form method="post">
<dsgovbr-campo tipo="email" nome="email" rotulo="E-mail" obrigatorio
ajuda="Usamos só para avisos."></dsgovbr-campo>
<dsgovbr-campo tipo="select" nome="uf" rotulo="Estado" valor="RN">
<dsgovbr-opcao valor="RN">Rio Grande do Norte</dsgovbr-opcao>
<dsgovbr-opcao valor="PB">Paraíba</dsgovbr-opcao>
</dsgovbr-campo>
</form>
campo.setAttribute("erro", "Informe um e-mail válido"); // erro="" limpa
campo.validar(); // validação nativa -> mostra a mensagem
campo.valor = "x@y.gov.br"; campo.controle.focus();
| Atributo | Efeito |
|---|---|
tipo | text (padrão), email, password, number, search, tel, url, date e afins, textarea, select, checkbox, switch ou radio (grupo em <fieldset>, com <dsgovbr-opcao>). |
nome, rotulo, valor, placeholder | name do controle, texto do rótulo, valor inicial e dica. |
obrigatorio | required no controle e " *" (oculto para leitores de tela) no rótulo. |
desabilitado, somente-leitura | disabled e readonly. |
tamanho | sm ou lg (.form-control-sm/-lg, .form-select-sm/-lg). |
prefixo, sufixo | Texto ao redor do controle (.input-group). |
ajuda, erro, sucesso | .form-text, .invalid-feedback + .is-invalid e .valid-feedback + .is-valid, com aria-describedby e aria-invalid. Valem sobre os filhos <dsgovbr-ajuda>, <dsgovbr-erro> e <dsgovbr-sucesso>; um atributo vazio limpa o estado. O erro vence o sucesso. |
marcado, linhas, autocomplete | Estado inicial de checkbox/switch, linhas do textarea e autocomplete. |
min, max, step, pattern, maxlength, minlength, inputmode | Repassados ao controle. |
Mudar um atributo (ex.: erro) remonta o campo sem perder o que a pessoa digitou, escolheu ou o foco.
Propriedades: controle (o elemento nativo), valor (leitura e escrita) e validar().
Diferenças conhecidas em relação à referência GOV.BR DS (RF-05)
- O web component
<dsgovbr-campo>não cria controle customizado nem usaElementInternals: o<input>,<select>ou<textarea>é o nativo, dentro do<form>. Não há os estadoswarningeinfodo GOV.BR DS, nem máscara de entrada. - Estados de validação: o GOV.BR DS usa borda de 2px na cor do estado. Aqui o desenho é o mesmo (borda de 1px + sombra interna de 1px na mesma cor), mas a espessura computada da borda segue 1px — escolha para não alterar a altura do campo. O GOV.BR DS também tem os estados
warningeinfonos campos, que o Bootstrap não tem (não replicados). - Marca de seleção: o GOV.BR DS desenha o "check" com bordas rotacionadas via pseudo-elemento; mantemos o ícone SVG nativo do Bootstrap, recolorido pelo
$primaryjá mapeado. Aproximação visual, não replicação de anatomia. - Foco: campos de texto usam o foco do GOV.BR DS (borda dourada
#c2850c+ anel de 2px); checkbox e radio ainda usam o anel azul do Bootstrap, não o foco dourado. - Select: é o
<select>nativo com a superfície dos campos de texto e a seta na cor interativa, no lugar do botão circular do Select do GOV.BR DS. A lista aberta é a do navegador: sem busca, sem seleção múltipla com checkbox e sem o "Selecionar todos". - Switch: tamanho médio do GOV.BR DS (trilho de 52x30px, botão de 22px, trilho branco também quando ligado, hover em camada e foco dourado). O Bootstrap põe o switch à esquerda do rótulo; para o padrão do GOV.BR DS (rótulo à esquerda), use
.form-check-reverse. Sem os tamanhos pequeno e grande, a posição acima do rótulo, os ícones no botão e o texto de estado (data-enabled/data-disabled). - Altura dos campos: aproximada (32/40/48px), sem paridade de pixel garantida em todas as fontes/navegadores.