.. -*- coding: utf-8 -*-

HTML views

~~~~~~~~~~

Special views

`````````````

*noresult*

    This view is the default view used when no result has been found

    (e.g. empty result set).

*final*

    Display the value of a cell without trasnformation (in case of a non final

    entity, we see the eid). Applicable on any result set.

*null*

    This view is the default view used when nothing needs to be rendered.

Entity views

````````````

*incontext, outofcontext*

    Those are used to display a link to an entity, depending on the

    entity having to be displayed in or out of context

    result of `textincontext` and `textoutofcontext` wrapped in a link

    leading to the primary view of the entity.

*oneline*

    This view is used when we can't tell if the entity should be considered as

    in a link leading to the primary view of the entity.

List

`````

*list*

    This view displays a list of entities by creating a HTML list (`<ul>`)

    and call the view `listitem` for each entity of the result set.

*listitem*

    This view redirects by default to the `outofcontext` view.

*sameetypelist*

    This view displays a list of entities of the same type, in HTML section (`<div>`)

    and call the view `sameetypelistitem` for each entity of the result set.

*sameetypelistitem*

    This view redirects by default to the `listitem` view.

*csv*

    This view applies to entity groups, which are individually

    displayed using the `incontext` view. It displays each entity as a

    coma separated list. It is NOT related to the well-known text file

    format.

Text entity views

~~~~~~~~~~~~~~~~~

*text*

    This is the simplest text view for an entity. By default it returns the

    result of the `.dc_title` method, which is cut to fit the

    `navigation.short-line-size` property if necessary.

*textincontext, textoutofcontext*

    Similar to the `text` view, but called when an entity is considered out or

    in context. By default it returns respectively the result of the

    methods `.dc_title` and `.dc_long_title` of the entity.