Evaluation des expressions JSTL

Certaines propriétés des tags peuvent être de simples expressions JSTL, comme ${beanName.beanProperty}. Ces proprétés sont désignées par "[EL]".

Boutons submit

formActions

Utilisé à l'intérieur du tag <layout:form> pour inclure des tags struts-layout ou des boutons.

Peut automatiquement générer des boutons save/reset/cancel ou des boutons confirm/cancel si les attributs name & property sont spécifiés.

Attributs :

Nom de l'attribut Description
align Alignement de la colonne générée. Par défaut : CENTER.
key -
name -
property -

submit

Rend un bouton submit.

Diffère de celui de la taglib html par l'ajout d'un attribut permettant de spécifier l'action à exécuter dans le cas d'une DispatchAction. Cela permet de créer des formulaires avec plusieurs boutons valider ou annuler appelant différentes méthodes d'une DispatchAction. Son mode d'affichage dépend du mode d'affichage du formulaire.

Attributs :

Nom de l'attribut Description
accesskey -
alt -
altkey -
bundle -
mode Mode d'affichage du bouton. Format: "X,Y,Z" où X Y Z valent "D" (display), "N" (not displayed) "C" (cell, le bouton est remplacé par un espace vide) ou "F" (frozen, fixe l'attribut HTML disabled) concernant les modes d'affichage création, édition et consultation du formulaire.
onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup -
policy Nom de la politique d'affichage à utiliser.
property -
reqCode Valeur du paramètre indiquant l'action à exécuter dans le cas d'une action de type DispatchAction.
selectCode Positionne la valeur du paramètre 'selectCode' du formulaire à la valeur de la propriété 'selectProperty' du bean dont le nom est indiqué par la valeur 'selectName', lors de la soumission du formulaire.
selectName cf selectCode.
selectProperty cf selectCode.
style -
styleClass -
tabindex -
title -
titleKey -
valign -
value -

cancel

Rend un bouton cancel.

Diffère de celui de la taglib html par l'ajout d'un attribut permettant de spécifier l'action à exécuter dans le cas d'une DispatchAction. Cela permet de créer des formulaires avec plusieurs boutons valider ou annuler appelant différentes méthodes d'une DispatchAction.

Attributs :

Nom de l'attribut Description
accesskey -
mode Mode d'affichage du bouton. Format: "X,Y,Z" où X Y Z valent "D" (display), "N" (not displayed) "C" (cell, le bouton est remplacé par un espace vide) ou "F" (frozen, fixe l'attribut HTML disabled) concernant les modes d'affichage création, édition et consultation du formulaire.
onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup -
policy Nom de la politique d'affichage à utiliser.
property -
reqCode Valeur du paramètre indiquant l'action à exécuter dans le cas d'une action de type DispatchAction.
style -
styleClass -
tabindex -
valign -
value -

reset

Rend un bouton reset.

Attributs :

Nom de l'attribut Description
accesskey -
mode Mode d'affichage du bouton. Format: "X,Y,Z" où X Y Z valent "D" (display), "N" (not displayed) "C" (cell, le bouton est remplacé par un espace vide) ou "F" (frozen, fixe l'attribut HTML disabled) concernant les modes d'affichage création, édition et consultation du formulaire.
onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup -
policy Nom de la politique d'affichage à utiliser.
reqCode Valeur du paramètre indiquant l'action à exécuter dans le cas d'une action de type DispatchAction.
style -
styleClass -
tabindex -
valign -
value -

image

Rend un bouton image.

Diffère de celui de la taglib html par l'ajout d'un attribut permettant de spécifier l'action à exécuter dans le cas d'une DispatchAction. Cela permet de créer des formulaires avec plusieurs boutons valider ou annuler appelant différentes méthodes d'une DispatchAction.

Attributs :

Nom de l'attribut Description
accesskey -
alt -
altKey -
border -
bundle -
mode Mode d'affichage du bouton. Format: "X,Y,Z" où X Y Z valent "D" (display), "N" (not displayed) "C" (cell, le bouton est remplacé par un espace vide) ou "F" (frozen, fixe l'attribut HTML disabled) concernant les modes d'affichage création, édition et consultation du formulaire.
nameNom de l'image à afficher, relative au répertoire contenant les images struts-layout
onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup -
page -
pageKey -
policy Nom de la politique d'affichage à utiliser.
property -
reqCode Valeur du paramètre indiquant l'action à exécuter dans le cas d'une action de type DispatchAction.
src -
srcKey -
style -
styleClass -
tabindex -
valign -
value -

button

Rend un bouton.

Attributs :

Nom de l'attribut Description
accesskey -
mode Mode d'affichage du bouton. Format: "X,Y,Z" où X Y Z valent "D" (display), "N" (not displayed) "C" (cell, le bouton est remplacé par un espace vide) ou "F" (frozen, fixe l'attribut HTML disabled) concernant les modes d'affichage création, édition et consultation du formulaire.
onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup -
policy Nom de la politique d'affichage à utiliser.
property -
reqCode Valeur du paramètre indiquant l'action à exécuter dans le cas d'une action de type DispatchAction.
style -
styleClass -
tabindex -
valign -
value -

Disposition

write

Version modifiée du tag <bean:write> qui permet l'affichage formaté d'une valeur. Ce tag peut ê placé dans un tag layout (panel, form, grid, etc.)

Attributs :

