4.2.5 Type array
4.2.5.1 Description
Les attributs de type array permettent de définir des tableaux.
Chacun des attributs contenu dans un array est alors dit multiple, et correspond à une colonne du dit array. Un tableau ne peut pas contenir d'autres attributs de type array
.
4.2.5.2 Représentation
Les array sont représentés au moyen d'une table
.
Chaque colonne correspond à un attribut contenu dans l'array. Le libellé de la colonne est le libellé de l'attribut correspondant.
-
consultation :
Un tableau.
-
modification :
La première colonne contient les outils permettant la sélection, suppression, et le déplacement d'une colonne, alors que la dernière ligne contient les outils permettant de rajouter une ligne ou de dupliquer une ligne existante.
-
odt :
Un tableau
4.2.5.3 Comportement
Aucun comportement particulier.
4.2.5.4 Format de stockage
Le tableau en lui même n'est pas stocké, mais modifie la façon dont les attributs qu'il contient sont stockés. En effet, une fois dans un tableau, un attribut est multiple, et nécessite donc le stockage de plusieurs valeurs. Pour rester simple, la valeur stockée sera une suite des valeurs de stockage simples séparées par un séparateur interne.
Pour plus de précisions, se reporter au chapitre avancé sur les formats de stockage.
4.2.5.5 Options applicables à l'array
- cellbodystyle
-
Indique le style css appliqué sur les cellules du corps de tableau.
Les valeurs possibles sont :
- toute définition css valide.
- cellheadstyle
-
Indique le style css appliqué sur les cellules de l'entête de tableau.
Les valeurs possibles sont :
- toute définition css valide.
- classname
-
Indique une classe css à appliquer aux cellules du corps tableau en consultation.
Les valeurs possibles sont :
- tout nom de classe valide.
- displayrowcount 3.2.17
-
Indique si le nombre de lignes du tableau est affiché dans l'entête de la première colonne.
Les valeurs possibles sont un entier n avec :
- n <= -1 pour ne jamais afficher le nombre de lignes ;
- n = 0 pour toujours afficher le nombre de lignes ;
- n > 0 pour afficher le nombre de lignes si celui-ci est > n.
Par défaut la valeur de
displayrowcount
est10
. - empty
-
Indique que le tableau, s'il est vide ne doit pas afficher la première rangée en modification. Dans le cas contraire, en modification, le tableau est initialisé avec une rangée vide.
Les valeurs possibles sont :
yes
no
(comportement par défaut)
- height
-
Indique la hauteur du corps du tableau. Si le corps du tableau dépasse la hauteur spécifiée, un ascenseur vertical apparaîtra.
Ne fonctionne qu'avec les navigateurs récents.
Les valeurs possibles sont:
- Une taille en pixels (par exemple
150px
).
- Une taille en pixels (par exemple
- sorttable
-
Indique que le tableau est triable. L'utilisateur peut cliquer sur un en-tête de colonne pour trier cette colonne.
Le tri est effectué au moyen du script sorttable.js.
L'utilisation avancée de sorttable.js sort du sujet de cette documentation, et est à charge et de la responsabilité du développeur.
Les valeurs possibles sont :
yes
no
(comportement par défaut)
- twidth
-
Indique la largeur du tableau. Si le corps du tableau dépasse la largeur spécifiée, un ascenseur horizontal apparaîtra.
Les valeurs possibles sont :
- une valeur absolue en pixel (par exemple
100px
), - une largeur relative en pourcentage (par exemple
30%
)
La valeur par défaut est
100%
. - une valeur absolue en pixel (par exemple
- userowadd
-
Indique si l'utilisateur est autorisé à ajouter des rangées au tableau. Dans ce cas, le bouton correspondant est affiché.
Cela permet de ne pas être en conflit si le tableau doit être rempli par un code spécifique sur l'interface, mais pas par l'utilisateur.
Les valeurs possibles sont :
yes
(comportement par défaut)no
- rowviewzone
- Indique une vue spécifique de tableau pour la consultation.
- roweditzone
- Indique une vue spécifique de tableau pour la modification.
4.2.5.6 Options applicables aux attributs contenus dans un array
- align
-
Indique l'alignement horizontal pour les cellules de la colonne.
Les valeur possibles sont :
-
left
, -
right
, -
center
, justify
-
- bgcolor
-
Indique la couleur de fond des cellules de la colonne.
Les valeurs possibles sont :
- toute couleur css valide
(exemple :
yellow
,#FF335A
, etc.)
- toute couleur css valide
(exemple :
- color
-
Indique la couleur du texte pour les cellules de la colonne.
Les valeurs possibles sont :
- toute couleur css valide
(exemple :
yellow
,#FF335A
, etc.)
- toute couleur css valide
(exemple :
- cwidth
-
Indique la largeur de la colonne.
Les valeurs possibles sont :
- une valeur absolue en pixel (par exemple
100px
), - une largeur relative en pourcentage (par exemple
30%
) auto
(comportement par défaut)
- une valeur absolue en pixel (par exemple