@openui5/sap.ui.documentation 1.96.5 → 1.99.0

package/src/sap/ui/documentation/sdk/controller/App.controller.js

@@ -8,6 +8,7 @@ sap.ui.define([
 	"sap/ui/events/KeyCodes",
 	"sap/ui/thirdparty/jquery",
 	"sap/ui/documentation/sdk/controller/BaseController",
+	"sap/ui/documentation/sdk/controller/util/NewsInfo",
 	"sap/ui/documentation/sdk/controller/util/SearchUtil",
 	"sap/ui/core/mvc/Controller",
 	"sap/ui/model/Filter",
@@ -36,6 +37,7 @@ sap.ui.define([
 	KeyCodes,
 	jQuery,
 	BaseController,
+	NewsInfo,
 	SearchUtil,
 	Controller,
 	Filter,
@@ -129,7 +131,8 @@ sap.ui.define([
 					aResultArr.push({
 						"groupTitle": sCurrGroupTitle,
 						"version": sCurrGroupTitle + " (" + iCounter + " versions)",
-						"nodes": aNodes
+						"nodes": aNodes,
+						"path": aNodes[0].path
 					});
 				}
 
@@ -194,6 +197,9 @@ sap.ui.define([
 
 				}.bind(this));
 
+				this._oNewsModel = new JSONModel();
+				this.setModel(this._oNewsModel, "news");
+
 				// Cache view reference
 				this._oSupportedLangModel = new JSONModel();
 
@@ -213,6 +219,10 @@ sap.ui.define([
 
 				this._oConfigUtil = this.getOwnerComponent().getConfigUtil();
 				this._oCookieNames = this._oConfigUtil.COOKIE_NAMES;
+				this._sLocalStorageNewsName = this._oConfigUtil.LOCAL_STORAGE_NAMES['OLD_NEWS_IDS'];
+
+				NewsInfo.prepareNewsData(this._oConfigUtil);
+
 				this._bSupportsPrefersColorScheme = !!(window.matchMedia &&
 					(window.matchMedia('(prefers-color-scheme: dark)').matches ||
 					window.matchMedia('(prefers-color-scheme: light)').matches));
@@ -232,6 +242,7 @@ sap.ui.define([
 				}, this);
 
 				this.bus = Core.getEventBus();
+				this.bus.subscribe("newsChanged", "onDemoKitNewsChanged", this._syncNewsModelWithNewsInfo, this);
 
 				this._createConfigurationBasedOnURIInput();
 
@@ -288,6 +299,8 @@ sap.ui.define([
 				jQuery(document.body).addClass(this.getOwnerComponent().getContentDensityClass());
 
 				Device.orientation.attachHandler(this._onOrientationChange, this);
+
+				this._syncNewsModelWithNewsInfo();
 			},
 
 			onExit: function() {
@@ -379,6 +392,69 @@ sap.ui.define([
 				}
 			},
 
+			navigateToNews: function() {
+				this.getRouter().navTo("news");
+			},
+
+			handleNewsPress: function (oEvent) {
+				var oButton = oEvent.getSource(),
+					oView = this.getView();
+
+				if (this._oNewsModel.getProperty("/newsCount") === 0) {
+					this.navigateToNews();
+				} else if (!this._oNewsPopover) {
+					Fragment.load({
+						name: "sap.ui.documentation.sdk.view.NewsPopover",
+						controller: this
+					}).then(function(oPopover) {
+						oView.addDependent(oPopover);
+						this._oNewsPopover = oPopover;
+						this._oNewsPopover.openBy(oButton);
+					}.bind(this));
+				} else {
+					this._oNewsPopover.openBy(oButton);
+				}
+			},
+
+			handleShowAllPress: function () {
+				this._oNewsPopover.close();
+				this.navigateToNews();
+			},
+
+			handleDismissAllPress: function () {
+				NewsInfo.moveAllNewItemsToOld();
+			},
+
+			handleNewsItemClose: function (oEvent) {
+				var oItem = oEvent.getSource(),
+					iItemCustomId = oItem.getCustomData()[0].getValue(),
+					oItemInfoInItemsProperty = this._oNewsModel.getProperty("/items").find(function(oItem){
+						return oItem.id === iItemCustomId;
+					});
+
+					NewsInfo.moveNewItemToOld(oItemInfoInItemsProperty);
+			},
+
+			handleVisitNewsLink: function(oEvent) {
+				var oItem = oEvent.getSource(),
+					sItemLink = oItem.getCustomData()[0].getValue();
+
+				URLHelper.redirect(sItemLink, true);
+			},
+
+			_syncNewsModelWithNewsInfo: function() {
+				var aNewsInfoCopy,
+					sPreparationFailureMessage = NewsInfo.getPreparationFailureMessage();
+
+				if (!sPreparationFailureMessage) {
+					aNewsInfoCopy = NewsInfo.getNewNewsArray().slice();
+					this._oNewsModel.setProperty("/items", aNewsInfoCopy);
+					this._oNewsModel.setProperty("/newsCount", aNewsInfoCopy.length);
+				}
+
+				this._oNewsModel.setProperty("/newsPreparationFailureMessage", sPreparationFailureMessage);
+			},
+
 			handleMenuItemClick: function (oEvent) {
 				var sTargetText = oEvent.getParameter("item").getKey(),
 					sTarget = this.MENU_LINKS_MAP[sTargetText];
@@ -1264,7 +1340,7 @@ sap.ui.define([
 
 			/**
 			 * Event handler for the rating to update the label and the data
-			 * @param {sap.ui.base.Event}
+			 * @param {sap.ui.base.Event} oEvent
 			 */
 			onPressRatingButton: function(oEvent) {
 				var that = this;

package/src/sap/ui/documentation/sdk/controller/BaseController.js

@@ -161,7 +161,7 @@ sap.ui.define([
 
 			/**
 			 * Opens a legal disclaimer for Links Popover.
-			 * @param {sap.ui.base.Event} oEvent: the <code>Image</code> press event
+			 * @param {sap.ui.base.Event} oEvent the <code>Image</code> press event
 			 * @public
 			 */
 			onDisclaimerLinkPress: function (oEvent) {

package/src/sap/ui/documentation/sdk/controller/ControlsMaster.controller.js

@@ -19,7 +19,8 @@ sap.ui.define([
 	"sap/base/util/UriParameters",
 	"sap/ui/util/Storage",
 	"sap/ui/core/Core",
-	"sap/ui/documentation/sdk/controller/util/Highlighter"
+	"sap/ui/documentation/sdk/controller/util/Highlighter",
+	"sap/ui/documentation/sdk/util/Resources"
 ], function(
 	jQuery,
 	Device,
@@ -35,7 +36,8 @@ sap.ui.define([
 	UriParameters,
 	Storage,
 	Core,
-	Highlighter
+	Highlighter,
+	ResourcesUtil
 ) {
 		"use strict";
 
@@ -280,7 +282,7 @@ sap.ui.define([
 				}
 
 				// Apply theme and compact mode also to iframe samples if there is actually a change
-				if (bRTLChanged || bContentDensityChanged || bThemeChanged) {
+				if ((bRTLChanged || bContentDensityChanged || bThemeChanged) && !ResourcesUtil.getHasProxy()) {
 
 					$SampleFrame = jQueryDOM("#sampleFrame");
 					if ($SampleFrame.length > 0) {
@@ -403,8 +405,7 @@ sap.ui.define([
 
 			getGroupHeader: function (oGroup) {
 				return new GroupHeaderListItem({
-					title: oGroup.key,
-					upperCase: false
+					title: oGroup.key
 				});
 			},
 

package/src/sap/ui/documentation/sdk/controller/News.controller.js

@@ -0,0 +1,77 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+sap.ui.define([
+		"sap/ui/documentation/sdk/controller/BaseController",
+		'sap/ui/model/json/JSONModel',
+		"sap/ui/documentation/sdk/controller/util/NewsInfo",
+		"sap/ui/core/Core",
+		"sap/m/library"
+		],
+		function (BaseController, JSONModel, NewsInfo, Core, mobileLibrary) {
+		'use strict';
+
+		return BaseController.extend('sap.ui.documentation.sdk.controller.News', {
+			onInit: function() {
+				this.getRouter().getRoute("news").attachPatternMatched(this._onMatched, this);
+
+				this._oModel = new JSONModel();
+				this.setModel(this._oModel);
+
+				NewsInfo.prepareNewsData(this.getOwnerComponent().getConfigUtil());
+
+				Core.getEventBus().subscribe("newsChanged", "onDemoKitNewsChanged", this._syncModelWithNewsInfo, this);
+			},
+
+			onAfterRendering: function() {
+				this._syncModelWithNewsInfo();
+			},
+
+			handleNewsItemClose: function (oEvent) {
+				var oItem = oEvent.getSource(),
+					iItemCustomId = oItem.getCustomData()[0].getValue(),
+					oItemInfoInItemsProperty = this._oModel.getProperty("/new").find(function(oItem){
+						return oItem.id === iItemCustomId;
+					});
+
+					NewsInfo.moveNewItemToOld(oItemInfoInItemsProperty);
+			},
+
+			handleMarkAsRead: function () {
+				NewsInfo.moveAllNewItemsToOld();
+			},
+
+			handleVisitLink: function(oEvent) {
+				var oItem = oEvent.getSource(),
+					sItemLink = oItem.getCustomData()[0].getValue();
+
+				mobileLibrary.URLHelper.redirect(sItemLink, true);
+			},
+
+			_syncModelWithNewsInfo: function() {
+				var sPreparationFailureMessage = NewsInfo.getPreparationFailureMessage();
+
+				if (!sPreparationFailureMessage) {
+					this._oModel.setProperty("/new", NewsInfo.getNewNewsArray().slice());
+					this._oModel.setProperty("/old", NewsInfo.getOldNewsArray().slice());
+				}
+				this._oModel.setProperty("/preparationFailureMessage", sPreparationFailureMessage);
+			},
+
+			/**
+			 * Handles "demoapps" routing
+			 * @function
+			 * @private
+			 */
+			_onMatched: function () {
+				try {
+					this.hideMasterSide();
+				} catch (e) {
+					// try-catch due to a bug in UI5 SplitApp, CL 1898264 should fix it
+				}
+			}
+		});
+	});

package/src/sap/ui/documentation/sdk/controller/Sample.controller.js

@@ -17,8 +17,10 @@ sap.ui.define([
     "sap/ui/core/HTML",
     "sap/m/library",
     "sap/base/Log",
+	"sap/base/util/UriParameters",
 	"sap/ui/core/Fragment",
-	"sap/ui/documentation/sdk/util/Resources"
+	"sap/ui/documentation/sdk/util/Resources",
+	"./config/sampleForwardingConfig"
 ], function(
     jQuery,
 	SampleBaseController,
@@ -31,14 +33,20 @@ sap.ui.define([
 	HTML,
 	mobileLibrary,
 	Log,
+	UriParameters,
 	Fragment,
-	ResourcesUtil
+	ResourcesUtil,
+	sampleForwardingConfig
 ) {
 		"use strict";
 
 		// shortcut for sap.m.URLHelper
 		var URLHelper = mobileLibrary.URLHelper;
 
+		var COZY = "cozy",
+			COMPACT = "compact",
+			CONDENSED = "condensed";
+
 		return SampleBaseController.extend("sap.ui.documentation.sdk.controller.Sample", {
 			/* =========================================================== */
 			/* lifecycle methods										   */
@@ -54,15 +62,29 @@ sap.ui.define([
 					showNewTab: false,
 					rtaLoaded: false
 				});
+				this._oSampleIframeSettings = {
+					densityMode: COMPACT,
+					themeActive: "sap_fiori_3",
+					rtl: false
+				};
 
 				this._sId = null; // Used to hold sample ID
 				this._sEntityId = null; // Used to hold entity ID for the sample currently shown
+				this.router = this.getRouter();
 
 				// Load runtime authoring asynchronously
-				Promise.all([
-					sap.ui.getCore().loadLibrary("sap.ui.fl", {async: true}),
-					sap.ui.getCore().loadLibrary("sap.ui.rta", {async: true})
-				]).then(this._loadRTA.bind(this));
+				if (!ResourcesUtil.getHasProxy()) {
+					Promise.all([
+						sap.ui.getCore().loadLibrary("sap.ui.fl", {async: true}),
+						sap.ui.getCore().loadLibrary("sap.ui.rta", {async: true})
+					]).then(function () {
+						sap.ui.require([
+							"sap/ui/fl/Utils",
+							"sap/ui/fl/FakeLrepConnectorLocalStorage",
+							"sap/ui/core/util/reflection/JsControlTreeModifier"
+						], this._loadRTA.bind(this));
+					}.bind(this));
+				}
 
 				this.getView().setModel(this.oModel);
 
@@ -85,6 +107,14 @@ sap.ui.define([
 				this._sEntityId = event.getParameter("arguments").entityId;
 
 				this.byId("page").setBusy(true);
+
+				if (sampleForwardingConfig[this._sId]) {
+					return this.router.navTo("sample", {
+						entityId: sampleForwardingConfig[this._sId].entityId,
+						sampleId: sampleForwardingConfig[this._sId].sampleId
+					}, true);
+				}
+
 				this.getModel("appView").setProperty("/bHasMaster", false);
 
 				ControlsInfo.loadData().then(this._loadSample.bind(this));
@@ -145,11 +175,12 @@ sap.ui.define([
 						var oSampleConfig = oConfig && oConfig.sample || {};
 
 						// only have the option to run standalone if there is an iframe
-						oModelData.showNewTab = !!oSampleConfig.iframe || ResourcesUtil.getHasProxy();
+						oModelData.showNewTab = !!oSampleConfig.iframe || !!ResourcesUtil.getHasProxy();
 						oModelData.id = oSample.id;
 						oModelData.name = oSample.name;
 						oModelData.details = oSample.details;
 						oModelData.description = oSample.description;
+						oModelData.showSettings = !!ResourcesUtil.getHasProxy();
 
 						if (oSampleConfig) {
 
@@ -211,6 +242,141 @@ sap.ui.define([
 					});
 			},
 
+			/**
+			 * Opens the View settings dialog
+			 * @public
+			 */
+			handleSettings: function () {
+				var oSampleFrame = this._oHtmlControl.$()[0].contentWindow,
+					oSampleFrameCore = oSampleFrame.sap.ui.getCore(),
+					oView;
+
+				if (!this._oMessageBundle) {
+					this._oMessageBundle = new oSampleFrame.sap.ui.model.resource.ResourceModel({
+						bundleName: "sap.ui.documentation.messagebundle"
+					});
+				}
+
+				if (!this._oSettingsDialog) {
+					this._oSettingsDialog = new oSampleFrame.sap.ui.xmlfragment("sap.ui.documentation.sdk.view.appSettingsDialog", this);
+
+					oView = oSampleFrameCore.byId("__xmlview0");
+					oView.setModel(this._oMessageBundle, "i18n");
+					oView.addDependent(this._oSettingsDialog);
+				}
+
+				setTimeout(function () {
+					var oAppSettings = oSampleFrameCore.getConfiguration(),
+						oThemeSelect = oSampleFrameCore.byId("ThemeSelect"),
+						sUriParamTheme = UriParameters.fromQuery(window.location.search).get("sap-theme"),
+						bDensityMode = this._oSampleIframeSettings.densityMode;
+
+					// Theme select
+					oThemeSelect.setSelectedKey(sUriParamTheme ? sUriParamTheme : oAppSettings.getTheme());
+
+					// RTL
+					oSampleFrameCore.byId("RTLSwitch").setState(oAppSettings.getRTL());
+
+					// Density mode select
+					oSampleFrameCore.byId("DensityModeSwitch").setSelectedKey(bDensityMode);
+
+					this._oSettingsDialog.open();
+				}.bind(this), 0);
+			},
+
+			/**
+			 * Closes the View settings dialog
+			 * @public
+			 */
+			handleCloseAppSettings: function () {
+				this._oSettingsDialog.close();
+			},
+
+			handleSaveAppSettings: function () {
+				var oSampleFrame = this._oHtmlControl.$()[0].contentWindow,
+					oSampleFrameCore = oSampleFrame.sap.ui.getCore(),
+					sDensityMode = oSampleFrameCore.byId("DensityModeSwitch").getSelectedKey(),
+					sTheme = oSampleFrameCore.byId("ThemeSelect").getSelectedKey(),
+					bRTL = oSampleFrameCore.byId("RTLSwitch").getState(),
+					oView = oSampleFrameCore.byId("__xmlview0");
+
+				this._oSettingsDialog.close();
+
+				// Lazy loading of busy dialog
+				if (!this._oBusyDialog) {
+					oSampleFrame.sap.ui.require(["sap/m/BusyDialog"], function () {
+						this._oBusyDialog = new oSampleFrame.sap.m.BusyDialog();
+						oView.addDependent(this._oBusyDialog);
+						this._handleBusyDialog();
+					}.bind(this));
+				} else {
+					this._handleBusyDialog();
+				}
+
+				// handle settings change
+				this._applyAppConfiguration(sTheme, sDensityMode, bRTL);
+			},
+
+			/**
+			 * Apply content configuration
+			 * @param {string} sThemeActive name of the theme
+			 * @param {string} sDensityMode content density mode
+			 * @param {boolean} bRTL right to left mode
+			 * @private
+			 */
+			_applyAppConfiguration: function(sThemeActive, sDensityMode, bRTL){
+				var oSampleFrame = this._oHtmlControl.$()[0].contentWindow,
+					oSampleFrameCore = oSampleFrame.sap.ui.getCore();
+
+				if (this._oSampleIframeSettings.densityMode !== sDensityMode) {
+					this._oSampleIframeSettings.densityMode = sDensityMode;
+					this._toggleContentDensityClasses(oSampleFrame.jQuery("body"), sDensityMode);
+				}
+
+				if (this._oSampleIframeSettings.rtl !== bRTL) {
+					oSampleFrameCore.getConfiguration().setRTL(bRTL);
+					this._oSampleIframeSettings.rtl = bRTL;
+				}
+
+				if (oSampleFrameCore.getConfiguration().getTheme() !== sThemeActive) {
+					oSampleFrameCore.applyTheme(sThemeActive);
+					this._oSampleIframeSettings.themeActive = sThemeActive;
+				} else if (this._oSampleIframeSettings.densityMode !== sDensityMode) {
+					// Notify Core for content density change only if no theme change happened
+					oSampleFrameCore.notifyContentDensityChanged();
+				}
+			},
+
+			/**
+			 * Toggles content density classes in the provided html body
+			 * @param {object} oBody the html body to set the correct class on
+			 * @param {string} sDensityMode content density mode
+			 * @private
+			 */
+			_toggleContentDensityClasses: function(oBody, sDensityMode){
+				switch (sDensityMode) {
+					case COMPACT:
+						oBody.toggleClass("sapUiSizeCompact", true).toggleClass("sapUiSizeCozy", false).toggleClass("sapUiSizeCondensed", false);
+						break;
+					case CONDENSED:
+						oBody.toggleClass("sapUiSizeCondensed", true).toggleClass("sapUiSizeCozy", false).toggleClass("sapUiSizeCompact", true);
+						break;
+					default:
+						oBody.toggleClass("sapUiSizeCozy", true).toggleClass("sapUiSizeCondensed", false).toggleClass("sapUiSizeCompact", false);
+				}
+			},
+
+			/**
+			 * Handles View settings dialog
+			 * @public
+			 */
+			_handleBusyDialog : function () {
+				this._oBusyDialog.open();
+				setTimeout(function () {
+					this._oBusyDialog.close();
+				}.bind(this), 1000);
+			},
+
 			_updateFileContent: function(sRef, sFile) {
 				this.fetchSourceFile(sRef + "/" + sFile).then(function(vContent) {
 					var aFiles = this.oModel.getProperty("/files");
@@ -267,7 +433,7 @@ sap.ui.define([
 			/**
 			 * Extends the sSampleId with the relative path defined in sIframePath and returns the resulting path.
 			 * @param {string} sSampleId
-			 * @param {string} sIframe
+			 * @param {string} sIframePath
 			 * @returns {string}
 			 * @private
 			 */
@@ -325,6 +491,20 @@ sap.ui.define([
 				}
 
 				if (!this._oHtmlControl) {
+					var oComponent = this.getOwnerComponent();
+
+					// Guarantees the sample initially to have the same content density, as the whole Demo Kit
+					switch (oComponent.getContentDensityClass()) {
+						case "sapUiSizeCompact":
+							this._oSampleIframeSettings.densityMode = COMPACT;
+							break;
+						case "sapUiSizeCondensed":
+							this._oSampleIframeSettings.densityMode = CONDENSED;
+							break;
+						default:
+							this._oSampleIframeSettings.densityMode = COZY;
+					}
+
 					this._oHtmlControl = new HTML({
 						id : "sampleFrame",
 						content : '<iframe src="' + this.sIFrameUrl + '" id="sampleFrame" frameBorder="0"></iframe>'
@@ -335,17 +515,58 @@ sap.ui.define([
 							if (!this._oHtmlControl._jQueryHTMLControlLoadEventAttached) {
 								this._oHtmlControl.$().on("load", function () {
 									var oSampleFrame = this._oHtmlControl.$()[0].contentWindow,
-										oSampleFrameCore = oSampleFrame.sap.ui.getCore();
+										oSampleFrameCore = oSampleFrame.sap.ui.getCore(),
+										oFrame = document.getElementById("sampleFrame");
+
+									this._oMessageBundle = null;
+									this._oSettingsDialog = null;
+									this._oBusyDialog = null;
+
+									if (this.oModel.getData().iframe) {
+										Promise.all([
+											oSampleFrameCore.loadLibrary("sap.ui.fl", {async: true}),
+											oSampleFrameCore.loadLibrary("sap.ui.rta", {async: true})
+										]).then(function () {
+											oSampleFrame.sap.ui.require([
+												"sap/ui/fl/Utils",
+												"sap/ui/fl/FakeLrepConnectorLocalStorage",
+												"sap/ui/core/util/reflection/JsControlTreeModifier"
+											], this._loadRTA.bind(this));
+										}.bind(this));
+
+
+										oFrame.onToggleAdaptationMode = function () {
+											oSampleFrame.sap.ui.require([
+												"sap/ui/rta/api/startKeyUserAdaptation"
+											], function (
+												startKeyUserAdaptation
+											) {
+												if (!this._oRTA) {
+													var oContainer = oSampleFrameCore.byId("__container0");
+
+													startKeyUserAdaptation({
+														rootControl : oContainer.getComponentInstance()
+													}).then(function(oRta) {
+														this._oRTA = oRta;
+														oContainer.$().css({"padding-top": "2.5rem", "box-sizing": "border-box"});
+														this._oRTA.attachStop(function () {
+															oContainer.$().css({"padding-top": "0", "box-sizing": "content-box"});
+															this._oRTA.destroy();
+															delete this._oRTA;
+														}.bind(this));
+													}.bind(this));
+												}
+											}.bind(this));
+										};
+									}
 
 									// Apply theme settings to iframe sample
 									oSampleFrame.sap.ui.getCore().attachInit(function () {
-										var bCompact = jQuery(document.body).hasClass("sapUiSizeCompact");
-
-										oSampleFrameCore.applyTheme(ResourcesUtil.getHasProxy() ? this._sDefaultSampleTheme : this._oCore.getConfiguration().getTheme());
-										oSampleFrameCore.getConfiguration().setRTL(this._oCore.getConfiguration().getRTL());
-										oSampleFrame.jQuery('body')
-											.toggleClass("sapUiSizeCompact", bCompact)
-											.toggleClass("sapUiSizeCozy", !bCompact);
+										oSampleFrameCore.applyTheme(ResourcesUtil.getHasProxy() ?
+											this._oSampleIframeSettings.themeActive : this._oCore.getConfiguration().getTheme());
+										oSampleFrameCore.getConfiguration().setRTL(ResourcesUtil.getHasProxy() ?
+											this._oSampleIframeSettings.rtl : this._oCore.getConfiguration().getRTL());
+										this._toggleContentDensityClasses(oSampleFrame.jQuery('body'), this._oSampleIframeSettings.densityMode);
 
 										// Notify Core for content density change
 										oSampleFrameCore.notifyContentDensityChanged();
@@ -395,7 +616,7 @@ sap.ui.define([
 			},
 
 			onDemoKitThemeChanged: function(sChannelId, sEventId, oData) {
-				if (this._oHtmlControl) {
+				if (this._oHtmlControl && !ResourcesUtil.getHasProxy()) {
 					this._oHtmlControl.$()[0].contentWindow.sap.ui.getCore().applyTheme(oData.sThemeActive);
 				}
 				this.setDefaultSampleTheme();
@@ -436,12 +657,7 @@ sap.ui.define([
 				this.sIFrameUrl = this.sIFrameUrl + decodeURI(oIFrameURL.search);
 			},
 
-			_loadRTA: function () {
-				sap.ui.require([
-					"sap/ui/fl/Utils",
-					"sap/ui/fl/FakeLrepConnectorLocalStorage",
-					"sap/ui/core/util/reflection/JsControlTreeModifier"
-				], function (
+			_loadRTA: function (
 					Utils,
 					FakeLrepConnectorLocalStorage,
 					JsControlTreeModifier
@@ -469,18 +685,23 @@ sap.ui.define([
 							this._oRTA = null;
 						}
 					}, this);
-				}.bind(this));
 			},
 
 			onToggleAdaptationMode : function (oEvt) {
+				if (this.oModel.getData().iframe) {
+					window.document.getElementsByTagName("iframe")[0].onToggleAdaptationMode();
+					return;
+				}
 				sap.ui.require([
 					"sap/ui/rta/api/startKeyUserAdaptation"
 				], function (
 					startKeyUserAdaptation
 				) {
 					if (!this._oRTA) {
+						var oContainer = this.byId("page").getContent()[0];
+
 						startKeyUserAdaptation({
-							rootControl : this.byId("page").getContent()[0].getComponentInstance()
+							rootControl : oContainer.getComponentInstance()
 						}).then(function(oRta) {
 							this._oRTA = oRta;
 							this._oRTA.attachStop(function () {

package/src/sap/ui/documentation/sdk/controller/TopicDetail.controller.js

@@ -405,7 +405,7 @@ sap.ui.define([
 			/**
 			 *  Iterates over all links marked as external and adds a icon and disclaimer proxy
 			 *
-			 * @param oElement, the dom ref to the container
+			 * @param {Element} oElement the DOM ref to the container
 			 * @private
 			 */
 			_fixExternalLinks: function (oElement) {
@@ -432,7 +432,7 @@ sap.ui.define([
 			 *  1. First loop - calculates the sum of all colgroup children
 			 *  2. Second loop - transforms the origin values to percent
 			 *
-			 * @param oElement, the dom ref to the container
+			 * @param {Element} oElement the DOM ref to the container
 			 * @private
 			 */
 			_computeColumnGroupValues: function (oElement) {
@@ -471,8 +471,8 @@ sap.ui.define([
 			 * 1) The link is a non SAP and the icon image is link-external.png
 			 * 2) The link is a SAP and the icon image is link-sap.png
 			 *
-			 * @param aDomRef, the dom ref to the external link
-			 * @param sHref, the url string
+			 * @param {Element} aDomRef the DOM ref to the external link
+			 * @param {string} sHref the url string
 			 * @private
 			 */
 			_addIconToExternalUrl: function (aDomRef, sHref) {
@@ -529,9 +529,9 @@ sap.ui.define([
 			 * 3) The first seven symbols from the ID used in the Demo Kit URLs are added at the end
 			 * 4) The file type is added at the end “.md”
 			 *
-			 * @param sUrl, the url of the file in the internal repo
-			 * @param sTitle, the title of the file
-			 * @returns {string}, the url of the file in the GitHub repo
+			 * @param {string} sUrl the url of the file in the internal repo
+			 * @param {string} sTitle the title of the file
+			 * @returns {string} the url of the file in the GitHub repo
 			 * @private
 			 */
 			_formatToGitHubUrl: function(sUrl, sTitle) {