Descriptions détaillées des balises WML Struts

Familiarisez-vous avec les balises WML utilisées par des portlets dans la structure d'application Struts.

Les balises répertoriées ci-après sont utilisées par des portlets dans la structure d'application Struts. Pour obtenir une description abrégée de la prise en charge de WML dans la structure d'application Struts, voir Utilisation des balises WML.

<wml:cancel/>

Affiche un élément <postfield> WML avec une valeur cancel. Cette balise n'est valide que lorsqu'elle est imbriquée dans le corps d'une balise form. Lorsque cet élément est ajouté à la fin, le servlet Action omet d'appeler la méthode validate() du bean form correspondant.

Tableau 1. Attributs de la balise cancel
Nom d'attribut	Description
propriété	Nom du paramètre avec la valeur spécifiée qui est définie dans l'objet de requête. Remarque : Si l'attribut de propriété est défini, l'application doit alors gérer la détection des annulations. [Expression d'exécution]
valeur	Valeur du paramètre de la requête. [Expression d'exécution]

<wml:card/>

Cette balise affiche un élément de carte, Cet élément n'est pas généré lorsque la balise est exécutée dans HCL Portal. Cela permet d'écrire des pages JSP utilisables à la fois dans l'environnement du servlet et dans celui du portlet.

Tableau 2. Attributs de la balise card
Nom de l'attribut	Description
id	Identificateur unique de la carte. [Expression d'exécution]
newcontext	Indicateur signalant que le contexte doit être réinitialisé lors de son chargement. [Expression d'exécution]
onenterbackward	Charger l'URL lors d'un accès via une tâche `<prev>`. [Expression d'exécution]
onenterforward	Charger l'URL lors d'un accès via une tâche `<go>`. [Expression d'exécution]
ontimer	Charge l'URL en cas d'expiration du délai. [Expression d'exécution]
ordered	Indicateur signalant que le contenu est classé. [Expression d'exécution]
titre	Indique le titre de la carte. [Expression d'exécution]
titleKey	Clé permettant de consulter un titre dans un regroupement de ressources. TitleKey n'est utilisé que lorsque l'attribut title est défini par la valeur Null. [Expression d'exécution]

<wml:errors/>

Extrait l'ensemble des messages d'erreur de l'objet de requête associé à la clé par défaut Action.ERROR_KEY ou à la valeur spécifiée par le nom d'attribut. Si des ActionErrors sont trouvées, elles sont affichées. Cette balise impose également la présence des deux clés de message suivantes dans la portée de l'application MessageResources.

errors.header - En-tête qui s'affiche avant la liste des messages d'erreur.
errors.footer - En-tête qui s'affiche après la liste des messages d'erreur.

Tableau 3. Attributs de la balise error
Nom de l'attribut	Description
groupement	Clé de l'attribut de contexte pour l'instance MessageResources à utiliser. Si cet attribut n'est pas spécifié, il prend par défaut les valeurs correspondant aux ressources de l'application configurées pour le servlet `Action` Struts. [Expression d'exécution]
locale	Clé d'attribut de la session associé à l'environnement local utilisé pour la sélection des messages à afficher. Si cet attribut n'est pas spécifié, il prend par défaut la valeur standard de l'application Struts. [Expression d'exécution]
nom	Nom du bean ayant la requête pour portée, dans lequel ont été stockés les messages d'erreur. S'il n'est pas indiqué, il prend pour valeur le nom spécifié par la chaîne de la constante `Action.ERROR_KEY`. [Expression d'exécution]
propriété	Nom de la propriété pour laquelle afficher les messages d'erreur. S'il n'est pas indiqué, tous les messages d'erreur s'affichent sans tenir compte de la propriété. [Expression d'exécution]

<wml:form/>

Cette balise ne génère aucun marquage, mais sert à déterminer la portée des beans et des transactions. Les balises contenues dans le corps de la balise form peuvent utiliser le bean de gestion des formulaires (form) pour alimenter les zones d'entrée.

Tableau 4. Attributs de la balise form
Nom de l'attribut	Description
action	URL utilisée pour l'envoi du formulaire. L'action est sélectionnée par une balise imbriquée et des balises postfield servent à soumettre les données. Pour plus de détails sur la spécification de l'action, reportez-vous à la documentation concernant la balise `html:form` de Struts. [Obligatoire] [Expression d'exécution]
nom	Nom du bean. L'attribut de portée sert à déterminer l'emplacement où le bean peut être localisé. Les balises contenues dans le corps de la balise form peuvent utiliser le bean de gestion des formulaires (form) pour alimenter les zones d'entrée. Pour plus de détails sur la spécification du nom, reportez-vous à la documentation concernant la balise `html:form` de Struts. [Expression d'exécution]
portée	Spécifie la portée du bean de gestion des formulaires (form) associé à ce formulaire. Pour plus de détails sur l'attribut de portée, reportez-vous à la documentation concernant la balise `html:form` de Struts. [Expression d'exécution]
type	Nom de classe qualifié complet du bean de gestion de formulaires. Pour plus de détails sur l'attribut de type, reportez-vous à la documentation concernant la balise `html:form` de Struts. [Expression d'exécution]

<wml:go/>

Cette balise affiche un élément <go> WML. Si la balise go est contenue dans le corps d'une balise form, l'action portant sur le formulaire est utilisée comme un hyperlien. Si l'attribut d'action du formulaire est défini, les attributs forward, href et page sont ignorés.

Tableau 5. Attributs de la balise go
Nom de l'attribut	Description
accept-charset	Permet de spécifier les codages de caractères que peut gérer l'application. [Expression d'exécution]
action	URL utilisée pour l'envoi du formulaire. L'action est sélectionnée par une balise imbriquée et des balises postfield servent à soumettre les données. [Expression d'exécution]
vers l'avant	Nom de la classe globale `ActionForward` à utiliser pour créer l'URL pour l'élément go. Remarque : Cet attribut est ignoré lorsque cette balise est spécifiée dans le corps d'une balise form qui désigne l'attribut d'action. Pour plus de détails sur l'attribut forward, reportez-vous à la documentation portant sur la balise `html:link` de Struts. [Expression d'exécution]
href	Spécifie l'URL destinée à l'élément go. Remarque : Cet attribut est ignoré lorsque cette balise est spécifiée dans le corps d'une balise form qui désigne l'attribut d'action. Pour plus de détails sur l'attribut href, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
method	Spécifie la méthode de soumission à HTTP : get ou post. [Expression d'exécution]
page	Spécifie le chemin relatif au contexte de l'URL qui doit être utilisée en tant qu'attribut href de l'élément go. Remarque : Cet attribut est ignoré lorsque cette balise est spécifiée dans le corps d'une balise form qui désigne l'attribut d'action. Pour plus de détails sur l'attribut page, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
sendreferer	Permet de spécifier que l'URL de base (deck) soit obligatoirement incluse dans la requête. [Expression d'exécution]
transaction	Crée un élément postfield afin que le marqueur de contrôle de la transaction en cours puisse être envoyé lorsque cet attribut a la valeur `true`. Pour plus de détails sur l'attribut transaction, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
urlType	Type de l'URL de portlet qui doit être créée. En l'absence de spécification, il s'agit du type standard. Valeurs prises en charge : return, standard [Expression d'exécution]

<wml:head/>

Génère un élément WML <head> associé aux attributs de langue extraits de l'objet Locale en cours de l'utilisateur, s'il existe. Cet élément n'est pas généré lorsque la balise est exécutée dans HCL Portal. Cela permet d'écrire des pages JSP utilisables à la fois dans l'environnement du servlet et dans celui du portlet.

<wml:link/>

Génère un élément WML <a> en tant qu'hyperlien vers l'URL spécifiée. L'URL sera automatiquement réécrite afin de maintenir l'état de la session en l'absence de cookies. Le corps de la balise s'affiche en tant que nom du lien. L'URL de base de cet hyperlien est calculée en fonction des attributs spécifiés parmi les suivants :

vers l'avant
href
page

Remarque : Vous ne pouvez spécifier qu'un seul et unique attribut parmi forward, href et page.

Tableau 6. Attributs de la balise link
Nom de l'attribut	Description
accesskey	Chiffre entre 0 et 9 qui s'affiche et qui indique à un utilisateur le chiffre du pavé numérique requis pour sélectionner cet élément. [Expression d'exécution]
vers l'avant	Nom de la classe globale `ActionForward` à utiliser pour créer l'URL. Pour plus de détails sur l'attribut forward, reportez-vous à la documentation portant sur la balise `html:link` de Struts. [Expression d'exécution]
href	Spécifie l'hyperlien qui doit rester inchangé en tant qu'URL. Pour plus de détails sur l'attribut href, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
indexé	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
indexId	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
nom	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
page	Spécifie le chemin relatif au contexte de l'URL qui doit être utilisée en tant qu'attribut href. Pour plus de détails sur l'attribut page, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
paramId	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
paramName	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
paramProperty	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
paramScope	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
propriété	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
portée	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
rel	Permet de spécifier la relation. [Expression d'exécution]
sendreferer	Permet de spécifier que l'URL de base soit obligatoirement incluse dans la requête. [Expression d'exécution]
transaction	Un élément postfield sera créé afin que le marqueur de contrôle de la transaction en cours puisse être envoyé lorsque cet attribut a la valeur True. Pour plus de détails sur l'attribut transaction, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
urlType	Type de l'URL de portlet qui doit être créée. En l'absence de spécification, il s'agit du type standard. Valeurs prises en charge : return, standard [Expression d'exécution]

