Passer au contenu principal

NumberField

Ouvrir dans ChatGPT
Ombre dwc-field 23.02
Java API

Le composant NumberField accepte des entrées numériques et rejette automatiquement les valeurs non valides. Il prend en charge les bornes minimales et maximales, les intervalles de pas et le texte d'espace réservé.

Utilisation du NumberField​

Inheritance

This class is a Field component, and inherits its features and behaviors. For an overview of Field properties, events, and other important information, please refer to the Field documentation.

NumberField étend la classe partagée Field, qui fournit des fonctionnalités communes à tous les composants de champ. L'exemple suivant crée un NumberField avec une étiquette et un texte d'espace réservé.

Afficher le code

Valeur du champ​

Le composant NumberField stocke sa valeur en tant que Double, permettant un traitement précis des entiers et des nombres décimaux.

Obtenir la valeur actuelle​

Vous pouvez récupérer la valeur numérique saisie par l'utilisateur en utilisant :

Double currentValue = numberField.getValue();

Définir une nouvelle valeur​

Pour définir le champ par programmation :

numberField.setValue(42.5);

Si aucune valeur n'a été saisie et qu'aucune valeur par défaut n'est définie, getValue() renverra null.

conseil

Bien que le champ soit conçu pour n'accepter que des entrées numériques valides, gardez à l'esprit que la valeur sous-jacente peut être nulle. Testez toujours pour null avant d'utiliser le résultat.

Usages​

Le NumberField est particulièrement utile dans les scénarios où la capture, l'affichage ou la manipulation de données numériques est essentielle pour votre application. Voici quelques exemples de quand utiliser le NumberField :

  1. Formulaires de saisie numérique : Lors de la conception de formulaires nécessitant des entrées numériques, l'utilisation d'un NumberField simplifie le processus de saisie pour les utilisateurs. Ceci est particulièrement utile pour les applications qui collectent des données utilisateur ou nécessitent des valeurs numériques.

  2. Analyse de données et calculs : Un NumberField est particulièrement précieux dans les applications impliquant l'analyse de données, les calculs ou les opérations mathématiques. Ils permettent aux utilisateurs d'entrer ou de manipuler des valeurs numériques avec précision.

  3. Applications financières et de budgétisation : Les applications impliquant des calculs financiers, la budgétisation ou le suivi des dépenses nécessitent souvent des saisies numériques précises. Un NumberField garantit une saisie précise des chiffres financiers.

  4. Mesure et conversion d'unités : Dans les applications traitant de mesures ou de conversions d'unités, le NumberField est idéal pour saisir des valeurs numériques avec des unités telles que la longueur, le poids ou le volume.

Valeur minimale et maximale​

Avec la méthode setMin(), vous pouvez spécifier la valeur minimale acceptable dans le champ numérique. Si un utilisateur saisit une valeur inférieure à ce seuil, le composant échouera à la validation des contraintes et fournira un retour approprié.

NumberField numberField = new NumberField();
numberField.setMin(0.0); // Minimum autorisé : 0.0

Séparément, la méthode setMax() vous permet de définir la valeur maximale acceptable. Si un utilisateur saisit une valeur supérieure à cette limite, l'entrée sera rejetée. Lorsque les valeurs minimales et maximales sont définies, la valeur maximale doit être supérieure ou égale à la minimum.

numberField.setMax(100.0); // Maximum autorisé : 100.0

Dans cette configuration, saisir une valeur comme -5 ou 150 serait invalide, tandis que les valeurs comprises entre 0 et 100 sont acceptées.

Granularité​

Vous pouvez utiliser la méthode setStep() pour spécifier la granularité que la valeur doit respecter lors de l'utilisation des touches fléchées pour modifier la valeur. Cela incrémentera ou décrémentera la valeur du composant par un certain pas à chaque fois. Cela ne s'applique pas lorsque l'utilisateur saisit directement une valeur, mais uniquement lors de l'interaction avec le NumberField à l'aide des touches fléchées.

Texte d'espace réservé​

Vous pouvez définir un texte d'espace réservé pour le NumberField à l'aide de la méthode setPlaceholder(). Le texte d'espace réservé est affiché lorsque le champ est vide, aidant à inciter l'utilisateur à entrer une entrée appropriée dans le NumberField.

Fournissez un contexte clair pour l'exactitude

Si l'entrée numérique se rapporte à une unité de mesure spécifique ou a un contexte particulier, fournissez un étiquetage clair ou des informations supplémentaires pour guider les utilisateurs et garantir une entrée précise.

Meilleures pratiques​

Pour assurer une intégration fluide et une expérience utilisateur optimale, considérez les meilleures pratiques suivantes lors de l'utilisation du NumberField :

  • Accessibilité : Utilisez le composant NumberField en tenant compte de l'accessibilité, en respectant les normes d'accessibilité telles que le bon étiquetage, le support de la navigation au clavier et la compatibilité avec les technologies d'assistance. Assurez-vous que les utilisateurs ayant des handicaps peuvent interagir efficacement avec le NumberField.

  • Utilisez des boutons d'incrément/décrément : Si cela est approprié pour votre application, envisagez d'utiliser des boutons d'incrément et de décrément avec le NumberField. Cela permet aux utilisateurs d'ajuster la valeur numérique par un incrément ou un décrément spécifique d'un simple clic.