面包屑

面包屑是一个导航组件，帮助用户沿着实体路径定位自己。

显示

默认情况下，面包屑会显示在标题部分（请参见 布局和截面 ）。对于默认的主模板，header部分由徽标、应用程序名、面包屑和最右边的登录框组成。面包屑显示在应用程序名称旁边，因此它们以分隔符开头。

以下是CubicWeb锻造的头部部分：

在中定义了三个breadcrumbs组件 cubicweb.web.views.ibreadcrumbs ：

• BreadCrumbEntityVComponent ：如果实体适用于 IBreadCrumbsAdapter .

• BreadCrumbETypeVComponent ：显示一个结果集，该结果集有多行，但所有实体类型相同，可以适应 IBreadCrumbsAdapter .

• BreadCrumbAnyRSetVComponent ：为任何其他结果集显示。

构建面包屑

这个 IBreadCrumbsAdapter 适配器在中定义 cubicweb.web.views.ibreadcrumbs 模块。它指定实现此接口的实体必须具有 breadcrumbs 和A parent_entity 方法。提供了每个的默认实现。此实现导出ITreeAdapter。

注解

重新定义面包屑是一种非常有效的方法。另一种方法是定义 ITreeAdapter 实体类型上的适配器。如果可用，它将用于计算面包屑。

这是API的 IBreadCrumbsAdapter 班级：

如果breadcrumbs方法返回实体列表，则 cubicweb.web.views.ibreadcrumbs.BreadCrumbView 用于显示元素。

默认情况下，对于任何实体，如果recurs=true，breadcrumbs方法返回实体列表，否则返回简单字符串列表。

为了查看层次面包屑，实体必须具有 parent 返回父实体的方法。默认情况下，实体上不存在此方法，因为无法猜测它。