Skip to main content

UserSettingsItem

<ui5-user-settings-item> | Since 2.8.0

The ui5-user-settings-item represents an item in the ui5-user-settings-dialog.

ES6 Module Import​

import "@ui5/webcomponents-fiori/dist/UserSettingsItem.js";

You can disable the UserSettingsItem by setting the enabled property to false, or use the UserSettingsItem in read-only mode by setting the editable property to false.

Note: Disabled and read-only states shouldn't be used together.

Properties​

accessibleName​

DescriptionDefines the accessible ARIA name of the component.
Typestring | undefined
Defaultundefined

disabled​

DescriptionDefines whether the component is in disabled state.
Note: A disabled component is completely noninteractive.
Typeboolean
Defaultfalse

headerText​

DescriptionDefines the headerText of the item.
Typestring | undefined
Default""

icon​

DescriptionDefines the icon of the component.
Typestring
Default"globe"

loading​

DescriptionIndicates whether a loading indicator should be shown.
Typeboolean
Defaultfalse

loadingReason​

DescriptionIndicates why the control is in loading state.
Typestring | undefined
Defaultundefined

selected​

DescriptionShows item tab.
Typeboolean
Defaultfalse

text​

DescriptionDefines the text of the user settings item.
Typestring
Default""

tooltip​

DescriptionDefines the tooltip of the component.
A tooltip attribute should be provided to represent the meaning or function when the component is collapsed and only the icon is visible.
Typestring
Default""

Slots​

default​

DescriptionDefines the page views of the user settings item.
If there are no tab views, the first page view will be shown unless there is selected one. If there is selected page view it will be shown no matter if there are tab views.
The page views are displayed by default if there is no selected tab view.
TypeArray<UserSettingsView>

tabs​

DescriptionDefines the tab views of the user settings item.
TypeArray<UserSettingsView>

Events​

selection-change​

DescriptionFired when a selected view changed.
TypeCustomEvent<UserSettingsItemViewSelectEventDetail>
Parametersview: UserSettingsView
The selected view.
BubblesNo
CancelableYes - via preventDefault()

Methods​

No methods available for this component.

CSS Parts​

No CSS parts available for this component.

CSS Custom States​

No CSS custom states available for this component.