Form Field
Campo do Formulário
Uma unidade completa de input com um label visível, um controle, ajuda opcional, estado de validação e uma mensagem de erro ligada.
Um exemplo real
Um campo de ID de imposto mantém seu rótulo visível. Ele explica o formato antes de você digitar e leva a um erro claro depois da validação.
Partes principais
- 01Rótulo persistente
- 02Input control
- 03Hint or format
- 04Validation message
Use-o quando
Dê a cada valor um campo completo com um nome acessível e um local consistente para ajuda e erros.
Não o use quando
Não use texto de espaço reservado como único rótulo. Não mostre um erro apenas pela cor.
Nome usado no código
label + input + aria-describedby + error message Antes de lançar
Give each field a label that code can read. Link hints and errors, and keep entered values. Check autofill, keyboard order, validation timing, submit states, failure recovery, zoom, and languages.
Outcome: Complete the task with Campo do Formulário (Form Field). User context: Um campo de ID de imposto mantém seu rótulo visível. Ele explica o formato antes de você digitar e leva a um erro claro depois da validação. Recommended pattern: Campo do Formulário (Form Field). Why it fits: Dê a cada valor um campo completo com um nome acessível e um local consistente para ajuda e erros. Do not use it when: Não use texto de espaço reservado como único rótulo. Não mostre um erro apenas pela cor. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary): É oficial para essa fonte. Outras plataformas ou equipes podem usar o termo de outra maneira. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Conferir este pedido
Review how Campo do Formulário (Form Field) is used now. Definition: Uma unidade completa de input com um label visível, um controle, ajuda opcional, estado de validação e uma mensagem de erro ligada. Release checks: Give each field a label that code can read. Link hints and errors, and keep entered values. Check autofill, keyboard order, validation timing, submit states, failure recovery, zoom, and languages. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.