@openui5/sap.ui.mdc 1.93.3 → 1.96.2

package/src/sap/ui/mdc/valuehelp/Popover.js

@@ -0,0 +1,362 @@
+/*
+ * ! OpenUI5
+ * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+sap.ui.define([
+	'sap/ui/mdc/valuehelp/base/Container',
+	'sap/ui/mdc/util/loadModules',
+	"sap/ui/dom/units/Rem"
+], function(
+	Container,
+	loadModules,
+	Rem
+) {
+	"use strict";
+
+	var MPopover, MLibrary, Toolbar, ToolbarSpacer;
+
+	/**
+	 * Constructor for a new <code>Popover</code> container.
+	 *
+	 * @param {string} [sId] ID for the new control, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new control
+	 * @class Container for the <code>sap.ui.mdc.ValueHelp</code> element showing a popover.
+	 * @extends sap.ui.mdc.valuehelp.base.Container
+	 * @version 1.96.2
+	 * @constructor
+	 * @abstract
+	 * @private
+	 * @ui5-restricted sap.ui.mdc
+	 * @since 1.95.0
+	 * @alias sap.ui.mdc.valuehelp.Popover
+	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
+	 */
+	var Popover = Container.extend("sap.ui.mdc.valuehelp.Popover", /** @lends sap.ui.mdc.valuehelp.Popover.prototype */
+	{
+		metadata: {
+			library: "sap.ui.mdc",
+			interfaces: [
+				"sap.ui.mdc.valuehelp.ITypeaheadContainer",
+				"sap.ui.mdc.valuehelp.IDialogContainer"
+			],
+			properties: {
+			},
+			defaultAggregation: "content"
+		}
+	});
+
+	Popover.prototype.invalidate = function(oOrigin) {
+
+		if (oOrigin) {
+			var oPopover = this.getAggregation("_container");
+			var oContent = this._oCurrentContent;
+			if (oPopover && oContent && oOrigin === oContent && !this._bIsBeingDestroyed) {
+				// Content invalidated -> invalidate Popover to rerender content
+				oPopover.invalidate(oOrigin);
+			} else { // standard logic
+				Container.prototype.invalidate.apply(this, arguments);
+			}
+		}
+
+	};
+
+	Popover.prototype._getUIAreaForContent = function() {
+		// if List or Table needs to be rerendered because of a change the corresponding UIArea is the static-UIArea used in the Popover.
+		var oPopover = this.getAggregation("_container");
+		if (oPopover) {
+			return oPopover.getUIArea();
+		}
+
+		return Container.prototype._getUIAreaForContent.apply(this, arguments);
+
+	};
+
+	Popover.prototype._getContent = function () {
+		var oContent = this.getContent();
+		return oContent && oContent[0];
+	};
+
+	Popover.prototype._getContainer = function () {
+		var oPopover = this.getAggregation("_container");
+
+		if (!oPopover) {
+			return loadModules([
+				"sap/m/Popover",
+				"sap/m/library",
+				"sap/m/Toolbar",
+				"sap/m/ToolbarSpacer"
+			]).then(function (aLoaded) {
+				MPopover = aLoaded[0];
+				MLibrary = aLoaded[1];
+				Toolbar = aLoaded[2];
+				ToolbarSpacer = aLoaded[3];
+
+				oPopover = new MPopover(this.getId() + "-pop", {
+					contentHeight: "auto",
+					placement: MLibrary.PlacementType.VerticalPreferredBottom,
+					showHeader: false,
+					showArrow: false,
+					title: this.getTitle(),
+					titleAlignment: MLibrary.TitleAlignment.Center,
+					afterOpen: this._handleOpened.bind(this),
+					afterClose: this._handleClosed.bind(this)
+				}).addStyleClass("sapMdcValueHelpPopover").addStyleClass("sapMComboBoxBasePicker").addStyleClass("sapMComboBoxBasePicker-CTX"); // to have a ComboBox popup
+
+				oPopover.addStyleClass(this._isSingleSelect() ? "sapMdcValueHelpSingleSelect" : "sapMdcValueHelpMultiSelect");
+
+				oPopover.addDelegate({onsapshow: this._handleRequestSwitchToDialog.bind(this)});
+
+				oPopover._getAllContent = function() {
+					var oParent = this.getParent();
+					var aContent = [];
+					if (oParent) {
+						if (this._oCurrentContent) {
+							aContent.push(this._oCurrentContent);
+						}
+					}
+					return aContent;
+				}.bind(this);
+
+				var oContent = this._getContent();
+				var oContainerConfig = this._getContainerConfig(oContent);
+
+				if (oContainerConfig) {
+					oPopover.setShowArrow(!!oContainerConfig.showArrow);
+					oPopover.setShowHeader(!!oContainerConfig.showHeader);
+					oPopover.setResizable(!!oContainerConfig.resizable);
+
+					if (oContainerConfig.getContentWidth) {
+						oPopover.setContentWidth(oContainerConfig.getContentWidth());
+					}
+				}
+
+				this.setAggregation("_container", oPopover, true);
+				return oPopover;
+			}.bind(this));
+		}
+
+		return oPopover;
+	};
+
+	var _setContainerHeight = function () {
+		var oContainer = this.getAggregation("_container");
+		var oContent = this._getContent();
+		var oContainerConfig = oContent && this._getContainerConfig(oContent);
+		if (oContainer && oContainerConfig && oContainerConfig.getContentHeight) {
+			var iHeight = oContainerConfig.getContentHeight();
+			var iContainerHeight = oContainer.$().find(".sapMPopoverCont").height();
+			var bContainerHeightBelowLimit = iContainerHeight < Rem.toPx("30rem");
+			oContainer.setContentHeight(!iHeight || bContainerHeightBelowLimit || iContainerHeight >= iHeight ? "auto" : "30rem");
+			oContainer.invalidate(); // TODO: Better way? Popover does not always update correctly
+		}
+	};
+
+	Popover.prototype._observeChanges = function (oChanges) {
+		if (oChanges.name === "content") {
+			var oContent = oChanges.child;
+			if (oChanges.mutation === "remove") {
+				oContent.detachEvent("contentUpdated", _setContainerHeight, this);
+				oContent.detachNavigated(this._handleNavigated, this);
+			} else {
+				oContent.attachEvent("contentUpdated", _setContainerHeight, this); // TODO: put event in content interface ot check existance?
+			}
+		}
+		Container.prototype._observeChanges.apply(this, arguments);
+	};
+
+	Popover.prototype._placeContent = function (oPopover) {
+
+		var oContent = this._getContent();
+		var oContentPromise = oContent && oContent.getContent();
+		var oContainerConfig = this._getContainerConfig(oContent);
+		var oFooterContentPromise = oContainerConfig && oContainerConfig.getFooter && oContainerConfig.getFooter();
+
+		return Promise.all([oContentPromise, oFooterContentPromise]).then(function (aContents) {
+			this._oCurrentContent = aContents[0];
+			var oFooterContent = aContents[1];
+
+			if (oFooterContent && oPopover.getFooter() != oFooterContent && oFooterContent.isA && oFooterContent.isA("sap.m.Toolbar")) {
+				oPopover.setFooter(oFooterContent);
+				return oPopover;
+			}
+
+			if (oFooterContent) {
+				if (!oPopover.getFooter()) {
+					var aToolbarContent = [new ToolbarSpacer(this.getId() + "-Spacer")].concat(oFooterContent);
+					var oToolbar = new Toolbar(this.getId() + "-TB", {
+						content: aToolbarContent
+					}).setModel(this._oManagedObjectModel, "$help"); // TODO: ManagedObjectModel never created!!!
+					oPopover.setFooter(oToolbar);
+				} else {
+					// TODO: update Toolbar?
+				}
+			} else if (oPopover.getFooter()) {
+				oPopover.setFooter();
+			}
+			return oPopover;
+		}.bind(this));
+	};
+
+	Popover.prototype._open = function (oPopover) {
+		if (oPopover.isOpen()) {
+			return;
+		}
+
+		var oControl = this._getControl();
+		var oTarget = oControl && oControl.getFocusElementForValueHelp && oControl.getFocusElementForValueHelp(this.isTypeahead());
+
+		if (oTarget && oTarget.getDomRef()) {
+			oPopover.setContentMinWidth(jQuery(oTarget.getDomRef()).outerWidth() + "px");
+			if (!this.isFocusInHelp()) {
+				oPopover.setInitialFocus(oTarget);
+			}
+			oPopover.openBy(oTarget);
+		}
+	};
+
+	Popover.prototype._close = function () {
+
+		var oPopover = this.getAggregation("_container");
+		if (oPopover) {
+			oPopover.close();
+		}
+
+	};
+
+	Popover.prototype._handleOpened = function () {
+		_setContainerHeight.call(this);
+
+		Container.prototype._handleOpened.apply(this, arguments);
+
+		var oContent = this._getContent();
+
+		if (oContent) {
+			oContent.onShow();
+		}
+
+	};
+
+	Popover.prototype._handleConfirmed = function (oEvent) {
+		this.fireConfirm({close: oEvent.getParameter("close") || this._isSingleSelect()});
+	};
+
+	Popover.prototype._handleClosed = function (oEvent) {
+
+		var oContent = this._getContent();
+
+		if (oContent) {
+			oContent.onHide();
+		}
+
+		var oPopover = this.getAggregation("_container");
+		if (oPopover) {
+			oPopover._oPreviousFocus = null; // TODO - find real solution
+		}
+
+		Container.prototype._handleClosed.apply(this, arguments);
+	};
+
+	Popover.prototype.removeFocus = function() {
+		var oContent = this._getContent();
+		if (oContent) {
+			oContent.removeFocus();
+		}
+	};
+
+	Popover.prototype._navigate = function (iStep) {
+		var oContent = this._getContent();
+		if (oContent) {
+			return oContent.navigate(iStep);
+		}
+	};
+
+
+	Popover.prototype.getItemForValue = function(oConfig) {
+		var oContent = this._getContent();
+		if (oContent) {
+			return oContent.getItemForValue(oConfig);
+		}
+	};
+
+	Popover.prototype.isValidationSupported = function(oConfig) {
+		var oContent = this._getContent();
+		if (oContent) {
+			return oContent.isValidationSupported();
+		}
+	};
+
+	Popover.prototype.getUseAsValueHelp = function() {
+
+		var oContent = this._getContent();
+		return oContent && oContent.getUseAsValueHelp && oContent.getUseAsValueHelp();
+
+	};
+
+	Popover.prototype.getValueHelpIcon = function() {
+
+		// ask content for icon
+		var oContent = this._getContent();
+		return oContent && oContent.getValueHelpIcon();
+
+	};
+
+	Popover.prototype.getAriaAttributes = function(iMaxConditions) {
+
+		var oContent = this._getContent();
+		var oContentAttributes = oContent && oContent.getAriaAttributes(iMaxConditions);
+
+		if (oContentAttributes) {
+			return {
+				contentId: oContentAttributes.contentId,
+				ariaHasPopup: oContentAttributes.ariaHasPopup,
+				role: this.getUseAsValueHelp() ? "combobox" : null, // Popover is a ComboBox, but only if used as valuehelp, only typeahead has no role (see sap.m.Input)
+				roleDescription: oContentAttributes.roleDescription // for multiselect-mTable it needs to be set
+			};
+		}
+
+		return Container.prototype.getAriaAttributes.apply(this, arguments);
+
+	};
+
+	Popover.prototype.shouldOpenOnClick = function() {
+
+		var oContent = this._getContent();
+		return !!oContent && oContent.shouldOpenOnClick();
+
+	};
+
+	Popover.prototype.shouldOpenOnNavigate = function() {
+
+		var oContent = this._getContent();
+		return !!oContent && oContent.shouldOpenOnNavigate();
+
+	};
+
+	Popover.prototype.isFocusInHelp = function() {
+
+		var oContent = this._getContent();
+		return !!oContent && oContent.isFocusInHelp();
+
+	};
+
+	Popover.prototype.isMultiSelect = function() {
+
+		var oContent = this._getContent();
+		return !!oContent && oContent.isMultiSelect();
+
+	};
+
+	Popover.prototype.exit = function () {
+		if (this._oCurrentContent) {
+			if (!this._oCurrentContent.bIsDestroyed) {
+				this._oCurrentContent.destroy();
+			}
+			this._oCurrentContent = null;
+		}
+	};
+
+	return Popover;
+
+});