overview

01
como deve aparecer no perfil

variantes

02

Single column (default)

Forms longos · mais legível, melhor em mobile.

Inline

Forms curtos (login, busca) · economiza espaço vertical.

estados

03
email válido
senha fraca · considere mais caracteres
campo desabilitado · faça login pra editar

modifiers · api

04
proptipodefaultdescrição
.form-groupclassagrupador label+input+helper
.form-labelclasslabel uppercase mono
.form-label .reqclassasterisco obrigatório
.form-helperclasstexto auxiliar abaixo
.form-errorclassmensagem de erro
.invalidclass no inputestado de erro visual

quando usar

05

use

  • Single column como default
  • Labels acima dos inputs (não ao lado)
  • Botão primary à esquerda, ghost à direita
  • Helper antes do erro, não substituído

não use

  • Placeholder substituindo label
  • Mais de 6-8 campos sem agrupar
  • Validar antes do submit (só se for crítico)
  • Asterisco vermelho sem indicação textual

acessibilidade

06 · wcag aa

código

07 · html
<form> <div class="form-group"> <label class="form-label" for="name">nome <span class="req">*</span></label> <input class="input" id="name" required> <div class="form-helper">ajuda</div> </div> <button type="submit" class="btn btn--primary">enviar</button> </form>