@openui5/sap.ui.documentation 1.131.0 → 1.132.0

package/src/sap/ui/documentation/sdk/view/SubApiDetail.view.xml

@@ -24,17 +24,30 @@
 							  upperCaseAnchorBar="false"
 							  busyIndicatorDelay="0">
 				<headerTitle>
-					<ObjectPageHeader id="title" objectTitle="{/title}" objectSubtitle="{/subTitle}">
+					<ObjectPageDynamicHeaderTitle id="title">
+						<expandedHeading>
+							<m:FlexBox fitContainer="true" alignItems="Center">
+								<m:Title text="{/title}" wrapping="true" />
+								<m:Label text="{/subTitle}" />
+							</m:FlexBox>
+						</expandedHeading>
+
+						<snappedHeading>
+							<m:FlexBox fitContainer="true" alignItems="Center">
+								<m:Title text="{/title}" wrapping="true" />
+								<m:Label text="{/subTitle}" />
+							</m:FlexBox>
+						</snappedHeading>
+
 						<actions>
-							<ObjectPageHeaderActionButton id="apiDetailBackToSearch" text="Back to search results" hideIcon="true" hideText="false" press="backToSearch" visible="false"/>
-							<ObjectPageHeaderActionButton
-									id="toggleFullScreenBtn"
-									visible="{device>/system/desktop}"
-									icon="sap-icon://full-screen"
-									tooltip="Show this sample in full screen mode"
-									press="onToggleFullScreen" />
+							<m:Button
+								id="toggleFullScreenBtn"
+								visible="{device>/system/desktop}"
+								icon="sap-icon://full-screen"
+								tooltip="Show this sample in full screen mode"
+								press="onToggleFullScreen" />
 						</actions>
-					</ObjectPageHeader>
+					</ObjectPageDynamicHeaderTitle>
 					<core:ExtensionPoint name="customTitle" />
 				</headerTitle>
 
@@ -169,11 +182,7 @@
 											 class="sapUiSmallMarginTop">
 											<custom:Row>
 												<custom:ParamText class="sapUiDocumentationParamBold sapUiDocumentationParamWrap" text="{name}" depth="{depth}" optional="{optional}" deprecated="{= ${deprecated} !== undefined }"/>
-												<layout:VerticalLayout class="sapUiDocumentationOrList" content="{path: 'types', templateShareable: false}" width="100%">
-													<m:Link text="{path: 'value', formatter: '.formatter.escapeSettingsValue'}"
-															href="{path: 'value', formatter: '.formatter.getUrlForType'}"
-															enabled="{= !!${linkEnabled} }"/>
-												</layout:VerticalLayout>
+												<custom:JSDocType typeInfo="{parts: ['typeInfo', 'types', 'type', 'linkEnabled'], formatter: '.formatter.formatJSDocType'}"/>
 												<layout:VerticalLayout>
 													<custom:JSDocText sanitizeContent="false" text="{description}"/>
 													<layout:VerticalLayout content="{path: 'examples', templateShareable: false}" width="100%">
@@ -236,11 +245,7 @@
 														class="sapUiDocumentationParamsTable">
 													<custom:Row>
 														<custom:ParamText text="{name}" phoneText="{phoneName}" depth="{depth}" optional="{optional}"/>
-														<layout:VerticalLayout class="sapUiDocumentationOrList" content="{path: 'types', templateShareable: false}" width="100%">
-															<m:Link text="{value}"
-																	href="{path: 'value', formatter: '.formatter.getUrlForType'}"
-																	enabled="{= !!${linkEnabled} }"/>
-														</layout:VerticalLayout>
+														<custom:JSDocType typeInfo="{parts: ['typeInfo', 'types', 'type', 'linkEnabled'], formatter: '.formatter.formatJSDocType'}"/>
 														<m:Text text="{defaultValue}" wrapping="false"/>
 														<custom:JSDocText sanitizeContent="false" text="{description}"/>
 													</custom:Row>
@@ -281,11 +286,7 @@
 											class="sapUiSmallMarginTop">
 											<custom:Row>
 												<custom:ParamText class="sapUiDocumentationParamBold" text="{name}"/>
-												<layout:VerticalLayout class="sapUiDocumentationOrList" content="{path : 'types'}">
-													<m:Link text="{value}"
-															href="{path: 'value', formatter: '.formatter.getUrlForType'}"
-															enabled="{= !!${linkEnabled} }"/>
-												</layout:VerticalLayout>
+												<custom:JSDocType typeInfo="{parts: ['typeInfo', 'types', 'type', 'linkEnabled'], formatter: '.formatter.formatJSDocType'}"/>
 												<m:Text text="{defaultValue}"/>
 												<layout:VerticalLayout width="100%">
 													<custom:JSDocText sanitizeContent="false" text="{description}"/>
@@ -525,9 +526,7 @@
 														<template:repeat list="{event>parameters}" var="parameter">
 															<custom:Row>
 																<custom:ParamText text="{parameter>name}" phoneText="{parameter>phoneName}" depth="{parameter>depth}" optional="{parameter>optional}"/>
-																<m:Link text="{parameter>type}"
-																		href="api/{parameter>type}"
-																		enabled="{= !!${parameter>linkEnabled} }"/>
+																<custom:JSDocType typeInfo="{parts: ['parameter>typeInfo', 'parameter>types', 'parameter>type', 'parameter>linkEnabled'], formatter: '.formatter.stringifyJSDocType'}"/>
 																<layout:VerticalLayout>
 																	<custom:JSDocText sanitizeContent="false" text="{path: 'parameter>description', formatter: '.formatter.escapeSettingsValue'}"/>
 																	<m:MessageStrip
