Quantity Spin Button Example
- -About This Example
-- The following example uses the Spin Button Pattern to implement three quantity inputs. -
-Similar examples include:
--
-
- Toolbar Example: A toolbar that contains a spin button for setting font size. -
-
-
Example
-Accessibility Features
--
-
-
- The element with role
spinbuttonallows text input, for - users who prefer to enter a value directly. -
- - - The spin button input and its adjacent buttons are visually - presented as a single form field containing an editable value, an - increment button, and a - decrement button. - -
- - When either the spin button input or its adjacent buttons have - received focus, a single visual focus indicator encompasses all - three, reinforcing the relationship between them. - -
- - For users who have not set a preference for reduced motion, the - focus indicator appears with subtle animation to draw attention. - -
-
- The increment and decrement buttons:
-
-
-
- - Are generously sized for ease of use. - -
- - Are adjacent to the spin button input so they can be accessed by - users of touch-based and voice-based assistive technologies. - -
-
- Are labeled with the
titleattribute, providing a - human-friendly representation of the plus and minus characters - for users of touch-based and voice-based assistive technologies. The -titleattribute also presents a tooltip on hover, - clarifying the meaning of each button’s icon. -
- - - Use an invisible live region to announce the updated value - when pressed. The live region empties its contents after 3 - seconds to avoid leaving stale content in the document. - -
-
- Are excluded from the page Tab sequence with
-
tabindex="-1"because they are redundant with the - arrow key support provided to keyboard users. -
- -
- Can be activated with voice control by speaking a command such
- as
Click add adult
. -
-
- - - When forced colors are enabled, system - color keywords are used to ensure visibility and sufficient - contrast for the spin button’s content and interactive states. - -
-
- Each spin button’s minimum and maximum values are programmatically
- defined with
aria-valueminand -aria-valuemax, enabling assistive technologies to - convey that information to users in a predictable manner. -
- -
- The minimum and maximum values are also visually expressed with
- adjacent help text, but is purposefully not associated using
-
aria-describedbysince the same information is already - programmatically defined. -
- -
- When a user inputs an invalid value:
-
-
-
- - The spin button is visually styled to indicate an error state. - -
-
-
aria-invalid="true"is added to the input to inform - assistive technologies of the invalid state. -
- -
- An error message is displayed and associated with
- the input using
aria-errormessage. -
-
-
Keyboard Support
-The spin buttons provide the following keyboard support described in the Spin Button Pattern.
-| Key | -Function | -
|---|---|
| Down Arrow | -Decreases value by 1. | -
| Up Arrow | -Increases value by 1. | -
| Home | -Decreases to minimum value. | -
| End | -Increases to maximum value. | -
| Standard single line text editing keys | -
-
|
-
Role, Property, State, and Tabindex Attributes
-| Role | -Attribute | -Element | -Usage | -
|---|---|---|---|
spinbutton |
- - | input[type="text"] |
- Identifies the input[type="text"] element as a spin button. |
-
| - | aria-valuenow="NUMBER" |
- input[type="text"] |
-
-
|
-
| - | aria-valuemin="NUMBER" |
- input[type="text"] |
- Indicates the minimum allowed value for the spin button. | -
| - | aria-valuemax="NUMBER" |
- input[type="text"] |
- Indicates the maximum allowed value for the spin button. | -
| - | aria-invalid="true" |
- input[type="text"] |
- Indicates that the current value is invalid. | -
| - | aria-errormessage="ID_REF" |
- input[type="text"] |
- Identifies the element that provides an error message for the spin button. | -
| - | title="NAME_STRING" |
- button |
- Defines the accessible name for each increment and decrement button (Remove adult, Add adult, Remove kid, Add kid, Remove animal, and Add animal). |
-
| - |
- aria-controls="ID_REF"
- |
- button |
- Identifies the element whose value will be modified when the button is activated. | -
| - | tabindex="-1" |
- button |
- Removes the increment and decrement buttons from the page Tab sequence while keeping them focusable so they can be accessed with touch-based and voice-based assistive technologies. | -
| - | aria-disabled="true" |
- button |
- Set when the minimum or maximum value has been reached to inform assistive technologies that the button has been disabled. | -
| - | aria-hidden="true" |
- span |
- For assistive technology users, hides the visible minus and plus characters in the increment and decrement buttons since they are symbolic of the superior button labels provided by the title attribute. |
-
| - | - | output |
-
-
|
-
JavaScript and CSS Source Code
--
-
- - CSS: - quantity-spinbutton.css - -
- - JavaScript: - - -
HTML Source Code
-To copy the following HTML code, please open it in CodePen.
- -
-
-
-