@ui5/webcomponents 2.5.0-rc.2 → 2.5.0

package/dist/custom-elements-internal.json

@@ -1296,48 +1296,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "dist/types/ColorPickerDisplayMode.js",
-      "declarations": [
-        {
-          "kind": "enum",
-          "name": "ColorPickerDisplayMode",
-          "description": "ColorPicker display modes.",
-          "_ui5privacy": "public",
-          "members": [
-            {
-              "kind": "field",
-              "static": true,
-              "privacy": "public",
-              "description": "Default display mode. Includes all color picker features.",
-              "default": "Default",
-              "name": "Default",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "static": true,
-              "privacy": "public",
-              "description": "Simplified display mode. Doesn't include alpha slider and inputs for RGB values.",
-              "default": "Simplified",
-              "name": "Simplified",
-              "readonly": true
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "ColorPickerDisplayMode",
-            "module": "dist/types/ColorPickerDisplayMode.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "dist/types/ComboBoxFilter.js",
@@ -4214,6 +4172,18 @@
             {
               "description": "Used to style the wrapper of the content of the component",
               "name": "bar"
+            },
+            {
+              "description": "Used to style the wrapper of the start content of the component",
+              "name": "startContent"
+            },
+            {
+              "description": "Used to style the wrapper of the middle content of the component",
+              "name": "midContent"
+            },
+            {
+              "description": "Used to style the wrapper of the end content of the component",
+              "name": "endContent"
             }
           ],
           "slots": [
@@ -4891,6 +4861,17 @@
               "privacy": "public",
               "_ui5since": "1.2.0"
             },
+            {
+              "kind": "field",
+              "name": "accessibleDescription",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Defines the accessible description of the component.",
+              "default": "undefined",
+              "privacy": "public",
+              "_ui5since": "2.5.0"
+            },
             {
               "kind": "field",
               "name": "type",
@@ -5024,6 +5005,15 @@
                 "text": "ButtonAccessibilityAttributes"
               }
             },
+            {
+              "description": "Defines the accessible description of the component.",
+              "name": "accessible-description",
+              "default": "undefined",
+              "fieldName": "accessibleDescription",
+              "type": {
+                "text": "string | undefined"
+              }
+            },
             {
               "description": "Defines whether the button has special form-related functionality.\n\n**Note:** This property is only applicable within the context of an HTML Form element.",
               "name": "type",
@@ -7541,19 +7531,12 @@
             },
             {
               "kind": "field",
-              "name": "displayMode",
+              "name": "simplified",
               "type": {
-                "text": "ColorPickerDisplayMode",
-                "references": [
-                  {
-                    "name": "ColorPickerDisplayMode",
-                    "package": "@ui5/webcomponents",
-                    "module": "dist/types/ColorPickerDisplayMode.js"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "\"Default\"",
-              "description": "Defines the display mode of the component.",
+              "default": "false",
+              "description": "When set to `true`, the alpha slider and inputs for RGB values will not be displayed.",
               "privacy": "public",
               "_ui5since": "2.5.0"
             }
@@ -7591,12 +7574,12 @@
               }
             },
             {
-              "description": "Defines the display mode of the component.",
-              "name": "display-mode",
-              "default": "\"Default\"",
-              "fieldName": "displayMode",
+              "description": "When set to `true`, the alpha slider and inputs for RGB values will not be displayed.",
+              "name": "simplified",
+              "default": "false",
+              "fieldName": "simplified",
               "type": {
-                "text": "\"Default\" | \"Simplified\""
+                "text": "boolean"
               }
             }
           ],
@@ -12137,7 +12120,7 @@
         },
         {
           "kind": "class",
-          "description": "### Overview\n\nThe `ui5-icon` component represents an SVG icon.\nThere are two main scenarios how the `ui5-icon` component is used:\nas a purely decorative element,\nor as an interactive element that can be focused and clicked.\n\n### Usage\n\n1. **Get familiar with the icons collections.**\n\nBefore displaying an icon, you need to explore the icons collections to find and import the desired icon.\n\nCurrently there are 3 icons collection, available as 3 npm packages:\n\n- [@ui5/webcomponents-icons](https://www.npmjs.com/package/@ui5/webcomponents-icons) represents the \"SAP-icons\" collection and includes the following\n[icons](https://sdk.openui5.org/test-resources/sap/m/demokit/iconExplorer/webapp/index.html#/overview/SAP-icons).\n- [@ui5/webcomponents-icons-tnt](https://www.npmjs.com/package/@ui5/webcomponents-icons-tnt) represents the \"tnt\" collection and includes the following\n[icons](https://sdk.openui5.org/test-resources/sap/m/demokit/iconExplorer/webapp/index.html#/overview/SAP-icons-TNT).\n- [@ui5/webcomponents-icons-icons-business-suite](https://www.npmjs.com/package/@ui5/webcomponents-icons-business-suite) represents the \"business-suite\" collection and includes the following\n[icons](https://ui5.sap.com/test-resources/sap/m/demokit/iconExplorer/webapp/index.html#/overview/BusinessSuiteInAppSymbols).\n\n2. **After exploring the icons collections, add one or more of the packages as dependencies to your project.**\n\n`npm i @ui5/webcomponents-icons`\n`npm i @ui5/webcomponents-icons-tnt`\n`npm i @ui5/webcomponents-icons-business-suite`\n\n3. **Then, import the desired icon**.\n\n`import \"@ui5/\\{package_name\\}/dist/\\{icon_name\\}.js\";`\n\n**For Example**:\n\nFor the standard \"SAP-icons\" icon collection, import an icon from the `@ui5/webcomponents-icons` package:\n\n`import \"@ui5/webcomponents-icons/dist/employee.js\";`\n\nFor the \"tnt\" (SAP Fiori Tools) icon collection, import an icon from the `@ui5/webcomponents-icons-tnt` package:\n\n`import \"@ui5/webcomponents-icons-tnt/dist/antenna.js\";`\n\nFor the \"business-suite\" (SAP Business Suite) icon collection, import an icon from the `@ui5/webcomponents-icons-business-suite` package:\n\n`import \"@ui5/webcomponents-icons-business-suite/dist/ab-testing.js\";`\n\n4. **Display the icon using the `ui5-icon` web component.**\nSet the icon collection (\"SAP-icons\", \"tnt\" or \"business-suite\" - \"SAP-icons\" is the default icon collection and can be skipped)\nand the icon name to the `name` property.\n\n`<ui5-icon name=\"employee\"></ui5-icon>`\n`<ui5-icon name=\"tnt/antenna\"></ui5-icon>`\n`<ui5-icon name=\"business-suite/ab-testing\"></ui5-icon>`\n\n### Keyboard Handling\n\n- [Space] / [Enter] or [Return] - Fires the `click` event if the `mode` property is set to `Interactive`.\n- [Shift] - If [Space] / [Enter] or [Return] is pressed, pressing [Shift] releases the ui5-icon without triggering the click event.\n\n### ES6 Module Import\n\n`import \"@ui5/webcomponents/dist/Icon.js\";`",
+          "description": "### Overview\n\nThe `ui5-icon` component represents an SVG icon.\nThere are two main scenarios how the `ui5-icon` component is used:\nas a purely decorative element,\nor as an interactive element that can be focused and clicked.\n\n### Usage\n\n1. **Get familiar with the icons collections.**\n\nBefore displaying an icon, you need to explore the icons collections to find and import the desired icon.\n\nCurrently there are 3 icons collection, available as 3 npm packages:\n\n- [@ui5/webcomponents-icons](https://www.npmjs.com/package/@ui5/webcomponents-icons) represents the \"SAP-icons\" collection and includes the following\n[icons](https://sdk.openui5.org/test-resources/sap/m/demokit/iconExplorer/webapp/index.html#/overview/SAP-icons).\n- [@ui5/webcomponents-icons-tnt](https://www.npmjs.com/package/@ui5/webcomponents-icons-tnt) represents the \"tnt\" collection and includes the following\n[icons](https://sdk.openui5.org/test-resources/sap/m/demokit/iconExplorer/webapp/index.html#/overview/SAP-icons-TNT).\n- [@ui5/webcomponents-icons-business-suite](https://www.npmjs.com/package/@ui5/webcomponents-icons-business-suite) represents the \"business-suite\" collection and includes the following\n[icons](https://ui5.sap.com/test-resources/sap/m/demokit/iconExplorer/webapp/index.html#/overview/BusinessSuiteInAppSymbols).\n\n2. **After exploring the icons collections, add one or more of the packages as dependencies to your project.**\n\n`npm i @ui5/webcomponents-icons`\n`npm i @ui5/webcomponents-icons-tnt`\n`npm i @ui5/webcomponents-icons-business-suite`\n\n3. **Then, import the desired icon**.\n\n`import \"@ui5/\\{package_name\\}/dist/\\{icon_name\\}.js\";`\n\n**For Example**:\n\nFor the standard \"SAP-icons\" icon collection, import an icon from the `@ui5/webcomponents-icons` package:\n\n`import \"@ui5/webcomponents-icons/dist/employee.js\";`\n\nFor the \"tnt\" (SAP Fiori Tools) icon collection, import an icon from the `@ui5/webcomponents-icons-tnt` package:\n\n`import \"@ui5/webcomponents-icons-tnt/dist/antenna.js\";`\n\nFor the \"business-suite\" (SAP Business Suite) icon collection, import an icon from the `@ui5/webcomponents-icons-business-suite` package:\n\n`import \"@ui5/webcomponents-icons-business-suite/dist/ab-testing.js\";`\n\n4. **Display the icon using the `ui5-icon` web component.**\nSet the icon collection (\"SAP-icons\", \"tnt\" or \"business-suite\" - \"SAP-icons\" is the default icon collection and can be skipped)\nand the icon name to the `name` property.\n\n`<ui5-icon name=\"employee\"></ui5-icon>`\n`<ui5-icon name=\"tnt/antenna\"></ui5-icon>`\n`<ui5-icon name=\"business-suite/ab-testing\"></ui5-icon>`\n\n### Keyboard Handling\n\n- [Space] / [Enter] or [Return] - Fires the `click` event if the `mode` property is set to `Interactive`.\n- [Shift] - If [Space] / [Enter] or [Return] is pressed, pressing [Shift] releases the ui5-icon without triggering the click event.\n\n### ES6 Module Import\n\n`import \"@ui5/webcomponents/dist/Icon.js\";`",
           "name": "Icon",
           "cssParts": [
             {
@@ -13092,6 +13075,17 @@
               "privacy": "public",
               "_ui5since": "1.1.0"
             },
+            {
+              "kind": "field",
+              "name": "accessibleDescription",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Defines the accessible description of the component.",
+              "default": "undefined",
+              "privacy": "public",
+              "_ui5since": "2.5.0"
+            },
             {
               "kind": "field",
               "name": "icon",
@@ -13260,6 +13254,15 @@
                 "text": "LinkAccessibilityAttributes"
               }
             },
+            {
+              "description": "Defines the accessible description of the component.",
+              "name": "accessible-description",
+              "default": "undefined",
+              "fieldName": "accessibleDescription",
+              "type": {
+                "text": "string | undefined"
+              }
+            },
             {
               "description": "Defines the icon, displayed as graphical element within the component before the link's text.\nThe SAP-icons font provides numerous options.\n\n**Note:** Usage of icon-only link is not supported, the link must always have a text.\n\n**Note:** We recommend using аn icon in the beginning or the end only, and with text.\n\nSee all the available icons within the [Icon Explorer](https://sdk.openui5.org/test-resources/sap/m/demokit/iconExplorer/webapp/index.html).",
               "name": "icon",
@@ -15342,8 +15345,7 @@
                   },
                   "name": "item",
                   "_ui5privacy": "public",
-                  "description": "The `ui5-menu-item` that triggers opening of the sub-menu or undefined when fired upon root menu opening.",
-                  "_ui5since": "1.14.0"
+                  "description": "The `ui5-menu-item` that triggers opening of the sub-menu or undefined when fired upon root menu opening."
                 }
               ]
             },
