Attributs de la bibliothèque de balises d'agrégation
La bibliothèque des balises d'agrégation permet d'agréger plusieurs portlets sur une page.
Les arguments pris en charge sont les suivants :
- init
- Cette balise initialise l'infrastructure des portlets framework et doit être utilisée en début de JSP. Toutes les autres balises décrites dans cette section ne sont valides que dans le corps de ces balises, par conséquent la balise init renferme généralement
un JSP. Si l'URL courante contient une option d'action, la méthode d'action du
portlet correspondant est appelée.
Les balise state et insert sont des sous-balises de
la balise init.Les attributs de la balise init sont les suivants :
- portletURLPrefix=”<toute chaîne>”
Cette URL définit le préfixe utilisé pour les URL de portlet. Les URL de portlet sont créées par la balise d'état ou dans la méthode de rendu d'un portlet, qui est appelée en utilisant la balise d'insertion. Il s'agit d'un attribut obligatoire.
- portletURLSuffix=”<toute chaîne>”
Cette URL définit le suffixe utilisé pour les URL de portlet. Les URL de portlet sont créées par la balise d'état ou dans la méthode de rendu d'un portlet, qui est appelée en utilisant la balise d'insertion. Il s'agit d'un attribut facultatif.
- portletURLQueryParams=”<toute chaîne>”
Cette URL définit les paramètres de requête utilisées pour les URL de portlet. Les URL de portlet sont créées par la balise d'état ou dans la méthode de rendu d'un portlet, qui est appelée en utilisant la balise d'insertion. Il s'agit d'un attribut facultatif.
- portletURLPrefix=”<toute chaîne>”
- scope, portlet
- Les balises tag et portlet permettent de fournir les informations nécessaires lors de l'installation d'une
application de portlet sous une racine de contexte à multiples parties, par exemple, /context1/context2. Ces balises définissent également les fenêtres de portlet qui doivent participer dans la coordination de portlet via des paramètres de rendu et ajoutent un paramètre de rendu à l'URL créée.Les attributs de la balise urlParam sont les suivants :
- context = "/<context1>/<context2>"
Indique la racine de contexte de l'application de portlet déployée. Cet attribut est obligatoire.
- portletname = "<portlet-name>"
Définit le nom du portlet. Cet attribut est obligatoire.
- windowId=”<toute chaîne>”
Définit l'ID fenêtre de l'instance du portlet concret. Cet attribut est obligatoire.
Voici un exemple d'utilisation des balises scope et portlet :<%@ taglib uri="http://ibm.com/portlet/aggregation" prefix="portlet" %> <portlet:scope> <portlet:portlet context="/myportletcontext1/myportletcontext2” portletname="MyPortlet" windowId="sample"/> </portlet:scope> <portlet:init portletURLPrefix="/myportalcontext/ "> …. </portlet:init>
- context = "/<context1>/<context2>"
- state
- La balise state crée une URL pointant sur le portlet donné au moyen d'un état
donné. Vous pouvez placer cette URL dans une variable spécifiée par l'attribut var
ou l'écrire directement sur le flux de sortie.
Cette balise permet de créer
des URL pour des boutons, images et autres éléments HTML, de sorte que lorsque
l'URL est appelée, les changements d'états définis dans URL sont appliqués au
portlet donné.Les attributs de la balise state sont les suivants :
- url=”<contexte>/<nom-portlet>”
Identifie le portlet pour cette balise au moyen du contexte et du nom-portlet pour adresser le portlet. Cet attribut est obligatoire.
- windowId=”<toute chaîne>”
Définit l'ID fenêtre de l'URL du portlet créée par cette balise. Il s'agit d'un attribut facultatif.
- var=”<toute chaîne>”
S'il est défini, l'URL est écrite dans une variable ayant la portée et le nom donnés, et non dans le flux de sortie. Il s'agit d'un attribut facultatif.
- scope = ”page|request|session|application”
Cet attribut n'est valide que si l'attribut var est défini. S'il est défini, l'URL n'est pas écrite dans le flux de sortie mais une variable créée dans la portée donnée ayant le nom donné. La valeur par défaut est page. Il s'agit d'un attribut facultatif.
- portletMode=”view|help|edit|<personnalisé>”
Cet attribut définit le mode du portlet.
- portletWindowState=”maximized|minimized|normal|<personnalisé>”
Cet attribut définit l'état de la fenêtre.
- action = ”true/false”
Cet attribut définit s'il s'agit d'une action URL. Il s'agit d'un attribut facultatif. La valeur par défaut est false.
- url=”<contexte>/<nom-portlet>”
- urlParam
- Ajoute un paramètre d'affichage à l'URL récemment créée.Les attributs de la balise urlParam sont les suivants :
- name=”<toute chaîne>”
Indique le nom du paramètre. Il s'agit d'un attribut obligatoire.
- value=”<toute chaîne>”
Indique la valeur du paramètre. Il s'agit d'un attribut obligatoire.
- name=”<toute chaîne>”
- insert
- Cette balise appelle la méthode d'affichage du portlet et en récupère le contenu
ainsi que le titre. Vous pouvez également placer le contenu et le titre du
portlet défini dans des variables au moyen des attributs contentVar et titleVar.Les attributs de la balise insert sont les suivants :
- url=”<contexte>/<nom-portlet>” (obligatoire) Identifie le portlet
de cette balise au moyen du contexte et du nom-portlet pour adresser le portlet
Il s'agit d'un attribut obligatoire.
- windowId=”<toute chaîne>”
Définit l'ID fenêtre du portlet. Il s'agit d'un attribut facultatif.
- contentVar=”<toute chaîne>”
S'il est défini, le contenu du portlet n'est pas écrit dans le flux de sortie, mais dans une variable ayant la portée et le nom définis. Il s'agit d'un attribut facultatif.
- contentScope = ”page|request|session|application”
Cet attribut n'est valide que si l'attribut contentVar est utilisé. S'il est défini, le contenu du portlet est écrit dans une variable ayant la portée et le nom définis et non pas dans le flux de sortie. La valeur par défaut est page. Il s'agit d'un attribut facultatif.
- titleVar=”<toute chaîne>”
S'il est défini, le contenu du portlet est écrit dans une variable ayant la portée et le nom définis. S'il n'est pas défini, le titre est ignoré et n'est pas écrit dans le flux de sortie. Il s'agit d'un attribut facultatif.
- titleScope = ”page|request|session|application”
Cet attribut n'est valide que que si la balise titleVar est utilisée. S'il est défini, le contenu du portlet est écrit dans une variable ayant la portée et le nom définis et non pas dans le flux de sortie. La valeur par défaut est page. Il s'agit d'un attribut facultatif.
- url=”<contexte>/<nom-portlet>” (obligatoire) Identifie le portlet
de cette balise au moyen du contexte et du nom-portlet pour adresser le portlet