fit-ui 2.12.2 → 2.12.4

package/dist/Fit.UI.js

@@ -682,7 +682,7 @@ Fit._internal =
 {
 	Core:
 	{
-		VersionInfo: { Major: 2, Minor: 12, Patch: 2 } // Do NOT modify format - version numbers are programmatically changed when releasing new versions - MUST be on a separate line!
+		VersionInfo: { Major: 2, Minor: 12, Patch: 4 } // Do NOT modify format - version numbers are programmatically changed when releasing new versions - MUST be on a separate line!
 	}
 };
 
@@ -21072,7 +21072,7 @@ Fit.Controls.WSDropDown = function(ctlId)
 		return list.JsonpCallback();
 	}
 
-	/// <function container="Fit.Controls.WSDropDownTypeDefs" name="ClearDataCallback">
+	/// <function container="Fit.Controls.WSDropDownTypeDefs" name="DataCallback">
 	/// 	<description> Event handler </description>
 	/// 	<param name="sender" type="$TypeOfThis"> Instance of control </param>
 	/// </function>
@@ -21084,54 +21084,39 @@ Fit.Controls.WSDropDown = function(ctlId)
 	/// 		Operation may be postponed if data is currently loading from WebService.
 	/// 		Use callback to pick up execution once data has been cleared.
 	/// 		Sender (Fit.Controls.WSDropDown) is passed to callback as an argument.
+	/// 		To make sure data reloads immediate, please use ReloadData(..) instead.
 	/// 	</description>
-	/// 	<param name="cb" type="Fit.Controls.WSDropDownTypeDefs.ClearDataCallback" default="undefined">
+	/// 	<param name="cb" type="Fit.Controls.WSDropDownTypeDefs.DataCallback" default="undefined">
 	/// 		If defined, callback is invoked when data is cleared
 	/// 	</param>
 	/// </function>
 	this.ClearData = function(cb)
 	{
-		Fit.Validation.ExpectFunction(cb, true);
-
-		// Postpone if WebService operation is currently running
-
-		if (requestCount > 0)
-		{
-			// Data is currently loading - postpone by adding request to process queue
-			onDataLoaded(function() { me.ClearData(cb); });
-			return;
-		}
-
-		// Clear data/cache/state
-
-		hideLinesForFlatData = true;	// Make TreeView hide helper lines if nodes received have no children
-		dataRequested = false;			// Make data in TreeView reload via ensureTreeViewData() when DropDown is opened
-		autoUpdatedSelections = null;	// Remove cached result from AutoUpdateSelected(..) used when multiple calls to the function is made
-
-		// Update action menu
-
-		// Update action menu in case "Show available options" has been disabled, which
-		// will be the case if the previous request returned no data. We need it enabled if
-		// action menu is enabled - otherwise the user won't be able to request updated data.
-		updateActionMenu();
-
-		// Cancel pending search operation if scheduled
-
-		cancelSearch();
-
-		// Invoke callback
-
-		if (Fit.Validation.IsSet(cb) === true)
-		{
-			cb(me);
-		}
-
-		// Immediately load TreeView data if DropDown is open and TreeView is active picker
+		clearData(true, true, cb);
+	}
 
-		if (me.IsDropDownOpen() === true && me.GetPicker() === tree)
+	/// <function container="Fit.Controls.WSDropDown" name="ReloadData" access="public">
+	/// 	<description>
+	/// 		Call this function to make control reload data immediately,
+	/// 		ensuring that the user will see the most recent values available.
+	/// 		Use callback to pick up execution once data has been loaded.
+	/// 		Sender (Fit.Controls.WSDropDown) is passed to callback as an argument.
+	/// 		To have data reload when needed (lazy loading), please use ClearData(..) instead.
+	/// 	</description>
+	/// 	<param name="cb" type="Fit.Controls.WSDropDownTypeDefs.DataCallback" default="undefined">
+	/// 		If defined, callback is invoked when data has been loaded
+	/// 	</param>
+	/// </function>
+	this.ReloadData = function(cb)
+	{
+		clearData(false, false, function() // false 1 = prevent clearData(..) from reloading data, false 2 = prevent action menu from updating to avoid flickering - done when data has been reloaded
 		{
-			ensureTreeViewData(); // Will not load anything if callback above triggered data load, e.g. by calling AutoUpdateSelected(..)
-		}
+			ensureTreeViewData(function()
+			{
+				updateActionMenu();
+				cb && cb(me);
+			});
+		});
 	}
 
 	this.MultiSelectionMode = Fit.Core.CreateOverride(this.MultiSelectionMode, function(val)
@@ -21490,9 +21475,9 @@ Fit.Controls.WSDropDown = function(ctlId)
 	// Private
 	// ============================================
 
-	function ensureTreeViewData(/*cb*/)
+	function ensureTreeViewData(cb)
 	{
-		//Fit.Validation.ExpectFunction(cb, true);
+		Fit.Validation.ExpectFunction(cb, true);
 
 		if (dataRequested === false)
 		{
@@ -21508,16 +21493,63 @@ Fit.Controls.WSDropDown = function(ctlId)
 				// calls updateActionMenu(..) which relies on this flag.
 				showActionMenuIfNoDataReceivedOrOnFirstInteractionIfEnabled();
 
-				/*if (Fit.Validation.IsSet(cb) === true)
+				if (Fit.Validation.IsSet(cb) === true)
 				{
 					cb(me);
-				}*/
+				}
 
 				fireOnDataLoaded();
 			});
 		}
 	}
 
+	function clearData(allowImmediateReload, refreshActionMenu, cb)
+	{
+		Fit.Validation.ExpectBoolean(allowImmediateReload);
+		Fit.Validation.ExpectBoolean(refreshActionMenu);
+		Fit.Validation.ExpectFunction(cb, true);
+
+		// Postpone if WebService operation is currently running
+
+		if (requestCount > 0)
+		{
+			// Data is currently loading - postpone by adding request to process queue
+			onDataLoaded(function() { me.ClearData(cb); });
+			return;
+		}
+
+		// Clear data/cache/state
+
+		hideLinesForFlatData = true;	// Make TreeView hide helper lines if nodes received have no children
+		dataRequested = false;			// Make data in TreeView reload via ensureTreeViewData() when DropDown is opened
+		autoUpdatedSelections = null;	// Remove cached result from AutoUpdateSelected(..) used when multiple calls to the function is made
+
+		// Update action menu
+
+		// Update action menu in case "Show available options" has been disabled, which
+		// will be the case if the previous request returned no data. We need it enabled if
+		// action menu is enabled - otherwise the user won't be able to request updated data.
+		refreshActionMenu && updateActionMenu();
+
+		// Cancel pending search operation if scheduled
+
+		cancelSearch();
+
+		// Invoke callback
+
+		if (Fit.Validation.IsSet(cb) === true)
+		{
+			cb(me);
+		}
+
+		// Immediately load TreeView data if DropDown is open and TreeView is active picker
+
+		if (allowImmediateReload === true && me.IsDropDownOpen() === true && me.GetPicker() === tree)
+		{
+			ensureTreeViewData(); // Will not load anything if callback above triggered data load, e.g. by calling AutoUpdateSelected(..)
+		}
+	}
+
 	function showActionMenuIfNoDataReceivedOrOnFirstInteractionIfEnabled()
 	{
 		// If no data is returned and DropDown is in TextSelectionMode, the user will