fit-ui 2.4.1 → 2.5.0

package/dist/Fit.UI.css

@@ -3851,6 +3851,13 @@ div.FitUiControlDropDown[data-selectionmodetoggle="true"]
 {
 	margin-right: 2em;
 }
+
+/* WSDropDown: Action Menu (ListView) */
+
+div.FitUiControlDropDown span.FitUiControlDropDownActionMenuItemDelete
+{
+	color: #DB1E1E;
+}
 /* Modern control (default) */
 
 div.FitUiControlFilePicker[data-legacy="false"] input
@@ -4106,7 +4113,7 @@ div.FitUiControlListView > div /* List item */
 	white-space: nowrap;
 }
 
-div.FitUiControlListView > div:hover
+div.FitUiControlListView[data-device="Desktop"] > div:hover
 {
 	background-color: #DADADA; /*#C3D9E0*/
 	cursor: pointer;

package/dist/Fit.UI.js

@@ -648,7 +648,7 @@ Fit._internal =
 {
 	Core:
 	{
-		VersionInfo: { Major: 2, Minor: 4, Patch: 1 } // Do NOT modify format - version numbers are programmatically changed when releasing new versions - MUST be on a separate line!
+		VersionInfo: { Major: 2, Minor: 5, Patch: 0 } // Do NOT modify format - version numbers are programmatically changed when releasing new versions - MUST be on a separate line!
 	}
 };
 
@@ -3048,6 +3048,8 @@ Fit.Controls.Component = function(controlId)
 		container = document.createElement("div");
 		container.id = id;
 		container._internal = { Instance: me };
+
+		Fit.Dom.Data(container, "device", ((Fit.Browser.GetInfo().IsMobile === false) ? "Desktop" : (Fit.Browser.GetInfo().IsPhone === true) ? "Phone" : "Tablet"));
 	}
 
 	/// <function container="Fit.Controls.Component" name="GetId" access="public" returns="string">
@@ -3278,8 +3280,6 @@ Fit.Controls.ControlBase = function(controlId)
 		me._internal.Data("dirty", "false");
 		me._internal.Data("enabled", "true");
 
-		me._internal.Data("device", ((Fit.Browser.GetInfo().IsMobile === false) ? "Desktop" : (Fit.Browser.GetInfo().IsPhone === true) ? "Phone" : "Tablet"));
-
 		// Add hidden inputs which are automatically populated with
 		// control value and state information when control is updated.
 
@@ -15924,8 +15924,15 @@ Fit.Controls.DropDown = function(ctlId)
 			{
 				var target = Fit.Events.GetTarget(e);
 
+				if (target !== document.documentElement && target !== document.body && Fit.Dom.IsRooted(target) === false)
+				{
+					return; // Do not close DropDown if target no longer exists - this may happen if something is removed within DropDown (e.g. an item in the WSDropDown's action menu)
+				}
+
 				if (me.IsDropDownOpen() === true && target !== me.GetDomElement() && Fit.Dom.Contained(me.GetDomElement(), target) === false)
+				{
 					me.CloseDropDown();
+				}
 			});
 			Fit.Array.Add(closeHandlers, eventId);
 		}
@@ -15942,6 +15949,11 @@ Fit.Controls.DropDown = function(ctlId)
 
 				coords = null;
 
+				if (target !== document.documentElement && target !== document.body && Fit.Dom.IsRooted(target) === false)
+				{
+					return; // Do not close DropDown if target no longer exists - this may happen if something is removed within DropDown (e.g. an item in the WSDropDown's action menu)
+				}
+
 				if (me.IsDropDownOpen() === true && target !== me.GetDomElement() && Fit.Dom.Contained(me.GetDomElement(), target) === false)
 				{
 					coords = Fit.Events.GetPointerState().Coordinates.Document;
@@ -16532,6 +16544,19 @@ Fit.Controls.DropDown = function(ctlId)
 				if (txt.parentElement.parentElement === null)
 					txt = txtPrimary;
 			}
+			else
+			{
+				// User selected an item which is already selected
+
+				if (me.TextSelectionMode() === true)
+				{
+					updateTextSelection(); // Make sure any search value is removed and text selection is restored
+				}
+				else
+				{
+					me.ClearInput(); // Make sure any search value is removed
+				}
+			}
 
 			// DISABLED: Now handled using picker.OnFocus(..) handler further down - see https://github.com/Jemt/Fit.UI/issues/86 for details
 			// if (eventArgs.ProgrammaticallyChanged === false && (isMobile === false || focusInputOnMobile === true))
@@ -17403,6 +17428,34 @@ Fit.Controls.DropDown = function(ctlId)
 		Fit.Array.Add(onCloseHandlers, cb);
 	}
 
+	// ============================================
+	// Protected
+	// ============================================
+
+	this._internal = (this._internal ? this._internal : {});
+
+	// Clear input field without firing OnInputChanged, and make placeholder appear
+	this._internal.ClearInputAndShowPlaceholder = function(forceFocusInput)
+	{
+		Fit.Validation.ExpectBoolean(forceFocusInput, true);
+
+		txtPrimary.value = "";
+		updatePlaceholder(true);
+
+		if (forceFocusInput)
+		{
+			// By default focus is never assigned to input on mobile if user opened the
+			// DropDown by clicking the arrow icon. ForceFocusInput allows us to ignore this
+			// aspect. On desktop the input field always remains focused  as it automatically
+			// steals back focus immediately after interacting with a picker control. See
+			// picker.OnFocusIn handler registered in SetPicker(..)
+			var orgFocusInputOnMobile = focusInputOnMobile;
+			focusInputOnMobile = true;
+			focusInput(txtActive);
+			focusInputOnMobile = orgFocusInputOnMobile;
+		}
+	}
+
 	// ============================================
 	// Private
 	// ============================================
@@ -18182,7 +18235,7 @@ Fit.Controls.DropDown = function(ctlId)
 
 		if (placeholder !== "" || force === true)
 		{
-			var setPlaceholder = placeholder !== "" && itemCollectionOrdered.length === 0 && me.GetInputValue() === "" && willAssumeInputValue !== true;
+			var setPlaceholder = placeholder !== "" && (me.TextSelectionMode() === true || itemCollectionOrdered.length === 0) && me.GetInputValue() === "" && willAssumeInputValue !== true;
 
 			Fit.Dom.Data(itemContainer, "placeholder", setPlaceholder === true ? placeholder : null);
 			Fit.Dom.Data(itemContainer, "placeholder-autoclear", setPlaceholder === true ? Fit.Browser.GetBrowser() === "MSIE" ? "true" : "false" : null);
@@ -18396,6 +18449,12 @@ Fit.Controls.DropDown = function(ctlId)
 			Fit.Dom.SetCaretPosition(txtPrimary, 0);
 		}
 
+		// Remove placeholder in case it was added using this._internal.ClearInputAndShowPlaceholder()
+
+		updatePlaceholder(true);
+
+		// Have TextSelection removed when input is changed
+
 		clearTextSelectionOnInputChange = true;
 	}
 
@@ -19027,6 +19086,7 @@ Fit.Controls.WSDropDown = function(ctlId)
 	var me = this;
 	var list = null;
 	var tree = null;
+	var actionMenu = null;
 
 	var search = "";
 	var forceNewSearch = false;
@@ -19040,6 +19100,9 @@ Fit.Controls.WSDropDown = function(ctlId)
 	var currentRequest = null;
 	var classes = null;
 	var autoUpdatedSelections = null; // Cached result from AutoUpdateSelected: [{ Title:string, Value:string, Exists:boolean }, ...]
+	var useActionMenu = false;
+	var useActionMenuForced = false;
+	var translations = null;
 
 	var onRequestHandlers = [];
 	var onResponseHandlers = [];
@@ -19155,6 +19218,22 @@ Fit.Controls.WSDropDown = function(ctlId)
 				{
 					fireOnDataLoaded();
 				}
+
+				// If no data is returned and DropDown is in TextSelectionMode, the user will
+				// not have an easy way to remove objects from the DropDown, unless SelectionModeToggle
+				// is true. Therefore we allow for items to be removed using an action menu.
+				// EDIT: Now displays action menu in both Visual and Text Selection Mode for consistency.
+
+				if (useActionMenuForced === false)
+				{
+					useActionMenu = eventArgs.Children.length === 0;
+				}
+
+				if (/*me.TextSelectionMode() === true &&*/ useActionMenu === true)
+				{
+					updateActionMenu();
+					me.SetPicker(actionMenu);
+				}
 			}
 		});
 		tree.OnAbort(function(sender, eventArgs)
@@ -19245,6 +19324,104 @@ Fit.Controls.WSDropDown = function(ctlId)
 				me.SetPicker(tree);
 		});
 
+		// Create action menu
+
+		var skipUpdateActionMenuOnChange = false;
+
+		actionMenu = new Fit.Controls.ListView(ctlId + "__ActionsListView");
+		actionMenu.OnSelect(function(sender, item) // Using OnSelect instead of OnItemSelectionChanging since DropDown fires OnItemSelectionChanging when selection is changed, which would result in OnItemSelectionChanging being executed multiple times
+		{
+			if (item.Value === "SearchMore")
+			{
+				me._internal.ClearInputAndShowPlaceholder(true); // NOTICE: TextSelectionMode only - Visual Selection Mode cannot be temporarily cleared to display the place holder
+			}
+			else if (item.Value === "ShowAll")
+			{
+				me.SetPicker(tree);
+			}
+			else if (item.Value === "RemoveAll")
+			{
+				skipUpdateActionMenuOnChange = true;
+				me.ClearSelections(); // Fires OnChange
+				skipUpdateActionMenuOnChange = false;
+
+				updateActionMenu(); // Update action menu (remove all "Remove: xyz" options)
+			}
+			else if (item.Value.indexOf("Remove:") === 0)
+			{
+				var dataValue = item.Value.replace("Remove:", "");
+
+				// Find item below if using keyboard to remove item
+
+				var above = null;
+				var below = null;
+
+				if (Fit.Browser.GetInfo().IsMobile === false && Fit.Events.GetPointerState().Buttons.Primary === false) // Do not find and highlight item below on touch devices, or if using the mouse
+				{
+					var items = actionMenu.GetItems();
+					var stopNext = false;
+
+					for (var i = 0 ; i < items.length ; i++)
+					{
+						if (items[i].Value.indexOf("Remove:") !== 0)
+						{
+							continue; // Skip items that do not remove individual selections
+						}
+
+						if (items[i].Value.replace("Remove:", "") === dataValue)
+						{
+							stopNext = true;
+							continue;
+						}
+
+						if (stopNext === false)
+						{
+							above = items[i].Value;
+						}
+						else
+						{
+							below = items[i].Value;
+							break;
+						}
+					}
+				}
+
+				// Remove item
+
+				skipUpdateActionMenuOnChange = true;
+				me.RemoveSelection(dataValue); // Fires OnChange
+				skipUpdateActionMenuOnChange = false;
+
+				// Update list of removable items
+
+				actionMenu.RemoveItem(item.Value);
+
+				if (me.GetSelections().length === 1)
+				{
+					updateActionMenu(); // Update action menu to get rid of "Remove all" item when only one item is left
+				}
+
+				// Highlight item below (or above) the item that was just removed
+
+				if (above !== null || below !== null)
+				{
+					actionMenu.RevealItemInView(below !== null ? below : above);
+				}
+			}
+
+			return false; // Prevent selection of behavioural item
+		});
+
+		me.OnChange(function(sender)
+		{
+			if (skipUpdateActionMenuOnChange === false)
+			{
+				updateActionMenu();
+			}
+		});
+
+		// Misc
+
 		me.OnOpen(function()
 		{
 			if (suppressTreeOnOpen === true)
@@ -19253,9 +19430,19 @@ Fit.Controls.WSDropDown = function(ctlId)
 				return;
 			}
 
-			me.SetPicker(tree);
-			ensureTreeViewData();
+			if (useActionMenu === true)
+			{
+				me.SetPicker(actionMenu);
+			}
+			else
+			{
+				me.SetPicker(tree);
+				ensureTreeViewData();
+			}
 		});
+
+		Fit.Internationalization.OnLocaleChanged(localize);
+		localize();
 	}
 
 	// ============================================
@@ -19480,7 +19667,6 @@ Fit.Controls.WSDropDown = function(ctlId)
 		return base(val);
 	});
 
-
 	/// <function container="Fit.Controls.WSDropDown" name="GetListView" access="public" returns="Fit.Controls.WSListView">
 	/// 	<description> Get WSListView control used to display data in a flat list view </description>
 	/// </function>
@@ -19497,6 +19683,44 @@ Fit.Controls.WSDropDown = function(ctlId)
 		return tree;
 	}
 
