@ui5/webcomponents 1.0.0-rc.9 → 1.0.0

package/dist/Select.js

@@ -6,25 +6,28 @@ import {
 	isDown,
 	isEnter,
 	isEscape,
+	isHome,
+	isEnd,
 	isShow,
 	isTabNext,
 	isTabPrevious,
 } from "@ui5/webcomponents-base/dist/Keys.js";
+import announce from "@ui5/webcomponents-base/dist/util/InvisibleMessage.js";
 import Integer from "@ui5/webcomponents-base/dist/types/Integer.js";
 import { getFeature } from "@ui5/webcomponents-base/dist/FeaturesRegistry.js";
 import { getEffectiveAriaLabelText } from "@ui5/webcomponents-base/dist/util/AriaLabelHelper.js";
 import ValueState from "@ui5/webcomponents-base/dist/types/ValueState.js";
-import "@ui5/webcomponents-icons/dist/icons/slim-arrow-down.js";
+import "@ui5/webcomponents-icons/dist/slim-arrow-down.js";
 import { isPhone } from "@ui5/webcomponents-base/dist/Device.js";
 import { getI18nBundle } from "@ui5/webcomponents-base/dist/i18nBundle.js";
-import "@ui5/webcomponents-icons/dist/icons/decline.js";
+import "@ui5/webcomponents-icons/dist/decline.js";
 import {
 	VALUE_STATE_SUCCESS,
 	VALUE_STATE_INFORMATION,
 	VALUE_STATE_ERROR,
 	VALUE_STATE_WARNING,
 	INPUT_SUGGESTIONS_TITLE,
-	SELECT_ROLE_DESCRIPTION,
+	LIST_ITEM_POSITION,
 } from "./generated/i18n/i18n-defaults.js";
 import Option from "./Option.js";
 import Label from "./Label.js";
