OOUI/Eléments/Marquage

From mediawiki.org
< OOUI‎ | Elements
This page is a translated version of the page OOUI/Elements/Flagged and the translation is 100% complete.

La classe OO.ui.FlaggedElement est un attribut mixin, c'est à dire qu'elle est utilisée pour ajouter des fonctionnalités supplémentaires à un élément créé par une autre classe. La classe fournit une propriété flags qui contient le nom (ou un tableau de noms) des drapeaux de mise en forme, servant à personnaliser l'aspect et le comportement d'un widget pour mieux décrire son importance et sa fonctionnalité.

Lorsqu'un élément est configuré avec une propriété flags, la présentation de son CSS est mise à jour. Un widget configuré pour être par exemple 'destructive', sera profilé avec la classe CSS 'oo-ui-flaggedElement-destructive'.

Pour la liste complète des méthodes prises en charge et les options de configuration fournies par la classe FlaggedElement , voir la documentation du code.

Chaque drapeau que vous pouvez initialiser ainsi que le comportement associé est défini dans les widgets ou les éléments spécifiques dont quelques uns sont décrits ci-après.

ButtonElement et Tool

  • progressive - La mise en forme progressive est appliquée pour assurer que l'utilisateur pourra avancer quelque soit le processus dans lequel il se trouve.
  • destructive - La mise en forme destructrice est appliquée pour permettre au widget de supprimer quelque chose.
  • primary - Le comportement primaire est appliqué lorsqu'une seule action est possible, ou pour plusieurs actions parmi les plus communes. (Il n'a de sens que pour des suites de boutons ayant le drapeau primaire ou destructif).

Voir Boutons et sélecteurs pour un exemple de ces drapeaux.

ProcessDialog

Les actions sont un type spécial de bouton utilisé dans le dialogue des processus; elles utilisent les drapeaux suivants :

  • primary - L'action primaire (par exemple 'enregistrer' ou 'fait') fait avancer l'utilisateur dans le processus où il est engagé. L'action primaire est positionnée dans le coin supérieur droit de la fenêtre de dialogue. Parce que c'est un bouton, la signification d'action primary pour ButtonElement ci-dessus, s'applique également.
  • safe - L'action sécurisée (commme 'Annuler') ne modifie rien. Les actions 'Safe' sont habituellement configurées sans action. Les widgets d'action qui n'ont configuré aucune action ferment la fenêtre sans rien modifier. L'action sécurisée est positionnée dans le coin supérieur droit de la fenêtre de dialogue.
  • back - Indique que cette action va revenir à la fenêtre de dialogue précédente. Les actions qui ont ce drapeau reçoivent automatiquement une icône où le texte substitué indique le retour en arrière (sur les mobiles uniquement). Ne doit être utilisé qu'avec les actions 'safe'.
  • close - Indique que cette action va fermer le dialogue. Les actions qui ont ce drapeau reçoivent automatiquement une icône où le texte substitué indique la fermeture. Ne doit être utilisé qu'avec les actions 'safe'.

Veuillez lire la documentation sur les ensembles d'actions pour plus d'informations à propos de l'utilisation des drapeaux primaires et de sécurisation.

TextInputWidget

Le drapeau invalid est utilisé en interne pour indiquer que l'entrée utilisateur n'est pas valide. Il ne doit pas être initialisé directement; utiliser la méthode setValidityFlag .

MessageWidget

Les drapeaux : error, warning, success, et notice sont utilisés en interne pour afficher différents messages. Ne doit pas être initialisé directement, utiliser type à la place.