| window.open('url to open','window name','attribute1,attribute2')
This is the function that allows you to open a new browser window for the viewer to use. Note that all the names and attributes are separated with a comma rather than spaces. Here is what all the stuff inside is:
- 'url to open'
This is the web address of the page you wish to appear in the new window.
- 'window name'
You can name your window whatever you like, in case you need to make a reference to the window later.
As with alot of other things, you have a choice of attributes you can adjust.
Below is a list of the attributes you can use:
Use this to define the width of the new window.
Use this to define the height of the new window.
- resizable=yes or no
Use this to control whether or not you want the user to be able to resize the window.
- scrollbars=yes or no
This lets you decide whether or not to have scrollbars on the window.
- toolbar=yes or no
Whether or not the new window should have the browser navigation bar at the top (The back, foward, stop buttons..etc.).
- location=yes or no
Whether or not you wish to show the location box with the current url (The place to type http://address).
- directories=yes or no
Whether or not the window should show the extra buttons. (what's cool, personal buttons, etc...).
- status=yes or no
Whether or not to show the window status bar at the bottom of the window.
- menubar=yes or no
Whether or not to show the menus at the top of the window (File, Edit, etc...).
- copyhistory=yes or no
Whether or not to copy the old browser window's history list to the new window.
All right, here's an example code for opening a new window:
<INPUT type="button" value="New Window!" onClick="window.open('http://www.pageresource.com/jscript/jex5.htm', 'mywindow','width=400,height=200')">
Yes, you got a 400 by 200 window with some writing in it!
Some Important Rules
Before we move on, we need to make note of some things so you won't go insane like I did trying to get this to work right!
- Once you come to the onClick=" ", don't leave any spaces between anything. Just use the commas and the quote marks. Any white space will keep it from working correctly in Netscape.
- Don't put quote marks around the yes, no, or numbers for the attributes. You only use single quotes around the entire set of attributes.
- In some browsers, you may need to substitute the number 1 for yes, and the number zero for no in the attributes section. The yes or no should work fine, though.
A New Browser Window
Okay, enough rules. Let's look at the code that makes a completely new browser! Basically, you just use yes for all of the attributes. Here is the code:
<INPUT type="button" value="New Window!" onClick="window.open('http://www.pageresource.com/jscript/jex5.htm', 'mywindow','width=400,height=200,toolbar=yes,
Remember, keep everything on one line....one really, really long line! I just put the sample code on new lines so you wouldn't have to scroll forever to read everything........and your printer won't go crazy now either!
Closing a New Window
Hmm.....what's with the "Close Window" button you saw in the new window? How does one do do that? To use that trick, use the window.close() function in the HTML of the new window. Just put this code wherever you want the close button to show up in the new window:
<INPUT type="button" value="Close Window" onClick="window.close()">
Of course, the window can be closed with the "x" symbol on the top-right of the window as well.
Set the Window Position
There is another set of options you can use to set the position of the new window on the viewers, but it only works with NS4+ and IE4+:
- screenX=number in pixels
Sets the position of the window in pixels from the left of the screen in Netscape 4+.
- screenY=number in pixels
Sets the position of the window in pixels from the top of the screen in Netscape 4+.
- left=number in pixels
Sets the position of the window in pixels from the left of the screen in IE 4+.
- top=number in pixels
Sets the position of the window in pixels from the top of the screen in IE 4+.
Great, but how do you decide which commands to use if there are different ones for each browser? In this case, you can use both sets of commands- the browser will ignore the set it does not recognize. The example below will give you a new window 0 pixels from the left and 100 pixels from the top of your screen:
<INPUT type="button" value="New Window!" onClick="window.open('jex5.htm','mywindow', 'width=400,height=200,left=0,top=100,screenX=0,screenY=100')">
Now, that is a lot of work- but you can now customize a new window for your viewers!