analytics/webcontent/prompting/CMultipleTextPicker.js

/*
 *+------------------------------------------------------------------------+
 *| Licensed Materials - Property of IBM
 *| BI and PM: prmt
 *| (C) Copyright IBM Corp. 2002, 2011
 *|
 *| US Government Users Restricted Rights - Use, duplication or
 *| disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
 *|
 *+------------------------------------------------------------------------+
*/


/*
	CMultipleTextPicker.js

	This script is used to provide interactivity for the
	multiple select textBox prompt component.  This component is
	a combination of the date picker and a list box.
*/

//Constructor to create a checkboxlist component
//	oTextPicker: the text picker control
//	oLstChoices: the name of the select form control
//	oSubmit: the form control to submit selections to the server
//  bRequired: is this a required field true/false
//  sSubmitType: submit this as a standard form, or as XML
//  oErrorFeedback: object used to provide validation feedback
//  oSizer: image object used to control the minimum size of the list
//  oInsertButton: the insert button
//  oRemoveButton: the remove button

var CMultipleTextPicker_INSTANCES = new Array();

function CMultipleTextPicker(oTextPicker, oLstChoices, oSubmit,  bRequired, sSubmitType, oErrorFeedback, oSizer, oInsertButton, oRemoveButton, sCVId)
{
	this.setCVId(sCVId);
	CMultipleTextPicker_INSTANCES[CMultipleTextPicker_INSTANCES.length] = this;
	this.m_oTextPicker = oTextPicker;
	this.m_oLstChoices = oLstChoices;
	this.m_oSubmit = oSubmit;
	this.m_bRequired = bRequired;
	this.m_bValid = false;
	this.m_sSubmitType = sSubmitType;
	this.m_oErrorFeedback = oErrorFeedback;
	if (oInsertButton)
	{
		this.m_oInsertButton = oInsertButton;
	}

	if (oRemoveButton)
	{
		this.m_oRemoveButton = oRemoveButton;
	}

	this.checkData();
	//resize the list if necessary
	if(oSizer)
	{
		this.m_oSizer = oSizer;
		this.m_oLstChoices.style.width='auto';
		setTimeout("resizeCMultipleTextPickerINSTANCES()",1);
	}
	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

CMultipleTextPicker.prototype = new CPromptControl();

//select all items
function CMultipleTextPicker_selectAll()
{
	for (var i=0; i < this.m_oLstChoices.options.length; i++)
	{
		this.m_oLstChoices.options[i].selected =  true;
	}
	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

//remove selection from all items
function CMultipleTextPicker_deSelectAll()
{
	for (var i=0; i < this.m_oLstChoices.options.length; i++)
	{
		this.m_oLstChoices.options[i].selected =  false;
	}
	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

//insert values from the picker control
function CMultipleTextPicker_insert()
{
	var sInsertText = this.m_oTextPicker.sGetValue();
	var sDisplayValue = this.m_oTextPicker.sGetFormatValue();
	if (sInsertText)
	{
		//determine whether this is a single value or multiple values
		var rMultiline = /[\n\f\r]+/;
		var arInsertText = sInsertText.replace(/[\n\f\r\s]+$/,'').split(rMultiline);
		if (arInsertText.length > 1)
		{
			for (var i=0; i < arInsertText.length; i++)
			{
				var sFormatValue = getFormatByDataType(arInsertText[i], this.m_oTextPicker.m_sDataType, this.m_oTextPicker.m_bIsCurrency);
				this.m_oLstChoices.options[this.m_oLstChoices.options.length] = new Option(sFormatValue, arInsertText[i], false, false);
			}
		}
		else
		{
			this.m_oLstChoices.options[this.m_oLstChoices.options.length] = new Option(sDisplayValue, sInsertText, false, false);
		}
		//clear the choices from the text box
		this.m_oTextPicker.clear();
	}
	this.checkData();
	setTimeout("resizeCMultipleTextPickerINSTANCES()",1);

	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

//remove selections from the list of choices
function CMultipleTextPicker_remove()
{
	this.removeSelectedChoices();

	setTimeout("resizeCMultipleTextPickerINSTANCES()",1);
	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

CMultipleTextPicker.prototype = new CPromptControl();

//perform any special processing for the server.
//this function will wrap all list items in XML.
//This is required for cases where the unselected items need
//to be submitted too.
function CMultipleTextPicker_preProcess()
{
	var i=0;
	if (this.m_sSubmitType == K_PRMT_sXML)
	{
		//convert the data to XML and submit
		var sURLValues = K_PRMT_sEMPTY;
		if (this.m_oLstChoices.options.length > 0)
		{
			for(i = 0; i < this.m_oLstChoices.options.length; i ++)
			{
				sURLValues += '<selectOption';
				sURLValues += ' displayValue="' + sXmlEncode(this.m_oLstChoices.options[i].text) +'"';
				sURLValues += ' useValue="' + sXmlEncode(this.m_oLstChoices.options[i].value) + '"';
				if (this.m_oLstChoices.options[i].selected == true)
				{
					sURLValues += ' selected="true" />';
				}
				else
				{
					sURLValues += ' selected="false" />';
				}
			}
		}

		addSelectChoices(this.m_oSubmit, sURLValues);
	}
	else
	{
		//select all the choices so they can be submitted with the form
		for(i = 0; i < this.m_oLstChoices.options.length; i ++)
		{
			this.m_oLstChoices.options[i].selected = true;
		}
	}
}

//return true unless this is a required prompt
//and there are no values
function CMultipleTextPicker_checkData()
{
	if ((this.m_bRequired == true) && (this.m_oLstChoices.options.length === 0))
	{
		this.m_bValid = false;
		this.checkFail();
		return false;
	}
	else
	{
		this.m_bValid = true;
		this.checkPass();
		return true;
	}
}

//make sure that choices are always visible and set a minimum size
//resize the list to fit the data if required
//if there are no items, prevent the list from
//shrinking too small
//allow the list to expand to fit the biggest item
function CMultipleTextPicker_resizeList()
{
	if (this.m_oErrorFeedback)
	{
		if(this.m_oLstChoices.style.tableLayout!='fixed')
		{
			this.m_oLstChoices.style.width='auto';
		}
		if (this.m_oLstChoices.offsetWidth < 200)
		{
			this.m_oLstChoices.style.width='200px';
		}
		this.m_oErrorFeedback.style.width = this.m_oLstChoices.offsetWidth + 'px';

	}
}

//enable and disable the insert and remove buttons
//based on what the user has selected
function CMultipleTextPicker_checkInsertRemove()
{
	if (this.m_oInsertButton)
	{
		if ((this.m_oTextPicker.getValid() == true) && this.m_oTextPicker.hasValue())
		{
			this.m_oInsertButton.disabled = false;
		}
		else
		{
			this.m_oInsertButton.disabled = true;
			this.m_oInsertButton.className = "clsInsertRemoveButton";
		}
	}

	if (this.m_oRemoveButton)
	{
		if (this.m_oLstChoices.selectedIndex == -1)
		{
			this.m_oRemoveButton.disabled = true;
			this.m_oRemoveButton.className = "clsInsertRemoveButton";
		}
		else
		{
			this.m_oRemoveButton.disabled = false;
		}
	}
}

//add a value to the list via javascript
function CMultipleTextPicker_add(sDisplayValue, sInsertText)
{
	this.m_oLstChoices.options[this.m_oLstChoices.options.length] = new Option(sDisplayValue, sInsertText, false, false);
	this.checkData();
	setTimeout("resizeCMultipleTextPickerINSTANCES()",1);
	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

//add an item to the list without any checking by the control
//this method provides an efficient way to add items, but
//the update() method should be called to clean up the control
//when finished adding
function CMultipleTextPicker_addNoUpdate(sDisplayValue, sInsertText, sel)
{
	sDisplayValue = sDecodeU003( sDisplayValue );
	sInsertText = sDecodeU003( sInsertText );
	if (sel == true) {
		this.m_oLstChoices.options[this.m_oLstChoices.options.length] = new Option(sDisplayValue, sInsertText, true, true);
	}
	else {
		this.m_oLstChoices.options[this.m_oLstChoices.options.length] = new Option(sDisplayValue, sInsertText, false, false);
	}
}

//clean up the control
function CMultipleTextPicker_update()
{
	this.checkData();
	setTimeout("resizeCMultipleTextPickerINSTANCES()",1);
	//check the states of the insert and remove buttons
	this.checkInsertRemove();
}

//Prototypes to assign methods to new instances of the object
CMultipleTextPicker.prototype.selectAll = CMultipleTextPicker_selectAll;
CMultipleTextPicker.prototype.deSelectAll = CMultipleTextPicker_deSelectAll;
CMultipleTextPicker.prototype.insert = CMultipleTextPicker_insert;
CMultipleTextPicker.prototype.remove = CMultipleTextPicker_remove;
CMultipleTextPicker.prototype.preProcess = CMultipleTextPicker_preProcess;
CMultipleTextPicker.prototype.checkData = CMultipleTextPicker_checkData;
CMultipleTextPicker.prototype.resizeList = CMultipleTextPicker_resizeList;
CMultipleTextPicker.prototype.checkInsertRemove = CMultipleTextPicker_checkInsertRemove;
CMultipleTextPicker.prototype.add = CMultipleTextPicker_add;
CMultipleTextPicker.prototype.addNoUpdate = CMultipleTextPicker_addNoUpdate;
CMultipleTextPicker.prototype.update = CMultipleTextPicker_update;

function resizeCMultipleTextPickerINSTANCES() {
	if (typeof CMultipleTextPicker_INSTANCES == K_PRMT_sOBJECT && CMultipleTextPicker_INSTANCES.length) {
		for (var i = 0; i < CMultipleTextPicker_INSTANCES.length; i++) {
			CMultipleTextPicker_INSTANCES[i].resizeList();
		}
	}
}