goa/doc/devmanual_fr/sect_stdlib_vues.txt
author Katia Saurfelt <katia.saurfelt@logilab.fr>
Tue, 19 May 2009 11:44:06 +0200 (2009-05-19)
branchstable
changeset 1863 9a02979a2c00
parent 0 b97547f5f1fa
permissions -rw-r--r--
do not use <br> in widgets

Vues pr�d�finies dans la librairie
----------------------------------
Un certain nombre de vues sont utilis�es pour construire l'interface web, qui
s'appliquent � une ou plusieurs entit�s. On les distingue par leur identifiant,
et les principales sont : 

:primary:
    vue principale pour une entit�, elle est appel�e par d�faut lorsqu'il n'y a
    qu'un seul �l�ment correspondant � la recherche. Cette vue est cens�e
    afficher le maximum d'informations � propos de l'objet.
:secondary:
    vue secondaire d'une entit�. Par d�faut, Elle affiche les deux premiers
    attributs de l'entit� sous la forme d'un lien cliquable amenant sur la vue
    primaire.
:oneline:
    similaire � la vue `secondary`, mais appel�e dans des cas o� l'on d�sire que
    la vue tient sur une ligne, ou de mani�re g�n�rale juste avoir une vue plus
    abbr�g�e. Par d�faut, cette vue utilise le param�tre de configuration
    `MAX_LINE_CHAR` pour contr�ler la taille du r�sultat.
:text:
    similaire � la vue `oneline`, mais ne devant pas contenir de html.
:incontext, outofcontext:
    similaire � la vue `secondary`, mais appel� si l'entit� est consid�r�e comme
    en dehors ou dans son contexte. Par d�fault renvoie respectivement le
    r�sultat de `textincontext` et `textoutofcontext` entour� par un lien
    permettant d'acc�der � la vue primaire de l'entit�
:textincontext, textoutofcontext:
    similaire � la vue `text`, mais appel� si l'entit� est consid�r�e comme
    en dehors ou dans son contexte. Par d�fault renvoie respectivement le
    r�sultat des m�thodes `.dc_title` et `.dc_long_title` de l'entit�
:list:
    cr�e une liste html (<ul>) et appelle la vue `listitem` pour chaque entit�
:listitem:
    redirige par d�faut vers la vue `outofcontext`
:rss:
    cr�e unvue RSS/XML et appelle la vue `rssitem` pour chaque entit�
:rssitem:
    cr�e unvue RSS/XML pour une entit� � partir des r�sultats renvoy�s par les
    m�thodes dublin core de l'objet (`dc_*`)

Vues de d�part :

:index:
    page d'acceuil
:schema:
    affiche le sch�ma de l'application

Vues particuli�res :

:noresult:
    appel� si le result set est vide
:finall:
    affiche la valeur de la cellule sans transformation (dans le cas d'une
    entit� non finale, on voit son eid). Appelable sur n'importe quel result
    set.
:table:
    cr�e une table html (<table>) et appelle la vue `cell` pour chaque cellule
    du r�sultat. Appelable sur n'importe quel result set.
:cell:
    par d�faut redirige sur la vue `final` si c'est une entit� finale
    ou sur la vue `outofcontext` sinon
:null:
    vue toujours appelable et ne retournant rien