Tags select

Tags : select - radio - radios - checkboxes - option - options - optionsCollection

select

Rend une liste de choix déroulante. Les principales différences avec le tag <html:select> sont :

  • Rend une étiquette
  • Supporte les attributs de struts-layout isRequired, layout, policy et mode.
Nom de l'attribut Description
accesskey Le caractère du clavier à utiliser pour se placer immédiatement sur cet élément.
arg0, arg1, arg2, arg3, arg4 Valeurs optionnelles des paramètres de remplacement. [EL]
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.
filter Si vaut true, filtre les caractères HTML sensibles. Fonctionne avec les données provenant de tous les tags options
hint Clé d'un message d'indice à afficher comme tooptil text sur l'étiquette.
isRequired Si cet attribut vaut true, une étoile rouge est affichée après la zone de saisie si sa valeur est null. Valeurs possibles : true | false. Par défaut : false. [EL]
key Clé de l'étiquette à afficher. Si cette clé n'a pas de valeur correspondante dans les messages, la clé est affichée.
layout Si cet attribut vaut false, le tag ne génère pas le code de disposition HTML (ie ne génère que le tag <input>). Cela permet d'utiliser uniquement le framework "display mode" de struts-layout.
layoutId Identifiant DHTML du tag. Cet attribut permet d'afficher/cacher le tag grâce au code suivant :

document.getElementById(layoutId + "F").style = "none" pour cacher (ou "" pour afficher);

document.getElementById(layoutId + "L").style = "none" pour cacher (ou "" pour afficher);

layoutId + "F" correspond à la zone de saisie, layoutId + "L" à l'étiquette.
maxlength Nombre maximal de colonnes de la zone.
mode Mode d'affichage de la zone de saisie. Le mode doit être de la forme <create field mode>,<edit field mode>,<inspect field mode>. Valeurs possibles : E (editable), I (inspectable+hidden, ie read-only), N (not displayed), H (hidden), P (inspect si présent), S (show, inspect mais non caché), R (read-only), D (disabled)
multiple Si vaut true, l'élément select généré supportera les sélections multiples.
name Nom du bean du contexte pageContext, request, session ou application dont on veut éditer une propriété. La valeur par défaut est le bean du formulaire struts
onblur, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup Gestionnaires d'événements JavaScript. [EL]
policy Nom de la politique d'affichage
property Propriété du bean à voir/éditer. [EL]
size Nombre de colonnes à afficher dans la zone.
styleClass Classe du style CSS à utiliser.
tabindex L'ordre de tabulation pour cet élément (entiers positifs croissants).
tooltip Clé d'un message à afficher comme tooptil text sur la zone de saisie. [EL]
value Valeur de la zone.

radio

Rend un bouton radio. Les principales différences avec le tag <html:radio> sont :

  • Rend une étiquette
  • Supporte les attributs de struts-layout isRequired, layout, policy et mode.
Nom de l'attribut Description
accesskey Le caractère du clavier à utiliser pour se placer immédiatement sur cet élément.
arg0, arg1, arg2, arg3, arg4 Valeurs optionnelles des paramètres de remplacement. [EL]
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.
hint Clé d'un message d'indice à afficher comme tooptil text sur l'étiquette.
key Clé de l'étiquette à afficher. Si cette clé n'a pas de valeur correspondante dans les messages, la clé est affichée.
layoutId Identifiant DHTML du tag. Cet attribut permet d'afficher/cacher le tag grâce au code suivant :

document.getElementById(layoutId + "F").style = "none" pour cacher (ou "" pour afficher);

document.getElementById(layoutId + "L").style = "none" pour cacher (ou "" pour afficher);

layoutId + "F" correspond à la zone de saisie, layoutId + "L" à l'étiquette.
maxlength Nombre maximal de colonnes de la zone.
name Nom du bean du contexte pageContext, request, session ou application dont on veut éditer une propriété. La valeur par défaut est le bean du formulaire struts
onblur, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup Gestionnaires d'événements JavaScript. [EL]
policy Nom de la politique d'affichage
property Propriété du bean à voir/éditer. [EL]
size Nombre de colonnes de la zone.
styleClass Classe du style CSS à utiliser.
tabindex L'ordre de tabulation pour cet élément (entiers positifs croissants).
tooltip Clé d'un message à afficher comme tooptil text sur la zone de saisie. [EL]
value Valeur de la zone.

radios

Rend une liste de boutons radio. Ce tag est utilisé comme le tag select mais il affiche des boutons radio au lieu d'une liste de choix.

La liste est peuplée par les tags <layout:option> et <layout:options>.

Nom de l'attribut Description
accesskey Le caractère du clavier à utiliser pour se placer immédiatement sur cet élément.
arg0, arg1, arg2, arg3, arg4 Valeurs optionnelles des paramètres de remplacement. [EL]
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.
cols Nombre de colonnes à afficher dans la zone.
hint Clé d'un message d'indice à afficher comme tooptil text sur l'étiquette.
key Clé de l'étiquette à afficher. Si cette clé n'a pas de valeur correspondante dans les messages, la clé est affichée.
layout Si cet attribut vaut false, le tag ne génère pas le code de disposition HTML (ie ne génère que le tag <input>). Cela permet d'utiliser uniquement le framework "display mode" de struts-layout.
layoutId Identifiant DHTML du tag. Cet attribut permet d'afficher/cacher le tag grâce au code suivant :