@@ -55,7 +58,7 @@ const metadata = {
 	slots: /** @lends sap.ui.webcomponents.main.Select.prototype */ {
 
 		/**
-		 * Defines the <code>ui5-select</code> options.
+		 * Defines the component options.
 		 *
 		 * <br><br>
 		 * <b>Note:</b> Only one selected option is allowed.
@@ -63,24 +66,24 @@ const metadata = {
 		 *
 		 * <br><br>
 		 * <b>Note:</b> Use the <code>ui5-option</code> component to define the desired options.
-		 * @type {HTMLElement[]}
-		 * @slot
+		 * @type {sap.ui.webcomponents.main.ISelectOption[]}
+		 * @slot options
 		 * @public
 		 */
 		"default": {
 			propertyName: "options",
 			type: HTMLElement,
-			listenFor: { include: ["*"] },
+			invalidateOnChildChange: true,
 		},
 
 		/**
-		 * Defines the value state message that will be displayed as pop up under the <code>ui5-select</code>.
+		 * Defines the value state message that will be displayed as pop up under the component.
 		 * <br><br>
 		 *
 		 * <b>Note:</b> If not specified, a default text (in the respective language) will be displayed.
 		 * <br>
 		 * <b>Note:</b> The <code>valueStateMessage</code> would be displayed,
-		 * when the <code>ui5-select</code> is in <code>Information</code>, <code>Warning</code> or <code>Error</code> value state.
+		 * when the component is in <code>Information</code>, <code>Warning</code> or <code>Error</code> value state.
 		 * @type {HTMLElement[]}
 		 * @since 1.0.0-rc.9
 		 * @slot
@@ -89,13 +92,24 @@ const metadata = {
 		valueStateMessage: {
 			type: HTMLElement,
 		},
+
+		/**
+		 * The slot is used to render native <code>input</code> HTML element within Light DOM to enable form submit,
+		 * when <code>name</code> property is set.
+		 * @type {HTMLElement[]}
+		 * @slot
+		 * @private
+		 */
+		formSupport: {
+			type: HTMLElement,
+		},
 	},
 	properties: /** @lends  sap.ui.webcomponents.main.Select.prototype */  {
 
 		/**
-		 * Defines whether <code>ui5-select</code> is in disabled state.
+		 * Defines whether the component is in disabled state.
 		 * <br><br>
-		 * <b>Note:</b> A disabled <code>ui5-select</code> is noninteractive.
+		 * <b>Note:</b> A disabled component is noninteractive.
 		 *
 		 * @type {boolean}
 		 * @defaultvalue false
@@ -106,8 +120,8 @@ const metadata = {
 		},
 
 		/**
-		 * Determines the name with which the <code>ui5-select</code> will be submitted in an HTML form.
-		 * The value of the <code>ui5-select</code> will be the value of the currently selected <code>ui5-option</code>.
+		 * Determines the name with which the component will be submitted in an HTML form.
+		 * The value of the component will be the value of the currently selected <code>ui5-option</code>.
 		 *
 		 * <br><br>
 		 * <b>Important:</b> For the <code>name</code> property to have effect, you must add the following import to your project:
@@ -127,7 +141,7 @@ const metadata = {
 		},
 
 		/**
-		 * Defines the value state of the <code>ui5-select</code>.
+		 * Defines the value state of the component.
 		 * <br><br>
 		 * Available options are:
 		 * <ul>
@@ -148,10 +162,10 @@ const metadata = {
 		},
 
 		/**
-		 * Defines whether the <code>ui5-select</code> is required.
+		 * Defines whether the component is required.
 		 *
 		 * @since 1.0.0-rc.9
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @defaultvalue false
 		 * @public
 		 */
@@ -160,14 +174,14 @@ const metadata = {
 		},
 
 		/**
-		 * Defines the aria-label attribute for the select.
+		 * Sets the accessible aria name of the component.
 		 *
 		 * @type {String}
 		 * @since 1.0.0-rc.9
-		 * @private
-		 * @defaultvalue ""
+		 * @public
+		 * @since 1.0.0-rc.15
 		 */
-		ariaLabel: {
+		accessibleName: {
 			type: String,
 		},
 
@@ -176,10 +190,10 @@ const metadata = {
 		 *
 		 * @type {String}
 		 * @defaultvalue ""
-		 * @private
-		 * @since 1.0.0-rc.9
+		 * @public
+		 * @since 1.0.0-rc.15
 		 */
-		ariaLabelledby: {
+		accessibleNameRef: {
 			type: String,
 			defaultValue: "",
 		},
@@ -239,11 +253,17 @@ const metadata = {
  *
  * <h3>Keyboard Handling</h3>
  * The <code>ui5-select</code> provides advanced keyboard handling.
- * If the <code>ui5-select</code> is focused,
- * you can open or close the drop-down by pressing <code>F4</code>, <code>ALT+UP</code> or <code>ALT+DOWN</code> keys.
- * Once the drop-down is opened, you can use the <code>UP</code> and <code>DOWN</code> arrow keys
- * to navigate through the available options and select one by pressing the <code>Space</code> or <code>Enter</code> keys.
  * <br>
+ * <ul>
+ * <li>[F4, ALT+UP, ALT+DOWN, SPACE, ENTER] - Opens/closes the drop-down.</li>
+ * <li>[UP, DOWN] - If the drop-down is closed - changes selection to the next or the previous option. If the drop-down is opened - moves focus to the next or the previous option.</li>
+ * <li>[SPACE, ENTER] - If the drop-down is opened - selects the focused option.</li>
+ * <li>[ESC] - Closes the drop-down without changing the selection.</li>
+ * <li>[HOME] - Navigates to first option</li>
+ * <li>[END] - Navigates to the last option</li>
+ * </ul>
+ * <br>
+ *
  * <h3>ES6 Module Import</h3>
  * <code>import "@ui5/webcomponents/dist/Select";</code>
  * <br>
@@ -290,7 +310,8 @@ class Select extends UI5Element {
 		this._selectedIndexBeforeOpen = -1;
 		this._escapePressed = false;
 		this._lastSelectedOption = null;
-		this.i18nBundle = getI18nBundle("@ui5/webcomponents");
+		this._typedChars = "";
+		this._typingTimeoutID = -1;
 	}
 
 	onBeforeRendering() {
@@ -301,9 +322,13 @@ class Select extends UI5Element {
 	onAfterRendering() {
 		this.toggleValueStatePopover(this.shouldOpenValueStateMessagePopover);
 
-		if (this._isPickerOpen && !this._listWidth) {
-			this._listWidth = this.responsivePopover.offsetWidth;
+		if (this._isPickerOpen) {
+			if (!this._listWidth) {
+				this._listWidth = this.responsivePopover.offsetWidth;
+			}
 		}
+
+		this._attachRealDomRefs();
 	}
 
 	_onfocusin() {
@@ -315,11 +340,10 @@ class Select extends UI5Element {
 	}
 
 	get _isPickerOpen() {
-		return this.responsivePopover && this.responsivePopover.opened;
+		return !!this.responsivePopover && this.responsivePopover.opened;
 	}
 
 	async _respPopover() {
-		this._iconPressed = true;
 		const staticAreaItem = await this.getStaticAreaItemDomRef();
 		return staticAreaItem.querySelector("[ui5-responsive-popover]");
 	}
@@ -327,14 +351,15 @@ class Select extends UI5Element {
 	/**
 	 * Currently selected option.
 	 * @readonly
-	 * @type { ui5-option }
+	 * @type { sap.ui.webcomponents.main.ISelectOption }
 	 * @public
 	 */
 	get selectedOption() {
-		return this.options.find(option => option.selected);
+		return this._filteredItems.find(option => option.selected);
 	}
 
 	async _toggleRespPopover() {
+		this._iconPressed = true;
 		this.responsivePopover = await this._respPopover();
 		if (this.disabled) {
 			return;
@@ -343,46 +368,66 @@ class Select extends UI5Element {
 		if (this._isPickerOpen) {
 			this.responsivePopover.close();
 		} else {
-			this.responsivePopover.open(this);
+			this.responsivePopover.showAt(this);
 		}
 	}
 
+	async _attachRealDomRefs() {
+		this.responsivePopover = await this._respPopover();
+
+		this.options.forEach(option => {
+			option._getRealDomRef = () => this.responsivePopover.querySelector(`*[data-ui5-stable=${option.stableDomRef}]`);
+		});
+	}
+
 	_syncSelection() {
-		let lastSelectedOptionIndex = -1;
-		const opts = this.options.map((opt, index) => {
-			if (opt.selected) {
+		let lastSelectedOptionIndex = -1,
+			firstEnabledOptionIndex = -1;
+		const options = this._filteredItems;
+		const syncOpts = options.map((opt, index) => {
+			if (opt.selected || opt.textContent === this.value) {
+				// The second condition in the IF statement is added because of Angular Reactive Forms Support(Two way data binding)
 				lastSelectedOptionIndex = index;
 			}
+			if (firstEnabledOptionIndex === -1) {
+				firstEnabledOptionIndex = index;
+			}
 
 			opt.selected = false;
+			opt._focused = false;
 
 			return {
 				selected: false,
+				_focused: false,
 				icon: opt.icon,
 				value: opt.value,
 				textContent: opt.textContent,
 				id: opt._id,
+				stableDomRef: opt.stableDomRef,
 			};
 		});
 
-		if (lastSelectedOptionIndex > -1) {
-			opts[lastSelectedOptionIndex].selected = true;
-			this.options[lastSelectedOptionIndex].selected = true;
-			this._text = opts[lastSelectedOptionIndex].textContent;
+		if (lastSelectedOptionIndex > -1 && !syncOpts[lastSelectedOptionIndex].disabled) {
+			syncOpts[lastSelectedOptionIndex].selected = true;
+			syncOpts[lastSelectedOptionIndex]._focused = true;
+			options[lastSelectedOptionIndex].selected = true;
+			options[lastSelectedOptionIndex]._focused = true;
+			this._text = syncOpts[lastSelectedOptionIndex].textContent;
 			this._selectedIndex = lastSelectedOptionIndex;
 		} else {
 			this._text = "";
 			this._selectedIndex = -1;
+			if (syncOpts[firstEnabledOptionIndex]) {
+				syncOpts[firstEnabledOptionIndex].selected = true;
+				syncOpts[firstEnabledOptionIndex]._focused = true;
+				options[firstEnabledOptionIndex].selected = true;
+				options[firstEnabledOptionIndex]._focused = true;
+				this._selectedIndex = firstEnabledOptionIndex;
+				this._text = options[firstEnabledOptionIndex].textContent;
+			}
 		}
 
-		if (lastSelectedOptionIndex === -1 && opts[0]) {
-			opts[0].selected = true;
-			this.options[0].selected = true;
-			this._selectedIndex = 0;
-			this._text = this.options[0].textContent;
-		}
-
-		this._syncedOptions = opts;
+		this._syncedOptions = syncOpts;
 	}
 
 	_enableFormSupport() {
@@ -390,7 +435,7 @@ class Select extends UI5Element {
 		if (FormSupport) {
 			FormSupport.syncNativeHiddenInput(this, (element, nativeInput) => {
 				nativeInput.disabled = element.disabled;
-				nativeInput.value = element._currentlySelectedOption.value;
+				nativeInput.value = element._currentlySelectedOption ? element._currentlySelectedOption.value : "";
 			});
 		} else if (this.name) {
 			console.warn(`In order for the "name" property to have effect, you should also: import "@ui5/webcomponents/dist/features/InputElementsFormSupport.js";`); // eslint-disable-line
@@ -407,20 +452,90 @@ class Select extends UI5Element {
 		if (isShow(event)) {
 			event.preventDefault();
 			this._toggleRespPopover();
+		} else if (isSpace(event)) {
+			event.preventDefault();
+		} else if (isEscape(event) && this._isPickerOpen) {
+			this._escapePressed = true;
+		} else if (isHome(event)) {
+			this._handleHomeKey(event);
+		} else if (isEnd(event)) {
+			this._handleEndKey(event);
+		} else if (isEnter(event)) {
+			this._handleSelectionChange();
+		} else if (isUp(event) || isDown(event)) {
+			this._handleArrowNavigation(event);
 		}
+	}
 
-		if (isSpace(event)) {
-			event.preventDefault();
+	_handleKeyboardNavigation(event) {
+		if (isEnter(event)) {
+			return;
 		}
 
-		if (!this._isPickerOpen) {
-			this._handleArrowNavigation(event, true);
+		const typedCharacter = event.key.toLowerCase();
+
+		this._typedChars += typedCharacter;
+
+		// We check if we have more than one characters and they are all duplicate, we set the
+		// text to be the last input character (typedCharacter). If not, we set the text to be
+		// the whole input string.
+
+		const text = (/^(.)\1+$/i).test(this._typedChars) ? typedCharacter : this._typedChars;
+
+		clearTimeout(this._typingTimeoutID);
+
+		this._typingTimeoutID = setTimeout(() => {
+			this._typedChars = "";
+			this._typingTimeoutID = -1;
+		}, 1000);
+
+		this._selectTypedItem(text);
+	}
+
+	_selectTypedItem(text) {
+		const currentIndex = this._selectedIndex;
+		const itemToSelect = this._searchNextItemByText(text);
+
+		if (itemToSelect) {
+			const nextIndex = this._getSelectedItemIndex(itemToSelect);
+
+			this._changeSelectedItem(this._selectedIndex, nextIndex);
+
+			if (currentIndex !== this._selectedIndex) {
+				this.itemSelectionAnnounce();
+			}
 		}
 	}
 
+	_searchNextItemByText(text) {
+		let orderedOptions = this._filteredItems.slice(0);
+		const optionsAfterSelected = orderedOptions.splice(this._selectedIndex + 1, orderedOptions.length - this._selectedIndex);
+		const optionsBeforeSelected = orderedOptions.splice(0, orderedOptions.length - 1);
+
+		orderedOptions = optionsAfterSelected.concat(optionsBeforeSelected);
+
+		return orderedOptions.find(option => option.textContent.toLowerCase().startsWith(text));
+	}
+
+	_handleHomeKey(event) {
+		event.preventDefault();
+		this._changeSelectedItem(this._selectedIndex, 0);
+	}
+
+	_handleEndKey(event) {
+		const lastIndex = this._filteredItems.length - 1;
+
+		event.preventDefault();
+		this._changeSelectedItem(this._selectedIndex, lastIndex);
+	}
+
 	_onkeyup(event) {
-		if (isSpace(event) && !this._isPickerOpen) {
-			this._toggleRespPopover();
+		if (isSpace(event)) {
+			if (this._isPickerOpen) {
+				this._handleSelectionChange();
+			} else {
+				this._toggleRespPopover();
+			}
 		}
 	}
 
@@ -429,9 +544,9 @@ class Select extends UI5Element {
 	}
 
 	_select(index) {
-		this.options[this._selectedIndex].selected = false;
+		this._filteredItems[this._selectedIndex].selected = false;
 		this._selectedIndex = index;
-		this.options[index].selected = true;
+		this._filteredItems[index].selected = true;
 	}
 
 	/**
@@ -441,62 +556,66 @@ class Select extends UI5Element {
 	_handleItemPress(event) {
 		const item = event.detail.item;
 		const selectedItemIndex = this._getSelectedItemIndex(item);
-		this._select(selectedItemIndex);
 
+		this._handleSelectionChange(selectedItemIndex);
+	}
+
+	_itemMousedown(event) {
+		// prevent actual focus of items
+		event.preventDefault();
+	}
+
+	_onclick(event) {
+		this.getFocusDomRef().focus();
 		this._toggleRespPopover();
 	}
 
 	/**
-	 * The user used arrow up/down on the list
+	 * The user selected an item with Enter or Space
 	 * @private
 	 */
-	_handleSelectionChange(event) {
-		const item = event.detail.selectedItems[0];
-		const selectedItemIndex = this._getSelectedItemIndex(item);
-		this._select(selectedItemIndex);
-	}
-
-	_applyFocusAfterOpen() {
-		if (!this._currentlySelectedOption) {
-			return;
-		}
+	_handleSelectionChange(index = this._selectedIndex) {
+		this._select(index);
 
-		const li = this.responsivePopover.querySelector(`#${this._currentlySelectedOption._id}-li`);
-
-		li.parentElement._itemNavigation.currentIndex = this._selectedIndex;
-		li && li.focus();
+		this._toggleRespPopover();
 	}
 
-	_handlePickerKeydown(event) {
-		if (isEscape(event) && this._isPickerOpen) {
-			this._escapePressed = true;
+	_handleArrowNavigation(event) {
+		let nextIndex = -1;
+		const currentIndex = this._selectedIndex;
+		const isDownKey = isDown(event);
+
+		event.preventDefault();
+		if (isDownKey) {
+			nextIndex = this._getNextOptionIndex();
+		} else {
+			nextIndex = this._getPreviousOptionIndex();
 		}
 
-		if (isEnter(event) || isSpace(event)) {
-			this._shouldClosePopover = true;
+		this._changeSelectedItem(this._selectedIndex, nextIndex);
+
+		if (currentIndex !== this._selectedIndex) {
+			// Announce new item even if picker is opened.
+			// The aria-activedescendents attribute can't be used,
+			// because listitem elements are in different shadow dom
+			this.itemSelectionAnnounce();
 		}
 	}
 
-	_handleArrowNavigation(event, shouldFireEvent) {
-		let nextIndex = -1;
-		const isDownKey = isDown(event);
-		const isUpKey = isUp(event);
+	_changeSelectedItem(oldIndex, newIndex) {
+		const options = this._filteredItems;
 
-		if (isDownKey || isUpKey) {
-			event.preventDefault();
-			if (isDownKey) {
-				nextIndex = this._getNextOptionIndex();
-			} else {
-				nextIndex = this._getPreviousOptionIndex();
-			}
+		options[oldIndex].selected = false;
+		options[oldIndex]._focused = false;
 
-			this.options[this._selectedIndex].selected = false;
-			this.options[nextIndex].selected = true;
-			this._selectedIndex = nextIndex === -1 ? this._selectedIndex : nextIndex;
+		options[newIndex].selected = true;
+		options[newIndex]._focused = true;
 
-			if (shouldFireEvent) {
-				this._fireChangeEvent(this.options[nextIndex]);
-			}
+		this._selectedIndex = newIndex;
+
+		if (!this._isPickerOpen) {
+			// arrow pressed on closed picker - do selection change
+			this._fireChangeEvent(options[newIndex]);
 		}
 	}
 
@@ -510,19 +629,24 @@ class Select extends UI5Element {
 
 	_beforeOpen() {
 		this._selectedIndexBeforeOpen = this._selectedIndex;
-		this._lastSelectedOption = this.options[this._selectedIndex];
+		this._lastSelectedOption = this._filteredItems[this._selectedIndex];
+	}
+
+	_afterOpen() {
+		this.opened = true;
 	}
 
 	_afterClose() {
+		this.opened = false;
 		this._iconPressed = false;
 		this._listWidth = 0;
 
 		if (this._escapePressed) {
 			this._select(this._selectedIndexBeforeOpen);
 			this._escapePressed = false;
-		} else if (this._lastSelectedOption !== this.options[this._selectedIndex]) {
-			this._fireChangeEvent(this.options[this._selectedIndex]);
-			this._lastSelectedOption = this.options[this._selectedIndex];
+		} else if (this._lastSelectedOption !== this._filteredItems[this._selectedIndex]) {
+			this._fireChangeEvent(this._filteredItems[this._selectedIndex]);
+			this._lastSelectedOption = this._filteredItems[this._selectedIndex];
 		}
 	}
 
@@ -530,18 +654,16 @@ class Select extends UI5Element {
 		this.fireEvent("change", { selectedOption });
 
 		//  Angular two way data binding
-		this.selectedItem = selectedOption;
+		this.selectedItem = selectedOption.textContent;
 		this.fireEvent("selected-item-changed");
 	}
 
 	get valueStateTextMappings() {
-		const i18nBundle = this.i18nBundle;
-
 		return {
-			"Success": i18nBundle.getText(VALUE_STATE_SUCCESS),
-			"Information": i18nBundle.getText(VALUE_STATE_INFORMATION),
-			"Error": i18nBundle.getText(VALUE_STATE_ERROR),
-			"Warning": i18nBundle.getText(VALUE_STATE_WARNING),
+			"Success": Select.i18nBundle.getText(VALUE_STATE_SUCCESS),
+			"Information": Select.i18nBundle.getText(VALUE_STATE_INFORMATION),
+			"Error": Select.i18nBundle.getText(VALUE_STATE_ERROR),
+			"Warning": Select.i18nBundle.getText(VALUE_STATE_WARNING),
 		};
 	}
 
@@ -561,20 +683,16 @@ class Select extends UI5Element {
 		return this.disabled || undefined;
 	}
 
-	get selectRoleDescription() {
-		return this.i18nBundle.getText(SELECT_ROLE_DESCRIPTION);
-	}
-
 	get _headerTitleText() {
-		return this.i18nBundle.getText(INPUT_SUGGESTIONS_TITLE);
+		return Select.i18nBundle.getText(INPUT_SUGGESTIONS_TITLE);
 	}
 
 	get _currentSelectedItem() {
-		return this.shadowRoot.querySelector(`#${this.options[this._selectedIndex]._id}-li`);
+		return this.shadowRoot.querySelector(`#${this._filteredItems[this._selectedIndex]._id}-li`);
 	}
 
 	get _currentlySelectedOption() {
-		return this.options[this._selectedIndex];
+		return this._filteredItems[this._selectedIndex];
 	}
 
 	get tabIndex() {
@@ -583,6 +701,20 @@ class Select extends UI5Element {
 		&& this.responsivePopover.opened) ? "-1" : "0";
 	}
 
+	 /**
+	 * This method is relevant for sap_horizon theme only
+	 */
+	get _valueStateMessageInputIcon() {
+		const iconPerValueState = {
+			Error: "error",
+			Warning: "alert",
+			Success: "sys-enter-2",
+			Information: "information",
+		};
+
+		return this.valueState !== ValueState.None ? iconPerValueState[this.valueState] : "";
+	}
+
 	get classes() {
 		return {
 			popoverValueState: {
@@ -592,17 +724,20 @@ class Select extends UI5Element {
 				"ui5-valuestatemessage--warning": this.valueState === ValueState.Warning,
 				"ui5-valuestatemessage--information": this.valueState === ValueState.Information,
 			},
+			popover: {
+				"ui5-valuestatemessage-popover": this.hasValueState,
+			},
 		};
 	}
 
 	get styles() {
 		return {
 			popoverHeader: {
-				"width": `${this.offsetWidth}px`,
+				"max-width": `${this.offsetWidth}px`,
 			},
 			responsivePopoverHeader: {
-				"display": this.options.length && this._listWidth === 0 ? "none" : "inline-block",
-				"width": `${this.options.length ? this._listWidth : this.offsetWidth}px`,
+				"display": this._filteredItems.length && this._listWidth === 0 ? "none" : "inline-block",
+				"width": `${this._filteredItems.length ? this._listWidth : this.offsetWidth}px`,
 			},
 		};
 	}
@@ -632,10 +767,26 @@ class Select extends UI5Element {
 		return isPhone();
 	}
 
+	get _filteredItems() {
+		return this.options.filter(option => !option.disabled);
+	}
+
+	itemSelectionAnnounce() {
+		let text;
+		const optionsCount = this._filteredItems.length;
+		const itemPositionText = Select.i18nBundle.getText(LIST_ITEM_POSITION, this._selectedIndex + 1, optionsCount);
+
+		if (this.focused && this._currentlySelectedOption) {
+			text = `${this._currentlySelectedOption.textContent} ${this._isPickerOpen ? itemPositionText : ""}`;
+
+			announce(text, "Polite");
+		}
+	}
+
 	async openValueStatePopover() {
 		this.popover = await this._getPopover();
 		if (this.popover) {
-			this.popover.openBy(this);
+			this.popover.showAt(this);
 		}
 	}
 
@@ -651,6 +802,10 @@ class Select extends UI5Element {
 		}
 	}
 
+	get selectedOptionIcon() {
+		return this.selectedOption && this.selectedOption.icon;
+	}
+
 	async _getPopover() {
 		const staticAreaItem = await this.getStaticAreaItemDomRef();
 		return staticAreaItem.querySelector("[ui5-popover]");
@@ -668,6 +823,10 @@ class Select extends UI5Element {
 			Button,
 		];
 	}
+
+	static async onDefine() {
+		Select.i18nBundle = await getI18nBundle("@ui5/webcomponents");
+	}
 }
 
 Select.define();