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

// Provides control sap.m.FlexBox.
sap.ui.define([
	'./FlexBoxStylingHelper',
	'./FlexItemData',
	'./library',
	'sap/ui/base/ManagedObjectObserver',
	'sap/ui/core/Control',
	'sap/ui/core/InvisibleRenderer',
	'./FlexBoxRenderer',
	'sap/ui/thirdparty/jquery'
],
function(
	FlexBoxStylingHelper,
	FlexItemData,
	library,
	ManagedObjectObserver,
	Control,
	InvisibleRenderer,
	FlexBoxRenderer,
	jQuery
) {
	"use strict";

	// shortcut for sap.m.BackgroundDesign
	var BackgroundDesign = library.BackgroundDesign;

	// shortcut for sap.m.FlexAlignContent
	var FlexAlignContent = library.FlexAlignContent;

	// shortcut for sap.m.FlexWrap
	var FlexWrap = library.FlexWrap;

	// shortcut for sap.m.FlexAlignItems
	var FlexAlignItems = library.FlexAlignItems;

	// shortcut for sap.m.FlexJustifyContent
	var FlexJustifyContent = library.FlexJustifyContent;

	// shortcut for sap.m.FlexRendertype
	var FlexRendertype = library.FlexRendertype;

	// shortcut for sap.m.FlexDirection
	var FlexDirection = library.FlexDirection;

	/**
	 * Constructor for a new <code>sap.m.FlexBox</code>.
	 *
	 * @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
	 * The <code>sap.m.FlexBox</code> control builds the container for a flexible box layout.<br>
	 * <br>
	 * <b>Note:</b> Be sure to check the <code>renderType</code> setting to avoid issues due to browser inconsistencies.
	 *
	 * @extends sap.ui.core.Control
	 *
	 * @author SAP SE
	 * @version 1.108.49
	 *
	 * @public
	 * @alias sap.m.FlexBox
	 * @see https://www.w3.org/TR/css-flexbox-1/
	 * @see https://www.w3schools.com/css/css3_flexbox.asp
	 * @see {@link topic:674890e6d8534eaba2eaf63242e077eb Flex Box}
	 */
	var FlexBox = Control.extend("sap.m.FlexBox", /** @lends sap.m.FlexBox.prototype */ {
		metadata : {

			library : "sap.m",
			properties : {

				/**
				 * The height of the <code>sap.m.FlexBox</code>. Note that when a percentage is given, for the height to work as expected, the height of the surrounding container must be defined.
				 * @since 1.9.1
				 */
				height : {type : "sap.ui.core.CSSSize", group : "Dimension", defaultValue : ''},

				/**
				 * The width of the <code>sap.m.FlexBox</code>. Note that when a percentage is given, for the width to work as expected, the width of the surrounding container must be defined.
				 * @since 1.9.1
				 */
				width : {type : "sap.ui.core.CSSSize", group : "Dimension", defaultValue : ''},

				/**
				 * Determines whether the <code>sap.m.FlexBox</code> is in block or inline mode.
				 *
				 * @see http://www.w3.org/TR/css-flexbox-1/#flex-containers
				 */
				displayInline : {type : "boolean", group : "Appearance", defaultValue : false},

				/**
				 * Determines the direction of the layout of child elements.
				 *
				 * @see http://www.w3.org/TR/css-flexbox-1/#flex-direction-property
				 */
				direction : {type : "sap.m.FlexDirection", group : "Appearance", defaultValue : FlexDirection.Row},

				/**
				 * Determines whether the <code>sap.m.FlexBox</code> will be sized to completely fill its container. If the <code>sap.m.FlexBox</code> is inserted into a Page, the property 'enableScrolling' of the Page needs to be set to 'false' for the FlexBox to fit the entire viewport.
				 */
				fitContainer : {type : "boolean", group : "Appearance", defaultValue : false},

				/**
				 * Determines whether the layout is rendered as a series of divs or as an unordered list (ul).<br>
				 * <br>
				 * We recommend to use <code>Bare</code> in most cases to avoid layout issues due to browser inconsistencies.
				 */
				renderType : {type : "sap.m.FlexRendertype", group : "Misc", defaultValue : FlexRendertype.Div},

				/**
				 * Determines the layout behavior along the main axis.
				 *
				 * @see http://www.w3.org/TR/css-flexbox-1/#justify-content-property
				 */
				justifyContent : {type : "sap.m.FlexJustifyContent", group : "Appearance", defaultValue : FlexJustifyContent.Start},

				/**
				 * Determines the layout behavior of items along the cross-axis.
				 *
				 * @see http://www.w3.org/TR/css-flexbox-1/#align-items-property
				 */
				alignItems : {type : "sap.m.FlexAlignItems", group : "Appearance", defaultValue : FlexAlignItems.Stretch},

				/**
				 * Determines the wrapping behavior of the flex container. This property has no effect in older browsers, e.g. Android Native 4.3 and below.
				 *
				 * @see http://www.w3.org/TR/css-flexbox-1/#flex-wrap-property
				 *
				 * @since 1.36.0
				 */
				wrap : {type : "sap.m.FlexWrap", group : "Appearance", defaultValue : FlexWrap.NoWrap},

				/**
				 * Determines the layout behavior of container lines when there's extra space along the cross-axis.
				 *
				 * @see http://www.w3.org/TR/css-flexbox-1/#align-content-property
				 *
				 * @since 1.36.0
				 */
				alignContent : {type : "sap.m.FlexAlignContent", group : "Appearance", defaultValue : FlexAlignContent.Stretch},

				/**
				 * Defines the background style of the <code>sap.m.FlexBox</code>.
				 *
				 * @since 1.38.5
				 */
				backgroundDesign: {type: "sap.m.BackgroundDesign", group: "Appearance", defaultValue: BackgroundDesign.Transparent}
			},
			defaultAggregation : "items",
			aggregations : {

				/**
				 * Flex items within the flexible box layout
				 */
				items : {type : "sap.ui.core.Control", multiple : true, singularName : "item"}
			},
			designtime: "sap/m/designtime/FlexBox.designtime",
			dnd: { draggable: false, droppable: true }
		},

		renderer: FlexBoxRenderer
	});

	/**
	 * Initializes the control.
	 */
	FlexBox.prototype.init = function() {
		this._oItemDelegate = {
			onAfterRendering: this._onAfterItemRendering
		};

		this._oItemsObserver = new ManagedObjectObserver(this._onItemsChange.bind(this));
		this._oItemsObserver.observe(this, { aggregations: ["items"] });
	};

	FlexBox.prototype.exit = function() {
		if (this._oItemsObserver) {
			this._oItemsObserver.disconnect();
			this._oItemsObserver = null;
		}
	};

	FlexBox.prototype._onItemsChange = function(oChanges) {
		if (oChanges.name === "items" && oChanges.child) {
			if (oChanges.mutation === "insert") {
				this._onItemInserted(oChanges.child);
			} else if (oChanges.mutation === "remove") {
				this._onItemRemoved(oChanges.child);
			}
		} else if (oChanges.name === "visible") {
			this._onItemVisibilityChange(oChanges);
		}
	};

	/**
	 * Helper that gets called when new item is inserted into items aggregation.
	 *
	 * @private
	 * @param {object} oItem Inserted item.
	 */
	FlexBox.prototype._onItemInserted = function(oItem) {
		if (oItem && !(oItem instanceof FlexBox)) {
			this._oItemsObserver.observe(oItem, { properties: ["visible"] });

			if (this.getRenderType() === FlexRendertype.Bare) {
				oItem.addEventDelegate(this._oItemDelegate, oItem);
			}
		}
	};

	/**
	 * Helper that gets called when an item is removed from items aggregation.
	 *
	 * @private
	 * @param {object} oItem Removed item.
	 */
	FlexBox.prototype._onItemRemoved = function(oItem) {
		if (oItem && !(oItem instanceof FlexBox)) {
			this._oItemsObserver.unobserve(oItem, { properties: ["visible"] });

			if (this.getRenderType() === FlexRendertype.Bare) {
				oItem.removeEventDelegate(this._oItemDelegate, oItem);
			}
		}
	};

	/**
	 * Helper that gets called when an item visibility is changed.
	 * Syncs the visibility of flex item wrapper, if visibility changes.
	 *
	 * @private
	 */
	FlexBox.prototype._onItemVisibilityChange = function(oChanges) {
		var oItem = oChanges.object,
			$wrapper;

		// Early return conditions
		if (this.getRenderType() !== FlexRendertype.List &&
			this.getRenderType() !== FlexRendertype.Div) {
			return;
		}

		if (oItem.getLayoutData()) {
			$wrapper = jQuery(document.getElementById(oItem.getLayoutData().getId()));
		} else {
			$wrapper = jQuery(document.getElementById(InvisibleRenderer.createInvisiblePlaceholderId(oItem))).parent();
		}

		if (oChanges.current) {
			$wrapper.removeClass("sapUiHiddenPlaceholder").removeAttr("aria-hidden");
		} else {
			$wrapper.addClass("sapUiHiddenPlaceholder").attr("aria-hidden", "true");
		}
	};

	/**
	 * Gets called after an item is (re)rendered.
	 * Here <code>this</code> points to the control, not to the FlexBox.
	 *
	 * @private
	 */
	FlexBox.prototype._onAfterItemRendering = function() {
		var oLayoutData = this.getLayoutData();
		if (oLayoutData instanceof FlexItemData) {
			FlexBoxStylingHelper.setFlexItemStyles(null, oLayoutData);
		}
	};

	/**
	 * Sets the render type of the FlexBox.
	 *
	 * @public
	 * @param {string} sValue Render type in string format.
	 * @returns {this} <code>this</code> FlexBox reference for chaining.
	 */
	FlexBox.prototype.setRenderType = function(sValue) {
		var sOldValue = this.getRenderType(),
			aItems = this.getItems();

		if (sValue === sOldValue) {
			return this;
		}

		this.setProperty("renderType", sValue);

		if (sOldValue === "Bare") {
			aItems.forEach(this._onItemRemoved, this);
		}

		if (sValue === "Bare") {
			aItems.forEach(this._onItemInserted, this);
		}

		return this;
	};

	/**
	 * Gets the accessibility information.
	 *
	 * @protected
	 * @returns {object} The accessibility information.
	 * @see sap.ui.core.Control#getAccessibilityInfo
	 */
	FlexBox.prototype.getAccessibilityInfo = function() {
		return {children: this.getItems()};
	};

	return FlexBox;
});