Numeric Stepper (Visual Pattern)
A numeric stepper shows a number you can type and controls to add or subtract. It may use a native number input or ARIA spinbutton semantics. Plus and minus buttons alone do not create those semantics.
A real example
For ticket quantity, a person can type 4 or press the plus and minus controls.
Main parts
- 01Persistent label
- 02Input control
- 03Hint or format
- 04Validation message
Use it when
Use this pattern for a quantity with limits when one-step changes are common. Build and test the correct input or spinbutton semantics.
Do not use it when
Never treat its visual name as an accessibility role. Also avoid it for a wide range that would take too many presses.
Name used in code
<input type="number"> Before you ship
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: Use Numeric Stepper (Visual Pattern) to solve this user need without losing the current context. User context: For ticket quantity, a person can type 4 or press the plus and minus controls. Recommended pattern: Numeric Stepper (Visual Pattern). Why it fits: Use this pattern for a quantity with limits when one-step changes are common. Build and test the correct input or spinbutton semantics. Do not use it when: Never treat its visual name as an accessibility role. Also avoid it for a wide range that would take too many presses. 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): No single official standard controls the whole term. Its meaning may change across teams, platforms, or frameworks. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Check this request
Review the current use of Numeric Stepper (Visual Pattern). Definition: A numeric stepper shows a number you can type and controls to add or subtract. It may use a native number input or ARIA spinbutton semantics. Plus and minus buttons alone do not create those semantics. 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, report the evidence you found, gaps, severity, and the smallest safe fix.