CSS: form-field

.instui-form-field — Um wrapper de campo de formulário: um rótulo, seus controles e layouts inline, obrigatórios ou somente leitura.

Uma mensagem de erro permanece oculta até que o controle do campo esteja :user-invalid (após o usuário interagir) ou você adicione a classe -invalid. Use -layout-inline para posicionar o rótulo ao lado dos controles e -layout-stacked para colocá‑lo acima. Também define seu próprio gap entre o rótulo, os controles e as mensagens; encadear um modificador utilitário de espaçamento -gap-* sobrescreve esse valor interno.

Source: form-field.css

Acessibilidade

O elemento <label> envolve o controle, de modo que o texto do rótulo o nomeia nativamente; o asterisco de obrigatoriedade é decorativo e deve ser ocultado da tecnologia assistiva (aria-hidden), e a mensagem de erro aparece assim que o controle estiver :user-invalid ou você adicionar a classe -invalid.

Uso

@import "@pantoken/components/components.css";
@import "@pantoken/components/form-field.css";

Exemplos

<label class="instui-form-field">
  <span class="label">Email address</span>
  <span class="controls"><input class="instui-text-input" type="email" placeholder="[email protected]"></span>
  <div class="instui-form-field-messages">
    <span class="instui-form-field-message -type-hint">We'll never share it.</span>
    <span class="instui-form-field-message -type-error">Enter a valid email address.</span>
  </div>
</label>

Estrutura

.instui-form-field
  .label
  .controls
    text-input (component)
  form-field-messages (component)

flowchart TD n0[".instui-form-field"]:::cssdoc-root n1(".label"):::cssdoc-part n2(".controls"):::cssdoc-part n3(["text-input"]):::cssdoc-component n4(["form-field-messages"]):::cssdoc-component n0 --> n1 n2 --> n3 n0 --> n2 n0 --> n4 click n3 "/api/css/text-input.md" click n4 "/api/css/form-field-messages.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

Modificadores

Modificador	Descrição
.-inline	Layout inline (abreviação para -layout-inline).
.-invalid	Estado inválido (erro).
.-label-align-end	Alinha o texto do rótulo à extremidade (end).
.-label-align-start	Alinha o texto do rótulo ao início (start).
.-layout-inline	Layout inline: rótulo ao lado dos controles.
.-layout-stacked	Layout empilhado: rótulo acima dos controles.
.-readonly	Estado somente leitura.
.-v-align-bottom	Alinha o rótulo na parte inferior em relação aos controles.
.-v-align-top	Alinha o rótulo no topo em relação aos controles.

Partes

Parte	Descrição
.controls	A área de controle ao lado ou abaixo do rótulo.
.label	O rótulo do campo.

Pseudo-elementos

Pseudo-elemento	Descrição
::after	Renderiza o asterisco decorativo de campo obrigatório após o texto do rótulo quando o campo for obrigatório.

Estados

Estado	Descrição
:required	—

Tokens consumidos

Token	Tipo	Valor
--instui-component-form-field-layout-asterisk-color	<color>	LightDarklight-dark(#CF1F24, #FA917F)
--instui-component-form-field-layout-font-family	[ <font-family-name> | <generic-font-family> ]#	Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-form-field-layout-font-size	<length>	1rem
--instui-component-form-field-layout-font-weight	<integer>	400
--instui-component-form-field-layout-gap-inputs	<length>	0.75rem
--instui-component-form-field-layout-gap-primitives	<length>	0.5rem
--instui-component-form-field-layout-line-height	<length>	1.125rem
--instui-component-form-field-layout-readonly-text-color	<color>	LightDarklight-dark(#576773, #AAB0B5)
--instui-component-form-field-layout-text-color	<color>	LightDarklight-dark(#273540, #ffffff)

Compatibilidade do navegador

• Contém os estilos do seu elemento com a at-rule CSS @scope; requer uma versão recente do Chromium, Firefox ou Safari.

Subcomponentes

• form-field-messages
• text-input

Relacionado

• form-field-messages — Renderiza as mensagens de dica, erro e sucesso do campo.
• form-field-group — Agrupa campos relacionados sob uma legenda compartilhada.