`$msg.warn`¶

Description¶

Inscrit un message d'avertissement à l'écran de l'utilisateur.

Syntaxe¶

$msg.warn( text [ , options ] )

Paramètres¶

text string

Message à inscrire en tant qu'avertissement.

Techniquement le paramètre peut être de n'importe quel type. Le message sera construit à partir de la représentation de l'objet en tant que string.

source string

Chaîne de caractères désignant la source du message. Si non défini, la source est script.

target map / string

Objet(s) sur le(s)quel(s) porte(nt) l'avertissement.

Le paramètre peut être un contexte unique passé sous forme de map ou de string, ou un tableau de maps/strings permettant de désigner plusieurs contextes en même temps.

attributes map

Map d'attributs à associer au message dans l'arbre de sortie. On pourra par exemple spécifier un attribut disableOutputEscaping pour indiquer à la feuille de style de désactiver l'échappement des caractères spéciaux. Attention dans ce cas à ce que le message ne présente pas de risque d'injection XSS, c'est-à-dire qu'il ne contienne aucune valeur issue directement ou indirectement d'une saisie utilisateur non nettoyée (sanitized).

Retour¶

Le message d'avertissement

Exemple¶

$msg.warn("Il faut faire attention.");

$msg.warn("Il faut faire <b>très</b> attention.",
          { attributes: { disableOutputEscaping: "yes" } });

La méthode $msg.error fournit un exemple d'utilisation avec plusieurs "targets".

$msg.warn¶