--- trunk/web/iwf/iwfcore.js	2005/11/14 16:16:57	54
+++ trunk/web/iwf/iwfcore.js	2005/11/15 14:29:45	55
@@ -1,48 +1,64 @@
-// -----------------------------------------------------------------------------
-// IWF - Interactive Website Framework.  Javascript library for creating
-// responsive thin client interfaces.
+// =========================================================================
+/// IWF - Interactive Website Framework.  Javascript library for creating
+/// responsive thin client interfaces.
+///
+/// Copyright (C) 2005 Brock Weaver brockweaver@users.sourceforge.net
+///
+///     This library is free software; you can redistribute it and/or modify
+/// it under the terms of the GNU Lesser General Public License as published
+/// by the Free Software Foundation; either version 2.1 of the License, or
+/// (at your option) any later version.
+///
+///     This library is distributed in the hope that it will be useful, but
+/// WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+/// or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
+/// License for more details.
+///
+///    You should have received a copy of the GNU Lesser General Public License
+/// along with this library; if not, write to the Free Software Foundation,
+/// Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+///
+/// Brock Weaver
+/// brockweaver@users.sourceforge.net
+/// 1605 NW Maple Pl
+/// Ankeny, IA 50021
+///
+//! http://iwf.sourceforge.net/
+// =========================================================================
+//! NOTE: To minimize file size, strip all fluffy comments (except the LGPL, of course!)
+//! using the following regex (global flag and multiline on):
+//!            ^\t*//([^/!].*|$)
 //
-// Copyright (C) 2005 Brock Weaver brockweaver@gmail.com
+// This reduces file size by about 30%, give or take.
 //
-//     This library is free software; you can redistribute it and/or modify
-// it under the terms of the GNU Lesser General Public License as published
-// by the Free Software Foundation; either version 2.1 of the License, or
-// (at your option) any later version.
-//
-//     This library is distributed in the hope that it will be useful, but
-// WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
-// or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
-// License for more details.
-//
-//    You should have received a copy of the GNU Lesser General Public License
-// along with this library; if not, write to the Free Software Foundation,
-// Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-//
-// Brock Weaver
-// brockweaver@gmail.com
-// 1605 NW Maple Pl
-// Ankeny, IA 50021
-// -----------------------------------------------------------------------------
+//!  To rip out only logging statements (commented or uncommented):
+//!            ^/{0,2}iwfLog.*
+// =========================================================================
 
 // --------------------------------------------------------------------------
-// iwfcore.js
+//! iwfcore.js
 //
 // Core functions
 //
-// Dependencies:
-// (none)
+//! Dependencies:
+//! (none)
 //
-// Brock Weaver - brockweaver@sourceforge.net - iwf.sourceforge.net
-// v 0.1 - 2005-06-05
-// Initial release.
-// --------------------------------------------------------------------------
+//! Brock Weaver - brockweaver@users.sourceforge.net
+//! v 0.2 - 2005-11-14
+//! iwfcore bug patch
+//! --------------------------------------------------------------------------
+//! - fixed iwfAttribute to return most current value instead of initial value
+//!
+//! v 0.1 - 2005-06-05
+//! Initial release.
+//! --------------------------------------------------------------------------
 
 // -----------------------------------
 // Begin: Configurable variables
 // -----------------------------------
 
 // set to true to enable logging.  Logging simply means certain values are appended to a string. nothing is written out or communicated over the wire anywhere.
-var iwfLoggingEnabled = true;
+var _iwfLoggingEnabled = true;
 
 
 // -----------------------------------
@@ -80,7 +96,7 @@
 	return frm;
 }
 
