NumberField

Ouvrir dans ChatGPT

Shadow dwc-field 23.02

Java API

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.

Vous pouvez utiliser le composant NumberField pour accepter une entrée numérique d'un utilisateur. Il garantit que seules des valeurs numériques valides sont saisies et fournit une interface pratique pour entrer des nombres.

Afficher le code

Java

Valeur du champ

Le composant NumberField stocke sa valeur en tant que Double, permettant une gestion précise à la fois des entiers et des nombres décimaux.

Obtention de 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 programme :

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.

Utilisations

Le NumberField est le mieux utilisé dans des scénarios où la capture, l'affichage ou la manipulation de données numériques est essentielle pour votre application. Voici quelques exemples de situations où utiliser le NumberField :

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

2. Analyse et calcul de données : Un NumberField est particulièrement précieux dans les applications impliquant l'analyse de données, des calculs ou des 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, de budgétisation ou de suivi des dépenses nécessitent souvent des entrées numériques précises. Un NumberField garantit l'entrée exacte des chiffres financiers.

4. Mesure et conversion d'unités : Dans les applications traitant des mesures ou des 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 de contrainte et fournira un retour d'information 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 valeur minimale.

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é à laquelle la valeur doit se conformer lors de l'utilisation des touches fléchées pour modifier la valeur. Cela incrémente ou décrémente la valeur du composant par un certain pas à chaque fois. Cela ne s'applique pas lorsque l'utilisateur saisit directement une valeur, mais uniquement lorsqu'il interagit avec le NumberField en utilisant les touches fléchées.

Texte de remplacement

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

Donnez un contexte clair pour l'exactitude

Si l'entrée numérique concerne une unité de mesure spécifique ou a un contexte particulier, fournissez une étiquette claire ou des informations supplémentaires pour guider les utilisateurs et garantir une saisie précise.

Meilleures pratiques

Pour garantir 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 l'étiquetage approprié, le support de la navigation au clavier et la compatibilité avec les technologies d'assistance. Assurez-vous que les utilisateurs handicapés peuvent interagir efficacement avec le NumberField.

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