Champs
Le framework webforJ prend en charge onze types de composants de champ, y compris quatre champs masqués, chacun ayant des comportements et des implémentations différents adaptés à divers besoins d'entrée. Bien que chacun de ces composants ait des variations dans leurs implémentations, cet article décrit les propriétés communes parmi toutes les classes de champ.
Cette section décrit les caractéristiques communes de divers composants de champ dans webforJ, et n'est pas elle-même une classe qui peut être instanciée et utilisée.
Propriétés partagées des champs
Étiquette
Une étiquette de champ est un texte descriptif ou un titre associé au champ qui peut être défini dans le constructeur ou en utilisant la méthode setLabel(). Les étiquettes fournissent une brève explication ou un prompt pour aider les utilisateurs à comprendre l'objectif ou l'entrée attendue pour ce champ particulier. Les étiquettes de champ sont importantes pour la convivialité et jouent un rôle crucial dans l'accessibilité, car elles permettent aux lecteurs d'écran et aux technologies d'assistance de fournir des informations précises et de faciliter la navigation au clavier.
Texte d'aide
Chaque champ peut afficher un texte d'aide sous l'entrée en utilisant la méthode setHelperText(). Ce texte d'aide offre un contexte ou des explications supplémentaires sur les entrées disponibles, garantissant que les utilisateurs disposent des informations nécessaires pour faire des choix éclairés.
Requis
Vous pouvez appeler la méthode setRequired(true) pour exiger que les utilisateurs fournissent une valeur avant de soumettre un formulaire. Cette propriété fonctionne en tandem avec l'étiquette du champ, fournissant une indication visuelle qu'un champ est nécessaire. Cette indication visuelle aide les individus à remplir les formulaires avec précision.
Les composants de champ contiennent une validation visuelle intégrée pour informer les utilisateurs lorsqu'un champ requis est vide ou si un utilisateur a supprimé une valeur.
Vérification orthographique
En utilisant setSpellCheck(true), vous pouvez permettre au navigateur ou à l'agent utilisateur de vérifier l'orthographe du texte saisi par l'utilisateur et d'identifier les erreurs éventuelles.
Préfixe et suffixe
Les emplacements offrent des options flexibles pour améliorer la capacité des composants de champ. Vous pouvez avoir des icônes, des étiquettes, des indicateurs de chargement, la possibilité de supprimer/réinitialiser, des images de profil/avatar, et d'autres composants bénéfiques imbriqués dans un champ pour clarifier l'intention auprès des utilisateurs.
Les champs ont deux emplacements : les emplacements prefix et suffix. Utilisez les méthodes setPrefixComponent() et setSuffixComponent() pour insérer divers composants avant et après l'option affichée dans un champ. Voici un exemple utilisant le champ TextField :
TextField textField = new TextField();
textField.setPrefixComponent(TablerIcon.create("box"));
textField.setSuffixComponent(TablerIcon.create("box"));
Style
Étant donné que tous les composants de champ sont construits à partir d'un unique composant web, ils partagent tous les parties de Shadow et les valeurs de propriété CSS suivantes.
Sujets
Champs masqués
4 articles
ColorField
A component that provides a default browser-based color picker, allowing users to select a color from an input field.
DateField
A component that provides a default browser-based date picker for selecting a date through an input field.
DateTimeField
A component that provides a default browser-based date and time picker for selecting both date and time through a single input field.
NumberField
A component that provides a default browser-based input field for entering numeric values, with built-in controls for incrementing or decrementing the value.
PasswordField
A single-line input component for securely entering and masking password data.
TextField
A single-line input component for entering and editing text data.
TimeField
A component that provides a default browser-based time picker for selecting a time value through an input field.