+	/// <function container="Fit.Controls.WSDropDown" name="UseActionMenu" access="public">
+	/// 	<description> Get/set value indicating whether control uses the built-in action menu to ease addition and removal of items </description>
+	/// 	<param name="val" type="boolean" default="undefined"> If defined, True enables the action menu, False disables it </param>
+	/// </function>
+	this.UseActionMenu = function(val)
+	{
+		Fit.Validation.ExpectBoolean(val, true);
+
+		if (Fit.Validation.IsSet(val) === true)
+		{
+			useActionMenuForced = true;
+
+			if (val !== useActionMenu)
+			{
+				useActionMenu = val;
+
+				if (val === true)
+				{
+					updateActionMenu();
+
+					if (me.IsDropDownOpen() === true)
+					{
+						me.SetPicker(actionMenu);
+					}
+				}
+				else
+				{
+					if (me.GetPicker() === actionMenu)
+					{
+						me.SetPicker(tree.GetChildren().length > 0 ? tree : list);
+					}
+				}
+			}
+		}
+
+		return useActionMenu;
+	}
+
 	// See documentation on ControlBase
 	this.Dispose = Fit.Core.CreateOverride(this.Dispose, function()
 	{
@@ -19504,10 +19728,13 @@ Fit.Controls.WSDropDown = function(ctlId)
 
 		list.Destroy();
 		tree.Destroy();
+		actionMenu.Destroy();
 
 		cancelSearch();
 
-		me = list = tree = search = forceNewSearch = hideLinesForFlatData = dataRequested = dataLoading = requestCount = onDataLoadedCallback = suppressTreeOnOpen = timeOut = currentRequest = classes = autoUpdatedSelections = onRequestHandlers = onResponseHandlers = null;
+		Fit.Internationalization.RemoveOnLocaleChanged(localize);
+
+		me = list = tree = actionMenu = search = forceNewSearch = hideLinesForFlatData = dataRequested = dataLoading = requestCount = onDataLoadedCallback = suppressTreeOnOpen = timeOut = currentRequest = classes = autoUpdatedSelections = useActionMenu = useActionMenuForced = translations = onRequestHandlers = onResponseHandlers = null;
 
 		base();
 	});
@@ -19698,6 +19925,48 @@ Fit.Controls.WSDropDown = function(ctlId)
 		}
 	}
 
+	function updateActionMenu()
+	{
+		if (useActionMenu === false)
+		{
+			return;
+		}
+
+		var searchIcon = "<span class='FitUiControlDropDownActionMenuItem FitUiControlDropDownActionMenuItemSearch fa fa-search'></span> ";
+		var showAllIcon = "<span class='FitUiControlDropDownActionMenuItem FitUiControlDropDownActionMenuItemShowAll fa fa-sitemap'></span> ";
+		var delIcon = "<span class='FitUiControlDropDownActionMenuItem FitUiControlDropDownActionMenuItemDelete fa fa-times'></span> ";
+
+		var selectedItems = me.GetSelections();
+		var addRemoveAll = selectedItems.length > 1;
+
+		actionMenu.RemoveItems();
+
+		actionMenu.AddItem(searchIcon + translations.SearchMore, "SearchMore");
+
+		if (dataRequested === false || tree.GetChildren().length > 0)
+		{
+			actionMenu.AddItem(showAllIcon + translations.ShowAllOptions, "ShowAll");
+		}
+
+		if (addRemoveAll === true)
+		{
+			actionMenu.AddItem(delIcon + translations.RemoveAll, "RemoveAll");
+		}
+
+		Fit.Array.ForEach(selectedItems, function(item)
+		{
+			actionMenu.AddItem((addRemoveAll === true ? " &nbsp; &nbsp; &nbsp; " : "") + delIcon + translations.Remove + " " + item.Title, "Remove:" + item.Value);
+		});
+	}
+
+	function localize()
+	{
+		var locale = Fit.Internationalization.GetLocale(me);
+		translations = locale.Translations;
+
+		updateActionMenu();
+	}
+
 	function onDataLoaded(cb)
 	{
 		Fit.Validation.ExpectFunction(cb);
@@ -19775,31 +20044,46 @@ Fit.Controls.WSDropDown = function(ctlId)
 		// All locales inherit from en. All country specific overrides inherit
 		// from their primary locale (e.g. de_AT inherits from de).
 		// English (en) MUST be defined!
-		
+
 		"en": // US
 		{
 			Translations:
 			{
-				InvalidSelection		: "Invalid selection"
+				InvalidSelection		: "Invalid selection",
+
+				SearchMore				: "Search for more options",
+				ShowAllOptions			: "Show all available options",
+				RemoveAll				: "Remove all selected",
+				Remove					: "Remove"
 			}
 		},
 		"da":
 		{
 			Translations:
 			{
-				InvalidSelection		: "Ugyldigt valg"
+				InvalidSelection		: "Ugyldigt valg",
+
+				SearchMore				: "Søg efter flere valgmuligheder",
+				ShowAllOptions			: "Vis alle tilgængelige valgmuligheder",
+				RemoveAll				: "Fjern alle valgte",
+				Remove					: "Fjern"
 			}
 		},
 		"de":
 		{
 			Translations:
 			{
-				InvalidSelection		: "Ungültige Auswahl"
+				InvalidSelection		: "Ungültige Auswahl",
+
+				SearchMore				: "Nach weiteren Optionen suchen",
+				ShowAllOptions			: "Alle verfügbaren Optionen anzeigen",
+				RemoveAll				: "Alle ausgewählten entfernen",
+				Remove					: "Entfernen"
 			}
 		}
 	}
 	Fit.Internationalization.AddLocalization(Fit.Controls.DropDown, locale);
