Class sap.m.BreadcrumbsModule: sap/m/Breadcrumbs

extends Control

Enables users to navigate between items by providing a list of links to previous steps in the user's navigation path. The last three steps can be accessed as links directly The remaining links prior to them are available in a drop-down menu.


Since: 1.34.
Constructor Summary
new sap.m.Breadcrumbs(sId?, mSettings?)Constructor for a new Breadcrumbs

Accepts an object literal mSettings that defines initial property values, aggregated and associated objects as well as event handlers.

Events borrowed from class sap.ui.core.Control
validateFieldGroup
Events borrowed from class sap.ui.base.ManagedObject
formatError, modelContextChange, parseError, validationError, validationSuccess
Method Summary
sap.m.Breadcrumbs.extend(sClassName, oClassInfo?, FNMetaImpl?)Creates a new subclass of class sap.m.Breadcrumbs with name sClassName and enriches it with the information contained in oClassInfo.
sap.m.Breadcrumbs.getMetadata()Returns a metadata object for class sap.m.Breadcrumbs.
addLink(oLink)Adds some link to the aggregation links.
destroyLinks()Destroys all the links in the aggregation links.
getCurrentLocationText()Gets current value of property currentLocationText.
getLinks()Gets content of aggregation links.
indexOfLink(oLink)Checks for the provided sap.m.Link in the aggregation links.
insertLink(oLink, iIndex)Inserts a link into the aggregation links.
removeAllLinks()Removes all the controls from the aggregation links.
removeLink(vLink)Removes a link from the aggregation links.
setCurrentLocationText(sCurrentLocationText)Sets a new value for property currentLocationText.
Methods borrowed from class sap.ui.core.Control
addStyleClass, allowTextSelection, attachBrowserEvent, attachValidateFieldGroup, checkFieldGroupIds, clone, detachBrowserEvent, detachValidateFieldGroup, fireValidateFieldGroup, getAccessibilityInfo, getBusy, getBusyIndicatorDelay, getControlsByFieldGroupId, getFieldGroupIds, getIdForLabel, getRenderer, getVisible, hasStyleClass, invalidate, isBusy, onAfterRendering, onBeforeRendering, placeAt, removeStyleClass, rerender, setBusy, setBusyIndicatorDelay, setFieldGroupIds, setVisible, toggleStyleClass, triggerValidateFieldGroup
Methods borrowed from class sap.ui.core.Element
$, addCustomData, addDependent, addEventDelegate, applyFocusInfo, bindElement, data, destroy, destroyCustomData, destroyDependents, destroyLayoutData, destroyTooltip, enhanceAccessibilityState, exit, findElements, fireEvent, focus, getCustomData, getDependents, getDomRef, getElementBinding, getFocusDomRef, getFocusInfo, getInterface, getLayoutData, getMetadata, getTooltip, getTooltip_AsString, getTooltip_Text, indexOfCustomData, indexOfDependent, init, insertCustomData, insertDependent, prop, removeAllCustomData, removeAllDependents, removeCustomData, removeDependent, removeEventDelegate, setLayoutData, setTooltip, toString, unbindElement
Methods borrowed from class sap.ui.base.ManagedObject
addAggregation, addAssociation, applySettings, attachFormatError, attachModelContextChange, attachParseError, attachValidationError, attachValidationSuccess, bindAggregation, bindContext, bindObject, bindProperty, destroyAggregation, detachFormatError, detachModelContextChange, detachParseError, detachValidationError, detachValidationSuccess, findAggregatedObjects, fireFormatError, fireModelContextChange, fireParseError, fireValidationError, fireValidationSuccess, getAggregation, getAssociation, getBinding, getBindingContext, getBindingInfo, getBindingPath, getEventingParent, getId, getModel, getObjectBinding, getOriginInfo, getParent, getProperty, hasModel, indexOfAggregation, insertAggregation, isBound, isInvalidateSuppressed, isTreeBinding, propagateMessages, removeAggregation, removeAllAggregation, removeAllAssociation, removeAssociation, setAggregation, setAssociation, setBindingContext, setModel, setProperty, unbindAggregation, unbindContext, unbindObject, unbindProperty, validateAggregation, validateProperty
Methods borrowed from class sap.ui.base.EventProvider
attachEvent, attachEventOnce, detachEvent, hasListeners
Constructor Detail
new sap.m.Breadcrumbs(sId?, mSettings?)
Constructor for a new Breadcrumbs