Nom de l'attribut Description
filterFiltre les caractères HTML sensibles (défaut : true)
layout Si cet attribut vaut false, la valeur n'est pas encadrée par le code HTML de disposition (<th>).
name Comme pour le tag <bean:write>.
property Comme pour le tag <bean:write>.
type Format à utiliser pour afficher la valeur.
style Style CSS à utiliser pour afficher la valeur.
styleClass Classe du style CSS à utiliser pour afficher la valeur.

message

Version modifiée du tag <bean:message>, ce tag peut être placé dans un tag layout (panel, form, grid, etc.)

Attributs :

Nom de l'attribut Description
arg0 -
arg0Name -
arg0Property -
arg1 -
arg2 -
arg3 -
key -
styleClass Classe du style CSS à utiliser pour afficher la valeur.

link

Version modifiée du tag <html:link>, ce tag peut être placé dans un tag layout (panel, form, grid, etc.). Ce tag génère aussi le code JavaScript nécessaire si struts-layout est configuré pour avertir l'utilisateur lorsqu'il clique sur un lien alors qu'il n'a pas enregistré ses modifications.

Nom de l'attribut Description
accesskey -
anchor -
forward -
href -
linkName -
layoutNe génère pas d'information de mise en page si mis à false
mode Mode d'affichage du lien.
name -
onblur, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup -
page -
paramId -
paramName -
paramProperty -
paramScope -
policy Nom de la politique d'affichage du lien.
property -
scope -
schemeGénère une URL absolue avec le scheme spécifié (http/https) [EL]
style -
styleClass -
tabindex -
target -
transaction -

skin

Insère un lien dans la feuille de styles choisie grâce à LayoutUtils.setSkin(...). Si aucun skin n'a été choisi, le skin par défaut spécifié dans le fichier Struts-Layout.properties sera utilisé.

Nom de l'attribut Description
includeScript Si cet attribut vaut true, les fichiers javascript de struts-layout seront inclus dans la page.

mode

Inclus le corps du tag dans la page uniquement si le mode d'affichage du formulaire correspond à l'un de ceux spécifiés dans l'attribut value.

Nom de l'attribut Description
value Liste des modes d'affichage autorisés, séparés par des virgules. Ex : "create,edit" ou seulement "inspect".

notMode

Inclus le corps du tag dans la page uniquement si le mode d'affichage du formulaire ne correspond pas à celui spécifié dans l'attribut value.

Nom de l'attribut Description
value Mode d'affichage du formulaire à non autorisé. Valeurs possibles : "create", "edit" et "inspect".

policy

Inclus le corps du tag uniquement si la politique spcécifiée retourne MODE_EDIT.

Nom de l'attribut Description
policy Politique à interroger pour déterminer si le corps du tag doit être évalué.

Listes

news - Rend une collection

Déprécié. Rend les propriétés sélectionnées de chaque objet d'une collection, utilisant un panel par objet. Les attributs sont les mêmes que pour le tag collection.

table - Itère sur une collection et affiche le corps du tag dans une table dont le nombre de colonnes peut être spécifié

Ce tag affiche chaque élément d'une collection dans une table dont le nombre de colonnes est fixé par le déeloppeur.

Nom de l'attribut Description
align L'alignement de la table.
col Le nombre de colonnes de la table.
id Nom à utiliser pour exposer les beans dans la collection.
indexId Nom à utiliser pour exposer l'index lors de l'itération.
name Nom d'un bean du contexte contenant la collection.
property Si le bean nquote;est pas la collection elle-même, nom de la propriété qui donnera la collection.
width La largeur de la table.

html

Rend les tags HTML suivants : <html>, <head>, <title>, <base> and <body>. Ce tag inclus les fichiers JavaScript et le fichier CSS de struts-layout. Voir LayoutUtils.setSkin(HttpSession, String) pour changer le fichier CSS à utiliser. Si ce tag n'est pas utilisé, le tag <layout:skin> doit être utilisé pour inclure les fichiers JavaScript et le fichier CSS.

Les tags suivants peuvent être placés dans le corps de ce tag : form, collection, news.

Attributs supplémentaires :

Nom de l'attribut Description
align Alignement du contenu. Par défaut : center.
bundle La clé de l'instance de MessageResources à utiliser. Si non spécifié, choisit par défaut l'application resources configuré pour la servlet action.
key Clé du message à utiliser comme titre de la page.
locale -
layout Génère le code HTML de disposition. Par défaut : true.
onload Gestionnaire de l'événement onload du corps de la page.
styleClass Classe CSS à utiliser pour afficher cette page.
width -
xhtml Rend les tags HTML comme des tags XHTML.

Note concernant les attributs du contexte de la servlet

Les attributs du contexte de la servlet suivants peuvent être spécifiés :

  • struts-layout-old-panel-nesting

    Le code HTML généré a changé dans struts-layout 0.5 afin que les panels et les collections puissent être placés dans d'autres tags sans avoir à ajouter de code HTML entre les tags. Si cet attribut vaut "false", l'ancien comportement sera conservé.
  • Attributs non documentés

    Il y a d'autres attributs non documentés qui peuvent être utilisés pour préserver la compatibilité avec les anciennes versions. Ils puvent être trouvés dans la classe fr.improve.struts.taglib.layout.util.LayoutUtils.

Initialisation de la bibliothèque

Si l'un des précédents attributs est spécifié, la bibliothèque devrait être initialisée par un appel à fr.improve.struts.taglib.layout.util.LayoutUtils.init(ServletContext). Il est recommandé d'ajouter cela dans la méthode init de la servlet.