@sapudex/web-components 0.117.1 → 0.127.6

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@sapudex/web-components",
-  "version": "0.117.1",
+  "version": "0.127.6",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -54,7 +54,7 @@
             },
             {
               "name": "title",
-              "description": "Defines the title of the accordion item component.",
+              "description": "Defines the title of the accordion item component.\nTODO: With transition to UI5 2.x, change \"title\" attribute name.\nTitle property is also valid HTML attribute that results in showing hover tooltip and is read by screen readers.",
               "value": { "type": "string", "default": "\"\"" }
             },
             {
@@ -89,7 +89,7 @@
               },
               {
                 "name": "title",
-                "description": "Defines the title of the accordion item component.",
+                "description": "Defines the title of the accordion item component.\nTODO: With transition to UI5 2.x, change \"title\" attribute name.\nTitle property is also valid HTML attribute that results in showing hover tooltip and is read by screen readers.",
                 "value": { "type": "string" }
               },
               {
@@ -245,6 +245,14 @@
             "events": []
           }
         },
+        {
+          "name": "udex-avatar-group",
+          "description": "<h3 class=\"comment-api-title\">Overview</h3>\n\n\n<h3>Usage</h3>\n\nFor the <code>udex-avatar-group</code>\n<h3>ES6 Module Import</h3>\n\n<code>import \"@udex/web-components/dist/AvatarGroup.js\";</code>\n---\n",
+          "doc-url": "",
+          "attributes": [],
+          "events": [],
+          "js": { "properties": [], "events": [] }
+        },
         {
           "name": "udex-badge",
           "description": "<h3 class=\"comment-api-title\">Overview</h3>\n\n\n<h3>Usage</h3>\n\nFor the <code>udex-badge</code>\n<h3>ES6 Module Import</h3>\n\n<code>import \"@udex/web-components/dist/Badge.js\";</code>\n---\n\n\n### **Slots:**\n - **default** - Defines the content of the component.",
@@ -975,9 +983,14 @@
               "description": "Allows setting a custom role.",
               "value": {
                 "type": "\"None\" | \"Dialog\" | \"AlertDialog\"",
-                "default": "\"Dialog\""
+                "default": "\"None\""
               }
             },
+            {
+              "name": "trigger-accessible-role",
+              "description": "Allows setting a custom role for dropdown trigger.",
+              "value": { "type": "string", "default": "\"combobox\"" }
+            },
             {
               "name": "open",
               "description": "Indicates if the dropdown pane is open",
@@ -1060,6 +1073,11 @@
                 "description": "Allows setting a custom role.",
                 "value": { "type": "\"None\" | \"Dialog\" | \"AlertDialog\"" }
               },
+              {
+                "name": "trigger-accessible-role",
+                "description": "Allows setting a custom role for dropdown trigger.",
+                "value": { "type": "string" }
+              },
               {
                 "name": "open",
                 "description": "Indicates if the dropdown pane is open",
@@ -1184,9 +1202,14 @@
               "description": "Allows setting a custom role.",
               "value": {
                 "type": "\"None\" | \"Dialog\" | \"AlertDialog\"",
-                "default": "\"Dialog\""
+                "default": "\"None\""
               }
             },
+            {
+              "name": "trigger-accessible-role",
+              "description": "Allows setting a custom role for dropdown trigger.",
+              "value": { "type": "string", "default": "\"combobox\"" }
+            },
             {
               "name": "no-result-text",
               "description": "Defines the \"no result\" text of the component.",
@@ -1334,6 +1357,11 @@
                 "description": "Allows setting a custom role.",
                 "value": { "type": "\"None\" | \"Dialog\" | \"AlertDialog\"" }
               },
