Numeric Stepper (Visual Pattern)
Controlador Numérico (Padrão Visual)
Um seletor de números mostra um número que você pode digitar e controles para adicionar ou tirar. Ele pode usar um input de número nativo ou a semântica de ARIA spinbutton. Só os botões de mais e menos não criam essa semântica.
Um exemplo real
Para quantidade de ingressos, uma pessoa pode digitar 4 ou pressionar os controles de mais e menos.
Partes principais
- 01Rótulo persistente
- 02Input control
- 03Hint or format
- 04Validation message
Use-o quando
Use este padrão para uma quantidade com limites quando mudanças de um passo são comuns. Construa e teste a semântica correta de entrada ou botão de incremento.
Não o use quando
Nunca trate seu nome visual como um papel de acessibilidade. Também evite isso para um intervalo amplo que exigiria muitos pressionamentos.
Nome usado no código
<input type="number"> 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 Controlador Numérico (Padrão Visual) (Numeric Stepper (Visual Pattern)). User context: Para quantidade de ingressos, uma pessoa pode digitar 4 ou pressionar os controles de mais e menos. Recommended pattern: Controlador Numérico (Padrão Visual) (Numeric Stepper (Visual Pattern)). Why it fits: Use este padrão para uma quantidade com limites quando mudanças de um passo são comuns. Construa e teste a semântica correta de entrada ou botão de incremento. Do not use it when: Nunca trate seu nome visual como um papel de acessibilidade. Também evite isso para um intervalo amplo que exigiria muitos pressionamentos. 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): Nenhum padrão oficial único controla todo o termo. Seu significado pode mudar entre equipes, plataformas ou frameworks. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Conferir este pedido
Review how Controlador Numérico (Padrão Visual) (Numeric Stepper (Visual Pattern)) is used now. Definition: Um seletor de números mostra um número que você pode digitar e controles para adicionar ou tirar. Ele pode usar um input de número nativo ou a semântica de ARIA spinbutton. Só os botões de mais e menos não criam essa semântica. 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.