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

Les widgets de type 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 à comprendre et à interagir avec 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 nœud de libellés 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 (pouvant contenir lui-même un libellé et une icône).

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



Les objets  supportent un nombre de méthodes qui peuvent être utilisées pour gérer les événements et pour obtenir (get) ou initialiser (set) la valeur des éléments contenus. Par exemple  renvoie le nom de l'icône;   reçoit soit le nom symbolique d'une icône ou une liste de noms d'icônes avec la langue pour clé et définit l'icône; enfin   définit le titre de l'icône. 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 le ResourceLoader. Les 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 :


 * pour agir comme des éléments indicateurs à l'intérieur des widgets sur un écran dont la taille est limitée, par exemple pour indiquer une action 'clear' dans un SearchInputWidget.
 * pour clarifier la fonction d'un élément de contrôle qui agit de manière particulière (une liste déroulante qui par exemple ouvre un menu au lieu de réaliser directement une action).

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 (respectivement  et  ) 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 nœud de libellés, ou une fonction :


 * chaîne de caractères : une chaîne textuelle à plat.
 * nœud de libellés : sélection jQuery d'éléments. Une sélection jQuery est utilisée pour tout ce qui est différent d'un libellé textuel à plat, par exemple un libellé comprenant un lien ou une mise en forme spéciale comme une couleur grise ou des éléments graphiques supplémentaires.
 * fonction : une fonction qui renverra une chaîne ultérieurement. 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.