// the functions in this file require the supplementary library lib.js

// These defaults should be changed the way it best fits your site
var _POPUP_FEATURES = 'scrollbars=1,resizable=1,location=1,status=1,menubar=1,directories=1,width=1024,height=768';
//var _POPUP_FEATURES = 'width=1024,height=768';
/*

# height: Specifies height of the window in pixels.
# width: width of the new window in pixels
# location: determines the presence of the location bar
# menubar: menubar
# scrollbars: scrollbars
# status: status bar
# toolbar: toolbar
# directories: specifies the display of link buttons
# resizable: determines whether the window can be resized. If it's absent or its value is set 'no', the window does not have resize handles around its border.

*/
function raw_popup(url, target, features) {
    // pops up a window containing url optionally named target, optionally having features
    if (isUndefined(features)) features = _POPUP_FEATURES;
    if (isUndefined(target  )) target   = '_blank';
    var theWindow = window.open(url, target, features);
    theWindow.focus();
    return theWindow;
}

function link_popup(src, features) {
    // to be used in an html event handler as in: <a href="..." onclick="link_popup(this,...)" ...
    // pops up a window grabbing the url from the event source's href
	try {	
	    return raw_popup(src.getAttribute('href'), src.getAttribute('target') || '_blank', features);	
	}
	catch(e) {

	}
	
}

function event_popup(e) {
    // to be passed as an event listener
    // pops up a window grabbing the url from the event source's href	
	try {
		link_popup(e.currentTarget);
		e.preventDefault();
	}
	catch(e) {

	}
	
}

function event_popup_features(features) {
    // generates an event listener similar to event_popup, but allowing window features
    return function(e) { link_popup(e.currentTarget, features); e.preventDefault() }
}