API jQuery UI - Widget Spinner
Catégorie
Utilisation
Description :Améliore la saisie de texte pour la saisie de valeurs numériques, avec des boutons haut/bas et la gestion des touches fléchées.
Version ajoutée :1.9
Spinner, ou widget d'incrémentation numérique, est le widget parfait pour gérer tous les types de saisie numérique. Il permet à l'utilisateur de saisir directement une valeur, ou de modifier une valeur existante en la faisant varier avec le clavier, la souris ou la molette de défilement. Lorsqu'il est combiné avec Globalize, vous pouvez même faire varier des devises et des dates dans divers paramètres régionaux.
Spinner utilise deux boutons pour superposer au champ de saisie une incrémentation et une décrémentation de la valeur actuelle. Spinner ajoute des événements keydown afin que la même incrémentation et décrémentation puissent être effectuées avec le clavier. Spinner délègue àGlobalizele formatage et l'analyse des nombres.
Interaction au clavier
- UP : Incrémente la valeur d'un pas.
- DOWN : Décrémente la valeur d'un pas.
- PAGE UP : Incrémente la valeur d'une page.
- PAGE DOWN : Décrémente la valeur d'une page.
Le focus reste dans le champ de texte après avoir cliqué sur les boutons du spinner avec la souris.
Tant que le spinner n'est pas en lecture seule (<input readonly>), les utilisateurs peuvent saisir des valeurs qui peuvent être invalides (inférieures au minimum, supérieures au maximum, non conformes au pas, saisie non numérique). Lors de l'incrémentation ou de la décrémentation, que ce soit par programmation ou via les boutons du spinner, la valeur est forcée à une valeur valide (pour plus d'informations, voir lastepUp()etstepDown()description.
Thèmes
Le widget Spinner utilise lejQuery UI CSS frameworkpour définir ses styles d'apparence et de convivialité. Si vous avez besoin d'utiliser des styles spécifiques au Spinner, vous pouvez utiliser les noms de classes CSS suivants :
ui-spinner: Le conteneur externe du spinner.ui-spinner-input: l'élément<input>sur lequel le widget Spinner est instancié.ui-spinner-button: Les boutons de contrôle utilisés pour incrémenter ou décrémenter la valeur du spinner. Le bouton haut aura également uneui-spinner-upclasse, et le bouton bas aura également uneui-spinner-downclasse。
Dépendances
- Noyau UI
- Fabrique de widgets
- Widget Bouton
- Globalize(externe, facultatif ; lorsqu'il est utilisé avec le
cultureetnumberFormatoption)
Notes supplémentaires
- Ce widget nécessite du CSS fonctionnel, sinon il ne fonctionnera pas. Si vous créez un thème personnalisé, veuillez utiliser le fichier CSS spécifique au widget comme point de départ.
- Ce widget manipule la valeur de l'élément par programmation, donc l'événement natif
changen'est pas déclenché lorsque la valeur de l'élément change. - La création d'un spinner sur
<input type="number">n'est pas prise en charge, car elle entraînera des conflits avec l'interface native du spinner.
Exemples
Un spinner numérique de base.
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>旋转器部件(Spinner Widget)演示</title> <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> <script src="//code.jquery.com/jquery-1.10.2.js"></script> <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script> </head> <body> <input id="spinner"> <script> $( "#spinner" ).spinner(); </script> </body> </html>Autres extensions