docs: more detailed explanation of opener attribute (#8953)

SAP · May 14, 2024 · 11f5cd6 · 11f5cd6
1 parent cf9f1c2
commit 11f5cd6
Show file tree

Hide file tree

Showing 5 changed files with 12 additions and 2 deletions.
diff --git a/packages/main/src/ColorPalettePopover.ts b/packages/main/src/ColorPalettePopover.ts
@@ -134,6 +134,8 @@ class ColorPalettePopover extends UI5Element {
 
 	/**
 	 * Defines the ID or DOM Reference of the element that the popover is shown at.
+	 * When using this attribute in a declarative way, you must only use the `id` (as a string) of the element at which you want to show the popover.
+	 * You can only set the `opener` attribute to a DOM Reference when using JavaScript.
 	 * @public
 	 * @default undefined
 	 * @since 1.21.0

diff --git a/packages/main/src/Menu.ts b/packages/main/src/Menu.ts
@@ -253,7 +253,9 @@ class Menu extends UI5Element {
 	loadingDelay!: number;
 
 	/**
-	 * Defines the ID or DOM Reference of the element that the menu is shown at
+	 * Defines the ID or DOM Reference of the element at which the menu is shown.
+	 * When using this attribute in a declarative way, you must only use the `id` (as a string) of the element at which you want to show the popover.
+	 * You can only set the `opener` attribute to a DOM Reference when using JavaScript.
 	 * @public
 	 * @default ""
 	 * @since 1.10.0

diff --git a/packages/main/src/Popover.ts b/packages/main/src/Popover.ts
@@ -222,7 +222,9 @@ class Popover extends Popup {
 	}
 
 	/**
-	 * Defines the ID or DOM Reference of the element that the popover is shown at
+	 * Defines the ID or DOM Reference of the element at which the popover is shown.
+	 * When using this attribute in a declarative way, you must only use the `id` (as a string) of the element at which you want to show the popover.
+	 * You can only set the `opener` attribute to a DOM Reference when using JavaScript.
 	 * @public
 	 * @default undefined
 	 * @since 1.2.0

diff --git a/packages/main/src/Select.ts b/packages/main/src/Select.ts
@@ -207,6 +207,8 @@ class Select extends UI5Element implements IFormInputElement {
 	/**
 	 * Defines a reference (ID or DOM element) of component's menu of options
 	 * as alternative to define the select's dropdown.
+	 * When using this attribute in a declarative way, you must only use the `id` (as a string) of the element at which you want to show the menu.
+	 * You can only set the `opener` attribute to a DOM Reference when using JavaScript.
 	 *
 	 * **Note:** Usage of `ui5-select-menu` is recommended.
 	 * @default undefined

diff --git a/packages/main/src/Tokenizer.ts b/packages/main/src/Tokenizer.ts
@@ -257,6 +257,8 @@ class Tokenizer extends UI5Element {
 
 	/**
 	 * Defines the ID or DOM Reference of the element that the menu is shown at
+	 * When using this attribute in a declarative way, you must only use the `id` (as a string) of the element at which you want to show the tokenizer.
+	 * You can only set the `opener` attribute to a DOM Reference when using JavaScript.
 	 * **Note:** Used inside MultiInput and MultiComboBox components.
 	 * @private
 	 * @default ""