feat(ui5-side-navigation): add indication tag slot

packages/fiori/src/NavigationMenuItem.ts

@@ -101,13 +101,28 @@ class NavigationMenuItem extends MenuItem {
 		return (!this.disabled && this.href) ? this.href : undefined;
 	}
 
+	get _tagContainerId() {
+		return `${this._id}-tag-container`;
+	}
+
+	get _ariaDescribedByIds() {
+		const ids = [
+			`${this._id}-invisibleText-describedby`,
+		];
+
+		if (this.hasEndContent) {
+			ids.push(this._tagContainerId);
+		}
+
+		return ids.filter(Boolean).join(" ");
+	}
+
 	get _accInfo() {
 		const accInfo = super._accInfo;
 
 		accInfo.role = "none";
 
 		if (this.hasSubmenu && this.associatedItem?.isSelectable) {
-			// For the menu item on first level (parent item)
 			accInfo.ariaSelectedText = NavigationMenuItem.i18nBundleFiori.getText(NAVIGATION_MENU_SELECTABLE_ITEM_HIDDEN_TEXT);
 		}
 

packages/fiori/src/NavigationMenuItemTemplate.tsx

@@ -47,18 +47,24 @@ function iconBegin(this: NavigationMenuItem) {
 }
 
 function iconEnd(this: NavigationMenuItem) {
-	if (this.hasSubmenu) {
-		return <Icon
-			part="icon"
-			name={slimArrowRightIcon}
-			class="ui5-menu-item-icon-end"
-		/>;
-	}
-
-	if (this.isExternalLink) {
-		return <Icon
-			class="ui5-sn-item-external-link-icon"
-			name={arrowRightIcon}
-		/>;
-	}
+	return (<>
+		{this.hasEndContent &&
+			<span id={this._tagContainerId} class="ui5-navmenu-item-tag-container">
+				<slot name="endContent"></slot>
+			</span>
+		}
+		{this.hasSubmenu &&
+			<Icon
+				part="icon"
+				name={slimArrowRightIcon}
+				class="ui5-menu-item-icon-end"
+			/>
+		}
+		{!this.hasSubmenu && this.isExternalLink &&
+			<Icon
+				class="ui5-sn-item-external-link-icon"
+				name={arrowRightIcon}
+			/>
+		}
+	</>);
 }

packages/fiori/src/SideNavigationItem.ts

@@ -20,7 +20,8 @@ import {
 	SIDE_NAVIGATION_OVERFLOW_ITEM_LABEL,
 	SIDE_NAVIGATION_PARENT_ITEM_SELECTABLE_DESCRIPTION,
 } from "./generated/i18n/i18n-defaults.js";
-import type { DefaultSlot } from "@ui5/webcomponents-base/dist/UI5Element.js";
+import type { DefaultSlot, Slot } from "@ui5/webcomponents-base/dist/UI5Element.js";
+import "@ui5/webcomponents/dist/Tag.js";
 
 // Templates
 import SideNavigationItemTemplate from "./SideNavigationItemTemplate.js";
@@ -81,6 +82,21 @@ class SideNavigationItem extends SideNavigationSelectableItemBase {
 	@slot({ type: HTMLElement, invalidateOnChildChange: true, "default": true })
 	items!: DefaultSlot<SideNavigationSubItem>;
 
+	/**
+	 * Defines the tag to be displayed.
+	 *
+	 * **Note:** Only one `ui5-tag` is allowed. The tag should use `design="Set2"`, `hide-state-icon`,
+	 * and `colorScheme` values 5-10 to avoid confusion with semantic colors (1-4).
+	 *
+	 * **Note:** It is recommended to limit tag width to 64px (4rem). If tag text exceeds this,
+	 * use shortened forms or abbreviations (e.g., "Experimental" → "Exp").
+	 *
+	 * @public
+	 * @since 2.7.0
+	 */
+	@slot({ type: HTMLElement })
+	tag!: Slot<HTMLElement>;
+
 	@i18n("@ui5/webcomponents-fiori")
 	static i18nBundle: I18nBundle;
 
@@ -183,9 +199,43 @@ class SideNavigationItem extends SideNavigationSelectableItemBase {
 	}
 
 	get _describedBy() {
+		const parts: string[] = [];
+
+		if (this.hasTag) {
+			parts.push(this._tagId);
+		}
+
+		if (!this.effectiveDisabled && this.items.length && !this.unselectable) {
+			parts.push(this._selectableItemDescriptionId);
+		}
+
+		return parts.length > 0 ? parts.join(" ") : undefined;
+	}
+
+	get _selectableItemDescriptionId() {
+		return `${this._id}-selectable-description`;
+	}
+
+	get _selectableItemDescriptionText() {
 		if (!this.effectiveDisabled && this.items.length && !this.unselectable) {
 			return SideNavigationItem.i18nBundle.getText(SIDE_NAVIGATION_PARENT_ITEM_SELECTABLE_DESCRIPTION, this.text ?? "");
 		}
+		return undefined;
+	}
+
+	get hasTag() {
+		return !!this.tag.length;
+	}
+
+	get _textId() {
+		return `${this._id}-text`;
+	}
+
+	get _textAriaLabelledBy() {
+		if (this.hasTag) {
+			return `${this._textId} ${this._tagId}`;
+		}
+		return undefined;
 	}
 
 	get classesArray() {

packages/fiori/src/SideNavigationItemTemplate.tsx

@@ -51,7 +51,12 @@ function ItemTemplate(this: SideNavigationItem) {
 					:
 					this.icon && <Icon class="ui5-sn-item-icon" name={this.icon}/>
 				}
-				<div class="ui5-sn-item-text">{this.text}</div>
+				<div class="ui5-sn-item-text" id={this._textId} aria-labelledby={this._textAriaLabelledBy}>{this.text}</div>
+				{this.hasTag &&
+					<div id={this._tagId} class="ui5-sn-item-tag-slot">
+						<slot name="tag"></slot>
+					</div>
+				}
 				{this.sideNavCollapsed ?
 					!!this.items.length &&
 					<Icon class="ui5-sn-item-toggle-icon"
@@ -81,6 +86,9 @@ function ItemTemplate(this: SideNavigationItem) {
 					<slot></slot>
 				</ul>
 			}
+			{this._selectableItemDescriptionText &&
+				<span id={this._selectableItemDescriptionId} class="ui5-hidden-text">{this._selectableItemDescriptionText}</span>
+			}
 		</>
 	);
 }

packages/fiori/src/SideNavigationPopoverTemplate.tsx

@@ -17,10 +17,21 @@ export default function SideNavigationTemplate(this: SideNavigation) {
 			target={item.target}
 			title={item.title}
 			tooltip={item._tooltip}
-			ref={this.captureRef.bind(item)}
+			ref={(el: HTMLElement | null) => {
+				if (el && item.tag.length > 0) {
+					const existingTags = Array.from(el.children).filter(child => child.getAttribute("slot") === "endContent");
+					if (existingTags.length === 0) {
+						item.tag.forEach(tagEl => {
+							const clonedTag = tagEl.cloneNode(true) as HTMLElement;
+							clonedTag.slot = "endContent";
+							el.appendChild(clonedTag);
+						});
+					}
+				}
+				this.captureRef.bind(item)(el);
+			}}
 		>
-
-			{item.children.length > 0 && !item.unselectable &&
+			{(item as SideNavigationItem).items?.length > 0 && !item.unselectable &&
 				(<NavigationMenuItem
 					class="ui5-navigation-menu-item-root-parent"
 					accessibilityAttributes={item.accessibilityAttributes}
@@ -31,8 +42,21 @@ export default function SideNavigationTemplate(this: SideNavigation) {
 					target={item.target}
 					title={item.title}
 					tooltip={item._tooltip}
-					ref={this.captureRef.bind(item)}
-				></NavigationMenuItem>)
+					ref={(el: HTMLElement | null) => {
+						if (el && item.tag.length > 0) {
+							const existingTags = Array.from(el.children).filter(child => child.getAttribute("slot") === "endContent");
+							if (existingTags.length === 0) {
+								item.tag.forEach(tagEl => {
+									const clonedTag = tagEl.cloneNode(true) as HTMLElement;
+									clonedTag.slot = "endContent";
+									el.appendChild(clonedTag);
+								});
+							}
+						}
+						this.captureRef.bind(item)(el);
+					}}
+				>
+				</NavigationMenuItem>)
 			}
 
 			{(item as any).items?.map(renderMenuItem)}
@@ -79,7 +103,19 @@ export default function SideNavigationTemplate(this: SideNavigation) {
 						selected={this._popoverContents.item.selected}
 						unselectable={this._popoverContents.item.unselectable}
 						onui5-click={this.handlePopupItemClick}
-						ref={this.captureRef.bind(this._popoverContents.item)}
+						ref={(el: HTMLElement | null) => {
+							if (el && this._popoverContents.item.tag.length > 0) {
+								const existingTags = Array.from(el.children).filter(child => child.getAttribute("slot") === "tag");
+								if (existingTags.length === 0) {
+									this._popoverContents.item.tag.forEach(tagEl => {
+										const clonedTag = tagEl.cloneNode(true) as HTMLElement;
+										clonedTag.slot = "tag";
+										el.appendChild(clonedTag);
+									});
+								}
+							}
+							this.captureRef.bind(this._popoverContents.item)(el as SideNavigationItem | null);
+						}}
 					>
 						{this._popoverContents.subItems.map(item =>
 							<SideNavigationSubItem
@@ -93,8 +129,21 @@ export default function SideNavigationTemplate(this: SideNavigation) {
 								selected={item.selected}
 								unselectable={item.unselectable}
 								onui5-click={this.handlePopupItemClick}
-								ref={this.captureRef.bind(item)}
-							/>
+								ref={(el: HTMLElement | null) => {
+									if (el && item.tag.length > 0) {
+										const existingTags = Array.from(el.children).filter(child => child.getAttribute("slot") === "tag");
+										if (existingTags.length === 0) {
+											item.tag.forEach(tagEl => {
+												const clonedTag = tagEl.cloneNode(true) as HTMLElement;
+												clonedTag.slot = "tag";
+												el.appendChild(clonedTag);
+											});
+										}
+									}
+									this.captureRef.bind(item)(el as SideNavigationSubItem | null);
+								}}
+							>
+							</SideNavigationSubItem>
 						)}
 					</SideNavigationItem>
 				</SideNavigation>

packages/fiori/src/SideNavigationSelectableItemBase.ts

@@ -254,6 +254,10 @@ class SideNavigationSelectableItemBase extends SideNavigationItemBase {
 		return this.selected;
 	}
 
+	get _tagId() {
+		return `${this._id}-tag`;
+	}
+
 	_onkeydown(e: KeyboardEvent) {
 		const isRTL = this.effectiveDir === "rtl";
 

packages/fiori/src/SideNavigationSubItem.ts

@@ -1,7 +1,10 @@
 import customElement from "@ui5/webcomponents-base/dist/decorators/customElement.js";
 import jsxRender from "@ui5/webcomponents-base/dist/renderer/JsxRenderer.js";
+import slot from "@ui5/webcomponents-base/dist/decorators/slot-strict.js";
+import type { Slot } from "@ui5/webcomponents-base/dist/UI5Element.js";
 import SideNavigationSelectableItemBase from "./SideNavigationSelectableItemBase.js";
 import SideNavigationSubItemTemplate from "./SideNavigationSubItemTemplate.js";
+import "@ui5/webcomponents/dist/Tag.js";
 
 // Styles
 import SideNavigationSubItemCss from "./generated/themes/SideNavigationSubItem.css.js";
@@ -30,6 +33,40 @@ import SideNavigationSubItemCss from "./generated/themes/SideNavigationSubItem.c
 	styles: SideNavigationSubItemCss,
 })
 class SideNavigationSubItem extends SideNavigationSelectableItemBase {
+	/**
+	 * Defines the tag to be displayed.
+	 *
+	 * **Note:** Only one `ui5-tag` is allowed. The tag should use `design="Set2"`, `hide-state-icon`,
+	 * and `colorScheme` values 5-10 to avoid confusion with semantic colors (1-4).
+	 *
+	 * **Note:** It is recommended to limit tag width to 64px (4rem). If tag text exceeds this,
+	 * use shortened forms or abbreviations (e.g., "Experimental" → "Exp").
+	 *
+	 * @public
+	 * @since 2.7.0
+	 */
+	@slot({ type: HTMLElement })
+	tag!: Slot<HTMLElement>;
+
+	get hasTag() {
+		return !!this.tag.length;
+	}
+
+	get _textId() {
+		return `${this._id}-text`;
+	}
+
+	get _textAriaLabelledBy() {
+		if (this.hasTag) {
+			return `${this._textId} ${this._tagId}`;
+		}
+		return undefined;
+	}
+
+	get _describedBy() {
+		return this.hasTag ? this._tagId : undefined;
+	}
+
 	_onkeydown(e: KeyboardEvent) {
 		super._onkeydown(e);
 	}

packages/fiori/src/SideNavigationSubItemTemplate.tsx

@@ -24,11 +24,17 @@ export default function SideNavigationSubItemTemplate(this: SideNavigationSubIte
 						  href={this._href}
 						  target={this._target}
 						  aria-haspopup={this._ariaHasPopup}
+						  aria-describedby={this._describedBy}
 			>
 				{this.icon &&
 					<Icon class="ui5-sn-item-icon" name={this.icon}/>
 				}
-				<div class="ui5-sn-item-text">{this.text}</div>
+				<div class="ui5-sn-item-text" id={this._textId} aria-labelledby={this._textAriaLabelledBy}>{this.text}</div>
+				{this.hasTag &&
+					<div id={this._tagId} class="ui5-sn-item-tag-slot">
+						<slot name="tag"></slot>
+					</div>
+				}
 				{this.isExternalLink &&
 					<Icon class="ui5-sn-item-external-link-icon"
 						  name={arrowRight}

packages/fiori/src/themes/NavigationMenuItem.css

@@ -90,4 +90,12 @@
 
 ::slotted([ui5-navigation-menu-item]:not(:last-of-type)) {
 	margin-block-end: var(--_ui5_side_navigation_item_bottom_margin);
-}
+}
+
+.ui5-navmenu-item-tag-container {
+	display: inline-flex;
+	align-items: center;
+	margin-inline-start: 0.5rem;
+	height: 1.375rem;
+	min-width: 1.375rem;
+}

packages/fiori/src/themes/SideNavigationItem.css

@@ -1,4 +1,5 @@
 @import "./SideNavigationItemBase.css";
+@import "./InvisibleTextStyles.css";
 
 :host {
 	color: var(--sapList_TextColor);