Champ numérique
VNumberInput est un champ pour un nombre, avec des boutons de pas, le clavier d’un spinbutton et un formatage selon la locale.
Utilisation
vue
Between 1 and 10.
Exemples
Boutons
controls place les boutons de pas de part et d’autre, les empile à la fin ou les retire. Ils restent hors de l’ordre de tabulation : les flèches du clavier agissent depuis le champ.
vue
Formatage
formatOptions reçoit les options d’Intl.NumberFormat. La valeur est formatée hors édition et affichée brute pendant la saisie. Avec style: 'percent', 0,15 s’affiche et se saisit 15.
vue
Pas
step fixe de combien les flèches et les boutons déplacent la valeur, sur une grille qui part de min. Les pas décimaux ne dérivent pas.
vue
Page Up and Page Down move ten steps.
API
Props
| Prop | Type | Défaut |
|---|---|---|
min | number | aucune |
| Plus petite valeur. Une valeur saisie inférieure y est ramenée à la validation. | ||
max | number | aucune |
| Plus grande valeur. Une valeur saisie supérieure y est ramenée à la validation. | ||
step | number | 1 |
| Déplacement des flèches et des boutons. Page précédente et Page suivante déplacent de dix pas. | ||
formatOptions | Intl.NumberFormatOptions | aucune |
Options d’Intl.NumberFormat pour la valeur affichée : devise, unité, pourcentage ou décimales. | ||
locale | string | aucune |
| Locale utilisée pour formater et lire le nombre. Par défaut, celle de la bibliothèque. | ||
controls | NumberInputControls'split' | 'stacked' | 'none' | 'split' |
| Position des boutons de pas. | ||
incrementLabel | string | aucune |
| Nom accessible du bouton plus. Par défaut, celui du dictionnaire de la bibliothèque. | ||
decrementLabel | string | aucune |
| Nom accessible du bouton moins. Par défaut, celui du dictionnaire de la bibliothèque. | ||
size | InputSize'sm' | 'md' | 'lg' | 'md' |
Taille du champ. Remplacée quand VInputGroup définit size. | ||
compact | boolean | false |
Réduit la hauteur sans changer les marges ni le texte. Remplacé quand VInputGroup définit compact. | ||
label | string | aucune |
Libellé visible lié au champ. Sans lui, fournissez aria-label ou aria-labelledby. | ||
hint | string | aucune |
Aide sous le champ, liée par aria-describedby. | ||
error | string | aucune |
Message d’erreur affiché à la place de l’aide. Définit aria-invalid et est annoncé quand il apparaît. | ||
invalid | boolean | false |
Définit aria-invalid et le style d’erreur. | ||
disabled | boolean | false |
| Désactive le champ et ses boutons. | ||
readonly | boolean | false |
| Empêche la saisie et les pas, en laissant le focus et la copie possibles. | ||
clearable | boolean | false |
Ajoute un bouton d’effacement qui met la valeur à null. | ||
clearLabel | string | aucune |
| Nom accessible du bouton d’effacement. Par défaut, celui du dictionnaire de la bibliothèque. | ||
loading | boolean | false |
| Affiche un indicateur de chargement à la fin du champ. | ||
loadingText | string | aucune |
| Texte accessible de l’indicateur. Par défaut, celui du dictionnaire de la bibliothèque. | ||
v-model | number | null | null |
Valeur du champ, un nombre, ou null quand il est vide. La saisie est validée à la sortie du champ et sur Entrée. | ||
Événements
| Événement | Type |
|---|---|
clear | [] |
Émis après que le bouton d’effacement a mis la valeur à null. | |