doc/devmanual_fr/sect_stdlib_vues.txt
changeset 0 b97547f5f1fa
equal deleted inserted replaced
-1:000000000000 0:b97547f5f1fa
       
     1 .. -*- coding: utf-8 -*-
       
     2 
       
     3 Vues prédéfinies dans la librairie
       
     4 ----------------------------------
       
     5 Un certain nombre de vues sont utilisées pour construire l'interface web, qui
       
     6 s'appliquent à une ou plusieurs entités. On les distingue par leur identifiant,
       
     7 et les principales sont : 
       
     8 
       
     9 :primary:
       
    10     vue principale pour une entité, elle est appelée par défaut lorsqu'il n'y a
       
    11     qu'un seul élément correspondant à la recherche. Cette vue est censée
       
    12     afficher le maximum d'informations à propos de l'objet.
       
    13 :secondary:
       
    14     vue secondaire d'une entité. Par défaut, Elle affiche les deux premiers
       
    15     attributs de l'entité sous la forme d'un lien cliquable amenant sur la vue
       
    16     primaire.
       
    17 :oneline:
       
    18     similaire à la vue `secondary`, mais appelée dans des cas où l'on désire que
       
    19     la vue tient sur une ligne, ou de manière générale juste avoir une vue plus
       
    20     abbrégée. Par défaut, cette vue utilise le paramètre de configuration
       
    21     `MAX_LINE_CHAR` pour contrôler la taille du résultat.
       
    22 :text:
       
    23     similaire à la vue `oneline`, mais ne devant pas contenir de html.
       
    24 :incontext, outofcontext:
       
    25     similaire à la vue `secondary`, mais appelé si l'entité est considérée comme
       
    26     en dehors ou dans son contexte. Par défault renvoie respectivement le
       
    27     résultat de `textincontext` et `textoutofcontext` entouré par un lien
       
    28     permettant d'accéder à la vue primaire de l'entité
       
    29 :textincontext, textoutofcontext:
       
    30     similaire à la vue `text`, mais appelé si l'entité est considérée comme
       
    31     en dehors ou dans son contexte. Par défault renvoie respectivement le
       
    32     résultat des méthodes `.dc_title` et `.dc_long_title` de l'entité
       
    33 :list:
       
    34     crée une liste html (<ul>) et appelle la vue `listitem` pour chaque entité
       
    35 :listitem:
       
    36     redirige par défaut vers la vue `outofcontext`
       
    37 :rss:
       
    38     crée unvue RSS/XML et appelle la vue `rssitem` pour chaque entité
       
    39 :rssitem:
       
    40     crée unvue RSS/XML pour une entité à partir des résultats renvoyés par les
       
    41     méthodes dublin core de l'objet (`dc_*`)
       
    42 
       
    43 Vues de départ :
       
    44 
       
    45 :index:
       
    46     page d'acceuil
       
    47 :schema:
       
    48     affiche le schéma de l'application
       
    49 
       
    50 Vues particulières :
       
    51 
       
    52 :noresult:
       
    53     appelé si le result set est vide
       
    54 :finall:
       
    55     affiche la valeur de la cellule sans transformation (dans le cas d'une
       
    56     entité non finale, on voit son eid). Appelable sur n'importe quel result
       
    57     set.
       
    58 :table:
       
    59     crée une table html (<table>) et appelle la vue `cell` pour chaque cellule
       
    60     du résultat. Appelable sur n'importe quel result set.
       
    61 :cell:
       
    62     par défaut redirige sur la vue `final` si c'est une entité finale
       
    63     ou sur la vue `outofcontext` sinon
       
    64 :null:
       
    65     vue toujours appelable et ne retournant rien