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. s should rarely be used without a label, though a label may be omitted if space is at a premium (e.g. in a toolbar) or if the icon is used in a context where its meaning is very clear to the user. In these cases, consider using a quiet  instead (which can include a label and icon itself).

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



s support a number of methods that can be used to handle events and to get or set the value of contained elements. 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).

s are often used by other widgets (e.g., text inputs, dropdowns, decorated options). In the following example, a  uses an indicator to help clarify that the field is required:



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

Methods can be used to set or get the indicator title ( and , respectively) or to get the name of the indicator. For a full list of supported methods and configuration options, please see the code-level documentation for IndicatorWidgets.

Etiquettes
Les étiquettes permettent d'identifier la fonction des éléments de l'interface. Each  can be configured with a   option that is set to a string, a label node, or a function:


 * 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. Functions are used in cases where the label value is not currently defined. Voir Etendre la bibliothèque pour plus d'informations.

For a full list of supported methods and configuration options, please see the code-level documentation for s.