Spinbutton
Botão de incremento
Spinbutton é o nome ARIA para um controle que seleciona um valor de um intervalo definido. Normalmente, as pessoas podem digitar um valor ou aumentá-lo e diminuí-lo. Um stepper numérico é uma forma de como ele pode se apresentar.
Um exemplo real
Um trabalhador de laboratório define uma temperatura para 37,5°C. A seta para cima adiciona 0,5, Page Up adiciona 5 e o valor para no máximo verificado de 45°C. Colar texto inválido mostra um erro em vez de alterá-lo silenciosamente.
Partes principais
- 01valor editável
- 02Controles de incremento
- 03Limites e passo
Use-o quando
Use-o quando as pessoas frequentemente ajustam um valor por etapas definidas e também precisam digitar o valor. O valor deve ter limites claros.
Não o use quando
Botões de mais e menos sozinhos não formam um spinbutton. Evite-o para valores sem limites, listas de escolhas muito longas ou tarefas em que um input normal seja mais claro.
Nome usado no código
input[type=number] or role=spinbutton with valuemin/valuemax/valuenow 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 Botão de incremento (Spinbutton). User context: Um trabalhador de laboratório define uma temperatura para 37,5°C. A seta para cima adiciona 0,5, Page Up adiciona 5 e o valor para no máximo verificado de 45°C. Colar texto inválido mostra um erro em vez de alterá-lo silenciosamente. Recommended pattern: Botão de incremento (Spinbutton). Why it fits: Use-o quando as pessoas frequentemente ajustam um valor por etapas definidas e também precisam digitar o valor. O valor deve ter limites claros. Do not use it when: Botões de mais e menos sozinhos não formam um spinbutton. Evite-o para valores sem limites, listas de escolhas muito longas ou tarefas em que um input normal seja mais claro. 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): O padrão cobre apenas o escopo listado. Ele não escolhe o estilo visual, decisão do produto ou exemplo de Vibulary. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Conferir este pedido
Review how Botão de incremento (Spinbutton) is used now. Definition: Spinbutton é o nome ARIA para um controle que seleciona um valor de um intervalo definido. Normalmente, as pessoas podem digitar um valor ou aumentá-lo e diminuí-lo. Um stepper numérico é uma forma de como ele pode se apresentar. 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.