@@ -20761,8 +20763,7 @@
                   },
                   "name": "selectedItems",
                   "_ui5privacy": "public",
-                  "description": "an array of selected items.",
-                  "_ui5since": "1.14.0"
+                  "description": "an array of selected items. Since: 1.14.0"
                 }
               ]
             }
@@ -24421,16 +24422,6 @@
               "description": "Defines the text that will be displayed below the `growingText` inside the growing button.\nHas no effect when type is set to Scroll.",
               "default": "undefined",
               "privacy": "public"
-            },
-            {
-              "kind": "field",
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Disables the growing feature.",
-              "privacy": "public"
             }
           ],
           "events": [
@@ -24473,15 +24464,6 @@
               "type": {
                 "text": "string | undefined"
               }
-            },
-            {
-              "description": "Disables the growing feature.",
-              "name": "disabled",
-              "default": "false",
-              "fieldName": "disabled",
-              "type": {
-                "text": "boolean"
-              }
             }
           ],
           "superclass": {
@@ -24800,6 +24782,16 @@
               "description": "Unique identifier of the row.",
               "privacy": "public"
             },
+            {
+              "kind": "field",
+              "name": "position",
+              "type": {
+                "text": "number"
+              },
+              "default": "-1",
+              "description": "Defines the position of the row respect to the total number of rows within the table when the <code>ui5-table-virtualizer</code> feature is used.",
+              "privacy": "public"
+            },
             {
               "kind": "field",
               "name": "interactive",
@@ -24831,6 +24823,15 @@
                 "text": "string"
               }
             },
