@sapui5/sap.fe.templates 1.144.0 → 1.146.0

package/src/sap/fe/templates/ObjectPage/ExtensionAPI.ts

@@ -12,6 +12,7 @@ import type { SideEffectsTargetType } from "sap/fe/core/services/SideEffectsServ
 import type Section from "sap/fe/macros/controls/Section";
 import type TableAPI from "sap/fe/macros/Table";
 import Link from "sap/m/Link";
+import MessageBox from "sap/m/MessageBox";
 import MessageItem from "sap/m/MessageItem";
 import MessagePopover from "sap/m/MessagePopover";
 import MessageStrip from "sap/m/MessageStrip";
@@ -28,6 +29,8 @@ import type Context from "sap/ui/model/Context";
 import type ODataV4Context from "sap/ui/model/odata/v4/Context";
 import type ObjectPageDynamicHeaderTitle from "sap/uxap/ObjectPageDynamicHeaderTitle";
 import type ObjectPageLayout from "sap/uxap/ObjectPageLayout";
+import type ObjectPageSection from "sap/uxap/ObjectPageSection";
+import type ObjectPageSubSection from "sap/uxap/ObjectPageSubSection";
 
 /**
  * Extension API for object pages on SAP Fiori elements for OData V4.
@@ -464,6 +467,83 @@ class ObjectPageExtensionAPI extends ExtensionAPI {
 			}
 		}
 	}
+
+	/**
+	 * Displays an error message when navigation to a section fails.
+	 */
+	private showNavigationError(): void {
+		const resourceModel = ResourceModelHelper.getResourceModel(this._view);
+		const sTitle = resourceModel.getText("C_ROUTING_NAVIGATION_DISABLED_TITLE");
+		Log.error(sTitle);
+		MessageBox.error(sTitle);
+	}
+
+	/**
+	 * Navigate to a specific section or subsection within the current page.
+	 * Works with Object Page layouts and other section-based layouts.
+	 * @param sectionOrSubSectionId The ID of the target section or subsection (without a view prefix, for example, "fe::FacetSection::TravelData" or "fe::SubSection::Details")
+	 * @public
+	 */
+	navigateToSubSection(sectionOrSubSectionId: string): void {
+		try {
+			// Find the Object Page Layout control
+			const objectPageLayout = this._view.getContent()[0] as ObjectPageLayout | undefined;
+
+			if (!objectPageLayout) {
+				this.showNavigationError();
+				return;
+			}
+
+			if (!sectionOrSubSectionId) {
+				this.showNavigationError();
+				return;
+			}
+
+			const control = this._view.byId(sectionOrSubSectionId);
+
+			if (!control) {
+				this.showNavigationError();
+				return;
+			}
+
+			let targetSubSection: ObjectPageSubSection | undefined;
+
+			// Check if control is a SubSection or Section
+			if (control.isA<ObjectPageSubSection>("sap.uxap.ObjectPageSubSection")) {
+				targetSubSection = control;
+			} else if (control.isA<ObjectPageSection>("sap.uxap.ObjectPageSection")) {
+				// If it's a section, get the first subsection
+				const subSections = control.getSubSections();
+				targetSubSection = subSections.length > 0 ? subSections[0] : undefined;
+			}
+
+			// Validate subsection
+			if (!targetSubSection || !targetSubSection.getVisible()) {
+				this.showNavigationError();
+				return;
+			}
+
+			// Get the full subsection ID (including view prefix)
+			const subsectionFullId = targetSubSection.getId();
+
+			if (!subsectionFullId) {
+				Log.error("Subsection ID is undefined, cannot set selected section.");
+				return;
+			}
+
+			// Navigate using ObjectPageLayout API
+			objectPageLayout.setSelectedSection(subsectionFullId);
+
+			// Trigger iApp state change by firing navigate event
+			const parentSection = targetSubSection.getParent() as ObjectPageSection;
+			objectPageLayout.fireNavigate({
+				section: parentSection,
+				subSection: targetSubSection
+			});
+		} catch (error) {
+			Log.error("Error during navigation to subsection:", error as Error);
+		}
+	}
 }
 
 export default ObjectPageExtensionAPI;

package/src/sap/fe/templates/ObjectPage/ObjectPage.view.xml

@@ -51,7 +51,11 @@
 				navigate=".handlers.onNavigateChange"
 			>
 				<uxap:landmarkInfo>
-					<uxap:ObjectPageAccessibleLandmarkInfo footerLabel="{sap.fe.i18n>T_COMMON_OBJECT_PAGE_FOOTER}" />
+					<uxap:ObjectPageAccessibleLandmarkInfo
+						headerRole="{= ${internal>/hasUShell} ? 'None' : 'Banner'}"
+						headerLabel="{sap.fe.i18n>T_COMMON_OBJECT_PAGE_HEADER}"
+						footerLabel="{sap.fe.i18n>T_COMMON_OBJECT_PAGE_FOOTER}"
+					/>
 				</uxap:landmarkInfo>
 				<uxap:dependents>
 					<control:CommandExecution execute="_executeTabShortCut" command="NextTab" />
@@ -139,6 +143,7 @@
 										<macro:Paginator
 											id="fe::Paginator"
 											ariaTitle="{= COMMONFORMATTERS.getBindingWithText(${headerInfo>Title/Value@@UI.getDataModelObjectPath}) }"
+											visible="{= !${viewData>/fclEnabled} || ${fclhelper>/showPaginatorButton} }"
 										/>
 									</template:if>
 									<!-- Flexible column layout menu-->