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.

    array - consultation html

    Figure 9. array - consultation html

  • 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.

    array - Modification html

    Figure 10. array - Modification html

  • odt :

    Un tableau

    array - consultation odt

    Figure 11. array - consultation odt

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 est 10.

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).
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%.

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 :

color

Indique la couleur du texte pour les cellules de la colonne.

Les valeurs possibles sont :

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)
×
nouveauté