The CMSBreadCrumbs control allows you to display current user's position within the Web site in format
Item 1 > Item 2 > Item 3
where Item X is name of the document in the path.
Inherits: CMSControlProperties - common properties
Properties
Property Name |
Description |
Sample Value |
BreadCrumbSeparator |
Character(s) that separate the bread crumbs. You can use HTML code here. |
">>" |
DefaultPath |
Path to the node whose path should be displayed. This value is used in case no Path value is provided and no alias path is provided through friendly URL. |
"/home" |
ShowCurrentItem |
Indicates if the current (last) item should be displayed. |
|
ShowCurrentItemAsLink |
Indicates if the current (last) item should be displayed as a link. |
|
StartingPath |
Starting part of the path. |
"/products" |
UrlTarget |
Specifies target frame for all URLs. |
"_blank" |
LoadDataAutomaticaly |
Indicates if data for the control should be loaded automatically. By default, the data is loaded automatically.
If you set this property to false, you can supply custom DataSet to the DataSource property and then call the ReloadData(false) method. |
|
RenderedHTML |
Allows you to get or set the HTML code rendered by the control.
You need to set this property before the Render event - e.g. in the OnLoad event. |
|
Methods
Method Name |
Description |
ReloadData |
Reloads the data.
If the forceLoad parameter is set to false and the custom value is assigned to the DataSource property, the properties of the CMSListMenu control are not used and only the data from the DataSource are used. |
Design
You can modify the design using the following CSS styles:
Class Name |
Description |
CMSBreadCrumbsLink |
Link (A element) in the bread crumbs path. |
CMSBreadCrumbsCurrentItem |
Style of the last item representing the current location (it's not a link). |
CMSBreadCrumbs Example
This example will show you how to display user's current location within Web site structure. It assumes that you have configured your project for Kentico CMS Controls.
| • | Create a new Web form. |
| • | Drag and drop the CMSBreadCrumbs control on the form. |
| • | In the Properties window, set the following property value: |
| • | Path: /Products/Notebooks |
Compile and run the project. You should see a page like this:
