web/iwf/iwfcore.js

// =========================================================================
/// 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*//([^/!].*|$)
//
// This reduces file size by about 30%, give or take.
//
//!  To rip out only logging statements (commented or uncommented):
//!            ^/{0,2}iwfLog.*
// =========================================================================

// --------------------------------------------------------------------------
//! iwfcore.js
//
// Core functions
//
//! Dependencies:
//! (none)
//
//! 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;


// -----------------------------------
// End: Configurable variables
// -----------------------------------


// -----------------------------------
// Begin: Element Utility Functions
// -----------------------------------

function iwfGetById(id){
        var el = null;
        if (iwfIsString(id) || iwfIsNumber(id)) el = document.getElementById(id);
        else if (typeof(id) == 'object') el = id;
        return el;
}

function iwfGetForm(id){
        var frm = iwfGetById(id);
        if (!frm){
                // or by forms collection...
                frm = document.forms ? document.forms[frm] : null;
                if (!frm){
                        // or by tag elements...
                        var allforms = iwfGetByTagName('form');
                        for(var i=0;i<allforms.length;i++){
                                if (iwfAttribute(allforms[i], 'name') == id){
                                        frm = allforms[i];
                                        break;
                                }
                        }
                }
        }
        return frm;
}

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);
                return null;
        } else {
                // find element within this form with given id.
                var el = null;
                if (iwfIsString(nm) || iwfIsNumber(nm)) {
                        for(var i=0;i<frm.elements.length;i++){
                                if (frm.elements[i].name == nm || frm.elements[i].id == nm){
                                        el = frm.elements[i];
                                        break;
                                }
                        }
                } else {
                        el = id;
                }
//iwfLog('iwfGetByNameWithinForm returning:\n\n' + iwfElementToString(el), true);
                return el;
        }
}

function iwfGetOrCreateByNameWithinForm(form, nm, tagNameOrHtml, typeAtt){
        var elFrm = iwfGetForm(form);

        if (!elFrm){
                iwfLog("IWF Core Error: <form> with name or id of '" + form + "' could not be located.", true);
                return;
        }

        var el = iwfGetByNameWithinForm(form, nm);
        if (!el){
                // element does not exist. create it.
                el = document.createElement(tagNameOrHtml);
                iwfAttribute(el, 'name', nm);

                if (typeAtt){
                        iwfAttribute(el, 'type', typeAtt);
                }

                elFrm.appendChild(el);
        }

        return el;
}

function iwfRemoveChild(parentId, id){
        var elParent = iwfGetById(parentId);
        if (elParent){
                var elChild = iwfGetById(id);
                if (elChild){
                        elParent.removeChild(elChild);
                }
        }
        return elParent;
}

function iwfGetOrCreateById(id, tagNameOrHtml, parentNodeId){
        var el = iwfGetById(id);
        if (!el){
                // element does not exist. create it.
                el = document.createElement(tagNameOrHtml);
                iwfAttribute(el, 'id', id);
                iwfAttribute(el, 'name', id);

                if (parentNodeId){
                        var elParent = iwfGetById(parentNodeId);
                        if (elParent){
                                iwfAddChild(elParent, el);
                        } else if (parentNodeId.toLowerCase() == 'body'){
                                iwfAddChild(document.body, el);
                        }
                }


        }
        return el;
}

function iwfAddChild(parentNodeId, childNodeId, atFront){

                var elChild = iwfGetById(childNodeId);
                if (!elChild) return null;

                // get the element who is to be the parent
                var elParent = iwfGetById(parentNodeId);

                // parent not found, try by tagName
                if (!elParent) {
                        var nodes = iwfGetByTagName(parentNodeId);
                        if (nodes && nodes.length > 0){
                                // always use the first element with that tag name as the parent (think 'body')
                                parent = nodes[0];
                        } else {
                                // couldn't find by id or tag name.  bomb out.
                                return null;
                        }
                }


                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 false;
        document.removeNode(el);
        return true;
}

function iwfElementToString(id){
        var el = iwfGetById(id);
        if (!el) return 'element ' + id + ' does not exist.';

        var s = '<' + el.tagName + ' ';
        if (el.attributes){
                for(var i=0;i<el.attributes.length;i++){
                        var att = el.attributes[i];
                        s += ' ' + att.nodeName + '="' + att.nodeValue + '" ';
                }
        }
        if (el.innerHTML == ''){
                s += ' />';
        } else {
                s += '>' + el.innerHTML + '</' + el.tagName + '>';
        }

        return s;
}

function iwfGetByTagName(tagName, root) {
        var nodes = new Array();
        tagName = tagName || '*';
        root = root || document;
        if (root.all){
                if (tagName == '*'){
                        nodes = root.all;
                } else {
                        nodes = root.all.tags(tagName);
                }
        } else if (root.getElementsByTagName) {
                nodes = root.getElementsByTagName(tagName);
        }
        return nodes;
}

function iwfGetByAttribute(tagName, attName, regex, callback) {
        var a, list, found = new Array();
        var reg = new RegExp(regex, 'i');
        list = iwfGetByTagName(tagName);
        for(var i=0;i<list.length;++i) {
                a = list[i].getAttribute(attName);
                if (!a) {a = list[i][attName];}
                if (typeof(a)=='string' && a.search(regex) != -1) {
                        found[found.length] = list[i];
                        if (callback) callback(list[i]);
                }
        }
        return found;
}

function iwfAttribute(id, attName, newval){
        var el = iwfGetById(id);
        if (!el) return;

        var val = null;
        if (iwfExists(newval)){
                if (newval == null){
                        // remove it, don't set it to null.
                        iwfRemoveAttribute(el, attName);
                } else {
                        el.setAttribute(attName, newval);
                }
        }
        // 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;
}

function iwfRemoveAttribute(id, attName){
        var el = iwfGetById(id);
        if (el){
                el.removeAttribute(attName);
        }
        return el;
}

function iwfGetParent(id, useOffsetParent){
        var el = iwfGetById(id);
        if (!el) return null;
        var cur = null;
        if (useOffsetParent && iwfExists(el.offsetParent)) { cur = el.offsetParent;
        } else if (iwfExists(el.parentNode)) { cur = el.parentNode;
        } else if (iwfExists(el.parentElement)) { cur = el.parentElement; }
        return cur;
}

// -----------------------------------
// End: Element Utility Functions
// -----------------------------------


// -----------------------------------
// Begin: Encoding Utility Functions
// -----------------------------------

function iwfXmlEncode(s){
        if (!s){
                return '';
        }
        var ret = s.replace(/&/gi, '&amp;').replace(/>/gi,'&gt;').replace(/</gi, '&lt;').replace(/'/gi, '&apos;').replace(/"/gi, '&quot;');
//alert('after xmlencoding: \n\n\n' + ret);
        return ret;
}

function iwfXmlDecode(s){
        if (!s){
                return '';
        }
        var ret = s.replace(/&gt;/gi, '>').replace(/&lt;/gi,'<').replace(/&apos;/gi, '\'').replace(/&quot;/gi, '"').replace(/&amp;/gi, '&');
//alert('after xmldecoding: \n\n\n' + ret);
        return ret;
}

function iwfHtmlEncode(s){
        if (!s){
                return '';
        }
        var ret = s.replace(/&/gi, '&amp;').replace(/>/gi,'&gt;').replace(/</gi, '&lt;').replace(/'/gi, '&apos;').replace(/"/gi, '&quot;');
//alert('after xmlencoding: \n\n\n' + ret);
        return ret;
}

function iwfHtmlDecode(s){
        if (!s){
                return '';
        }
        var ret = s.replace(/&gt;/gi, '>').replace(/&lt;/gi,'<').replace(/&apos;/gi, '\'').replace(/&quot;/gi, '"').replace(/&amp;/gi, '&');
//alert('after xmldecoding: \n\n\n' + ret);
        return ret;
}
// -----------------------------------
// End: Encoding Utility Functions
// -----------------------------------


// -----------------------------------
// Begin: Conversion / Formatting Utility Functions
// -----------------------------------

function iwfExists(){
        for(var i=0;i<arguments.length;i++){
                if(typeof(arguments[i])=='undefined') return false;
        }
        return true;
}

function iwfIsString(s){
        return typeof(s) == 'string';
}

function iwfIsNumber(n){
        return typeof(n) == 'number';
}

function iwfIsBoolean(b){
        return typeof(b) == 'boolean';
}

function iwfIsDate(val){
        var dt = iwfDateFormat(val);
        if(!dt){
                return false;
        } else {
                // determine if the month/day makes sense.
                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:
                        case 6:
                        case 9:
                        case 11:
                                maxdy = 30;
                                break;
                        case 2:
                                // check leap year
                                if (yr % 4 == 0 && (yr % 100 != 0 || yr % 400 == 0)){
                                        maxdy = 29;
                                }
                                break;
                        default:
                                // 1, 3, 5, 7, 8, 10, 12
                                maxdy = 31;
                                break;
                }
                return dy > 0 && dy <= maxdy;
        }
}

function iwfDateFormat(val){
        var delim = '/';
        if (val.indexOf(delim) == -1){
                delim = '-';
        }

        var today = new Date();
        var mo = '00' + (today.getMonth() + 1);
        var dy = '00' + (today.getDate());
        var yr = today.getFullYear();
        var arr = val.split(delim);
        switch(arr.length){
                case 2:
                        //! 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.
                                yr = arr[1];
                        } else {
                                //! assume second is date.
                                dy = '00' + arr[1];
                        }
                        break;
                case 3:
                        //! 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){
                                case 1:
                                        yr = '200' + arr[2];
                                        break;
                                case 2:
                                        if (arr[2] < 50){
                                                yr = '20' + arr[2];
                                        } else {
                                                yr = '19' + arr[2];
                                        }
                                        break;
                                case 3:
                                        //! 3 digits... assume 2000 I guess
                                        yr = '2' + arr[2];
                                        break;
                                case 4:
                                        yr = arr[2];
                                        break;
                                default:
                                        break;
                        }
                        break;
                default:
                        // invalid date.
                        return null;
                        break;
        }
        mo = mo.substring(mo.length - 2);
        dy = dy.substring(dy.length - 2);
        return mo + '/' + dy + '/' + yr;

}

function iwfToInt(val, stripFormatting){
        var s = iwfIntFormat(val, stripFormatting);
        return parseInt(s, 10);
}

function iwfToFloat(val, dp, stripFormatting){
        var s = iwfFloatFormat(val, dp, stripFormatting);
        return parseFloat(s);
}

function iwfIntFormat(val, stripFormatting){
        return iwfFloatFormat(val, -1, stripFormatting);
}

function iwfFloatFormat(val, dp, stripFormatting){
        if (stripFormatting && iwfIsString(val)){
                val = val.replace(/[^0-9\.]/gi,'');
        }
        if (isNaN(val)) {
                val = 0.0;
        }

        var s = '' + val;
        var pos = s.indexOf('.');
        if (pos == -1) {
                s += '.';
                pos += s.length;
        }
        s += '0000000000000000000';
        s = s.substr(0,pos+dp+1);
        return s;
}

// -----------------------------------
// End: Conversion / Formatting Utility Functions
// -----------------------------------

// -----------------------------------
// Begin: Form Submittal Utility Functions
// -----------------------------------
function iwfDoAction(act, frm, id, targetElement){
        // validate the form first
        if (window.iwfOnFormValidate){
                if (!iwfOnFormValidate(act)){
                        return;
                }
        }

        var frmId = frm;
        // try by id first...
        frm = iwfGetForm(frmId);

        if (!frm){
                iwfLog('IWF Core Error: Could not locate form with id or name of ' + frmId, true);
                return;
        }

        // get or create the iwfId
        var elId = iwfGetOrCreateById('iwfId', 'input');

        if (!elId){
                iwfLog('IWF Core Error: Could not create iwfId element!', true);
                return;
        } else {
                iwfAttribute(elId, 'value', id);
                iwfRemoveAttribute(elId, 'disabled');

                if (!iwfGetParent(elId)){
                        // our element has not been added to the document yet.
                        iwfAttribute(elId, 'type', 'hidden');
                        if (!iwfAddChild(frm, elId)){
                                iwfLog('IWF Core Error: Created iwfId element, but could not append to form ' + frm.outerHTML, true);
                                return;
                        }
                }
        }


        // get or create the iwfMode
        var elMode = iwfGetOrCreateById('iwfMode', 'input');
        if (!elMode){
                iwfLog('IWF Core Error: Could not create iwfMode element!', true);
                return;
        } else {
                iwfAttribute(elMode, 'value', act);
                iwfRemoveAttribute(elMode, 'disabled');
                if (!iwfGetParent(elMode)){
                        // our element has not been added to the document yet.
                        iwfAttribute(elMode, 'type', 'hidden');
                        if (!iwfAddChild(frm, elMode)){
                                iwfLog('IWF Core Error: Created iwfMode element, but could not append to form ' + frm.outerHTML, true);
                                return;
                        }
                }
        }

        // make our request
        var elRealTarget = iwfGetById(targetElement);
        if (elRealTarget){
                // use ajax because they specified a particular element to shove the results into.

                // get or create the iwfTarget
                var elTarget = iwfGetOrCreateById('iwfTarget', 'input');
                if (!elTarget){
                        iwfLog('IWF Core Error: Could not create iwfTarget element under form ' + frm.outerHTML, true);
                        return;
                } else {
                        iwfAttribute(elTarget, 'value', iwfAttribute(elRealTarget, 'id'));
                        iwfRemoveAttribute(elTarget, 'disabled');
                        if (!iwfGetParent(elTarget)){
                                // our element has not been added to the document yet.
                                iwfAttribute(elTarget, 'type', 'hidden');
                                if (!iwfAddChild(frm, elTarget)){
                                        iwfLog('IWF Core Error: Created iwfTarget element, but could not append to form ' + frm.outerHTML, true);
                                        return;
                                }
                        }
                }

                if (!window.iwfRequest){
                        iwfLog("IWF Core Error: when using the iwfDo* functions and passing a targetElement, you must also reference the iwfajax.js file from your main html file.", true);
                } else {
//alert('calling iwfRequest(' + frm + ')');
                        iwfRequest(frm);
                }
        } else {
                // do a normal html submit, since they didn't specify a particular target
iwfLog('doing frm.submit()', true);
                frm.submit();
        }
}

function iwfDoEdit(formId, id, targetElement){
                iwfDoAction('edit', formId, id, targetElement);
}
function iwfDoSave(formId, id, targetElement){
                iwfDoAction('save', formId, id, targetElement);
}
function iwfDoDelete(formId, id, targetElement){
                iwfDoAction('delete', formId, id, targetElement);
}
function iwfDoAdd(formId, id, targetElement){
                iwfDoAction('add', formId, id, targetElement);
}
function iwfDoSelect(formId, id, targetElement){
                iwfDoAction('select', formId, id, targetElement);
}
function iwfDoCancel(formId, id, targetElement){
                iwfDoAction('cancel', formId, id, targetElement);
}

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...
        location.href = 'mailto:' + uid + '@' + host;
}

function iwfClickLink(id){
        var el = iwfGetById(id);
        if (!el) return;

        if (el.click){
                el.click();
        } else {
                location.href = el.href;
        }
}

function iwfShowMessage(msg){
        var el = iwfGetById('msg');
        if (!el){
//              window.status = msg;
                alert(msg + '\n\nTo supress this alert, add a tag with an id of "msg" to this page.');
        } else {
                el.innerHTML = msg.replace(/\n/, '<br />');
        }
}


// -----------------------------------
// End: Form Submittal Utility Functions
// -----------------------------------

// -----------------------------------
// Begin: Logging Utility Functions
// -----------------------------------

