web/iwf/iwfcore.js

// -----------------------------------------------------------------------------
// IWF - Interactive Website Framework.  Javascript library for creating
// responsive thin client interfaces.
//
// Copyright (C) 2005 Brock Weaver brockweaver@gmail.com
//
//     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
// -----------------------------------------------------------------------------

// --------------------------------------------------------------------------
// iwfcore.js
//
// Core functions
//
// Dependencies:
// (none)
//
// Brock Weaver - brockweaver@sourceforge.net - iwf.sourceforge.net
// 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 iwfGetByIdWithinForm(form, id){
        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(id) || iwfIsNumber(id)) {
                        for(var i=0;i<frm.elements.length;i++){
                                if (frm.elements[i].name == id || frm.elements[i].id == id){
                                        el = frm.elements[i];
                                        break;
                                }
                        }
                } else {
                        el = id;
                }
//iwfLog('iwfGetByIdWithinForm returning:\n\n' + iwfElementToString(el), true);
                return el;
        }
}

function iwfGetOrCreateWithinForm(form, id, 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 = iwfGetByIdWithinForm(form, id);
        if (!el){
                // element does not exist. create it.
                el = document.createElement(tagNameOrHtml);
                iwfAttribute(el, 'name', id);

                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){
                                iwfAppendChild(elParent, el);
                        } else if (parentNodeId.toLowerCase() == 'body'){
                                iwfAppendChild(document.body, el);
                        }
                }


        }
        return el;
}

function iwfAppendChild(parentNodeId, childNodeId){

                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;
                        }
                }


                // append the element to the parent
                elParent.appendChild(elChild);

                return elParent;
}

function iwfRemoveNode(id){
        var el = iwfGetById(id);
        if (!el) return;
        document.removeNode(el);
}

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);
                }
        }
        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: Xml 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 = parseInt(dt.substring(0,2), 10);
                var dy = parseInt(dt.substring(3,2), 10);
                var yr = parseInt(dt.substring(6,4), 10);
                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){
//alert('action=' + act + '\nfrm=' + frm + '\nid=' + id + '\ntargetElement=' + 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 (!iwfAppendChild(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);
        }


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