<wml:option/>

Génère un élément WML <option>, représentant un des choix possibles pour un élément <select> englobant. Le texte visualisé par l'utilisateur provient soit du corps de cette balise, soit d'une chaîne de message consultée en raison de la définition des attributs bundle, locale et key. Si la valeur de la propriété de bean correspondante et la valeur spécifiée sont identiques, l'option sera marquée comme étant sélectionnée. Cette balise n'est valide que lorsqu'elle est imbriquée dans le corps d'une balise <wml:select>.

Tableau 7. Attributs de la balise option
Nom de l'attribut	Description
groupement	Permet de spécifier la clé du regroupement de ressources MessageResources stocké dans le contexte de servlet. [Expression d'exécution]
clé	Spécifie la clé permettant d'accéder au texte contenu dans le regroupement de ressources, déterminée à partir de l'attribut bundle. Lorsque l'attribut key n'est pas précisé, le texte provenant du corps de la balise est utilisé. [Expression d'exécution]
locale	Environnement local à utiliser pour la consultation des messages contenus dans le regroupement de ressources. [Expression d'exécution]
onpick	URL dans laquelle naviguer lorsque une sélection a été effectuée. [Expression d'exécution]
titre	Bref titre de zone [Expression d'exécution]
titleKey	Clé permettant de consulter un titre dans un regroupement de ressources. TitleKey n'est utilisé que lorsque l'attribut title est défini par la valeur Null. [Expression d'exécution]
valeur	Lorsque l'utilisateur sélectionne cette option, il s'agit de la valeur qui est envoyée. [Obligatoire] [Expression d'exécution]

<wml:options/>

Génère un ensemble d'éléments WML <option>, représentant les choix possibles associés à un élément <select>. Cette balise peut être utilisée à de nombreuses reprises au sein d'un même élément <wml:select>, avec ou à la place d'un ou plusieurs éléments <wml:option>. L'emploi d'un attribut de collection est expliqué dans la version HTML de la balise options.

Tableau 8. Attributs de la balise options
Nom de l'attribut	Description
collection	Nom du bean utilisé pour la création des options de sélection. Pour plus de détails sur l'attribut collection, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
labelName	Pour plus de détails sur l'attribut labelName, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
labelProperty	Pour plus de détails sur l'attribut labelProperty, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
nom	Pour plus de détails sur l'attribut href, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
propriété	Pour plus de détails sur l'attribut href, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]

<wml:password/>

Génère un élément WML <input> de type mot de passe, alimenté par la valeur spécifiée ou la propriété indiquée du bean associé au formulaire en cours. Cette balise n'est valide que lorsqu'elle est imbriquée dans le corps d'une balise form.

Tableau 9. Attributs de la balise password
Nom de l'attribut	Description
accesskey	Chiffre entre 0 et 9 qui s'affiche et qui indique à un utilisateur le chiffre du pavé numérique requis pour sélectionner cet élément. [Expression d'exécution]
emptyok	Indicateur signalant que cette zone peut rester vide. [Expression d'exécution]
format	Masque de format pour la zone d'entrée. [Expression d'exécution]
maxlength	Nombre maximal de caractères d'entrée admis. [Illimité] [Expression d'exécution]
nom	Nom d'attribut du bean dont les propriétés sont consultées lorsqu'est générée la valeur en cours de cette zone d'entrée. En l'absence de spécification, c'est le bean associé à la balise form dans laquelle l'attribut est imbriqué qui est utilisé. [Expression d'exécution]
propriété	Nom du paramètre de requête qui doit être inclus avec cet envoi, défini par la valeur spécifiée. [Obligatoire] [Expression d'exécution]
taille	Nombre d'emplacements de caractère à allouer. [Expression d'exécution]
tabindex	Ordre des balises dans une carte. [Expression d'exécution]
titre	Bref titre de zone [Expression d'exécution]
titleKey	Clé permettant de consulter un titre dans un regroupement de ressources. TitleKey n'est utilisé que lorsque l'attribut title est défini par la valeur Null. [Expression d'exécution]
valeur	Valeur du libellé à placer sur ce bouton. Cette valeur sera également soumise en tant que valeur du paramètre de requête spécifié. [Expression d'exécution]

<wml:postfield/>

Génère un élément WML <postfield>. Cette balise n'est valide que lorsqu'elle est imbriquée dans le corps d'une balise form.

Tableau 10. Attributs de la balise postfield
Nom de l'attribut	Description
nom	Nom d'attribut du bean dont les propriétés sont consultées lorsqu'est générée la valeur en cours de cette zone d'entrée. En l'absence de spécification, c'est le bean associé à la balise form dans laquelle l'attribut est imbriqué qui est utilisé. [Expression d'exécution]
propriété	Propriété de bean correspondante. [Obligatoire] [Expression d'exécution]
valeur	Valeur de la balise postfield. [Expression d'exécution]

<wml:rewrite/>

Génère un identificateur URI de requête respectant exactement les mêmes règles que la balise de lien, sans que soit créé l'hyperlien <a>. L'URI de base de cet hyperlien est calculé en fonction des attributs spécifiés parmi les suivants :

vers l'avant
href
page

Remarque : Vous ne pouvez spécifier qu'un seul et unique attribut parmi forward, href et page.

Tableau 11. Attributs de la balise rewrite
Nom de l'attribut	Description
vers l'avant	Nom de la classe globale `ActionForward` à utiliser pour créer l'URL. Pour plus de détails sur l'attribut forward, reportez-vous à la documentation portant sur la balise `html:link` de Struts. [Expression d'exécution]
href	Spécifie l'hyperlien qui doit rester inchangé en tant qu'URL. Pour plus de détails sur l'attribut href, reportez-vous à la documentation concernant la balise `html:link` de Struts. [Expression d'exécution]
indexé	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:rewrite` de Struts. [Expression d'exécution]
indexId	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:rewrite` de Struts. [Expression d'exécution]
nom	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:rewrite` de Struts. [Expression d'exécution]
page	Spécifie le chemin relatif au contexte de l'URL qui doit être utilisée en tant qu'attribut href. Pour plus de détails sur l'attribut page, reportez-vous à la documentation concernant la balise `html:rewrite` de Struts. [Expression d'exécution]
paramId	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:rewrite` de Struts. [Expression d'exécution]
paramName	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:rewrite` de Struts. [Expression d'exécution]
paramProperty	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:rewrite` de Struts. [Expression d'exécution]
paramScope	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:rewrite` de Struts. [Expression d'exécution]
propriété	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:rewrite` de Struts. [Expression d'exécution]
portée	Pour plus de détails sur cet attribut, reportez-vous à la documentation concernant la balise `html:rewrite` de Struts. [Expression d'exécution]
transaction	Crée un élément postfield afin que le marqueur de contrôle de la transaction en cours puisse être envoyé lorsque cet attribut a la valeur `true`. Pour plus de détails sur l'attribut transaction, reportez-vous à la documentation concernant la balise `html:rewrite` de Struts. [Expression d'exécution]

<wml:select/>

Génère un élément WML <select>, associé à une propriété de bean spécifiée par les attributs. Cette balise n'est valide que lorsqu'elle est imbriquée dans le corps d'une balise form. Pour plus de détails sur l'utilisation de cette balise, reportez-vous à la documentation concernant la balise html:select.

Tableau 12. Attributs de la balise select
Nom de l'attribut	Description
iname	Numéro d'indexation de l'option par défaut ( base 1 ) [Expression d'exécution]
ivalue	Valeur par défaut [Expression d'exécution]
multiple	Défini pour prendre en charge des sélections multiples. [Expression d'exécution]
nom	Nom du bean utilisé pour la détermination des options présélectionnées. [Expression d'exécution]
propriété	Définit le nom du paramètre de requête utilisé pour soumettre la valeur. [Obligatoire] [Expression d'exécution]
tabindex	Ordre des balises dans une carte. [Expression d'exécution]
titre	Bref titre de zone [Expression d'exécution]
titleKey	Clé permettant de consulter le titre dans un regroupement de ressources. `titleKey` n'est utilisé que lorsque l'attribut title est défini par la valeur `null`. [Expression d'exécution]
valeur	Valeur permettant de déterminer si une option a été sélectionnée. [Expression d'exécution]

<wml:text/>

Génère un élément WML <input> de type texte, alimenté par la valeur spécifiée ou la propriété indiquée du bean associé au formulaire en cours. Cette balise n'est valide que lorsqu'elle est imbriquée dans le corps d'une balise form.

Tableau 13. Attributs de la balise text
Nom de l'attribut	Description
accesskey	Chiffre entre 0 et 9 qui s'affiche et qui indique à un utilisateur le chiffre du pavé numérique requis pour sélectionner les données d'entrée. [Expression d'exécution]
emptyok	Indicateur signalant que cette zone peut rester vide.
format	Masque de format pour la zone d'entrée. [Expression d'exécution]
maxlength	Nombre maximal de caractères d'entrée admis. [Illimité] [Expression d'exécution]
nom	Nom d'attribut du bean dont les propriétés sont consultées lorsqu'est générée la valeur en cours de cette zone d'entrée. En l'absence de spécification, c'est le bean associé à la balise form dans laquelle l'attribut est imbriqué qui est utilisé. [Expression d'exécution]
propriété	Nom de cette zone d'entrée et nom de la propriété de bean correspondante, lorsque la valeur n'est pas spécifiée. La propriété de bean correspondante (si elle existe) doit être de type String (chaîne). [Obligatoire] [Expression d'exécution]
taille	Nombre d'emplacements de caractère à allouer. [Expression d'exécution]
tabindex	Ordre des balises dans une carte. [Expression d'exécution]
titre	Bref titre de zone [Expression d'exécution]
titleKey	Clé permettant de consulter le titre dans un regroupement de ressources. L'attribut title doit être défini par une valeur Null. [Expression d'exécution]
valeur	Valeur à laquelle cette zone doit être initialisée. [Utilisez la valeur de propriété de bean correspondante] [Expression d'exécution]

<wml:wml/>

Génère un élément <wml/>. Celui-ci n'est pas affiché dans l'environnement HCL Portal.