| // =================================================================== |
| // Author: Matt Kruse <matt@mattkruse.com> |
| // WWW: http://www.mattkruse.com/ |
| // |
| // NOTICE: You may use this code for any purpose, commercial or |
| // private, without any further permission from the author. You may |
| // remove this notice from your final code if you wish, however it is |
| // appreciated by the author if at least my web site address is kept. |
| // |
| // You may *NOT* re-distribute this code in any way except through its |
| // use. That means, you can include it in your product, or your web |
| // site, or any other form where the code is actually being used. You |
| // may not put the plain javascript up on your site for download or |
| // include it in your javascript libraries for download. |
| // If you wish to share this code with others, please just point them |
| // to the URL instead. |
| // Please DO NOT link directly to my .js files from your site. Copy |
| // the files to your server and use them there. Thank you. |
| // =================================================================== |
| |
| /* |
| PopupWindow.js |
| Author: Matt Kruse |
| Last modified: 05/15/03 |
| |
| DESCRIPTION: This object allows you to easily and quickly popup a window |
| in a certain place. The window can either be a DIV or a separate browser |
| window. |
| |
| COMPATIBILITY: Works with Netscape 4.x, 6.x, IE 5.x on Windows. Some small |
| positioning errors - usually with Window positioning - occur on the |
| Macintosh platform. Due to bugs in Netscape 4.x, populating the popup |
| window with <STYLE> tags may cause errors. |
| |
| USAGE: |
| // Create an object for a WINDOW popup |
| var win = new PopupWindow(); |
| |
| // Create an object for a DIV window using the DIV named 'mydiv' |
| var win = new PopupWindow('mydiv'); |
| |
| // Set the window to automatically hide itself when the user clicks |
| // anywhere else on the page except the popup |
| win.autoHide(); |
| |
| // Show the window relative to the anchor name passed in |
| win.showPopup(anchorname); |
| |
| // Hide the popup |
| win.hidePopup(); |
| |
| // Set the size of the popup window (only applies to WINDOW popups |
| win.setSize(width,height); |
| |
| // Populate the contents of the popup window that will be shown. If you |
| // change the contents while it is displayed, you will need to refresh() |
| win.populate(string); |
| |
| // set the URL of the window, rather than populating its contents |
| // manually |
| win.setUrl("http://www.site.com/"); |
| |
| // Refresh the contents of the popup |
| win.refresh(); |
| |
| // Specify how many pixels to the right of the anchor the popup will appear |
| win.offsetX = 50; |
| |
| // Specify how many pixels below the anchor the popup will appear |
| win.offsetY = 100; |
| |
| NOTES: |
| 1) Requires the functions in AnchorPosition.js |
| |
| 2) Your anchor tag MUST contain both NAME and ID attributes which are the |
| same. For example: |
| <A NAME="test" ID="test"> </A> |
| |
| 3) There must be at least a space between <A> </A> for IE5.5 to see the |
| anchor tag correctly. Do not do <A></A> with no space. |
| |
| 4) When a PopupWindow object is created, a handler for 'onmouseup' is |
| attached to any event handler you may have already defined. Do NOT define |
| an event handler for 'onmouseup' after you define a PopupWindow object or |
| the autoHide() will not work correctly. |
| */ |
| |
| // Set the position of the popup window based on the anchor |
| function PopupWindow_getXYPosition(anchorname) { |
| var coordinates; |
| if (this.type == "WINDOW") { |
| coordinates = getAnchorWindowPosition(anchorname); |
| } |
| else { |
| coordinates = getAnchorPosition(anchorname); |
| } |
| this.x = coordinates.x; |
| this.y = coordinates.y; |
| } |
| // Set width/height of DIV/popup window |
| function PopupWindow_setSize(width,height) { |
| this.width = width; |
| this.height = height; |
| } |
| // Fill the window with contents |
| function PopupWindow_populate(contents) { |
| this.contents = contents; |
| this.populated = false; |
| } |
| // Set the URL to go to |
| function PopupWindow_setUrl(url) { |
| this.url = url; |
| } |
| // Set the window popup properties |
| function PopupWindow_setWindowProperties(props) { |
| this.windowProperties = props; |
| } |
| // Refresh the displayed contents of the popup |
| function PopupWindow_refresh() { |
| if (this.divName != null) { |
| // refresh the DIV object |
| if (this.use_gebi) { |
| document.getElementById(this.divName).innerHTML = this.contents; |
| } |
| else if (this.use_css) { |
| document.all[this.divName].innerHTML = this.contents; |
| } |
| else if (this.use_layers) { |
| var d = document.layers[this.divName]; |
| d.document.open(); |
| d.document.writeln(this.contents); |
| d.document.close(); |
| } |
| } |
| else { |
| if (this.popupWindow != null && !this.popupWindow.closed) { |
| if (this.url!="") { |
| this.popupWindow.location.href=this.url; |
| } |
| else { |
| this.popupWindow.document.open(); |
| this.popupWindow.document.writeln(this.contents); |
| this.popupWindow.document.close(); |
| } |
| this.popupWindow.focus(); |
| } |
| } |
| } |
| // Position and show the popup, relative to an anchor object |
| function PopupWindow_showPopup(anchorname) { |
| this.getXYPosition(anchorname); |
| this.x += this.offsetX; |
| this.y += this.offsetY; |
| if (!this.populated && (this.contents != "")) { |
| this.populated = true; |
| this.refresh(); |
| } |
| if (this.divName != null) { |
| // Show the DIV object |
| if (this.use_gebi) { |
| document.getElementById(this.divName).style.left = this.x; |
| document.getElementById(this.divName).style.top = this.y; |
| document.getElementById(this.divName).style.visibility = "visible"; |
| } |
| else if (this.use_css) { |
| document.all[this.divName].style.left = this.x; |
| document.all[this.divName].style.top = this.y; |
| document.all[this.divName].style.visibility = "visible"; |
| } |
| else if (this.use_layers) { |
| document.layers[this.divName].left = this.x; |
| document.layers[this.divName].top = this.y; |
| document.layers[this.divName].visibility = "visible"; |
| } |
| } |
| else { |
| if (this.popupWindow == null || this.popupWindow.closed) { |
| // If the popup window will go off-screen, move it so it doesn't |
| if (this.x<0) { this.x=0; } |
| if (this.y<0) { this.y=0; } |
| if (screen && screen.availHeight) { |
| if ((this.y + this.height) > screen.availHeight) { |
| this.y = screen.availHeight - this.height; |
| } |
| } |
| if (screen && screen.availWidth) { |
| if ((this.x + this.width) > screen.availWidth) { |
| this.x = screen.availWidth - this.width; |
| } |
| } |
| this.popupWindow = window.open("about:blank","window_"+anchorname,this.windowProperties+",width="+this.width+",height="+this.height+",screenX="+this.x+",left="+this.x+",screenY="+this.y+",top="+this.y+""); |
| } |
| this.refresh(); |
| } |
| } |
| // Hide the popup |
| function PopupWindow_hidePopup() { |
| if (this.divName != null) { |
| if (this.use_gebi) { |
| document.getElementById(this.divName).style.visibility = "hidden"; |
| } |
| else if (this.use_css) { |
| document.all[this.divName].style.visibility = "hidden"; |
| } |
| else if (this.use_layers) { |
| document.layers[this.divName].visibility = "hidden"; |
| } |
| } |
| else { |
| if (this.popupWindow && !this.popupWindow.closed) { |
| this.popupWindow.close(); |
| this.popupWindow = null; |
| } |
| } |
| } |
| // Pass an event and return whether or not it was the popup DIV that was clicked |
| function PopupWindow_isClicked(e) { |
| if (this.divName != null) { |
| if (this.use_layers) { |
| var clickX = e.pageX; |
| var clickY = e.pageY; |
| var t = document.layers[this.divName]; |
| if ((clickX > t.left) && (clickX < t.left+t.clip.width) && (clickY > t.top) && (clickY < t.top+t.clip.height)) { |
| return true; |
| } |
| else { return false; } |
| } |
| else if (document.all) { // Need to hard-code this to trap IE for error-handling |
| var t = window.event.srcElement; |
| while (t.parentElement != null) { |
| if (t.id==this.divName) { |
| return true; |
| } |
| t = t.parentElement; |
| } |
| return false; |
| } |
| else if (this.use_gebi) { |
| var t = e.originalTarget; |
| while (t.parentNode != null) { |
| if (t.id==this.divName) { |
| return true; |
| } |
| t = t.parentNode; |
| } |
| return false; |
| } |
| return false; |
| } |
| return false; |
| } |
| |
| // Check an onMouseDown event to see if we should hide |
| function PopupWindow_hideIfNotClicked(e) { |
| if (this.autoHideEnabled && !this.isClicked(e)) { |
| this.hidePopup(); |
| } |
| } |
| // Call this to make the DIV disable automatically when mouse is clicked outside it |
| function PopupWindow_autoHide() { |
| this.autoHideEnabled = true; |
| } |
| // This global function checks all PopupWindow objects onmouseup to see if they should be hidden |
| function PopupWindow_hidePopupWindows(e) { |
| for (var i=0; i<popupWindowObjects.length; i++) { |
| if (popupWindowObjects[i] != null) { |
| var p = popupWindowObjects[i]; |
| p.hideIfNotClicked(e); |
| } |
| } |
| } |
| // Run this immediately to attach the event listener |
| function PopupWindow_attachListener() { |
| if (document.layers) { |
| document.captureEvents(Event.MOUSEUP); |
| } |
| window.popupWindowOldEventListener = document.onmouseup; |
| if (window.popupWindowOldEventListener != null) { |
| document.onmouseup = new Function("window.popupWindowOldEventListener(); PopupWindow_hidePopupWindows();"); |
| } |
| else { |
| document.onmouseup = PopupWindow_hidePopupWindows; |
| } |
| } |
| // CONSTRUCTOR for the PopupWindow object |
| // Pass it a DIV name to use a DHTML popup, otherwise will default to window popup |
| function PopupWindow() { |
| if (!window.popupWindowIndex) { window.popupWindowIndex = 0; } |
| if (!window.popupWindowObjects) { window.popupWindowObjects = new Array(); } |
| if (!window.listenerAttached) { |
| window.listenerAttached = true; |
| PopupWindow_attachListener(); |
| } |
| this.index = popupWindowIndex++; |
| popupWindowObjects[this.index] = this; |
| this.divName = null; |
| this.popupWindow = null; |
| this.width=0; |
| this.height=0; |
| this.populated = false; |
| this.visible = false; |
| this.autoHideEnabled = false; |
| |
| this.contents = ""; |
| this.url=""; |
| this.windowProperties="toolbar=no,location=no,status=no,menubar=no,scrollbars=auto,resizable,alwaysRaised,dependent,titlebar=no"; |
| if (arguments.length>0) { |
| this.type="DIV"; |
| this.divName = arguments[0]; |
| } |
| else { |
| this.type="WINDOW"; |
| } |
| this.use_gebi = false; |
| this.use_css = false; |
| this.use_layers = false; |
| if (document.getElementById) { this.use_gebi = true; } |
| else if (document.all) { this.use_css = true; } |
| else if (document.layers) { this.use_layers = true; } |
| else { this.type = "WINDOW"; } |
| this.offsetX = 0; |
| this.offsetY = 0; |
| // Method mappings |
| this.getXYPosition = PopupWindow_getXYPosition; |
| this.populate = PopupWindow_populate; |
| this.setUrl = PopupWindow_setUrl; |
| this.setWindowProperties = PopupWindow_setWindowProperties; |
| this.refresh = PopupWindow_refresh; |
| this.showPopup = PopupWindow_showPopup; |
| this.hidePopup = PopupWindow_hidePopup; |
| this.setSize = PopupWindow_setSize; |
| this.isClicked = PopupWindow_isClicked; |
| this.autoHide = PopupWindow_autoHide; |
| this.hideIfNotClicked = PopupWindow_hideIfNotClicked; |
| } |
| |