var _iwfLoggedItems = "";
function iwfLog(txt, showAlert){
        if (_iwfLoggingEnabled){
                _iwfLoggedItems += txt + '\n';
        } else {
                //! send to big bit bucket in the sky (/dev/null)
        }
        if (showAlert){
                alert(txt);
        }
}

function iwfHideLog(){
        iwfGetById("iwfLog").style.display="none";
}

function iwfClearLog(){
        _iwfLoggedItems = '';
        iwfRefreshLog();
}

function iwfRefreshLog(){
        iwfHideLog();
        iwfShowLog();
}

function iwfShowLog(){
        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){
                        alert(_iwfLoggedItems);
                } else {
                        el.style.position = 'absolute';
                        el.style.zIndex = '999999';
                        el.style.left = '10px';
                        el.style.top = '200px';
                        el.style.color = 'blue';
                        el.style.width = '500px';
                        el.style.height = '300px';
                        el.style.overflow = 'scroll';
                        el.style.padding = '5px 5px 5px 5px;'
                        el.style.backgroundColor = '#efefef';
                        el.style.border = '1px dashed blue';
                        el.style.display = 'block';
                        el.style.visibility = 'visible';
                        el.id = 'iwfLog';
//                      el.innerHTML = "IWF Log <span style='width:100px'>&nbsp;</span><a href='javascript:iwfRefreshLog();'>refresh</a> <a href='javascript:iwfHideLog();'>close</a> <a href='javascript:iwfClearLog();'>clear</a>:<hr />" + iwfXmlEncode(_iwfLoggedItems).replace(/\n/gi, '<br />').replace(/\t/gi,'&nbsp;&nbsp;&nbsp;&nbsp;');
                        el.innerHTML = "IWF Log <span style='width:100px'>&nbsp;</span><a href='javascript:iwfRefreshLog();'>refresh</a> <a href='javascript:iwfHideLog();'>close</a> <a href='javascript:iwfClearLog();'>clear</a>:<hr /><pre>" + _iwfLoggedItems.replace(/</gi, '&lt;').replace(/>/gi, '&gt;') + "</pre>";

                }
        }
}


// -----------------------------------
// End: Logging Utility Functions
// -----------------------------------
1	dpavlin	55	// =========================================================================
2			/// IWF - Interactive Website Framework. Javascript library for creating
3			/// responsive thin client interfaces.
4			///
5			/// Copyright (C) 2005 Brock Weaver brockweaver@users.sourceforge.net
6			///
7			/// This library is free software; you can redistribute it and/or modify
8			/// it under the terms of the GNU Lesser General Public License as published
9			/// by the Free Software Foundation; either version 2.1 of the License, or
10			/// (at your option) any later version.
11			///
12			/// This library is distributed in the hope that it will be useful, but
13			/// WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
14			/// or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
15			/// License for more details.
16			///
17			/// You should have received a copy of the GNU Lesser General Public License
18			/// along with this library; if not, write to the Free Software Foundation,
19			/// Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20			///
21			/// Brock Weaver
22			/// brockweaver@users.sourceforge.net
23			/// 1605 NW Maple Pl
24			/// Ankeny, IA 50021
25			///
26			//! http://iwf.sourceforge.net/
27			// =========================================================================
28			//! NOTE: To minimize file size, strip all fluffy comments (except the LGPL, of course!)
29			//! using the following regex (global flag and multiline on):
30			//! ^\t//([^/!].\|$)
31	dpavlin	46	//
32	dpavlin	55	// This reduces file size by about 30%, give or take.
33	dpavlin	46	//
34	dpavlin	55	//! To rip out only logging statements (commented or uncommented):
35			//! ^/{0,2}iwfLog.*
36			// =========================================================================
37	dpavlin	46
38			// --------------------------------------------------------------------------
39	dpavlin	55	//! iwfcore.js
40	dpavlin	46	//
41			// Core functions
42			//
43	dpavlin	55	//! Dependencies:
44			//! (none)
45	dpavlin	46	//
46	dpavlin	55	//! Brock Weaver - brockweaver@users.sourceforge.net
47			//! v 0.2 - 2005-11-14
48			//! iwfcore bug patch
49			//! --------------------------------------------------------------------------
50			//! - fixed iwfAttribute to return most current value instead of initial value
51			//!
52			//! v 0.1 - 2005-06-05
53			//! Initial release.
54			//! --------------------------------------------------------------------------
55	dpavlin	46
56			// -----------------------------------
57			// Begin: Configurable variables
58			// -----------------------------------
59
60			// 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.
61	dpavlin	55	var _iwfLoggingEnabled = true;
62	dpavlin	46
63
64			// -----------------------------------
65			// End: Configurable variables
66			// -----------------------------------
67
68
69			// -----------------------------------
70			// Begin: Element Utility Functions
71			// -----------------------------------
72
73			function iwfGetById(id){
74			var el = null;
75			if (iwfIsString(id) \|\| iwfIsNumber(id)) el = document.getElementById(id);
76			else if (typeof(id) == 'object') el = id;
77			return el;
78			}
79
80			function iwfGetForm(id){
81			var frm = iwfGetById(id);
82			if (!frm){
83			// or by forms collection...
84			frm = document.forms ? document.forms[frm] : null;
85			if (!frm){
86			// or by tag elements...
87			var allforms = iwfGetByTagName('form');
88			for(var i=0;i<allforms.length;i++){
89			if (iwfAttribute(allforms[i], 'name') == id){
90			frm = allforms[i];
91			break;
92			}
93			}
94			}
95			}
96			return frm;
97			}
98
99	dpavlin	55	function iwfGetByNameWithinForm(form, nm){
100	dpavlin	46	var frm = iwfGetForm(form);
101			if (!frm){
102			iwfLog("IWF Core Error: Could not locate form by id, document.forms, or document[] named '" + form + "'", true);
103			return null;
104			} else {
105			// find element within this form with given id.
106			var el = null;
107	dpavlin	55	if (iwfIsString(nm) \|\| iwfIsNumber(nm)) {
108	dpavlin	46	for(var i=0;i<frm.elements.length;i++){
109	dpavlin	55	if (frm.elements[i].name == nm \|\| frm.elements[i].id == nm){
110	dpavlin	46	el = frm.elements[i];
111			break;
112			}
113			}
114			} else {
115			el = id;
116			}
117	dpavlin	55	//iwfLog('iwfGetByNameWithinForm returning:\n\n' + iwfElementToString(el), true);
118	dpavlin	46	return el;
119			}
120			}
121
122	dpavlin	55	function iwfGetOrCreateByNameWithinForm(form, nm, tagNameOrHtml, typeAtt){
123	dpavlin	46	var elFrm = iwfGetForm(form);
124
125			if (!elFrm){
126			iwfLog("IWF Core Error: <form> with name or id of '" + form + "' could not be located.", true);
127			return;
128			}
129
130	dpavlin	55	var el = iwfGetByNameWithinForm(form, nm);
131	dpavlin	46	if (!el){
132			// element does not exist. create it.
133			el = document.createElement(tagNameOrHtml);
134	dpavlin	55	iwfAttribute(el, 'name', nm);
135	dpavlin	46
136			if (typeAtt){
137			iwfAttribute(el, 'type', typeAtt);
138			}
139
140			elFrm.appendChild(el);
141			}
142
143			return el;
144			}
145
146			function iwfRemoveChild(parentId, id){
147			var elParent = iwfGetById(parentId);
148			if (elParent){
149			var elChild = iwfGetById(id);
150			if (elChild){
151			elParent.removeChild(elChild);
152			}
153			}
154			return elParent;
155			}
156
157			function iwfGetOrCreateById(id, tagNameOrHtml, parentNodeId){
158			var el = iwfGetById(id);
159			if (!el){
160			// element does not exist. create it.
161			el = document.createElement(tagNameOrHtml);
162			iwfAttribute(el, 'id', id);
163			iwfAttribute(el, 'name', id);
164
165			if (parentNodeId){
166			var elParent = iwfGetById(parentNodeId);
167			if (elParent){
168	dpavlin	55	iwfAddChild(elParent, el);
169	dpavlin	46	} else if (parentNodeId.toLowerCase() == 'body'){
170	dpavlin	55	iwfAddChild(document.body, el);
171	dpavlin	46	}
172			}
173
174
175			}
176			return el;
177			}
178
179	dpavlin	55	function iwfAddChild(parentNodeId, childNodeId, atFront){
180	dpavlin	46
181			var elChild = iwfGetById(childNodeId);
182			if (!elChild) return null;
183
184			// get the element who is to be the parent
185			var elParent = iwfGetById(parentNodeId);
186
187			// parent not found, try by tagName
188			if (!elParent) {
189			var nodes = iwfGetByTagName(parentNodeId);
190			if (nodes && nodes.length > 0){
191			// always use the first element with that tag name as the parent (think 'body')
192			parent = nodes[0];
193			} else {
194			// couldn't find by id or tag name. bomb out.
195			return null;
196			}
197			}
198
199
200
201	dpavlin	55	if (!atFront \|\| !elParent.hasChildNodes()){
202			// append as last child of elParent
203			elParent.appendChild(elChild);
204			} else {
205			// append as first child of elParent
206			elParent.insertBefore(elChild, elParent.childNodes[0]);
207			}
208	dpavlin	46
209			return elParent;
210			}
211
212			function iwfRemoveNode(id){
213			var el = iwfGetById(id);
214	dpavlin	55	if (!el) return false;
215	dpavlin	46	document.removeNode(el);
216	dpavlin	55	return true;
217	dpavlin	46	}
218
219			function iwfElementToString(id){
220			var el = iwfGetById(id);
221			if (!el) return 'element ' + id + ' does not exist.';
222
223			var s = '<' + el.tagName + ' ';
224			if (el.attributes){
225			for(var i=0;i<el.attributes.length;i++){
226			var att = el.attributes[i];
227	dpavlin	55	s += ' ' + att.nodeName + '="' + att.nodeValue + '" ';
228	dpavlin	46	}
229			}
230			if (el.innerHTML == ''){
231			s += ' />';
232			} else {
233			s += '>' + el.innerHTML + '</' + el.tagName + '>';
234			}
235
236			return s;
237			}
238
239			function iwfGetByTagName(tagName, root) {
240			var nodes = new Array();
241			tagName = tagName \|\| '*';
242			root = root \|\| document;
243			if (root.all){
244			if (tagName == '*'){
245			nodes = root.all;
246			} else {
247			nodes = root.all.tags(tagName);
248			}
249			} else if (root.getElementsByTagName) {
250			nodes = root.getElementsByTagName(tagName);
251			}
252			return nodes;
253			}
254
255			function iwfGetByAttribute(tagName, attName, regex, callback) {
256			var a, list, found = new Array();
257			var reg = new RegExp(regex, 'i');
258			list = iwfGetByTagName(tagName);
259			for(var i=0;i<list.length;++i) {
260			a = list[i].getAttribute(attName);
261			if (!a) {a = list[i][attName];}
262			if (typeof(a)=='string' && a.search(regex) != -1) {
263			found[found.length] = list[i];
264			if (callback) callback(list[i]);
265			}
266			}
267			return found;
268			}
269
270			function iwfAttribute(id, attName, newval){
271			var el = iwfGetById(id);
272			if (!el) return;
273
274			var val = null;
275			if (iwfExists(newval)){
276			if (newval == null){
277			// remove it, don't set it to null.
278			iwfRemoveAttribute(el, attName);
279			} else {
280			el.setAttribute(attName, newval);
281			}
282			}
283	dpavlin	55	// 2005-11-14 Brock Weaver
284			// added check for attribute on el before trying getAttribute method
285			// (Thanks J.P. Jarolim!)
286			if (el[attName]){
287			val = el[attName];
288			} else if (el.getAttribute) {
289			val = el.getAttribute(attName);
290			}
291	dpavlin	46	return val;
292			}
293
294			function iwfRemoveAttribute(id, attName){
295			var el = iwfGetById(id);
296			if (el){
297			el.removeAttribute(attName);
298			}
299			return el;
300			}
301
302			function iwfGetParent(id, useOffsetParent){
303			var el = iwfGetById(id);
304			if (!el) return null;
305			var cur = null;
306			if (useOffsetParent && iwfExists(el.offsetParent)) { cur = el.offsetParent;
307			} else if (iwfExists(el.parentNode)) { cur = el.parentNode;
308			} else if (iwfExists(el.parentElement)) { cur = el.parentElement; }
309			return cur;
310			}
311
312			// -----------------------------------
313			// End: Element Utility Functions
314			// -----------------------------------
315
316
317			// -----------------------------------
318			// Begin: Encoding Utility Functions
319			// -----------------------------------
320
321			function iwfXmlEncode(s){
322			if (!s){
323			return '';
324			}
325			var ret = s.replace(/&/gi, '&').replace(/>/gi,'>').replace(/</gi, '<').replace(/'/gi, ''').replace(/"/gi, '"');
326			//alert('after xmlencoding: \n\n\n' + ret);
327			return ret;
328			}
329
330			function iwfXmlDecode(s){
331			if (!s){
332			return '';
333			}
334			var ret = s.replace(/>/gi, '>').replace(/</gi,'<').replace(/'/gi, '\'').replace(/"/gi, '"').replace(/&/gi, '&');
335			//alert('after xmldecoding: \n\n\n' + ret);
336			return ret;
337			}
338
339			function iwfHtmlEncode(s){
340			if (!s){
341			return '';
342			}
343			var ret = s.replace(/&/gi, '&').replace(/>/gi,'>').replace(/</gi, '<').replace(/'/gi, ''').replace(/"/gi, '"');
344			//alert('after xmlencoding: \n\n\n' + ret);
345			return ret;
346			}
347
348			function iwfHtmlDecode(s){
349			if (!s){
350			return '';
351			}
352			var ret = s.replace(/>/gi, '>').replace(/</gi,'<').replace(/'/gi, '\'').replace(/"/gi, '"').replace(/&/gi, '&');
353			//alert('after xmldecoding: \n\n\n' + ret);
354			return ret;
355			}
356			// -----------------------------------
357	dpavlin	55	// End: Encoding Utility Functions
358	dpavlin	46	// -----------------------------------
359
360
361			// -----------------------------------
362			// Begin: Conversion / Formatting Utility Functions
363			// -----------------------------------
364
365			function iwfExists(){
366			for(var i=0;i<arguments.length;i++){
367			if(typeof(arguments[i])=='undefined') return false;
368			}
369			return true;
370			}
371
372			function iwfIsString(s){
373			return typeof(s) == 'string';
374			}
375
376			function iwfIsNumber(n){
377			return typeof(n) == 'number';
378			}
379
380			function iwfIsBoolean(b){
381			return typeof(b) == 'boolean';
382			}
383
384			function iwfIsDate(val){
385			var dt = iwfDateFormat(val);
386			if(!dt){
387			return false;
388			} else {
389			// determine if the month/day makes sense.
390	dpavlin	55	var mo = iwfToInt(dt.substring(0,2));
391			var dy = iwfToInt(dt.substring(3,2));
392			var yr = iwfToInt(dt.substring(6,4));
393	dpavlin	46	var maxdy = 28;
394			switch(mo){
395			case 4:
396			case 6:
397			case 9:
398			case 11:
399			maxdy = 30;
400			break;
401			case 2:
402			// check leap year
403			if (yr % 4 == 0 && (yr % 100 != 0 \|\| yr % 400 == 0)){
404			maxdy = 29;
405			}
406			break;
407			default:
408			// 1, 3, 5, 7, 8, 10, 12
409			maxdy = 31;
410			break;
411			}
412			return dy > 0 && dy <= maxdy;
413			}
414			}
415
416			function iwfDateFormat(val){
417			var delim = '/';
418			if (val.indexOf(delim) == -1){
419			delim = '-';
420			}
421
422			var today = new Date();
423			var mo = '00' + (today.getMonth() + 1);
424			var dy = '00' + (today.getDate());
425			var yr = today.getFullYear();
426			var arr = val.split(delim);
427			switch(arr.length){
428			case 2:
429	dpavlin	55	//! possibles: 9/2, 9/2004, 09/06,
430			//! assume first is always month
431	dpavlin	46	mo = '00' + arr[0];
432			if (arr[1].length == 4){
433	dpavlin	55	//! assume second is year.
434	dpavlin	46	yr = arr[1];
435			} else {
436	dpavlin	55	//! assume second is date.
437	dpavlin	46	dy = '00' + arr[1];
438			}
439			break;
440			case 3:
441	dpavlin	55	//! possibles: 9/2/1, 9/02/04, 09/02/2004, 9/2/2004
442	dpavlin	46	mo = '00' + arr[0];
443			dy = '00' + arr[1];
444			switch(arr[2].length){
445			case 1:
446			yr = '200' + arr[2];
447			break;
448			case 2:
449			if (arr[2] < 50){
450			yr = '20' + arr[2];
451			} else {
452			yr = '19' + arr[2];
453			}
454			break;
455			case 3:
456	dpavlin	55	//! 3 digits... assume 2000 I guess
457	dpavlin	46	yr = '2' + arr[2];
458			break;
459			case 4:
460			yr = arr[2];
461			break;
462			default:
463			break;
464			}
465			break;
466			default:
467			// invalid date.
468			return null;
469			break;
470			}
471			mo = mo.substring(mo.length - 2);
472			dy = dy.substring(dy.length - 2);
473			return mo + '/' + dy + '/' + yr;
474
475			}
476
477			function iwfToInt(val, stripFormatting){
478			var s = iwfIntFormat(val, stripFormatting);
479			return parseInt(s, 10);
480			}
481
482			function iwfToFloat(val, dp, stripFormatting){
483			var s = iwfFloatFormat(val, dp, stripFormatting);
484			return parseFloat(s);
485			}
486
487			function iwfIntFormat(val, stripFormatting){
488			return iwfFloatFormat(val, -1, stripFormatting);
489			}
490
491			function iwfFloatFormat(val, dp, stripFormatting){
492			if (stripFormatting && iwfIsString(val)){
493			val = val.replace(/[^0-9\.]/gi,'');
494			}
495			if (isNaN(val)) {
496			val = 0.0;
497			}
498
499			var s = '' + val;
500			var pos = s.indexOf('.');
501			if (pos == -1) {
502			s += '.';
503			pos += s.length;
504			}
505			s += '0000000000000000000';
506			s = s.substr(0,pos+dp+1);
507			return s;
508			}
509
510			// -----------------------------------
511			// End: Conversion / Formatting Utility Functions
512			// -----------------------------------
513
514			// -----------------------------------
515			// Begin: Form Submittal Utility Functions
516			// -----------------------------------
517			function iwfDoAction(act, frm, id, targetElement){
518			// validate the form first
519			if (window.iwfOnFormValidate){
520			if (!iwfOnFormValidate(act)){
521			return;
522			}
523			}
524
525			var frmId = frm;
526			// try by id first...
527			frm = iwfGetForm(frmId);
528
529			if (!frm){
530			iwfLog('IWF Core Error: Could not locate form with id or name of ' + frmId, true);
531			return;
532			}
533
534			// get or create the iwfId
535			var elId = iwfGetOrCreateById('iwfId', 'input');
536
537			if (!elId){
538			iwfLog('IWF Core Error: Could not create iwfId element!', true);
539			return;
540			} else {
541			iwfAttribute(elId, 'value', id);
542			iwfRemoveAttribute(elId, 'disabled');
543
544			if (!iwfGetParent(elId)){
545			// our element has not been added to the document yet.
546			iwfAttribute(elId, 'type', 'hidden');
547	dpavlin	55	if (!iwfAddChild(frm, elId)){
548	dpavlin	46	iwfLog('IWF Core Error: Created iwfId element, but could not append to form ' + frm.outerHTML, true);
549			return;
550			}
551			}
552			}
553
554
555			// get or create the iwfMode
556			var elMode = iwfGetOrCreateById('iwfMode', 'input');
557			if (!elMode){
558			iwfLog('IWF Core Error: Could not create iwfMode element!', true);
559			return;
560			} else {
561			iwfAttribute(elMode, 'value', act);
562			iwfRemoveAttribute(elMode, 'disabled');
563			if (!iwfGetParent(elMode)){
564			// our element has not been added to the document yet.
565			iwfAttribute(elMode, 'type', 'hidden');
566	dpavlin	55	if (!iwfAddChild(frm, elMode)){
567	dpavlin	46	iwfLog('IWF Core Error: Created iwfMode element, but could not append to form ' + frm.outerHTML, true);
568			return;
569			}
570			}
571			}
572
573			// make our request
574			var elRealTarget = iwfGetById(targetElement);
575			if (elRealTarget){
576			// use ajax because they specified a particular element to shove the results into.
577
578			// get or create the iwfTarget
579			var elTarget = iwfGetOrCreateById('iwfTarget', 'input');
580			if (!elTarget){
581			iwfLog('IWF Core Error: Could not create iwfTarget element under form ' + frm.outerHTML, true);
582			return;
583			} else {
584			iwfAttribute(elTarget, 'value', iwfAttribute(elRealTarget, 'id'));
585			iwfRemoveAttribute(elTarget, 'disabled');
586			if (!iwfGetParent(elTarget)){
587			// our element has not been added to the document yet.
588			iwfAttribute(elTarget, 'type', 'hidden');
589	dpavlin	55	if (!iwfAddChild(frm, elTarget)){
590	dpavlin	46	iwfLog('IWF Core Error: Created iwfTarget element, but could not append to form ' + frm.outerHTML, true);
591			return;
592			}
593			}
594			}
595
596			if (!window.iwfRequest){
597			iwfLog("IWF Core Error: when using the iwfDo* functions and passing a targetElement, you must also reference the iwfajax.js file from your main html file.", true);
598			} else {
599			//alert('calling iwfRequest(' + frm + ')');
600			iwfRequest(frm);
601			}
602			} else {
603			// do a normal html submit, since they didn't specify a particular target
604	dpavlin	55	iwfLog('doing frm.submit()', true);
605	dpavlin	46	frm.submit();
606			}
607			}
608
609			function iwfDoEdit(formId, id, targetElement){
610			iwfDoAction('edit', formId, id, targetElement);
611			}
612			function iwfDoSave(formId, id, targetElement){
613			iwfDoAction('save', formId, id, targetElement);
614			}
615			function iwfDoDelete(formId, id, targetElement){
616			iwfDoAction('delete', formId, id, targetElement);
617			}
618			function iwfDoAdd(formId, id, targetElement){
619			iwfDoAction('add', formId, id, targetElement);
620			}
621			function iwfDoSelect(formId, id, targetElement){
622			iwfDoAction('select', formId, id, targetElement);
623			}
624			function iwfDoCancel(formId, id, targetElement){
625			iwfDoAction('cancel', formId, id, targetElement);
626			}
627
628			function iwfMailTo(uid, host){
629			// this is just so an email doesn't have to be output to the browser in raw text for
630			// email harvesters to grab...
631	dpavlin	55	location.href = 'mailto:' + uid + '@' + host;
632	dpavlin	46	}
633
634			function iwfClickLink(id){
635			var el = iwfGetById(id);
636			if (!el) return;
637
638			if (el.click){
639			el.click();
640			} else {
641			location.href = el.href;
642			}
643			}
644
645			function iwfShowMessage(msg){
646			var el = iwfGetById('msg');
647			if (!el){
648			// window.status = msg;
649			alert(msg + '\n\nTo supress this alert, add a tag with an id of "msg" to this page.');
650			} else {
651			el.innerHTML = msg.replace(/\n/, '<br />');
652			}
653			}
654
655
656			// -----------------------------------
657			// End: Form Submittal Utility Functions
658			// -----------------------------------
659
660			// -----------------------------------
661			// Begin: Logging Utility Functions
662			// -----------------------------------
663
664			var _iwfLoggedItems = "";
665			function iwfLog(txt, showAlert){
666	dpavlin	55	if (_iwfLoggingEnabled){
667	dpavlin	46	_iwfLoggedItems += txt + '\n';
668			} else {
669	dpavlin	55	//! send to big bit bucket in the sky (/dev/null)
670	dpavlin	46	}
671			if (showAlert){
672			alert(txt);
673			}
674			}
675
676			function iwfHideLog(){
677			iwfGetById("iwfLog").style.display="none";
678			}
679
680			function iwfClearLog(){
681			_iwfLoggedItems = '';
682			iwfRefreshLog();
683			}
684
685			function iwfRefreshLog(){
686			iwfHideLog();
687			iwfShowLog();
688			}
689
690			function iwfShowLog(){
691	dpavlin	55	if (!_iwfLoggingEnabled){
692			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.");
693	dpavlin	46	} else {
694			var el = iwfGetOrCreateById('iwfLog', 'div', 'body');
695			if (!el){
696			alert(_iwfLoggedItems);
697			} else {
698			el.style.position = 'absolute';
699			el.style.zIndex = '999999';
700			el.style.left = '10px';
701			el.style.top = '200px';
702			el.style.color = 'blue';
703			el.style.width = '500px';
704			el.style.height = '300px';
705			el.style.overflow = 'scroll';
706			el.style.padding = '5px 5px 5px 5px;'
707			el.style.backgroundColor = '#efefef';
708			el.style.border = '1px dashed blue';
709			el.style.display = 'block';
710			el.style.visibility = 'visible';
711			el.id = 'iwfLog';
712			// el.innerHTML = "IWF Log <span style='width:100px'> </span><a href='javascript:iwfRefreshLog();'>refresh</a> <a href='javascript:iwfHideLog();'>close</a> <a href='javascript:iwfClearLog();'>clear</a>:<hr />" + iwfXmlEncode(_iwfLoggedItems).replace(/\n/gi, '<br />').replace(/\t/gi,'    ');
713			el.innerHTML = "IWF Log <span style='width:100px'> </span><a href='javascript:iwfRefreshLog();'>refresh</a> <a href='javascript:iwfHideLog();'>close</a> <a href='javascript:iwfClearLog();'>clear</a>:<hr /><pre>" + _iwfLoggedItems.replace(/</gi, '<').replace(/>/gi, '>') + "</pre>";
714
715			}
716			}
717			}
718
719
720			// -----------------------------------
721			// End: Logging Utility Functions
722			// -----------------------------------