← Documentação · Componentes · Exemplos

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

Como aparece no seu documento oficial.

Campo de texto — erro e sucesso

Informe um e-mail válido.
CPF válido.

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

Escolha uma opção válida.

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.

Escolha o estado de residência. Selecione Rio Grande do Norte Paraíba E-mail Telefone Nenhum (indisponível)
<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();
AtributoEfeito
tipotext (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, placeholdername do controle, texto do rótulo, valor inicial e dica.
obrigatoriorequired no controle e " *" (oculto para leitores de tela) no rótulo.
desabilitado, somente-leituradisabled e readonly.
tamanhosm ou lg (.form-control-sm/-lg, .form-select-sm/-lg).
prefixo, sufixoTexto 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, autocompleteEstado inicial de checkbox/switch, linhas do textarea e autocomplete.
min, max, step, pattern, maxlength, minlength, inputmodeRepassados 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)