ion-breadcrumb
A Breadcrumb is a single navigation item that is a child of the Breadcrumbs component. A breadcrumb can link elsewhere in an app or it can be plain text. Each breadcrumb has a separator between it and the next breadcrumb and can optionally contain an icon.
See the Breadcrumbs documentation for more information.
Interfacesβ
BreadcrumbCollapsedClickEventDetailβ
interface BreadcrumbCollapsedClickEventDetail {
collapsedBreadcrumbs?: HTMLIonBreadcrumbElement[];
}
BreadcrumbCustomEventβ
While not required, this interface can be used in place of the CustomEvent interface for stronger typing .
interface BreadcrumbCustomEvent extends CustomEvent {
detail: BreadcrumbCollapsedClickEventDetail;
target: HTMLIonBreadcrumbElement;
}
Propertiesβ
activeβ
| Description | If true, the breadcrumb will take on a different look to show that it is the currently active breadcrumb. Defaults to true for the last breadcrumb if it is not set on any. |
| Attribute | active |
| Type | boolean |
| Default | false |
colorβ
| Description | The color to use from your application's color palette. Default options are: "primary", "secondary", "tertiary", "success", "warning", "danger", "light", "medium", and "dark". For more information on colors, see theming. |
| Attribute | color |
| Type | "danger" ο½ "dark" ο½ "light" ο½ "medium" ο½ "primary" ο½ "secondary" ο½ "success" ο½ "tertiary" ο½ "warning" ο½ string ο½ undefined |
| Default | undefined |
disabledβ
| Description | If true, the user cannot interact with the breadcrumb. |
| Attribute | disabled |
| Type | boolean |
| Default | false |
downloadβ
| Description | This attribute instructs browsers to download a URL instead of navigating to it, so the user will be prompted to save it as a local file. If the attribute has a value, it is used as the pre-filled file name in the Save prompt (the user can still change the file name if they want). |
| Attribute | download |
| Type | string ο½ undefined |
| Default | undefined |
hrefβ
| Description | Contains a URL or a URL fragment that the hyperlink points to. If this property is set, an anchor tag will be rendered. |
| Attribute | href |
| Type | string ο½ undefined |
| Default | undefined |
modeβ
| Description | The mode determines which platform styles to use. This is a virtual property that is set once during initialization and will not update if you change its value after the initial render. |
| Attribute | mode |
| Type | "ios" ο½ "md" |
| Default | undefined |
relβ
| Description | Specifies the relationship of the target object to the link object. The value is a space-separated list of link types. |
| Attribute | rel |
| Type | string ο½ undefined |
| Default | undefined |
routerAnimationβ
| Description | When using a router, it specifies the transition animation when navigating to another page using href. |
| Attribute | undefined |
| Type | ((baseEl: any, opts?: any) => Animation) ο½ undefined |
| Default | undefined |
routerDirectionβ
| Description | When using a router, it specifies the transition direction when navigating to another page using href. |
| Attribute | router-direction |
| Type | "back" ο½ "forward" ο½ "root" |
| Default | 'forward' |
separatorβ
| Description | If true, show a separator between this breadcrumb and the next. Defaults to true for all breadcrumbs except the last. |
| Attribute | separator |
| Type | boolean ο½ undefined |
| Default | undefined |
targetβ
| Description | Specifies where to display the linked URL. Only applies when an href is provided. Special keywords: "_blank", "_self", "_parent", "_top". |
| Attribute | target |
| Type | string ο½ undefined |
| Default | undefined |
Eventsβ
| Name | Description | Bubbles |
|---|---|---|
ionBlur | Emitted when the breadcrumb loses focus. | true |
ionFocus | Emitted when the breadcrumb has focus. | true |
Methodsβ
No public methods available for this component.
CSS Shadow Partsβ
| Name | Description |
|---|---|
collapsed-indicator | The indicator element that shows the breadcrumbs are collapsed. |
native | The native HTML anchor or div element that wraps all child elements. |
separator | The separator element between each breadcrumb. |
CSS Custom Propertiesβ
- iOS
- MD
| Name | Description |
|---|---|
--background-focused | Background color of the breadcrumb when focused |
--color | Text color of the breadcrumb |
--color-active | Text color of the active breadcrumb |
--color-focused | Text color of the breadcrumb when focused |
--color-hover | Text color of the breadcrumb on hover |
| Name | Description |
|---|---|
--background-focused | Background color of the breadcrumb when focused |
--color | Text color of the breadcrumb |
--color-active | Text color of the active breadcrumb |
--color-focused | Text color of the breadcrumb when focused |
--color-hover | Text color of the breadcrumb on hover |
Slotsβ
No slots available for this component.