/*
Developed by S3 Group Pty Ltd
Suite 328, Level 3, 368 Sussex Street
Sydney, NSW 2000
www.s3group.com.au

Copyright 2006
Last Modified: 23rd June 2006

--------------------------------------

INSTRUCTIONS
This header file provides one function:
var canItWork = importXML( string: locationOfXMLFile, string: nameOfFunction[, optional boolean: allowCache[, optional boolean: delay]] );
eg.
var canItWork = importXML( 'myXML.xml', 'runThis' );

To support (Internet) Explorer 5 on Mac, the XML file should use a stylesheet:
<?xml-stylesheet type="text/css" href="blank.css"?>
Although that stylesheet could in fact be completely empty. Failure to do this will produce errors when you
try to manipulate the DOM of the XML file.

When the xml file has loaded, the named function will be run, and will be passed a reference to the document
object of the XML file. You can then manipulate the data in the file using W3C DOM scripting.

Browsers may cache the XML files (with Safari, the import fails if the file is already cached by the current page).
To prevent this, the script adds a timestamp to the end of each request URL (changes every millisecond).
If you do not want this timestamp to be added, pass the value 'true' as a third parameter.
var canItWork = importXML( 'myXML.xml', 'runThis', true );
This is not recommended.

Browsers that use the iframe may have problems if the XML takes a long time to load, as they will attempt to
access the data before it is ready. If you know that this might happen, you can use the delay parameter to
make the script wait for the specified amount of time before attemting to use the data, hopefully giving the
XML the chance to load. For example, to introduce a 2 second delay:
var canItWork = importXML( 'myXML.xml', 'runThis', false, 2000 );
*/

// ---------------
// XML functions *
// ---------------

var S3_ldD = [];

function S3_XML_importXML( oURL, oFunct, oNoRand, oDelay ) {
	//note: in XML importing event handlers, 'this' refers to window
	if( !oNoRand ) {
		oURL += ( ( oURL.indexOf('?') + 1 ) ? '&' : '?' ) + ( new Date() ).getTime();
	} //prevent cache
	
	if( window.XMLHttpRequest ) {
		//alternate XMLHTTP request - Gecko, Safari 1.2+ and Opera 7.6+
		S3_ldD[S3_ldD.length] = new XMLHttpRequest();
		S3_ldD[S3_ldD.length-1].onreadystatechange = new Function( 'if( S3_ldD['+(S3_ldD.length-1)+'].readyState == 4 && S3_ldD['+(S3_ldD.length-1)+'].status < 300 ) { '+oFunct+'(S3_ldD['+(S3_ldD.length-1)+'].responseXML); }' );
		S3_ldD[S3_ldD.length-1].open("GET", oURL, true);
		S3_ldD[S3_ldD.length-1].send(null);
		return true;
	}

	if( !navigator.__ice_version && window.ActiveXObject ) {
	//the Microsoft way - IE 5+/Win (ICE produces errors and fails to use try-catch correctly)
		try { //IE Mac has the property window.ActiveXObject but produces errors if you try and use it
			try {
				var tho = new ActiveXObject( 'Microsoft.XMLDOM' ); //newer
			} catch(e) {
				var tho = new ActiveXObject( 'Msxml2.XMLHTTP' ); //older
			} 
			S3_ldD[S3_ldD.length] = tho;
			S3_ldD[S3_ldD.length-1].onreadystatechange = new Function( 'if( S3_ldD['+(S3_ldD.length-1)+'].readyState == 4 ) { '+oFunct+'(S3_ldD['+(S3_ldD.length-1)+']); }' );
			S3_ldD[S3_ldD.length-1].load(oURL);
			return true;
		} catch(e) {}
	}

	if( document.createElement && document.childNodes ) {
		//load the XML in an iframe
		var ifr = document.createElement('DIV');
		ifr.style.visibility = 'hidden'; ifr.style.position = 'absolute'; ifr.style.top = '0px'; ifr.style.left = '0px';
		//onload only fires in Opera so I use a timer for all
		if( !window.S3_XML_timer ) {
			window.S3_XML_timer = window.setInterval('S3_checkXMLLoad();',100);
		}
		ifr.innerHTML = '<iframe src="'+oURL+'" name="S3_XML_loader_'+S3_ldD.length+'" height="0" width="0"><\/iframe>';
		S3_ldD[S3_ldD.length] = oFunct+'S3_SPLIT'+(oDelay?oDelay:1)+'';
		document.body.appendChild(ifr);
		return true;
	}
	return false;
}

function S3_checkXMLLoad() {
	//check if each imported file is available (huge files may not have loaded completely - nothing I can do - use the delay to help)
	for( var x = 0; x < S3_ldD.length; x++ ) {
		if( S3_ldD[x] && window.frames['S3_XML_loader_'+x] ) {
			setTimeout( S3_ldD[x].split('S3_SPLIT')[0] + '(window.frames.S3_XML_loader_'+x+'.window.document);', parseInt(S3_ldD[x].split('S3_SPLIT')[1]) );
			S3_ldD[x] = false;
		}
	}
}