@@ -651,20 +650,7 @@
 															<template:repeat list="{method>parameters}" var="parameter">
 																<custom:Row>
 																	<custom:ParamText text="{parameter>name}" phoneText="{parameter>phoneName}" depth="{parameter>depth}" optional="{parameter>optional}"/>
-																	<layout:VerticalLayout class="sapUiDocumentationOrList" width="100%">
-																		<template:repeat list="{parameter>types}" var="type">
-																			<template:if test="{= !!${type>linkEnabled} }">
-																				<template:then>
-																					<m:Link text="{path: 'type>value', formatter: '.formatter.escapeSettingsValue'}"
-																							href="{path: 'type>value', formatter: '.formatter.getUrlForType'}"
-																							enabled="true"/>
-																				</template:then>
-																				<template:else>
-																					<m:Link text="{path: 'type>value', formatter: '.formatter.escapeSettingsValue'}" enabled="false"/>
-																				</template:else>
-																			</template:if>
-																		</template:repeat>
-																	</layout:VerticalLayout>
+																	<custom:JSDocType typeInfo="{parts: ['parameter>typeInfo','parameter>types'], formatter: '.formatter.stringifyJSDocType'}"/>
 																	<m:Text text="{parameter>defaultValue}" wrapping="false"/>
 																	<custom:JSDocText sanitizeContent="false" text="{path: 'parameter>description', formatter: '.formatter.escapeSettingsValue'}"/>
 																</custom:Row>
@@ -677,13 +663,7 @@
 																	columnTitles="Returns,Description"
 																	class="sapUiDocumentation2ColumnsEqualTable">
 															<custom:Row>
-																<layout:VerticalLayout class="sapUiDocumentationOrList" width="100%">
-																	<template:repeat list="{method>returnValue/types}" var="rtype">
-																		<m:Link text="{path: 'rtype>value', formatter: '.formatter.escapeSettingsValue'}"
-																				href="{path: 'rtype>value', formatter: '.formatter.getUrlForType'}"
-																				enabled="{= !!${rtype>linkEnabled} }"/>
-																	</template:repeat>
-																</layout:VerticalLayout>
+																<custom:JSDocType typeInfo="{parts: ['method>returnValue/typeInfo', 'method>returnValue/types'], formatter: '.formatter.stringifyJSDocType'}"/>
 																<custom:JSDocText sanitizeContent="false" text="{path: 'method>returnValue/description', formatter: '.formatter.escapeSettingsValue'}"/>
 															</custom:Row>
 														</custom:LightTable>
@@ -729,9 +709,7 @@
 											class="sapUiSmallMarginTop sapUiDocumentationSpecialSettingsTable">
 											<custom:Row>
 												<custom:ParamText class="sapUiDocumentationParamBold" text="{name}"/>
-												<m:Link text="{type}"
-														href="api/{type}"
-														enabled="{= !!${linkEnabled} }"/>
+												<custom:JSDocType typeInfo="{parts: ['typeInfo', 'types', 'type', 'linkEnabled'], formatter: '.formatter.formatJSDocType'}"/>
 												<custom:JSDocText sanitizeContent="false" text="{description}"/>
 											</custom:Row>
 										</custom:LightTable>

package/src/sap/ui/documentation/themes/base/JSDocType.less

@@ -0,0 +1,20 @@
+.sapUiJSDocType {
+	color: lighten(@sapUiLink,41);
+	display: inline-block;
+	font-family: @sapUiFontFamily;
+	font-size: @sapMFontMediumSize;
+	word-break: break-word; // ensure long names visible even when inside a narrow column
+	overflow-wrap: break-word;
+}
+
+.sapUiJSDocTypeLink {
+	color: @sapUiLink;
+	cursor: pointer;
+	text-decoration: none;
+	opacity: 1;
+}
+
+.sapUiJSDocTypeLink:hover:not(:active):not(:focus) {
+	color: @sapUiLinkHoverColor;
+	text-decoration: @sapUiLinkHoverTextDecoration;
+}

package/src/sap/ui/documentation/themes/base/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -13,6 +13,7 @@
  @import "DataTableFilterDropDown.less";
  @import "Documentation.less";
  @import "DemokitTreeItem.less";
+ @import "JSDocType.less";
  @import "LightTable.less";
  @import "ObjectPageSubSection.less";
  @import "Search.less";

package/src/sap/ui/documentation/themes/sap_belize/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_belize_base/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_belize_hcb/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_belize_hcw/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_belize_plus/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_fiori_3/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_fiori_3_dark/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_fiori_3_hcb/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_fiori_3_hcw/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_horizon/Link.less

@@ -1,3 +1,9 @@
-.sapMLnk:not(.sapMLnkDsbl) {
-	text-shadow: none;
+.sapUiDemokit {
+	.sapMLnk:not(.sapMLnkDsbl) {
+		text-shadow: none;
+	}
+
+	.sapMLnk:not(.sapMLnkDsbl):focus .defaultHighlightedText {
+		background: var(--sapContent_FocusColor);
+	}
 }

package/src/sap/ui/documentation/themes/sap_horizon/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_horizon_dark/Link.less

@@ -1,3 +1,9 @@
-.sapMLnk:not(.sapMLnkDsbl) {
-	text-shadow: none;
+.sapUiDemokit {
+	.sapMLnk:not(.sapMLnkDsbl) {
+		text-shadow: none;
+	}
+
+	.sapMLnk:not(.sapMLnkDsbl):focus .defaultHighlightedText {
+		background: var(--sapContent_FocusColor);
+	}
 }

package/src/sap/ui/documentation/themes/sap_horizon_dark/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_horizon_hcb/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/documentation/themes/sap_horizon_hcw/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */