Select
SAP SE
The <code>sap.m.Select</code> control provides a list of items that allows users to select an item.
sap.ui.core/Control
The name to be used in the HTML code (for example, for HTML forms that send data to the server via submit).
Determines whether the user can modify the selected item. When the property is set
to <code>false</code>, the control appears as disabled and CANNOT be focused.
<b>Note:</b> When both <code>enabled</code> and <code>editable</code> properties
are set to <code>false</code>, <code>enabled</code> has priority over
<code>editable</code>.
Determines whether the user can modify the selected item. When the property is set
to <code>false</code>, the control appears as disabled but CAN still be focused.
<b>Note:</b> When both <code>enabled</code> and <code>editable</code> properties
are set to <code>false</code>, <code>enabled</code> has priority over
<code>editable</code>.
Sets the width of the field. By default, the field width is automatically adjusted to the size
of its content and the default width of the field is calculated based on the widest list item
in the dropdown list.
If the width defined is smaller than its content, only the field width is changed whereas
the dropdown list keeps the width of its content.
If the dropdown list is wider than the visual viewport, it is truncated and an ellipsis is displayed
for each item.
For phones, the width of the dropdown list is always the same as the viewport.
<b>Note:</b> This property is ignored if the <code>autoAdjustWidth</code> property is set to <code>true</code>.
Sets the maximum width of the control.
<b>Note:</b> This property is ignored if the <code>autoAdjustWidth</code> property is set to <code>true</code>.
Key of the selected item.
<b>Notes:</b>
<ul>
<li> If duplicate keys exist, the first item matching the key is used.</li>
<li> If invalid or none <code>selectedKey</code> is used, the first item is
being selected.</li>
<li> Invalid or missing <code>selectedKey</code> leads to severe functional
issues in <code>sap.m.Table</code>, when the <code>sap.m.Select</code> is used inside a
<code>sap.m.Table</code> column.</li>
</ul>
ID of the selected item.
The URI to the icon that will be displayed only when using the <code>IconOnly</code> type.
Type of a select. Possible values <code>Default</code>, <code>IconOnly</code>.
Indicates whether the width of the input field is determined by the selected item's content.
Sets the horizontal alignment of the text within the input field.
Specifies the direction of the text within the input field with enumerated options.
By default, the control inherits text direction from the DOM.
Visualizes the validation state of the control, e.g. <code>Error</code>, <code>Warning</code>,
<code>Success</code>, <code>Information</code>.
Defines the text of the value state message popup.
If this is not specified, a default text is shown from the resource bundle.
Indicates whether the text values of the <code>additionalText</code> property of a
{@link sap.ui.core.ListItem} are shown.
Indicates whether the selection is restricted to one of the items in the list.
<b>Note:</b> We strongly recommend that you always set this property to <code>false</code> and bind
the <code>selectedKey</code> property to the desired value for better interoperability with data binding.
Determines whether the text in the items wraps on multiple lines when the available width is not enough.
This event is fired when the value in the selection field is changed in combination with one of
the following actions:
<ul>
<li>The focus leaves the selection field</li>
<li>The <i>Enter</i> key is pressed</li>
<li>The item is pressed</li>
</ul>
The selected item.
Defines the items contained within this control.
<b>Note:</b> For items with icons you can use {@link sap.ui.core.ListItem}.
Example:
<pre>
<code> <ListItem text="Paper plane" icon="sap-icon://paper-plane"></ListItem> </code>
</pre>
Internal aggregation to hold the inner picker popup.
Icon, displayed in the left most area of the <code>Select</code> input.
Internal aggregation to hold the picker's header
Internal aggregation to hold the picker's subheader.
Sets or retrieves the selected item from the aggregation named items.
Association to controls / IDs which label this control (see WAI-ARIA attribute <code>aria-labelledby</code>).