document.getElementById(layoutId + "F").style = "none" pour cacher (ou "" pour afficher);

document.getElementById(layoutId + "L").style = "none" pour cacher (ou "" pour afficher);

layoutId + "F" correspond à la zone de saisie, layoutId + "L" à l'étiquette.
maxlength Nombre maximal de colonnes de la zone.
mode Mode d'affichage de la zone de saisie. Le mode doit être de la forme <create field mode>,<edit field mode>,<inspect field mode>. Valeurs possibles : E (editable), I (inspectable+hidden, ie read-only), N (not displayed), H (hidden), P (inspect si présent), S (show, inspect mais non caché), R (read-only), D (disabled)
name Nom du bean du contexte pageContext, request, session ou application dont on veut éditer une propriété. La valeur par défaut est le bean du formulaire struts
onblur, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup Gestionnaires d'événements JavaScript. [EL]
policy Nom de la politique d'affichage
property Propriété du bean à voir/éditer. [EL]
styleClass Classe du style CSS à utiliser.
tabindex L'ordre de tabulation pour cet élément (entiers positifs croissants).
tooltip Clé d'un message à afficher comme tooptil text sur la zone de saisie. [EL]
value Valeur de la zone.

checkboxes

Affiche une liste de cases à cocher peuplée grâce aux tags <layout:option> et <layout:options>. La propriété correspondante dans le formulaire doit être une propriété indexée.

Nom de l'attribut Description
accesskey Le caractère du clavier à utiliser pour se placer immédiatement sur cet élément.
arg0, arg1, arg2, arg3, arg4 Valeurs optionnelles des paramètres de remplacement. [EL]
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.
hint Clé d'un message d'indice à afficher comme tooptil text sur l'étiquette.
key Clé de l'étiquette à afficher. Si cette clé n'a pas de valeur correspondante dans les messages, la clé est affichée.
layoutId Identifiant DHTML du tag. Cet attribut permet d'afficher/cacher le tag grâce au code suivant :

document.getElementById(layoutId + "F").style = "none" pour cacher (ou "" pour afficher);

document.getElementById(layoutId + "L").style = "none" pour cacher (ou "" pour afficher);

layoutId + "F" correspond à la zone de saisie, layoutId + "L" à l'étiquette.
maxlength Nombre maximal de colonnes de la zone.
mode Mode d'affichage de la zone de saisie. Le mode doit être de la forme <create field mode>,<edit field mode>,<inspect field mode>. Valeurs possibles : E (editable), I (inspectable+hidden, ie read-only), N (not displayed), H (hidden), P (inspect si présent), S (show, inspect mais non caché), R (read-only), D (disabled)
name Nom du bean du contexte pageContext, request, session ou application dont on veut éditer une propriété. La valeur par défaut est le bean du formulaire struts
onblur, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup Gestionnaires d'événements JavaScript. [EL]
policy Nom de la politique d'affichage
property Propriété du bean à voir/éditer. [EL]
styleClass Classe du style CSS à utiliser.
tooltip Clé d'un message à afficher comme tooptil text sur la zone de saisie. [EL]

option

Ajoute un choix dans une zone de liste.

Version struts-layout du tag <html:option>. Seul le nom a changé.

Nom de l'attribut Description
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é de l'étiquette à afficher. Si cette clé n'a pas de valeur correspondante dans les messages, la clé est affichée.
value Valeur de la zone.

options

Ajoute plusieurs choix dans une zone de liste.

Version struts-layout du tag <html:options>. Seul le nom a changé.

Nom de l'attribut Description
collection Nom d'un bean contenant une collection d'autres beans ayant des propriétés dont le nom est indiqué par les attributs "property" et "labelProperty", respectivement utilisés pour récupérer la valeur et l'étiquette de chaque option.
labelName Nom du bean contenant la collection d'étiquettes à afficher pour les options.
labelProperty Propriété du bean du formulaire, ou du bean indiqué par l'attribut "labelName", qui retournera la collection des étiquettes à afficher pour les options.
name Nom du bean contenant la collection des valeurs à retourner au serveur pour les options Si non spécifié, le bean du formulaire sera utilisé
property Propriété du bean du formulaire, ou du bean indiqué par l'attribut "name", qui retournera la collection des valeurs à retourner au serveur pour les options.

optionsCollection

Ajoute plusieurs choix dans une zone de liste.

Version struts-layout du tag <html:optionsCollection>. Seul le nom a changé.

Nom de l'attribut Description
label Propriété des beans de la collection repréntant l'étiquette à rendre pour chaque option. Par défaut : "label".
name Nom de l'attribut du bean dont les propriétés sont consultées lors du rendu de la valeur courante de la zone. Si non spécifié, le bean du formulaire dans lequel ce tag est imbriqué est utilisé.
property Propriété du bean du formulaire, ou du bean indiqué par l'attribut "name", qui retournera la collection d'objets à rendre pour les options.
value Propriété des beans de la collection repréntant la valeur à rendre pour chaque option. Par défaut : "value".