Accepts an object literal mSettings that defines initial property values, aggregated and associated objects as well as event handlers. See sap.ui.base.ManagedObject for a general description of the syntax of the settings object.

The supported settings are:

In addition, all settings applicable to the base type sap.ui.core.Control can be used as well.

Parameters:
{string}sId? ID for the new control, generated automatically if no ID is given
{object}mSettings? Initial settings for the new control
Method Detail
sap.m.Breadcrumbs.extend(sClassName, oClassInfo?, FNMetaImpl?): function
Creates a new subclass of class sap.m.Breadcrumbs with name sClassName and enriches it with the information contained in oClassInfo.

oClassInfo might contain the same kind of information as described in sap.ui.core.Control.extend.

Parameters:
{string}sClassName Name of the class being created
{object}oClassInfo? Object literal with information about the class
{function}FNMetaImpl? Constructor function for the metadata object; if not given, it defaults to sap.ui.core.ElementMetadata
Returns:
{function} Created class / constructor function
sap.m.Breadcrumbs.getMetadata(): sap.ui.base.Metadata
Returns a metadata object for class sap.m.Breadcrumbs.
Returns:
{sap.ui.base.Metadata} Metadata object describing this class
addLink(oLink): sap.m.Breadcrumbs
Adds some link to the aggregation links.
Parameters:
{sap.m.Link}oLink the link to add; if empty, nothing is inserted
Since:
1.34
Returns:
{sap.m.Breadcrumbs} Reference to this in order to allow method chaining
destroyLinks(): sap.m.Breadcrumbs
Destroys all the links in the aggregation links.
Since:
1.34
Returns:
{sap.m.Breadcrumbs} Reference to this in order to allow method chaining
getCurrentLocationText(): string
Gets current value of property currentLocationText.

Determines the text of current/last element in the Breadcrumbs path.

Since:
1.34
Returns:
{string} Value of property currentLocationText
getLinks(): sap.m.Link[]
Gets content of aggregation links.

A list of all the active link elements in the Breadcrumbs control. Note: Enabling the property wrapping of the link will not work since it's incompatible with the concept of the control. The other properties will work, but their effect may be undesirable.

Since:
1.34
Returns:
{sap.m.Link[]}
indexOfLink(oLink): int
Checks for the provided sap.m.Link in the aggregation links. and returns its index if found or -1 otherwise.
Parameters:
{sap.m.Link}oLink The link whose index is looked for
Since:
1.34
Returns:
{int} The index of the provided control in the aggregation if found, or -1 otherwise
insertLink(oLink, iIndex): sap.m.Breadcrumbs
Inserts a link into the aggregation links.
Parameters:
{sap.m.Link}oLink the link to insert; if empty, nothing is inserted
{int}iIndex the 0-based index the link should be inserted at; for a negative value of iIndex, the link is inserted at position 0; for a value greater than the current size of the aggregation, the link is inserted at the last position
Since:
1.34
Returns:
{sap.m.Breadcrumbs} Reference to this in order to allow method chaining
removeAllLinks(): sap.m.Link[]
Removes all the controls from the aggregation links.

Additionally, it unregisters them from the hosting UIArea.

Since:
1.34
Returns:
{sap.m.Link[]} An array of the removed elements (might be empty)
removeLink(vLink): sap.m.Link
Removes a link from the aggregation links.
Parameters:
{int|string|sap.m.Link}vLink The linkto remove or its index or id
Since:
1.34
Returns:
{sap.m.Link} The removed link or null
setCurrentLocationText(sCurrentLocationText): sap.m.Breadcrumbs
Sets a new value for property currentLocationText.

Determines the text of current/last element in the Breadcrumbs path.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{string}sCurrentLocationText New value for property currentLocationText
Since:
1.34
Returns:
{sap.m.Breadcrumbs} Reference to this in order to allow method chaining