Breadcrumbs

-----------

Display

~~~~~~~

Breadcrumbs are displayed by default in the header section (see

Here is the header section of the CubicWeb's forge:

.. image:: ../../../images/breadcrumbs_header.png

There are three breadcrumbs components defined in

  if the entity implements the ``IBreadCrumbs`` interface.

  one line, but with all entities of the same type which implement the

  ``IBreadCrumbs`` interface.

The ``IBreadCrumbs`` interface is defined in the

implements this interface must have a ``breadcrumbs`` method.

Here is the API of the ``breadcrumbs`` method:

.. automethod:: cubicweb.interfaces.IBreadCrumbs.breadcrumbs

If the breadcrumbs method return a list of entities, the

``cubicweb.web.views.ibreadcrumbs.BreadCrumbView`` is used to display

By default, for any entity, if recurs=True, breadcrumbs method returns

a list of entities, else a list of a simple string.

In order to see a hierarchical breadcrumbs, entities must have a

``parent`` method which returns the parent entity. By default this

method doesn't exist on entity, given that it can not be guessed.