Breadcrumbs Usage Guideline
|
| Guideline | Section | For Information About |
|---|---|---|
| Tab Bar | All | Application hierarchies |
Related ADF Elements
Refer to the ADF Faces Rich Client demos page to find demos and tag documentation for the ADF elements related to this component:
| ADF Element | Notes |
|---|---|
| af:breadcrumbs | Breadcrumbs component. |
| af:commandNavigationItem | Breadcrumb links. |

Purpose:
The Breadcrumbs component is used to indicate page location within the application hierarchy and to navigate up through the hierarchy.

Breadcrumbs in Local Context Region
Usage:

Breadcrumbs in Global Layer

Breadcrumbs consist of the following elements: Links, Breadcrumb Separators, Current Page Text, and the Overflow Iconic Button (opens the Overflow Breadcrumb Selector).

Purpose:
Identify and navigate to a higher level in the application hierarchy.
Description:

Navigating Up with a Breadcrumb Link
Usage:

Purpose:
Separate the links and text that represent different levels of pages in the application hierarchy.
Description:
Usage:
When page titles contain colon separators, the colons may also appear in individual Breadcrumb links and Current Page Text. Note that such use of colons in page titles has no effect on breadcrumb level separators.

Purpose:
Identifies the current page in the breadcrumb sequence.
Description:
The Current Page Text string always appears at the end of the breadcrumb links.
Usage:

Purpose:
Provides access to breadcrumb links that cannot fit into the space available for breadcrumbs.
Description:

Navigating Up with an Overflow Breadcrumb Link

Purpose:
Displays the Overflow Breadcrumb Panel.
Description:

Purpose:
Displays higher-level links that do not fit in the Breadcrumbs area.
Description:

The information architecture in most products consists of a top-down hierarchy, with a structure that could be displayed in an organization chart. Typically, each page has only one location within the application hierarchy, which is represented by the breadcrumbs, and each breadcrumb link consists of that page's title. There may be alternative methods to display that page, such as Search, but product teams should have no difficulty determining the breadcrumb path.

Path Through an Application Hierarchy
For detailed breadcrumb syntax for common page types, see Breadcrumb Syntax later in this guideline. The following subsections discuss cases where the path may not be so obvious.

Some products may consist of an object structure that can be viewed in different ways. As a result, such products may provide multiple "correct" paths to navigate to a page from the top of the hierarchy. In these cases, breadcrumbs should be generated according to the following recommendations:
Example:
Based on the application's hierarchy, there are two correct paths to navigate to page F: A > B > D > F and A > C > E > F. If the user navigates from A to C to E to F (or even from just E to F), use the following breadcrumbs on page F: A > C > E > F. However, if the user navigates from page A to F, the product team must choose a default location which may be either A > B > D > F or A > C > E > F.
Two Paths Through an Application Hierarchy

When an application has both level one and level two tabs, selection of a level one tab may also default to selection of the first level two tab. Consequently, on subordinate drill-down pages, breadcrumb links to both the parent tab and the level two tab would have the same target. To avoid this problem, combine the level one tab label with the level two label to form a single link in the breadcrumbs, using a colon (:) as a separator, such as "Projects: Overview". The colon should be appended directly to the level one tab label with one space before the level two label (no space in front of the colon and one space after it).

Breadcrumb text for each page should match the page header. To make breadcrumbs easier to read, syntax format is restricted to:

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| All | Breadcrumb may or may not be on object list page depending on location in application hierarchy.
If breadcrumb exists: xxx |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| All | xxx > ObjectTypes |
xxx > Purchase Orders xxx > Employees xxx > Courses |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| When user drills down on a View and Edit Page to secondary/child object details like attachments or expense lines | xxx > ObjectTypes > PrimaryObjectBreadcrumb |
xxx > Expense Reports > Paris Trip xxx > Course Tests > Psych 101 |


| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| All | xxx > ObjectType Note: Same syntax as Multi-Page Non-Linear Process. |
xxx > Customers xxx > Contracts |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| If the two pages constitute a sequential process | Use the following syntax in most cases:
xxx > ObjectType > {Process Name:}{Step Name} Use the following shortened syntax when either the Process Name or Step Name becomes too lengthy: xxx > ObjectType > Process Name Note: See 3-Plus Step by Step Process (Wizard) for directions on assembling the Process Name. |
Full form:
xxx > Customers > Create Customer: Name Shortened Form: xxx > Customers > Create Customer |
| If the two pages represent an object with two parts | Use the following syntax in most cases:
xxx > ObjectType > {ObjectName:}{Step Name} Use the following syntax when either the ObjectName or Step Name becomes too lengthy: xxx > ObjectType v ObjectName |
Full form:
xxx > Contracts > Bob's Supplies: Renewals Shortened Form: xxx > Contracts > Bob's Supplies |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| All | No breadcrumbs with train. |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| All | No breadcrumbs with train. |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| All | xxx > ObjectType |
xxx > Customers xxx > Contracts |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| When a process name exists | Use the following syntax in most contexts:
xxx > ObjectType > {Process Name:}{Step Name} Use the following syntax when either the Process Name or Step Name becomes too lengthy: xxx > ObjectType > Process Name |
Full Form:
xxx > Customers > Create Customer: Name Shortened Form: xxx > Customers > Create Customer |
| When a process name does not exist | Use the following syntax in most contexts:
xxx > ObjectType > {ObjectName:}{Step Name} Use the following when either the ObjectName or Step Name becomes too lengthy: xxx > ObjectType > ObjectName |
Full Form:
xxx > Contracts > Bob's Supplies: Renewals Shortened Form: xxx > Contracts > Bob's Supplies |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| All | Same as View and Edit Pages. |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| All | See View and Edit Pages breadcrumbs.
Note: As the user cycles through the batch of detail objects, the last breadcrumb element changes from page to page, and does not append to the previous detail object breadcrumb. |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| Root of Catalog | No breadcrumbs on primary page. | |
| Category Page | TabName | Clothes |
| Subcategory, sub-subcategory, and item names on Browse Pages | CatalogName > Category > SubCategory | Books > Art History > Modern Art |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| If export or import options exist | See appropriate breadcrumb for drill-down page (depends on where the user drilled down from). |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| All | No breadcrumb on primary global page; follow breadcrumb standards for drill-down pages. |

| Application Contexts | Recommended Syntax | Examples |
|---|---|---|
| All | No breadcrumb on home page.
Note: When drilling down from home page, breadcrumb is: "Home" |