Application Express User's Guide > Adding Navigation > Creating Breadcrumbs > How to Create Breadcrumbs
How to Create Breadcrumbs |
Previous |
Next |
To add a breadcrumb to a page in your application you must:
Create the breadcrumb by running the Create Breadcrumb Wizard.
Add entries to it.
Add the breadcrumb to a page by creating a region.
To create breadcrumbs from the Shared Components page:
On the Database Home Page, click the Application Builder icon.
Select an application.
On the Application Builder home page, click Shared Components.
Under Navigation, select Breadcrumbs.
The Breadcrumbs page appears.
Click Create.
Enter a name and click Create.
To create breadcrumbs from a Page Definition:
Navigate to the appropriate Page Definition:
Navigate to the Database Home Page.
Click the Application Builder icon.
Select an application.
Select a page.
The Page Definition appears.
Under Shared Components, scroll down to Breadcrumbs and click the Create icon.
Enter a name and click Create.
After you create a breadcrumb, you add entries to it.
To add a breadcrumb entry:
Navigate to the Breadcrumbs page:
Navigate to the Database Home Page.
Click the Application Builder icon.
Select an application.
On the Application Builder home page, click Shared Components.
Under Navigation, select Breadcrumbs.
The Breadcrumbs page appears.
Select a breadcrumb to add entries to.
Click Create Breadcrumb Entry.
Under Breadcrumb Identification, specify the page on which this menu will be current
Under Entry:
Sequence - Indicate the order in which breadcrumb entries appear.
Parent Bread Entry - Identify the parent of this entry.
Short Name - Specify the short name of this entry (referenced in the breadcrumb template).
Long Name - Specify the long name of this entry (referenced in the breadcrumb template).
Under Target:
If the target location is a URL:
From Target is a, select URL.
In URL Target, enter a URL.
If the target location is a page:
From Target is a, select Page in this Application
In Page, specify the page ID
You can make a breadcrumb conditional by making selections under Conditions.
To make the breadcrumb conditional:
Make a selection from the Condition Type list.
Enter an expression in the fields provided.
When you are finished defining menu attributes, click Create at the top of the page.
Repeat these procedures for each breadcrumb entry you need to create.
A region is a area on a page that serves as a container for content. Once you create a breadcrumb and a breadcrumb template, the next step is to create a region. Once you create a region you can add a breadcrumb to page.
See Also: "Creating a New Template" and "Breadcrumb Templates" for information about changing menu display |
To create a breadcrumb region:
Navigate to the appropriate Page Definition:
Navigate to the Database Home Page.
Click the Application Builder icon.
Select an application.
Select a page.
The Page Definition appears.
Under Regions, click the Create icon.
For the region type, select Breadcrumb.
Enter a title and select a region template.
Select a breadcrumb and a breadcrumb template.
Optional. Identify the breadcrumb entry used to identify this page:
Breadcrumb Entry Label - Enter a label for the breadcrumb entry.
Parent Breadcrumb Entry - Select the appropriate hierarchical parent.
Click Finish.
Repeat these procedures for each page where you would like to add breadcrumb navigation.
To give users more exact context, you can include session state in breadcrumbs, making your breadcrumbs dynamic. For example, suppose a page in your application displays a list of orders for a particular company and you want to include the following breadcrumb:
Home > Orders > Orders for ACME Inc
In this example, ACME Inc
not only indicates the page a user is on and the navigation path. The Application Express engine stores the value of ACME Inc. in session state.
To create this type of dynamic menu, you must include a reference to a session state item in the breadcrumb's short name or long name, for example:
&COMPANY_NAME.