-function iwfGetByIdWithinForm(form, id){
+function iwfGetByNameWithinForm(form, nm){
 	var frm = iwfGetForm(form);
 	if (!frm){
 		iwfLog("IWF Core Error: Could not locate form by id, document.forms, or document[] named '" + form + "'", true);
@@ -88,9 +104,9 @@
 	} else {
 		// find element within this form with given id.
 		var el = null;
-		if (iwfIsString(id) || iwfIsNumber(id)) {
+		if (iwfIsString(nm) || iwfIsNumber(nm)) {
 			for(var i=0;i<frm.elements.length;i++){
-				if (frm.elements[i].name == id || frm.elements[i].id == id){
+				if (frm.elements[i].name == nm || frm.elements[i].id == nm){
 					el = frm.elements[i];
 					break;
 				}
@@ -98,12 +114,12 @@
 		} else {
 			el = id;
 		}
-//iwfLog('iwfGetByIdWithinForm returning:\n\n' + iwfElementToString(el), true);
+//iwfLog('iwfGetByNameWithinForm returning:\n\n' + iwfElementToString(el), true);
 		return el;
 	}
 }
 
-function iwfGetOrCreateWithinForm(form, id, tagNameOrHtml, typeAtt){
+function iwfGetOrCreateByNameWithinForm(form, nm, tagNameOrHtml, typeAtt){
 	var elFrm = iwfGetForm(form);
 
 	if (!elFrm){
@@ -111,11 +127,11 @@
 		return;
 	}
 
-	var el = iwfGetByIdWithinForm(form, id);
+	var el = iwfGetByNameWithinForm(form, nm);
 	if (!el){
 		// element does not exist. create it.
 		el = document.createElement(tagNameOrHtml);
-		iwfAttribute(el, 'name', id);
+		iwfAttribute(el, 'name', nm);
 
 		if (typeAtt){
 			iwfAttribute(el, 'type', typeAtt);
@@ -149,9 +165,9 @@
 		if (parentNodeId){
 			var elParent = iwfGetById(parentNodeId);
 			if (elParent){
-				iwfAppendChild(elParent, el);
+				iwfAddChild(elParent, el);
 			} else if (parentNodeId.toLowerCase() == 'body'){
-				iwfAppendChild(document.body, el);
+				iwfAddChild(document.body, el);
 			}
 		}
 
@@ -160,7 +176,7 @@
 	return el;
 }
 
-function iwfAppendChild(parentNodeId, childNodeId){
+function iwfAddChild(parentNodeId, childNodeId, atFront){
 
 		var elChild = iwfGetById(childNodeId);
 		if (!elChild) return null;
@@ -182,16 +198,22 @@
 
 
 
-		// append the element to the parent
-		elParent.appendChild(elChild);
+		if (!atFront || !elParent.hasChildNodes()){
+			// append as last child of elParent
+			elParent.appendChild(elChild);
+		} else {
+			// append as first child of elParent
+			elParent.insertBefore(elChild, elParent.childNodes[0]);
+		}
 
 		return elParent;
 }
 
 function iwfRemoveNode(id){
 	var el = iwfGetById(id);
-	if (!el) return;
+	if (!el) return false;
 	document.removeNode(el);
+	return true;
 }
 
 function iwfElementToString(id){
@@ -202,7 +224,7 @@
 	if (el.attributes){
 		for(var i=0;i<el.attributes.length;i++){
 			var att = el.attributes[i];
-			s += ' ' + att.nodeName + '=' + att.nodeValue + ' ';
+			s += ' ' + att.nodeName + '="' + att.nodeValue + '" ';
 		}
 	}
 	if (el.innerHTML == ''){
@@ -258,7 +280,14 @@
 			el.setAttribute(attName, newval);
 		}
 	}
-	val = el.getAttribute(attName);
+	// 2005-11-14 Brock Weaver
+	// added check for attribute on el before trying getAttribute method
+	// (Thanks J.P. Jarolim!)
+	if (el[attName]){
+		val = el[attName];
+	} else if (el.getAttribute) {
+		val = el.getAttribute(attName);
+	}
 	return val;
 }
 
@@ -325,7 +354,7 @@
 	return ret;
 }
 // -----------------------------------
-// End: Xml Utility Functions
+// End: Encoding Utility Functions
 // -----------------------------------
 
 
@@ -358,9 +387,9 @@
 		return false;
 	} else {
 		// determine if the month/day makes sense.
-		var mo = parseInt(dt.substring(0,2), 10);
-		var dy = parseInt(dt.substring(3,2), 10);
-		var yr = parseInt(dt.substring(6,4), 10);
+		var mo = iwfToInt(dt.substring(0,2));
+		var dy = iwfToInt(dt.substring(3,2));
+		var yr = iwfToInt(dt.substring(6,4));
 		var maxdy = 28;
 		switch(mo){
 			case 4:
@@ -397,19 +426,19 @@
 	var arr = val.split(delim);
 	switch(arr.length){
 		case 2:
-			// possibles:  9/2, 9/2004, 09/06,
-			// assume first is always month
+			//! possibles:  9/2, 9/2004, 09/06,
+			//! assume first is always month
 			mo = '00' + arr[0];
 			if (arr[1].length == 4){
-				// assume second is year.
+				//! assume second is year.
 				yr = arr[1];
 			} else {
-				// assume second is date.
+				//! assume second is date.
 				dy = '00' + arr[1];
 			}
 			break;
 		case 3:
-			// possibles: 9/2/1, 9/02/04, 09/02/2004, 9/2/2004
+			//! possibles: 9/2/1, 9/02/04, 09/02/2004, 9/2/2004
 			mo = '00' + arr[0];
 			dy = '00' + arr[1];
 			switch(arr[2].length){
@@ -424,7 +453,7 @@
 					}
 					break;
 				case 3:
-					// 3 digits... assume 2000 I guess
+					//! 3 digits... assume 2000 I guess
 					yr = '2' + arr[2];
 					break;
 				case 4:
@@ -486,7 +515,6 @@
 // Begin: Form Submittal Utility Functions
 // -----------------------------------
 function iwfDoAction(act, frm, id, targetElement){
-//alert('action=' + act + '\nfrm=' + frm + '\nid=' + id + '\ntargetElement=' + targetElement);
 	// validate the form first
 	if (window.iwfOnFormValidate){
 		if (!iwfOnFormValidate(act)){
@@ -516,12 +544,11 @@
 		if (!iwfGetParent(elId)){
 			// our element has not been added to the document yet.
 			iwfAttribute(elId, 'type', 'hidden');
-			if (!iwfAppendChild(frm, elId)){
+			if (!iwfAddChild(frm, elId)){
 				iwfLog('IWF Core Error: Created iwfId element, but could not append to form ' + frm.outerHTML, true);
 				return;
 			}
 		}
-//alert(iwfElementToString(elId) + '\n\ndisabled=' + iwfAttribute(elId, 'disabled') + '\n\n' + elId.disabled);
 	}
 
 
@@ -536,7 +563,7 @@
 		if (!iwfGetParent(elMode)){
 			// our element has not been added to the document yet.
 			iwfAttribute(elMode, 'type', 'hidden');
-			if (!iwfAppendChild(frm, elMode)){
+			if (!iwfAddChild(frm, elMode)){
 				iwfLog('IWF Core Error: Created iwfMode element, but could not append to form ' + frm.outerHTML, true);
 				return;
 			}
@@ -559,7 +586,7 @@
 			if (!iwfGetParent(elTarget)){
 				// our element has not been added to the document yet.
 				iwfAttribute(elTarget, 'type', 'hidden');
-				if (!iwfAppendChild(frm, elTarget)){
+				if (!iwfAddChild(frm, elTarget)){
 					iwfLog('IWF Core Error: Created iwfTarget element, but could not append to form ' + frm.outerHTML, true);
 					return;
 				}
@@ -574,7 +601,7 @@
 		}
 	} else {
 		// do a normal html submit, since they didn't specify a particular target
-alert('doing frm.submit()');
+iwfLog('doing frm.submit()', true);
 		frm.submit();
 	}
 }
@@ -601,7 +628,7 @@
 function iwfMailTo(uid, host){
 	// this is just so an email doesn't have to be output to the browser in raw text for
 	// email harvesters to grab...
-	return 'mailto:' + uid + '@' + host;
+	location.href = 'mailto:' + uid + '@' + host;
 }
 
 function iwfClickLink(id){
@@ -636,11 +663,10 @@
 
 var _iwfLoggedItems = "";
 function iwfLog(txt, showAlert){
-	if (iwfLoggingEnabled){
+	if (_iwfLoggingEnabled){
 		_iwfLoggedItems += txt + '\n';
 	} else {
-		// send to big bit bucket in the sky
-		// | /dev/null
+		//! send to big bit bucket in the sky (/dev/null)
 	}
 	if (showAlert){
 		alert(txt);
@@ -662,8 +688,8 @@
 }
 
 function iwfShowLog(){
-	if (!iwfLoggingEnabled){
-		alert("Logging for IWF has been disabled.\nSet the iwfLoggingEnabled variable located in the iwfcore.js file to true to enable logging.");
+	if (!_iwfLoggingEnabled){
+		alert("Logging for IWF has been disabled.\nSet the _iwfLoggingEnabled variable located in the iwfcore.js (or iwfconfig.js) file to true to enable logging.");
 	} else {
 		var el = iwfGetOrCreateById('iwfLog', 'div', 'body');
 		if (!el){