+            {
+              "description": "Defines the position of the row respect to the total number of rows within the table when the <code>ui5-table-virtualizer</code> feature is used.",
+              "name": "position",
+              "default": "-1",
+              "fieldName": "position",
+              "type": {
+                "text": "number"
+              }
+            },
             {
               "description": "Defines the interactive state of the row.",
               "name": "interactive",
@@ -25018,6 +25019,154 @@
       "declarations": [],
       "exports": []
     },
+    {
+      "kind": "javascript-module",
+      "path": "dist/TableVirtualizer.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "### Overview\n\nThe `ui5-table-virtualizer` component is used inside the `ui5-table` to virtualize the table rows, if the `overflowMode` property of the table is set to 'Scroll'.\nIt is responsible for rendering only the rows that are visible in the viewport and updating them on scroll.\nThis allows large numbers of rows to exist, but maintain high performance by only paying the cost for those that are currently visible.\n\n**Note:** The maximum number of virtualized rows is limited by browser constraints, specifically the maximum supported height for a DOM element.\n\n### ES6 Module Import\n`import \"@ui5/webcomponents/dist/TableVirtualizer.js\";`",
+          "name": "TableVirtualizer",
+          "members": [
+            {
+              "kind": "field",
+              "name": "rowHeight",
+              "type": {
+                "text": "number"
+              },
+              "default": "45",
+              "description": "Defines the height of the rows in the table.\n\n**Note:** This property is mandatory for the virtualization to work properly.",
+              "privacy": "public"
+            },
+            {
+              "kind": "field",
+              "name": "rowCount",
+              "type": {
+                "text": "number"
+              },
+              "default": "100",
+              "description": "Defines the total count of rows in the table.\n\n**Note:** This property is mandatory for the virtualization to work properly.",
+              "privacy": "public"
+            },
+            {
+              "kind": "field",
+              "name": "extraRows",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Defines the count of extra rows to be rendered at the top and bottom of the table.\n\n**Note:** This property is experimental and may be changed or deleted in the future.",
+              "privacy": "public"
+            },
+            {
+              "kind": "method",
+              "name": "reset",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Resets the virtualizer to its initial state and triggers the `range-change` event.",
+              "privacy": "public"
+            }
+          ],
+          "events": [
+            {
+              "name": "range-change",
+              "_ui5privacy": "public",
+              "type": {
+                "text": "CustomEvent<RangeChangeEventDetail>",
+                "references": [
+                  {
+                    "name": "RangeChangeEventDetail",
+                    "package": "@ui5/webcomponents",
+                    "module": "dist/TableVirtualizer.js"
+                  }
+                ]
+              },
+              "description": "Fired when the virtualizer is changed by user interaction e.g. on scrolling.",
+              "_ui5Cancelable": false,
+              "_ui5allowPreventDefault": false,
+              "_ui5Bubbles": false,
+              "_ui5parameters": [
+                {
+                  "type": {
+                    "text": "number"
+                  },
+                  "name": "first",
+                  "_ui5privacy": "public",
+                  "description": "The 0-based index of the first children currently rendered"
+                },
+                {
+                  "type": {
+                    "text": "number"
+                  },
+                  "name": "last",
+                  "_ui5privacy": "public",
+                  "description": "The 0-based index of the last children currently rendered"
+                }
+              ]
+            }
+          ],
+          "attributes": [
+            {
+              "description": "Defines the height of the rows in the table.\n\n**Note:** This property is mandatory for the virtualization to work properly.",
+              "name": "row-height",
+              "default": "45",
+              "fieldName": "rowHeight",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "description": "Defines the total count of rows in the table.\n\n**Note:** This property is mandatory for the virtualization to work properly.",
+              "name": "row-count",
+              "default": "100",
+              "fieldName": "rowCount",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "description": "Defines the count of extra rows to be rendered at the top and bottom of the table.\n\n**Note:** This property is experimental and may be changed or deleted in the future.",
+              "name": "extra-rows",
+              "default": "0",
+              "fieldName": "extraRows",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "superclass": {
+            "name": "UI5Element",
+            "package": "@ui5/webcomponents-base",
+            "module": "dist/UI5Element.js"
+          },
+          "tagName": "ui5-table-virtualizer",
+          "customElement": true,
+          "_ui5experimental": "This component is not intended to be used in a productive enviroment. The API is under development and may be changed in the future.",
+          "_ui5privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "TableVirtualizer",
+            "module": "dist/TableVirtualizer.js"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "ui5-table-virtualizer",
+          "declaration": {
+            "name": "TableVirtualizer",
+            "module": "dist/TableVirtualizer.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "dist/Tag.js",
@@ -26646,6 +26795,21 @@
                 "module": "dist/Button.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "accessibleDescription",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Defines the accessible description of the component.",
+              "default": "undefined",
+              "privacy": "public",
+              "_ui5since": "2.5.0",
+              "inheritedFrom": {
+                "name": "Button",
+                "module": "dist/Button.js"
+              }
+            },
             {
               "kind": "field",
               "name": "type",
@@ -26819,6 +26983,19 @@
                 "module": "dist/Button.js"
               }
             },
+            {
+              "description": "Defines the accessible description of the component.",
+              "name": "accessible-description",
+              "default": "undefined",
+              "fieldName": "accessibleDescription",
+              "type": {
+                "text": "string | undefined"
+              },
+              "inheritedFrom": {
+                "name": "Button",
+                "module": "dist/Button.js"
+              }
+            },
             {
               "description": "Defines whether the button has special form-related functionality.\n\n**Note:** This property is only applicable within the context of an HTML Form element.",
               "name": "type",
@@ -27127,7 +27304,24 @@
               "description": "Fired when token selection is changed by user interaction",
               "_ui5Cancelable": false,
               "_ui5allowPreventDefault": false,
-              "_ui5Bubbles": true
+              "_ui5Bubbles": true,
+              "_ui5parameters": [
+                {
+                  "type": {
+                    "text": "Array<Token>",
+                    "references": [
+                      {
+                        "name": "Token",
+                        "package": "@ui5/webcomponents",
+                        "module": "dist/Token.js"
+                      }
+                    ]
+                  },
+                  "name": "tokens",
+                  "_ui5privacy": "public",
+                  "description": "An array of the selected items."
+                }
+              ]
             }
           ],
           "attributes": [
@@ -27546,9 +27740,9 @@
                 "text": "CustomEvent"
               },
               "description": "Fired when the component is activated either with a\nmouse/tap or by using the Enter or Space key.\n\n**Note:** The event will not be fired if the `disabled`\nproperty is set to `true`.",
-              "_ui5Cancelable": false,
-              "_ui5allowPreventDefault": false,
-              "_ui5Bubbles": false
+              "_ui5Cancelable": true,
+              "_ui5allowPreventDefault": true,
+              "_ui5Bubbles": true
             }
           ],
           "attributes": [