OOUI/Widgets/Icons, Indicators, and Labels/fr

Les widgets des types icône et indicateur contiennent de petits dessins (de la taille d'un texte normal) qui représentent efficacement une information permettant d'aider les utilisateurs pour agir et comprendre une interface.

Les étiquettes sont aussi utilisées pour aider à identifier les composants des interfaces. La valeur d'une étiquette peut être une chaîne de caractères, un noeud d'étiquettes ou une fonction qui les renvoie.

Icônes
La bibliothèque OOUI contient plus de 100 icônes pouvant être utilisées par les objets  pour créer de petits éléments graphiques et gérer des événements. Les objets  sont rarement utilisés sans étiquette, bien que cette dernière puisse être omise si on commence par un espace (par exemple dans une barre d'outils) ou si l'icône est utilisée dans un contexte où sa signification est évidente pour l'utilisateur. Dans ces cas, utilisez plutôt à la place un  silencieux (qui peut contenir lui-même un libellé et une icône).

Pour créer un, utiliser un   avec un   (IconWidget et démonstration directe de LabelWidget) :



Les objets  supportent un nombre de méthodes qui peuvent être utilisées pour gérer les événements et pour obtenir ou initialiser la valeur des éléments contenus. For example,  will return the name of the icon; , which takes either a symbolic icon name or a map of icon names keyed by language, will set the icon; and   will set the icon title. La liste complète des méthodes prises en charge ainsi que les options de configuration, sont décrites dans la documentation du code pour les objets.

Il faut charger quelque part les styles associés avant de créer, par exemple via ResourceLoader. Modules nommés par le masque, par exemple   pour l'icône de case à cocher. Les noms de groupe peuvent être trouvés sur la page de démonstration ou dans le code.

Indicateurs
Les indicateurs sont de petites icônes avec des cas d'utilisation très restreints :


 * To act as indicating elements within widgets on limited screen space, for example to signify a 'clear' action in a SearchInputWidget.
 * To clarify the function of a control that acts in an exceptional way (a dropdown that opens a menu instead of performing an action directly, for example).

Les objets  sont souvent utilisés par les autres widgets (tels que la saisie de texte, les listes déroulantes, les options décorées). Dans l'exemple suivant, un objet  utilise un indicateur pour aider à clarifier le fait que le champ est obligatoire :



Les indicateurs suivants sont inclus dans la bibliothèque OOUI :

Méthodes pouvant être utilisées pour initialiser ou pour récupérer le titre de l'indicateur ( et , respectivement) ou pour obtenir le nom de l'indicateur. La liste complète des méthodes prises en charge ainsi que les options de configuration, sont décrites dans la documentation du code pour IndicatorWidgets.

Etiquettes
Les étiquettes permettent d'identifier la fonction des éléments de l'interface. Chaque  peut être configuré avec une option   initialisée avec une chaîne de caractères, un noeud de libellé, ou une fonction :


 * String: a plaintext string
 * Label Node: a jQuery selection of elements. A jQuery selection is used for anything other than a plaintext label, e.g., a label that includes a link or special styling, such as a gray color or additional graphical elements.
 * Function: a function that will produce a string in the future. Les fonctions sont utilisées dans les cas où la valeur du libellé n'est pas actuellement définie. Voir Etendre la bibliothèque pour plus d'informations.

La liste complète des méthodes prises en charge ainsi que les options de configuration, sont décrites dans la documentation du code pour les objets.