Choix des données à afficher dans une information

Une information possède au minimum un titre. En général, elle possède également un aperçu et/ou un contenu.

L'aperçu peut, par exemple, être un court résumé de l'information ou encore la première phrase de celle-ci, tandis que le contenu est une version complète de l'information, généralement plus longue que l'aperçu.

D'autres données viennent compléter ces informations: les catégories liées à l'information, la date de publication, la date de dernière modification, des images, un fichier attaché, etc.

L'élément <affichage> pour sélectionner les données à afficher

Le choix des données à faire figurer dans l'information se fait grâce à des sous-éléments placés dans un élément <affichage>.

Cet élément <affichage> est à placer dans l'élément <valves>, auquel cas il est valable pour toutes les informations de toutes les sources. On peut également le placer à l'intérieur d'un élément <source_xxx>, auquel cas il est valable pour les informations de cette source-là.

C'est le même élément <affichage> qui sert également à donner un style à chacune des informations.

Par exemple, les sous-éléments <titre/>, <contenu/>, <aperçu/> et <auteur/> permettent d'afficher le titre, le contenu, l'aperçu et l'auteur d'une information.

A titre d'exemple, voici quelques combinaisons possibles de ces sous-éléments:

<valves maximum="1">
   <affichage style="voile" bords="arrondis">
      <titre/>
      <contenu/>
   </affichage>
   ...
</valves>

<valves maximum="1">
   <affichage style="voile" bords="arrondis">
      <titre/>
      <auteur/>
      <aperçu/>
   </affichage>
   ...
</valves>

<valves maximum="1">
   <affichage style="voile" bords="arrondis">
      <titre/>
   </affichage>
   ...
</valves>

<valves maximum="1">
   <affichage style="voile" bords="arrondis">
      <auteur/>
      <titre/>
   </affichage>
   ...
</valves>

<valves maximum="1">
   <affichage style="voile" bords="arrondis">
      <titre/>
      <aperçu/>
      <auteur/>
   </affichage>
   ...
</valves>

Les éléments dans <affichage> pour sélectionner les informations à afficher

Les sous-éléments à placer dans <affichage> sélectionnent les données à afficher. Ils sont à choisir parmi les éléments suivants:

• <titre/> pour afficher le titre de l'information;

• <aperçu/> pour afficher l'aperçu de l'information;

• <contenu/> pour afficher le contenu de l'information ;

• <vignette/> pour afficher une petite image qui illustre l'information;

• <illustration/> pour afficher une image qui illustre l'information;

• <vignette-source/> pour afficher une petite image qui illustre la source d'où provient l'information;

• <audio/> pour afficher un lecteur audio afin d'écouter une donnée sonore attachée à l'information;

• <vidéo/> pour afficher un lecteur vidéo afin de regarder une vidéo attachée à l'information;

• <fichier-attaché/> pour afficher un lien vers un fichier attaché à l'information;

• <plus/> pour afficher un lien pour plus d'information (dans le cas où on alterne entre résumé et information complète);

• <moins/> pour afficher un lien pour moins d'information (dans le cas où on alterne entre résumé et information complète);

Si plusieurs de ces sous-éléments sont utilisés, les informations qu'ils représentent viendront s'écrire les unes en dessous des autres (de haut en bas dans l'ordre de ces sous-éléments). Pour les vignettes ou les illustrations, il est toutefois possible "d'enrouler" le reste de ces informations autour de l'image.

A cela s'ajoute:

• <groupe> pour regrouper certaines données qui viendront s'écrire les unes à coté des autres (voir ci-après);

• <évidence> pour regrouper certaines données qui viendront s'écrire les unes à coté des autres en les mettant en évidence (voir ci-après);

• <résumé> pour définir une version succinte de l'information et alterner entre cette version succinte et une version plus complète (en cliquant dessus);

On peut également utiliser les sous-éléments suivants, dont les données viendront également s'écrire les unes en dessous des autres. Toutefois, ces sous-éléments peuvent être regroupés dans un élément <groupe> ou un élément <évidence> afin d'écrire ces données les unes à coté des autres, sur la même ligne de texte (ce qui allège la mise en page).

A cette liste s'ajoute les données liés aux sources (qui seront les mêmes pour toutes les informations provenant de la même source):

L'affichage par défaut

Par défaut, si vous ne mentionnez pas l'élément <affichage>, ou si celui-ci ne contient aucun sous-élément, la vignette , le titre et l'aperçu seront affichés.

<affichage/>

<affichage>
   <vignette/>
   <titre/>
   <aperçu/>
</affichage>

Si l'élément <affichage>, ne contient qu'un sous-élément <résumé/> vide, la vignette , le titre et le contenu seront utilisés en combinaison avec un résumé qui contiendra la vignette , le titre et l'aperçu. Le résumé sera cliquable et possédera un attribut refermable="oui" pour faire apparaitre une icone permettant d'afficher l'information complète.

<affichage> <résumé/> </affichage> Est équivalent à:	loading...ajax8
<affichage cible="ouvrirFermer" refermable="oui"> <vignette/> <titre/> <aperçu/> <résumé> <vignette/> <titre/> <contenu/> </résumé> </affichage>

Préfixes et suffixes

Toutes les informations, à part le titre, l'aperçu et le contenu (et bien entendu, les images) peuvent être affichées avec un préfixe ou un suffixe. Il s'agit de petits textes qui seront placés devant et derrière les informations en questions. Ces textes ne seront affichés que si l'information correspondante existe et n'est pas vide.

L'élément <groupe> pour écrire sur la même ligne

Par défault, les données s'écrivent les unes en dessous des autres. Toutefois, la plupart des données (hormis le titre, l'aperçu, le contenu et bien sûr les images) peuvent également s'écrire les unes à coté des autres, éventuellement séparées par des caractères de séparation.

Chacune de ces données peut être précédée d'un préfixe et suivie d'un suffixe. Ceux-ci seront utilisés uniquement si la donnée contient quelque chose à afficher.

Les données sont représentées par les sous-éléments suivants:

A cette liste s'ajoute les informations liés aux sources (qui seront les mêmes pour toutes les informations provenant de la même source):

On peut également utiliser:

• <évidence> pour mettre en évidence certaines informations au sein du groupe (toujours sur la même ligne que les autres informations);

• <sep puce="..."/> pour insérer une puce de séparation;

• <sep-texte/> pour insérer une texte de séparation;

Séparateur entre les informations

Par défaut, un tiret entouré de deux espaces (" - ") sera utilisé pour séparer deux informations. Vous pouvez changer cela, en utilisant un élément <sep-texte> ou <sep>.

L'utilisation de l'élément <sep-texte> définit un autre texte que le texte par défaut à utiliser en guise de séparateur.

Un élément <sep puce="..."/> définit une "puce" en guise de séparateur. Toutes les puces disponibles dans Sitemanager peuvent être utilisées.

Mise en évidence de certaines informations

Il est possible, au sein d'un élément <affichage> ou d'un élément <groupe>, de mettre en évidence certaines informations, en les regroupant dans un élément <évidence>. Ces informations seront alors mise en évidence, en utilisant un graphisme particulier qui contribue à rythmer la mise en page des informations.

L'élément <texte>

L'élément <texte> permet simplement d'afficher du texte, dans la même mise en page que les autres données de l'information.