Compare Revisions

Window.open

Revision 64285:

Revision 64285 by Potappo on

Revision 64286:

Revision 64286 by GT on

Title:
window.open
window.open
Slug:
DOM/window.open
DOM/window.open
Tags:
DOM, Gecko, NeedsUpdate, "Gecko DOM Reference", NeedsCompatTable
DOM, Gecko, NeedsUpdate, "Gecko DOM Reference", NeedsCompatTable
Content:

Revision 64285
Revision 64286
n19    <pre class="eval">n19    <p>
20var <var>win</var> = window.open(<var>url</var>, <var>name</var> 20      var <var>WindowObjectReference</var> = window.open(<var>str
>[, <var>features</var>]);>Url</var>, <var>strWindowName</var> {{mediawiki.external(', &lt;v
 >ar&gt;strWindowFeatures&lt;/var&gt;')}});
21</pre>21    </p>
n27        <code>win</code>&nbsp;n27        <code>WindowObjectReference</code>
28      </dt>
29      <dd>
30        the <code>window</code> of the newly opened document. Thi
>s value will be <code>null</code> if for some reasons the call di 
>d not succeed to open the window (e.g. because a popup blocker pr 
>evented it from opening). 
31      </dd>
32    </dl>
33    <dl>
34      <dt>28      </dt>
35        <code>url</code>&nbsp;29    </dl>
30    <p>
31      This is the reference pointing to the newly created browser
 > window. This reference is the return value of the open() method;
 > it will be <code>null</code> if for some reasons the execution d
 >id not succeed to open the window. A global variable is best used
 > to store such reference. You can then, for example, use it to lo
 >ok for properties of the new window or access its methods, assumi
 >ng that your main versus secondary window relationship complies w
 >ith <a class="external" href="http://www.mozilla.org/projects/sec
 >urity/components/same-origin.html">Same origin policy</a> securit
 >y requirements.
32    </p>
33    <dl>
36      </dt>34      <dt>
37      <dd>35        <code>strUrl</code>
38        the URL to be loaded in the newly opened window.
39      </dd>
40    </dl>
41    <dl>
42      <dt>36      </dt>
43        <code>name</code>&nbsp;37    </dl>
38    <p>
39      This is the URL to be loaded in the newly opened window. <c
 >ode>strUrl</code> can be an HTML document on the web, it can be a
 >n image file or any type of file which is supported by the browse
 >r.
40    </p>
41    <dl>
44      </dt>42      <dt>
45      <dd>43        <code>strWindowName</code>
46        a name by which the new window can be referenced, e.g. as
> the target of links or forms when the target attribute of an <co 
>de style="font-size: 1em;">&lt;a&gt;</code> element or of a <code 
> style="font-size: 1em;">&lt;form&gt;</code> is specified as the  
>"name" given in the string. This string parameter should not cont 
>ain any blank space. <var>name</var> does NOT specify the title o 
>f the new window. 
47      </dd>
48    </dl>
49    <dl>
50      <dt>44      </dt>
51        <code>features</code>&nbsp;45    </dl>
46    <p>
47      This is the string that just names the new window. Such str
 >ing can be used to be the target of links and forms when the targ
 >et attribute of an <code style="font-size: 1em;">&lt;a&gt;</code>
 > element or of a <code style="font-size: 1em;">&lt;form&gt;</code
 >> is specified. This string parameter should not contain any blan
 >k space. <code>strWindowName</code> does not specify the title of
 > the new window.
48    </p>
49    <dl>
52      </dt>50      <dt>
51        <code>strWindowFeatures</code>
53      <dd>52      </dt>
53    </dl>
54    <p>
54        Optional parameter. This parameter is the string which li55      Optional parameter. This parameter is the string which list
>sts the requested window features (window functionalities and too>s the requested window features (window functionalities and toolb
>lbars) of the new browser window. This string parameter must not >ars) of the new browser window. This string parameter must not co
>contain any blank space. Each requested window feature must be se>ntain any blank space. Each requested window feature must be sepa
>parated by a comma inside the character string.>rated by a comma inside the character string.
55      </dd>
56    </dl>56    </p>
n61      The <code>open()</code> method creates a new secondary brown61      The <code>open()</code> method creates a new secondary brow
>ser window, similar to choosing New Window from the File menu. Th>ser window, similar to choosing New Window from the File menu. Th
>e <var>url</var> parameter specifies the URL to be fetched and lo>e <var>strUrl</var> parameter specifies the URL to be fetched and
>aded in the new window. If <var>url</var> is an empty string, the> loaded in the new window. If <var>strUrl</var> is an empty strin
>n a new blank, empty window (URL <code>about:blank</code> loaded)>g, then a new blank, empty window (URL <code>about:blank</code> l
> is created with the default toolbars of the main window.>oaded) is created with the default toolbars of the main window.
n70var win;n70var WindowObjectReference;
71var features = "menubar=yes,location=yes,resizable=yes,scrollbars71var strWindowFeatures = "menubar=yes,location=yes,resizable=yes,s
>=yes,status=yes";>crollbars=yes,status=yes";
72</pre>
73    <p>
74      <br>
75    </p>
76    <pre class="eval">
77function openRequestedPopup()
78{
79  WindowObjectReference = window.open("http://www.cnn.com/",
80"CNN_WindowName", strWindowFeatures);
81}
82</pre>
83    <pre class="eval">
84var WindowObjectReference;
n75  win = window.open("http://www.cnn.com/", "CNN_WindowName", featn88  WindowObjectReference = window.open("http://www.domainname.ext/
>ures);>path/ImageFile.png",
89                  "DescriptiveWindowName",
90                  "resizable=yes,scrollbars=yes,status=yes");
n79      <br>n94      If a window with the name <var>strWindowName</var> already 
 >exists, then, instead of opening a new window, <var>strUrl</var> 
 >is loaded into the existing window. In this case the return value
 > of the method is the existing window and <var>strWindowFeatures<
 >/var> is ignored. Providing an empty string for <var>strUrl</var>
 > is a way to get a reference to an open window by its name withou
 >t changing the window's location. If you want to open a new windo
 >w on every call of <code>window.open()</code>, you should use the
 > special value <var>_blank</var> for <var>strWindowName</var>.
80    </p>
81    <pre class="eval">
82var win;
83 
84function openRequestedPopup()
85{
86  win = window.open("http://www.domainname.ext/path/ImageFile.png
>", 
87                    "DescriptiveWindowName",
88                    "resizable=no,scrollbars=yes,status=no");
89}
90</pre>
91    <p>95    </p>
92      If a window with the name <var>name</var> already exists, t
>hen, instead of opening a new window, <var>url</var> is loaded in 
>to the existing window. In this case the return value of the meth 
>od is the existing window and <var>features</var> is ignored. Pro 
>viding an empty string for <var>url</var> is a way to get a refer 
>ence to an open window by its name without changing the window's  
>location. If you want to open a new window on every call of <code 
>>window.open()</code>, you should use the special value <var>_bla 
>nk</var> for <var>name</var>. 
93    </p>96    <p>
94    <p>
95      <var>features</var> is an optional string containing a comm97      <var>strWindowFeatures</var> is an optional string containi
>a-separated list of requested features of the new window. After a>ng a comma-separated list of requested features of the new window
> window is opened, you can not use JavaScript to change the windo>. After a window is opened, you can not use JavaScript to change 
>w functionalities and the window toolbars. If <var>name</var> doe>the window functionalities and the window toolbars. If <var>strWi
>s not specify an existing window and if you do not supply the <va>ndowName</var> does not specify an existing window and if you do 
>r>features</var> parameter (or if the <var>features</var> paramet>not supply the <var>strWindowFeatures</var> parameter (or if the 
>er is an empty string), then the new secondary window will render><var>strWindowFeatures</var> parameter is an empty string), then 
> the default toolbars of the main window.>the new secondary window will render the default toolbars of the 
 >main window.
96    </p>
97    <p>98    </p>
99    <p>
98      If the <var>features</var> parameter is used and if no size100      If the <var>strWindowFeatures</var> parameter is used and i
> features are defined, then the new window dimensions will be the>f no size features are defined, then the new window dimensions wi
> same as the dimensions of the most recently rendered window.>ll be the same as the dimensions of the most recently rendered wi
 >ndow.
99    </p>
100    <p>101    </p>
102    <p>
101      If the <var>features</var> parameter is used and if no posi103      If the <var>strWindowFeatures</var> parameter is used and i
>tion features are defined, then the left and top coordinates of t>f no position features are defined, then the left and top coordin
>he new window dimension will be 22 pixels off from where the most>ates of the new window dimension will be 22 pixels off from where
> recently rendered window was. An offset is universally implement> the most recently rendered window was. An offset is universally 
>ed by browser manufacturers (it is 29 pixels in MSIE 6 SP2 with t>implemented by browser manufacturers (it is 29 pixels in MSIE 6 S
>he default theme) and its purpose is to help users to notice new >P2 with the default theme) and its purpose is to help users to no
>windows opening. If the most recently used window was maximized, >tice new windows opening. If the most recently used window was ma
>then there is no 22 pixels offset: the new, secondary window will>ximized, then there is no 22 pixels offset: the new, secondary wi
> be maximized as well.>ndow will be maximized as well.
102    </p>
103    <p>104    </p>
105    <p>
104      <strong>If you define the <var>features</var> parameter, th106      <strong>If you define the <var>strWindowFeatures</var> para
>en the features that are not listed, requested in the string will>meter, then the features that are not listed, requested in the st
> be disabled or removed</strong> (except <var>titlebar</var> and >ring will be disabled or removed</strong> (except <var>titlebar</
><var>close</var> which are by default <var>yes</var>).>var> and <var>close</var> which are by default <var>yes</var>).
n108        <strong>Tip</strong>: If you use the <var>features</var> n110        <strong>Tip</strong>: If you use the <var>strWindowFeatur
>parameter, then only list the features you want to include in the>es</var> parameter, then only list the features you want to inclu
> new window, that you want to be enabled or rendered; the others >de in the new window, that you want to be enabled or rendered; th
>(except <var>titlebar</var> and <var>close</var>) will be disable>e others (except <var>titlebar</var> and <var>close</var>) will b
>d, removed.>e disabled, removed.
n368      It is expected to see secondary window always resizable stan370      Starting with Firefox 3, secondary windows are always resiz
>rting from Firefox 3 ({{template.Bug(177838)}})>able ({{template.Bug(177838)}})
n657    <pre class="eval">n659    <pre>
658var win = null;660 &lt;script type="text/javascript"&gt;
661 var WindowObjectReference = null; // global variable
n660function openRequestedPopup(url, name)n663 function openRequestedPopup(strUrl, strWindowName)
661{664 {
662  if (win == null || win.closed)665  if(WindowObjectReference == null || WindowObjectReference.close
 >d)
663    win = window.open(url, name, "resizable=yes,scrollbars=yes,st666  {
>atus=yes"); 
667    WindowObjectReference = window.open(strUrl, strWindowName,
668           "resizable=yes,scrollbars=yes,status=yes");
669  }
t665    win.focus();t671  {
666}672    WindowObjectReference.focus();
667</pre>673  };
668    <pre>674 }
675 &lt;/script"&gt;
676 (...)
677 
669&lt;p&gt;&lt;a href="http://www.spreadfirefox.com/" target="Promo678 &lt;p&gt;&lt;a href="http://www.spreadfirefox.com/" target="Prom
>teFirefoxWindow">oteFirefoxWindow"
670onclick="openRequestedPopup(this.href, this.target); return false679 onclick="openRequestedPopup(this.href, this.target); return fals
>;">e;"
671title="This link will create a new window or will re-use 680 title="This link will create a new window or will re-use 
672an already opened one"&gt;Promote681 an already opened one"&gt;Promote
673Firefox adoption&lt;/a&gt;&lt;/p&gt;682 Firefox adoption&lt;/a&gt;&lt;/p&gt;

Back to History