-	Fit.Internationalization.AddLocalization(Fit.Controls.WSDropDown, locale);	
+	Fit.Internationalization.AddLocalization(Fit.Controls.WSDropDown, locale);
 })();
 /// <container name="Fit.Controls.FilePicker" extends="Fit.Controls.ControlBase">
 /// 	Control allowing for files to be selected locally and uploaded asynchronously.
@@ -22710,6 +22994,9 @@ Fit.Controls.ListView = function(controlId)
 	var firstWasHighlighted = false;
 	var isIe8 = (Fit.Browser.GetInfo().Name === "MSIE" && Fit.Browser.GetInfo().Version === 8);
 
+	var onSelectHandlers = [];
+	var onSelectedHandlers = [];
+
 	function init()
 	{
 		list.tabIndex = "0";
@@ -22763,12 +23050,17 @@ Fit.Controls.ListView = function(controlId)
 
 			// Fire OnChanging and OnChange events
 
+			var item = convertItemElementToObject(elm);
+			var selectionCanceled = fireOnSelectHandlers(item) === false;
+
 			// Notice: We always pass False as current selection state to OnItemSelectionChanging since ListView does
 			// not keep track of selection state. In theory item could very well already be selected in host control.
 			// Event handlers should not trust boolean to reveal selection in host control, only in picker.
-			if (me._internal.FireOnItemSelectionChanging(Fit.Dom.Text(elm), decode(Fit.Dom.Data(elm, "value")), false, false) === true)
+			if (selectionCanceled === false && me._internal.FireOnItemSelectionChanging(item.Title, item.Value, false, false) === true)
 			{
-				me._internal.FireOnItemSelectionChanged(Fit.Dom.Text(elm), decode(Fit.Dom.Data(elm, "value")), true, false);
+				fireOnSelectedHandlers(item);
+
+				me._internal.FireOnItemSelectionChanged(item.Title, item.Value, true, false);
 				me._internal.FireOnItemSelectionComplete();
 			}
 		}
@@ -22888,6 +23180,21 @@ Fit.Controls.ListView = function(controlId)
 		return null;
 	}
 
+	/// <function container="Fit.Controls.ListView" name="GetItems" access="public" returns="Fit.Controls.ListViewTypeDefs.ListViewItem[]">
+	/// 	<description> Get all items - returns array containing objects with Title (string) and Value (string) properties </description>
+	/// </function>
+	this.GetItems = function()
+	{
+		var items = [];
+
+		Fit.Array.ForEach(list.children, function(child)
+		{
+			Fit.Array.Add(items, convertItemElementToObject(child));
+		});
+
+		return items;
+	}
+
 	/// <function container="Fit.Controls.ListView" name="HasItem" access="public" returns="boolean">
 	/// 	<description> Returns value indicating whether control contains item with specified value </description>
 	/// 	<param name="value" type="string"> Value of item to check for </param>
@@ -22911,6 +23218,11 @@ Fit.Controls.ListView = function(controlId)
 		if (item !== null)
 		{
 			Fit.Dom.Remove(item);
+
+			if (item === active)
+			{
+				active = null;
+			}
 		}
 	}
 
@@ -22974,12 +23286,17 @@ Fit.Controls.ListView = function(controlId)
 
 				if (active !== null)
 				{
+					var item = convertItemElementToObject(active);
+					var selectionCanceled = fireOnSelectHandlers(item) === false;
+
 					// Notice: We always pass False as current selection state to OnItemSelectionChanging since ListView does
 					// not keep track of selection state. In theory item could very well already be selected in host control.
 					// Event handlers should not trust boolean to reveal selection in host control, only in picker.
-					if (me._internal.FireOnItemSelectionChanging(Fit.Dom.Text(active), decode(Fit.Dom.Data(active, "value")), false, false) === true)
+					if (selectionCanceled === false && me._internal.FireOnItemSelectionChanging(item.Title, item.Value, false, false) === true)
 					{
-						me._internal.FireOnItemSelectionChanged(Fit.Dom.Text(active), decode(Fit.Dom.Data(active, "value")), true, false);
+						fireOnSelectedHandlers(item);
+
+						me._internal.FireOnItemSelectionChanged(item.Title, item.Value, true, false);
 						me._internal.FireOnItemSelectionComplete();
 					}
 				}
