Spinbutton
Bouton de sélection
Spinbutton est le nom ARIA pour un contrôle qui permet de choisir une valeur dans une plage définie. Les personnes peuvent généralement saisir une valeur ou l’augmenter et la diminuer. Un stepper numérique est une façon dont il peut apparaître.
Un vrai exemple
Un chercheur en laboratoire règle une température à 37,5°C. Flèche haut ajoute 0,5, Page Up ajoute 5, et la valeur s'arrête au maximum contrôlé de 45°C. Coller un texte invalide affiche une erreur au lieu de le modifier silencieusement.
Parties principales
- 01Valeur modifiable
- 02Contrôles d'incrément
- 03Limites et étape
Utilisez-le lorsque
Utilisez-le lorsque les utilisateurs ajustent souvent une valeur par étapes définies et doivent également saisir la valeur. La valeur doit avoir des limites claires.
Ne l'utilisez pas lorsque
Les boutons plus et moins seuls ne constituent pas une zone de défilement (spinbutton). Évitez-les pour les valeurs sans limites, les très longues listes de choix ou les tâches où un champ de saisie normal est plus clair.
Nom utilisé dans le code
input[type=number] or role=spinbutton with valuemin/valuemax/valuenow Avant d'expédier
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 Bouton de sélection (Spinbutton). User context: Un chercheur en laboratoire règle une température à 37,5°C. Flèche haut ajoute 0,5, Page Up ajoute 5, et la valeur s'arrête au maximum contrôlé de 45°C. Coller un texte invalide affiche une erreur au lieu de le modifier silencieusement. Recommended pattern: Bouton de sélection (Spinbutton). Why it fits: Utilisez-le lorsque les utilisateurs ajustent souvent une valeur par étapes définies et doivent également saisir la valeur. La valeur doit avoir des limites claires. Do not use it when: Les boutons plus et moins seuls ne constituent pas une zone de défilement (spinbutton). Évitez-les pour les valeurs sans limites, les très longues listes de choix ou les tâches où un champ de saisie normal est plus clair. 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): La norme couvre uniquement le champ d'application énuméré. Elle ne choisit ni le style visuel, ni la décision de produit, ni l'exemple de Vibulary. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Vérifiez cette demande
Review how Bouton de sélection (Spinbutton) is used now. Definition: Spinbutton est le nom ARIA pour un contrôle qui permet de choisir une valeur dans une plage définie. Les personnes peuvent généralement saisir une valeur ou l’augmenter et la diminuer. Un stepper numérique est une façon dont il peut apparaître. 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.