Usage:
*var myPopupFeatures = new com.bigbad.PopupFeatures( {scrollbars:false,status:false,resizable:false} );window.open( "myUrl", "myTarget", myPopupFeatures.toString() );window.open( "myUrl", "myTarget",com.bigbad.PopupFeatures.defaultPopupFeatures.toString( {width:500,height:400} ) );Note: not all properties are available in all browsers
* * @author Gregory RamspergertoString()
**/
com.bigbad.PopupFeatures = function( defaults ) {
if( defaults == null ) return;
// transfer all properties into this object.
var prop;
for( prop in defaults ) {
this[prop] = defaults[prop];
}
}
/**
* Convert the PopupFeatures instance to a string
* @param overrides Object Object whose properties will be used to override the instance properties
* @return the string to be used as the features parameter in the window.open( url, target, features ) call.
* @type String
**/
com.bigbad.PopupFeatures.prototype.toString = function( overrides ) {
if( overrides == null ) overrides = new Object();
var rtn = new Array();
for( prop in this ) {
var val;
if( (val = this.getPropValue(prop, overrides))!=null ) {
if( typeof val == "function" ) continue;
switch( prop ) {
case "left":
rtn[rtn.length] = "screenX=" + val;
case "top":
rtn[rtn.length] = "screenY=" + val;
default:
rtn[rtn.length] = prop + "=" + val;
}
}
}
return rtn.join(",");
}
/**
* Retrieve the set value a given property.
* Boolean values are converted to the strings "yes" or "no", representing true and false respectively
* @private
* @param prop String Name of the property to retrieve.
* @param overrides Object Object whose properties will be used in place of instance values for popup properties. See toString()
* @return the value or null if the value was not set.
**/
com.bigbad.PopupFeatures.prototype.getPropValue = function( prop, overrides ) {
var val = null;
if( overrides == null ) val = this[prop];
else val = ( overrides[prop] != null ) ? overrides[prop] : this[prop];
return ( val == null ) ? null : (typeof val == "boolean" ? ( val ? "yes" : "no" ) : val );
}
/**
*
Copy parent window's history to the new child window.
*Default: no value
* @type Boolean **/ com.bigbad.PopupFeatures.prototype.copyhistory = null; /** *New window is dependent on parent window and is closed automatically if parent is closed.
*Default: no value
* @type Boolean **/ com.bigbad.PopupFeatures.prototype.dependent = null; /** *New window has directory buttons
*Default: false
height of new window in pixels
*Default: no value
* @type Number **/ com.bigbad.PopupFeatures.prototype.height = null; /** *Height of content (visible body area) in new window in pixels
*Default: no value
* @type Number **/ com.bigbad.PopupFeatures.prototype.innerHeight = null; /** *Width of content (visible body area) in new window in pixels
*Default: no value
* @type Number **/ com.bigbad.PopupFeatures.prototype.innerWidth = null; /** *Initial position on screen of the left edge of the popup window
*Default: no value
* @type Number **/ com.bigbad.PopupFeatures.prototype.left = null; /** *New window has the location bar
*Default: false
New window has the menu bar
*Default: false
Height of the new window (including chrome) in pixels
*Default: no value
* @type Number **/ com.bigbad.PopupFeatures.prototype.outerHeight = null; /** *Width of the new window (including chrome) in pixels
*Default: no value
* @type Number **/ com.bigbad.PopupFeatures.prototype.outerWidth = null; /** *New window is resizable by the user
*Default: true
New window has the scroll bars
*Default: true
New window has the status bar
*Default: true
New window has the tool bar
*Default: false
Initial position on screen of the top edge of the popup window
*Default: no value
* @type Number **/ com.bigbad.PopupFeatures.prototype.top = null; /** *Width of new window in pixels
*Default: no value
* @type Number **/ com.bigbad.PopupFeatures.prototype.width = null; /** * PopupFeatures instance using all of the default values. * @type com.bigbad.PopupFeatures **/ com.bigbad.PopupFeatures.defaultPopupFeatures = new com.bigbad.PopupFeatures(); /** * @class Popup for simple creation of popup windows. *Note: All methods are static
* * @author Gregory RamspergerAccessibility note: This method should be used whenever popping up window from an anchor link. This allows browsers without JavaScript to reach the window. Additionally, search engines will also be able to crawl though this link.
* *Usage:
*<a href="/some/url/" target="myWin" onclick="return com.bigbad.Popup.popupDom(this, myPopupFeatures);">popup</a><a href="/some/url/" target="myWin" onclick="return com.bigbad.Popup.popupDom(this, null, {width:600,height:400} );">popup</a><a href="/some/url/" target="myWin" onclick="return com.bigbad.Popup.popupDom(this, myPopupFeatures, {width:600,height:400} );">popup</a>false on success.
* @see com.bigbad.PopupFeatures#toString
**/
com.bigbad.Popup.popupDom = function( anchor, features, overrides ) {
com.bigbad.Popup.popup(
anchor.href,
anchor.target,
features,
overrides
);
return false;
}
/**
* Popup a window
*
* Usage:
*var myWin = com.bigbad.Popup.popup("/some/url/", "myWin", myPopupFeatures);var myWin = com.bigbad.Popup.popup("/some/url/", "myWin", null, {width:600,height:400} );var myWin = com.bigbad.Popup.popup("/some/url/", "myWin", myPopupFeatures, {width:600,height:400} );