@@ -23038,6 +23355,47 @@ Fit.Controls.ListView = function(controlId)
 		return highlightFirst;
 	}
 
+	/// <function container="Fit.Controls.ListViewTypeDefs" name="OnSelectEventHandler" returns="boolean | void">
+	/// 	<description> OnSelect event handler </description>
+	/// 	<param name="sender" type="$TypeOfThis"> Instance of control </param>
+	/// 	<param name="item" type="{ Title: string, Value: string }"> Selected item </param>
+	/// </function>
+
+	/// <function container="Fit.Controls.ListView" name="OnSelect" access="public">
+	/// 	<description>
+	/// 		Register event handler fired when item is being selected.
+	/// 		Selection can be canceled by returning False.
+	/// 		The following arguments are passed to event handler function:
+	/// 		Sender (ListView) and Item (with Title (string) and Value (string) properties).
+	/// 	</description>
+	/// 	<param name="cb" type="Fit.Controls.ListViewTypeDefs.OnSelectEventHandler"> Event handler function </param>
+	/// </function>
+	this.OnSelect = function(cb)
+	{
+		Fit.Validation.ExpectFunction(cb);
+		Fit.Array.Add(onSelectHandlers, cb);
+	}
+
+	/// <function container="Fit.Controls.ListViewTypeDefs" name="OnSelectedEventHandler">
+	/// 	<description> OnSelected event handler </description>
+	/// 	<param name="sender" type="$TypeOfThis"> Instance of control </param>
+	/// 	<param name="item" type="{ Title: string, Value: string }"> Selected item </param>
+	/// </function>
+
+	/// <function container="Fit.Controls.ListView" name="OnSelected" access="public">
+	/// 	<description>
+	/// 		Register event handler fired when item is selected.
+	/// 		The following arguments are passed to event handler function:
+	/// 		Sender (ListView) and Item (with Title (string) and Value (string) properties).
+	/// 	</description>
+	/// 	<param name="cb" type="Fit.Controls.ListViewTypeDefs.OnSelectedEventHandler"> Event handler function </param>
+	/// </function>
+	this.OnSelected = function(cb)
+	{
+		Fit.Validation.ExpectFunction(cb);
+		Fit.Array.Add(onSelectedHandlers, cb);
+	}
+
 	this.Destroy = Fit.Core.CreateOverride(this.Destroy, function(calledInternally)
 	{
 		Fit.Validation.ExpectBoolean(calledInternally, true);
@@ -23063,7 +23421,7 @@ Fit.Controls.ListView = function(controlId)
 			me.Destroy(true); // PickerBase.Destroy()
 		}
 
-		me = list = active = persistView = scrollPositionTop = highlightFirst = firstWasHighlighted = isIe8 = null;
+		me = list = active = persistView = scrollPositionTop = highlightFirst = firstWasHighlighted = isIe8 = onSelectHandlers = onSelectedHandlers = null;
 	});
 
 	// ============================================
@@ -23175,6 +23533,37 @@ Fit.Controls.ListView = function(controlId)
 		}
 	}
 
+	function fireOnSelectHandlers(item)
+	{
+		Fit.Validation.ExpectObject(item);
+		Fit.Validation.ExpectString(item.Title);
+		Fit.Validation.ExpectString(item.Value);
+
+		var selectionCanceled = false;
+
+		Fit.Array.ForEach(onSelectHandlers, function(handler)
+		{
+			if (handler(me, item) === false)
+			{
+				selectionCanceled = true;
+			}
+		});
+
+		return selectionCanceled === true ? false : true; // Return False if canceled
+	}
+
+	function fireOnSelectedHandlers(item)
+	{
+		Fit.Validation.ExpectObject(item);
+		Fit.Validation.ExpectString(item.Title);
+		Fit.Validation.ExpectString(item.Value);
+
+		Fit.Array.ForEach(onSelectedHandlers, function(handler)
+		{
+			handler(me, item);
+		});
+	}
+
 	function repaint()
 	{
 		if (isIe8 === true)