+              {
+                "name": "trigger-accessible-role",
+                "description": "Allows setting a custom role for dropdown trigger.",
+                "value": { "type": "string" }
+              },
               {
                 "name": "no-result-text",
                 "description": "Defines the \"no result\" text of the component.",
@@ -1802,6 +1830,11 @@
           "description": "<h3 class=\"comment-api-title\">Overview</h3>\n\n\n<h3>Usage</h3>\n\nFor the <code>udex-footer</code>\n<h3>ES6 Module Import</h3>\n\n<code>import @udex/web-components/dist/Footer.js\";</code>\n---\n\n\n### **Events:**\n - **logo-click** - Triggered on click interaction with logo in footer\n- **back-to-top-click** - Triggered on click interaction with \"Back to Top\" button\n- **contact-phone-click** - Triggered on click interaction with phone number link in footer\n- **contact-phone-local-numbers-click** - Triggered on click interaction with local country numbers list link\n- **contact-email-click** - Triggered on click interaction with \"Contact us by email\" link\n- **contact-chat-click** - Triggered on click interaction with \"Contact us by chat\" link\n- **quick-links-click** - Triggered on click interaction with a link within \"Quick Links\" category\n- **trending-click** - Triggered on click interaction with a link within \"Trending\" category\n- **about-sap-click** - Triggered on click interaction with a link within \"About SAP\" category\n- **site-information-click** - Triggered on click interaction with a link within \"Site Information\" category\n- **social-media-link-click** - Triggered on click interaction with any of the social media links within footer",
           "doc-url": "",
           "attributes": [
+            {
+              "name": "logo-title",
+              "description": "Defines the Logo default title",
+              "value": { "type": "string", "default": "\"\"" }
+            },
             {
               "name": "logo-url",
               "description": "Defines the Logo URL",
@@ -1861,6 +1894,11 @@
               "name": "logo-alt",
               "description": "Alt for Logo",
               "value": { "type": "string", "default": "\"\"" }
+            },
+            {
+              "name": "logo-aria-label",
+              "description": "Defines an aria label for the logo link",
+              "value": { "type": "string" }
             }
           ],
           "events": [
@@ -1911,6 +1949,11 @@
           ],
           "js": {
             "properties": [
+              {
+                "name": "logo-title",
+                "description": "Defines the Logo default title",
+                "value": { "type": "string" }
+              },
               {
                 "name": "logo-url",
                 "description": "Defines the Logo URL",
@@ -1970,6 +2013,11 @@
                 "name": "logo-alt",
                 "description": "Alt for Logo",
                 "value": { "type": "string" }
+              },
+              {
+                "name": "logo-aria-label",
+                "description": "Defines an aria label for the logo link",
+                "value": { "type": "string" }
               }
             ],
             "events": [
@@ -3232,6 +3280,11 @@
               "description": "Defines the Logo image URL",
               "value": { "type": "string", "default": "\"\"" }
             },
+            {
+              "name": "logo-title",
+              "description": "Defines the Logo default title",
+              "value": { "type": "string", "default": "\"\"" }
+            },
             {
               "name": "site-label",
               "description": "Defines a site label. It will be displayed next to a logo.",
@@ -3313,6 +3366,11 @@
                 "description": "Defines the Logo image URL",
                 "value": { "type": "string" }
               },
+              {
+                "name": "logo-title",
+                "description": "Defines the Logo default title",
+                "value": { "type": "string" }
+              },
               {
                 "name": "site-label",
                 "description": "Defines a site label. It will be displayed next to a logo.",
@@ -3911,11 +3969,6 @@
           "description": "<h3 class=\"comment-api-title\">Overview</h3>\n\n\n<h3>Usage</h3>\n\nFor the <code>udex-password-field</code>\n<h3>ES6 Module Import</h3>\n\n<code>import \"@udex/web-components/dist/UDExPasswordField.js\";</code>\n---\n",
           "doc-url": "",
           "attributes": [
-            {
-              "name": "type",
-              "description": "Defines supporting text under the input field.",
-              "value": { "type": "string", "default": "\"\"" }
-            },
             {
               "name": "disabled",
               "description": "Defines whether the component is in disabled state.\n<br><br>\n<b>Note:</b> A disabled component is completely noninteractive.",
@@ -3944,10 +3997,7 @@
             {
               "name": "value-state",
               "description": "Defines the value state of the component.",
-              "value": {
-                "type": "\"Success\" | \"Error\" | \"Warning\" | \"Standard\"",
-                "default": "\"Standard\""
-              }
+              "value": { "type": "ValueState", "default": "\"Standard\"" }
             },
             {
               "name": "supporting-text",
@@ -3988,11 +4038,6 @@
           "events": [],
           "js": {
             "properties": [
-              {
-                "name": "type",
-                "description": "Defines supporting text under the input field.",
-                "value": { "type": "string" }
-              },
               {
                 "name": "disabled",
                 "description": "Defines whether the component is in disabled state.\n<br><br>\n<b>Note:</b> A disabled component is completely noninteractive.",
@@ -4021,9 +4066,7 @@
               {
                 "name": "value-state",
                 "description": "Defines the value state of the component.",
-                "value": {
-                  "type": "\"Success\" | \"Error\" | \"Warning\" | \"Standard\""
-                }
+                "value": { "type": "ValueState" }
               },
               {
                 "name": "supporting-text",
@@ -4321,6 +4364,49 @@
           "events": [],
           "js": { "properties": [], "events": [] }
         },
+        {
+          "name": "udex-rating-bar",
+          "description": "<h3 class=\"comment-api-title\">Overview</h3>\n\n\n<h3>Usage</h3>\n\nFor the <code>udex-rating-bar</code>\n<h3>ES6 Module Import</h3>\n\n<code>import \"@udex/web-components/dist/RatingBar.js\";</code>\n---\n",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "rating",
+              "description": "Defines the associated rating.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "percentage",
+              "description": "Defines the percentage.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "show-percentage",
+              "description": "Defines wether the percentage is shown or not.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "rating",
+                "description": "Defines the associated rating.",
+                "value": { "type": "number" }
+              },
+              {
+                "name": "percentage",
+                "description": "Defines the percentage.",
+                "value": { "type": "number" }
+              },
+              {
+                "name": "show-percentage",
+                "description": "Defines wether the percentage is shown or not.",
+                "value": { "type": "boolean" }
+              }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "udex-rating-indicator",
           "description": "### Overview\n\n### ES6 Module Import\n\n`import @udex/web-components/dist/RatingIndicator.js\";`\n---\n",
@@ -4357,6 +4443,50 @@
             "events": []
           }
         },
+        {
+          "name": "udex-review",
+          "description": "<h3 class=\"comment-api-title\">Overview</h3>\n\n\n<h3>Usage</h3>\n\nFor the <code>udex-review</code>\n<h3>ES6 Module Import</h3>\n\n<code>import \"@udex/web-components/dist/Review.js\";</code>\n---\n\n\n### **Slots:**\n - **reviewButton** - Slot for a button for writing a review.\n- **defaultText** - Slot for the default text when there are no reviews or rating.\n- **default** - Slot for rating bars.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "rating",
+              "description": "Defines the rating.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "reviews",
+              "description": "Defines the total number of reviews.",
+              "value": { "type": "number", "default": "0" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "reviewButton",
+              "description": "Slot for a button for writing a review."
+            },
+            {
+              "name": "defaultText",
+              "description": "Slot for the default text when there are no reviews or rating."
+            },
+            { "name": "default", "description": "Slot for rating bars." }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "rating",
+                "description": "Defines the rating.",
+                "value": { "type": "number" }
+              },
+              {
+                "name": "reviews",
+                "description": "Defines the total number of reviews.",
+                "value": { "type": "number" }
+              }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "udex-search",
           "description": "<h3 class=\"comment-api-title\">Overview</h3>\n\n\n<h3>Usage</h3>\n\nFor the <code>udex-search</code>\n<h3>ES6 Module Import</h3>\n\n<code>import @udex/web-components/dist/Search.js\";</code>\n---\n\n\n### **Events:**\n - **submit-search-value** - Fired event when the user submitted the value.\n- **handle-value-search** - Fired event when the user typed to search field.\n- **handle-value-reset** - Fired event when the user clicks on the reset button.\n- **handle-close-search** - Fired event when the user presses escape in search field.\n- **dropdown-item-click** - Fired event when the user clicks on the item inside the popover.\n- **prefix-item-click** - Fired event when the user clicks on the intem inside the prefix dropdown.\n\n### **Slots:**\n - **default** - Defines the prefix dropdown of the Search component.",
@@ -4427,6 +4557,31 @@
               "description": "Defines the accessible ARIA name of the component.",
               "value": { "type": "string", "default": "\"\"" }
             },
+            {
+              "name": "accessible-name-reset-icon",
+              "description": "Defines the accessible ARIA name of the reset icon.",
+              "value": { "type": "string", "default": "\"Clear\"" }
+            },
+            {
+              "name": "accessible-name-search-icon",
+              "description": "Defines the accessible ARIA name of the search icon (applied just when \"nonInteractiveSubmitButton\" is active).",
+              "value": { "type": "string", "default": "\"Search\"" }
+            },
+            {
+              "name": "tooltip-reset-button",
+              "description": "Defines the tooltip of the clear button.",
+              "value": { "type": "string", "default": "\"Clear\"" }
+            },
+            {
+              "name": "tooltip-voice-button",
+              "description": "Defines the tooltip of the voice button.",
+              "value": { "type": "string", "default": "\"Voice\"" }
+            },
+            {
+              "name": "tooltip-submit-button",
+              "description": "Defines the tooltip of the submit button.",
+              "value": { "type": "string", "default": "\"Search\"" }
+            },
             {
               "name": "no-result-text",
               "description": "Defines the text if the suggestion list doesn't return results.",
@@ -4532,6 +4687,31 @@
                 "description": "Defines the accessible ARIA name of the component.",
                 "value": { "type": "string" }
               },
+              {
+                "name": "accessible-name-reset-icon",
+                "description": "Defines the accessible ARIA name of the reset icon.",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "accessible-name-search-icon",
+                "description": "Defines the accessible ARIA name of the search icon (applied just when \"nonInteractiveSubmitButton\" is active).",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "tooltip-reset-button",
+                "description": "Defines the tooltip of the clear button.",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "tooltip-voice-button",
+                "description": "Defines the tooltip of the voice button.",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "tooltip-submit-button",
+                "description": "Defines the tooltip of the submit button.",
+                "value": { "type": "string" }
+              },
               {
                 "name": "no-result-text",
                 "description": "Defines the text if the suggestion list doesn't return results.",
@@ -4568,7 +4748,7 @@
         },
         {
           "name": "udex-secondary-navigation",
-          "description": "<h3 class=\"comment-api-title\">Overview</h3>\n\n\n<h3>Usage</h3>\n\nFor the <code>udex-secondary-navigation</code>\n<h3>ES6 Module Import</h3>\n\n<code>import \"@udex/web-components/dist/SecondaryNavigation.js\";</code>\n---\n\n\n### **Events:**\n - **item-click** - Fires when item is clicked\n- **sub-item-click** - Fires when sub item is clicked\n\n### **Slots:**\n - **breadcrumbs** - Slot for breadcrumbs.\n- **buttons** - Slot for action buttons.",
+          "description": "<h3 class=\"comment-api-title\">Overview</h3>\n\n\n<h3>Usage</h3>\n\nFor the <code>udex-secondary-navigation</code>\n<h3>ES6 Module Import</h3>\n\n<code>import \"@udex/web-components/dist/SecondaryNavigation.js\";</code>\n---\n\n\n### **Events:**\n - **item-click** - Fires when item is clicked\n\n### **Slots:**\n - **breadcrumbs** - Slot for breadcrumbs.\n- **buttons** - Slot for action buttons.",
           "doc-url": "",
           "attributes": [
             {
@@ -4600,10 +4780,6 @@
             {
               "name": "item-click",
               "description": "Fires when item is clicked"
-            },
-            {
-              "name": "sub-item-click",
-              "description": "Fires when sub item is clicked"
             }
           ],
           "js": {
@@ -4633,10 +4809,6 @@
               {
                 "name": "item-click",
                 "description": "Fires when item is clicked"
-              },
-              {
-                "name": "sub-item-click",
-                "description": "Fires when sub item is clicked"
               }
             ]
           }
@@ -4656,6 +4828,11 @@
               "description": "Defines back item.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "mobile-link-title",
+              "description": "Defines an aria label for item",
+              "value": { "type": "string" }
+            },
             {
               "name": "active",
               "description": "Defines active state for the item",
@@ -4669,7 +4846,7 @@
             {
               "name": "target",
               "description": "Defines target for the item",
-              "value": { "type": "string" }
+              "value": { "type": "Target" }
             },
             {
               "name": "sub-title",
@@ -4709,6 +4886,11 @@
                 "description": "Defines back item.",
                 "value": { "type": "boolean" }
               },
+              {
+                "name": "mobile-link-title",
+                "description": "Defines an aria label for item",
+                "value": { "type": "string" }
+              },
               {
                 "name": "active",
                 "description": "Defines active state for the item",
@@ -4722,7 +4904,7 @@
               {
                 "name": "target",
                 "description": "Defines target for the item",
-                "value": { "type": "string" }
+                "value": { "type": "Target" }
               },
               {
                 "name": "sub-title",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sapudex/web-components",
-  "version": "0.117.1",
+  "version": "0.127.6",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
@@ -30,17 +30,17 @@
   "dependencies": {
     "@types/vimeo__player": "^2.18.3",
     "@types/youtube": "^0.1.0",
-    "@ui5/webcomponents": "1.24.12",
-    "@ui5/webcomponents-base": "1.24.12",
-    "@ui5/webcomponents-fiori": "1.24.12",
-    "@ui5/webcomponents-icons": "1.24.12",
-    "@ui5/webcomponents-theming": "1.24.12",
+    "@ui5/webcomponents": "1.24.15",
+    "@ui5/webcomponents-base": "1.24.15",
+    "@ui5/webcomponents-fiori": "1.24.15",
+    "@ui5/webcomponents-icons": "1.24.15",
+    "@ui5/webcomponents-theming": "1.24.15",
     "@vimeo/player": "^2.24.0",
     "video.js": "8.19.2"
   },
   "devDependencies": {
-    "@ui5/webcomponents-tools": "1.24.12",
-    "chromedriver": "^131.0.1",
+    "@ui5/webcomponents-tools": "1.24.15",
+    "chromedriver": "132.0.2",
     "cross-env": "^7.0.3",
     "typescript": "^4.9.4",
     "wdio-chromedriver-service": "^8.1.1",

package/src/AccordionItem.hbs

@@ -2,15 +2,12 @@
     aria-expanded="{{expanded}}"
     role="listitem"
     @keydown={{keydownHandler}}>
-    <div class="udex-accordion-item__header-wrapper"
-         aria-level="2"
-         role="heading">
+    <div class="udex-accordion-item__header-wrapper">
       <div role="button"
            class="udex-accordion-item__header"
            tabindex="0"
            aria-expanded="false"
            aria-controls="udex-accordion-item__{{_id}}-content"
-           aria-labelledby="{{ariaLabelledby}}"
            @focus={{focusHandler}}
            @click={{itemClickHandler}}>
           <div class="udex-accordion-item__icon-wrapper">

package/src/AccordionItem.ts

@@ -62,6 +62,8 @@ class UDExAccordionItem extends UI5Element {
 
   /**
    * Defines the title of the accordion item component.
+   * TODO: With transition to UI5 2.x, change "title" attribute name.
+   * Title property is also valid HTML attribute that results in showing hover tooltip and is read by screen readers.
    *
    * @default ""
    * @public
@@ -167,10 +169,6 @@ class UDExAccordionItem extends UI5Element {
     return classes;
   }
 
-  get ariaLabelledby() {
-    return `${this._id}-header-title`;
-  }
-
   onAfterRendering() {
     this._el = this.shadowRoot?.querySelector(".udex-accordion-item") || null;
     const accordion = this.shadowRoot?.querySelector<HTMLElement>(
@@ -193,6 +191,9 @@ class UDExAccordionItem extends UI5Element {
     }
 
     this?.parentElement?.addEventListener("ui5-toggle-items", this.toggleAllHandler.bind(this));
+    // TODO: this should be removed with transition to UI5 2.x, wne changed "title" attribute name.
+    // Fix was provided to avoid reading "title" property by screen readers, which results reading title twice.
+    this.setAttribute("aria-hidden", "true");
   }
 }
 

package/src/Avatar.ts

@@ -200,6 +200,26 @@ class UDExAvatar extends UI5Element {
     }
   }
 
+  /**
+   * Returns the effective avatar size.
+   * @default "S"
+   * @private
+   */
+  get effectiveSize(): AvatarSize {
+    // we read the attribute, because the "size" property will always have a default value
+    return this.getAttribute("size") as AvatarSize || this.size;
+  }
+
+  /**
+   * Returns the effective background color.
+   * @default "Blue"
+   * @private
+   */
+  get еffectiveBackgroundColor(): AvatarColorScheme {
+    // we read the attribute, because the "background-color" property will always have a default value
+    return this.getAttribute("color-scheme") as AvatarColorScheme || this.colorScheme;
+  }
+
   get getUI5AvatarColorScheme(): string {
     return udexToUi5ColorSchemeMap[this.colorScheme];
   }
@@ -223,7 +243,10 @@ class UDExAvatar extends UI5Element {
   }
 
   get avatarAccessibleName(): string {
-    return `${this.accessibleName ? this.accessibleName : UDExAvatar.i18nBundle.getText(AVATAR_TEXT)} ${this.disabled ? UDExAvatar.i18nBundle.getText(DISABLED) : ""} ${this.showAttentionBadge ? UDExAvatar.i18nBundle.getText(ATTENTION_BADGE) : ""}`;
+    let accName = `${this.accessibleName ? this.accessibleName : `${UDExAvatar.i18nBundle.getText(AVATAR_TEXT)} ${this.initials}`}`;
+    accName += ` ${this.disabled ? UDExAvatar.i18nBundle.getText(DISABLED) : ""}`;
+    accName += ` ${this.showAttentionBadge ? UDExAvatar.i18nBundle.getText(ATTENTION_BADGE) : ""}`;
+    return accName;
   }
 }