`$msg.error`¶

Description¶

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

Syntaxe¶

$msg.error( text [ , options ] )

Paramètres¶

text string

Message à inscrire en tant qu'erreur.

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.

options map

Map d'options à passer à la méthode. Les options reconnues sont:

source string

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

target map / string / array

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

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'erreur

Exemple¶

if (#dateConsultation <= limiteDate) {
    $data.invalidate("dateConsultation",
                     $i18n.getLabel("message.limite.date.consultation",
                                    { bundle: "messages",
                                      arguments: $cal.format(limiteDate, "dd/MM/yyyy") }));
}

if (#nbreFemmes == null && #nbreHommes == null) {
    $data.invalidate([ "nbreFemmes", "nbreHommes" ],
                     $i18n.getLabel("message.donnee.nbreFemmesHommes.manquante",
                                    { bundle: "messages" }));
}

$msg.error¶