Skip to content
Permalink
Browse files
[gw] (2) window.toolbar and company.
git-svn-id: http://svn.whatwg.org/webapps@2679 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Jan 17, 2009
1 parent 9179e6f commit abadd69fca28c6483db4ab6cc0511d7865da3669
Showing with 225 additions and 3 deletions.
  1. +109 −3 index
  2. +116 −0 source
112 index
@@ -22,7 +22,7 @@
<div class=head>
<p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
<h1>HTML 5</h1>
<h2 class="no-num no-toc" id=draft-recommendation-&mdash;-date:-01-jan-1901>Draft Recommendation &mdash; 16 January 2009</h2>
<h2 class="no-num no-toc" id=draft-recommendation-&mdash;-date:-01-jan-1901>Draft Recommendation &mdash; 17 January 2009</h2>
<p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<dl><dt>Multiple-page version:</dt>
@@ -650,7 +650,8 @@
<li><a href=#apis-for-creating-and-navigating-browsing-contexts-by-name><span class=secno>5.2.2 </span>APIs for creating and navigating browsing contexts by name</a></li>
<li><a href=#accessing-other-browsing-contexts><span class=secno>5.2.3 </span>Accessing other browsing contexts</a></li>
<li><a href=#garbage-collection-and-browsing-contexts><span class=secno>5.2.4 </span>Garbage collection and browsing contexts</a></li>
<li><a href=#named-access-on-the-window-object><span class=secno>5.2.5 </span>Named access on the <code>Window</code> object</a></ol></li>
<li><a href=#named-access-on-the-window-object><span class=secno>5.2.5 </span>Named access on the <code>Window</code> object</a></li>
<li><a href=#browser-interface-elements><span class=secno>5.2.6 </span>Browser interface elements</a></ol></li>
<li><a href=#origin><span class=secno>5.3 </span>Origin</a>
<ol>
<li><a href=#relaxing-the-same-origin-restriction><span class=secno>5.3.1 </span>Relaxing the same-origin restriction</a></ol></li>
@@ -33583,6 +33584,13 @@ interface <dfn id=window>Window</dfn> {
readonly attribute <a href=#history-1>History</a> <a href=#dom-history title=dom-history>history</a>;
readonly attribute <a href=#undomanager>UndoManager</a> <a href=#dom-undomanager title=dom-undoManager>undoManager</a>;
<a href=#selection-0>Selection</a> <a href=#dom-getselection title=dom-getSelection>getSelection</a>();
[Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-locationbar title=dom-window-locationbar>locationbar</a>;
[Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-menubar title=dom-window-menubar>menubar</a>;
[Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-personalbar title=dom-window-personalbar>personalbar</a>;
[Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-scrollbars title=dom-window-scrollbars>scrollbars</a>;
[Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-statusbar title=dom-window-statusbar>statusbar</a>;
[Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-toolbar title=dom-window-toolbar>toolbar</a>;<!--
[Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-directories">directories</span>; // legacy (Gecko-only) -->
void <a href=#dom-window-close title=dom-window-close>close</a>();
void <a href=#dom-window-focus title=dom-window-focus>focus</a>();
void <a href=#dom-window-blur title=dom-window-blur>blur</a>();
@@ -33916,7 +33924,105 @@ interface <dfn id=window>Window</dfn> {

<li><a href=#html-elements>HTML elements</a> elements that have an <code title=attr-id><a href=#the-id-attribute>id</a></code> content attribute whose value is <var title="">name</var>.</li>

</ul><h3 id=origin><span class=secno>5.3 </span>Origin</h3>
</ul><h4 id=browser-interface-elements><span class=secno>5.2.6 </span>Browser interface elements</h4>

<p>To allow Web pages to integrate with Web browsers, certain Web
browser interface elements are exposed in a limited way to scripts
in Web pages.</p>

<p>Each interface element is represented by a <code><a href=#barprop>BarProp</a></code>
object:</p>

<pre class=idl>interface <dfn id=barprop>BarProp</dfn> {
attribute boolean <a href=#dom-barprop-visible title=dom-BarProp-visible>visible</a>;
};</pre>

<p>The <dfn id=dom-barprop-visible title=dom-BarProp-visible>visible</dfn> attribute, on
getting, must return either true or a value determined by the user
agent to most accurately represent the visibility state of the user
interface element that the object represents, as described below. On
setting, the new value must be discarded.</p>

<p>The following <code><a href=#barprop>BarProp</a></code> objects exist for each
<code>Document</code> object in a <a href=#browsing-context>browsing
context</a>. Some of the user interface elements represented by
these objects might have no equivalent in some user agents; for
those user agents, unless otherwise specified, the object must act
as if it was present and visible (i.e. its <code title=dom-BarProp-visible><a href=#dom-barprop-visible>visible</a></code> attribute must return
true).</p>

<dl><dt><dfn id=the-location-bar-barprop-object>The location bar <code>BarProp</code> object</dfn></dt>

<dd>Represents the user interface element that contains a control
that displays the <a href=#url>URL</a> of the <a href=#active-document>active
document</a>, or some similar interface concept.</dd>

<dt><dfn id=the-menu-bar-barprop-object>The menu bar <code>BarProp</code> object</dfn></dt>

<dd>Represents the user interface element that contains a list of
commands in menu form, or some similar interface concept.</dd>

<dt><dfn id=the-personal-bar-barprop-object>The personal bar <code>BarProp</code> object</dfn></dt>

<dd>Represents the user interface element that contains links to
the user's favorite pages, or some similar interface concept.</dd>

<dt><dfn id=the-scrollbar-barprop-object>The scrollbar <code>BarProp</code> object</dfn></dt>

<dd>Represents the user interface element that contains a scrolling
mechanism, or some similar interface concept.</dd>

<dt><dfn id=the-status-bar-barprop-object>The status bar <code>BarProp</code> object</dfn></dt>

<dd>Represents a user interface element found immediately below or
after the document, as appropriate for the <a href=#default-view>default
view</a>'s media. If the user agent has no such user interface
element, then the object may act as if the corresponding user
interface element was absent (i.e. its <code title=dom-BarProp-visible><a href=#dom-barprop-visible>visible</a></code> attribute may return
false).</dd>

<dt><dfn id=the-tool-bar-barprop-object>The tool bar <code>BarProp</code> object</dfn></dt>

<dd>Represents the user interface element found immediately above
or before the document, as appropriate for the <a href=#default-view>default
view</a>'s media. If the user agent has no such user interface
element, then the object may act as if the corresponding user
interface element was absent (i.e. its <code title=dom-BarProp-visible><a href=#dom-barprop-visible>visible</a></code> attribute may return
false).</dd>

</dl><p>The <dfn id=dom-window-locationbar title=dom-window-locationbar><code>locationbar</code></dfn>
attribute must return <a href=#the-location-bar-barprop-object>the location bar <code>BarProp</code>
object</a>.</p>

<p>The <dfn id=dom-window-menubar title=dom-window-menubar><code>menubar</code></dfn>
attribute must return <a href=#the-menu-bar-barprop-object>the menu bar <code>BarProp</code>
object</a>.</p>

<p>The <dfn id=dom-window-personalbar title=dom-window-personalbar><code>personalbar</code></dfn>
attribute must return <a href=#the-personal-bar-barprop-object>the personal bar <code>BarProp</code>
object</a>.</p>

<p>The <dfn id=dom-window-scrollbars title=dom-window-scrollbars><code>scrollbars</code></dfn>
attribute must return <a href=#the-scrollbar-barprop-object>the scrollbar <code>BarProp</code>
object</a>.</p>

<p>The <dfn id=dom-window-statusbar title=dom-window-statusbar><code>statusbar</code></dfn> attribute
must return <a href=#the-status-bar-barprop-object>the status bar <code>BarProp</code>
object</a>.</p>

<p>The <dfn id=dom-window-toolbar title=dom-window-toolbar><code>toolbar</code></dfn>
attribute must return <a href=#the-tool-bar-barprop-object>the tool bar <code>BarProp</code>
object</a>.</p>

<!--
<p>For legacy reasons, the <dfn
title="dom-window-directories"><code>directories</code></dfn>
attribute must also return <span>the personal bar
<code>BarProp</code> object</span>.</p>
-->


<h3 id=origin><span class=secno>5.3 </span>Origin</h3>
<!-- Hallowed are the Ori -->

<p>The <dfn id=origin-0>origin</dfn> of a resource and the <dfn id=effective-script-origin>effective script
116 source
@@ -38156,6 +38156,13 @@ interface <dfn>Window</dfn> {
readonly attribute <span>History</span> <span title="dom-history">history</span>;
readonly attribute <span>UndoManager</span> <span title="dom-undoManager">undoManager</span>;
<span>Selection</span> <span title="dom-getSelection">getSelection</span>();
[Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-locationbar">locationbar</span>;
[Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-menubar">menubar</span>;
[Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-personalbar">personalbar</span>;
[Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-scrollbars">scrollbars</span>;
[Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-statusbar">statusbar</span>;
[Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-toolbar">toolbar</span>;<!--
[Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-directories">directories</span>; // legacy (Gecko-only) -->
void <span title="dom-window-close">close</span>();
void <span title="dom-window-focus">focus</span>();
void <span title="dom-window-blur">blur</span>();
@@ -38530,6 +38537,115 @@ interface <dfn>Window</dfn> {



<h4>Browser interface elements</h4>

<p>To allow Web pages to integrate with Web browsers, certain Web
browser interface elements are exposed in a limited way to scripts
in Web pages.</p>

<p>Each interface element is represented by a <code>BarProp</code>
object:</p>

<pre class="idl">interface <dfn>BarProp</dfn> {
attribute boolean <span title="dom-BarProp-visible">visible</span>;
};</pre>

<p>The <dfn title="dom-BarProp-visible">visible</dfn> attribute, on
getting, must return either true or a value determined by the user
agent to most accurately represent the visibility state of the user
interface element that the object represents, as described below. On
setting, the new value must be discarded.</p>

<p>The following <code>BarProp</code> objects exist for each
<code>Document</code> object in a <span>browsing
context</span>. Some of the user interface elements represented by
these objects might have no equivalent in some user agents; for
those user agents, unless otherwise specified, the object must act
as if it was present and visible (i.e. its <code
title="dom-BarProp-visible">visible</code> attribute must return
true).</p>

<dl>

<dt><dfn>The location bar <code>BarProp</code> object</dfn></dt>

<dd>Represents the user interface element that contains a control
that displays the <span>URL</span> of the <span>active
document</span>, or some similar interface concept.</dd>

<dt><dfn>The menu bar <code>BarProp</code> object</dfn></dt>

<dd>Represents the user interface element that contains a list of
commands in menu form, or some similar interface concept.</dd>

<dt><dfn>The personal bar <code>BarProp</code> object</dfn></dt>

<dd>Represents the user interface element that contains links to
the user's favorite pages, or some similar interface concept.</dd>

<dt><dfn>The scrollbar <code>BarProp</code> object</dfn></dt>

<dd>Represents the user interface element that contains a scrolling
mechanism, or some similar interface concept.</dd>

<dt><dfn>The status bar <code>BarProp</code> object</dfn></dt>

<dd>Represents a user interface element found immediately below or
after the document, as appropriate for the <span>default
view</span>'s media. If the user agent has no such user interface
element, then the object may act as if the corresponding user
interface element was absent (i.e. its <code
title="dom-BarProp-visible">visible</code> attribute may return
false).</dd>

<dt><dfn>The tool bar <code>BarProp</code> object</dfn></dt>

<dd>Represents the user interface element found immediately above
or before the document, as appropriate for the <span>default
view</span>'s media. If the user agent has no such user interface
element, then the object may act as if the corresponding user
interface element was absent (i.e. its <code
title="dom-BarProp-visible">visible</code> attribute may return
false).</dd>

</dl>

<p>The <dfn
title="dom-window-locationbar"><code>locationbar</code></dfn>
attribute must return <span>the location bar <code>BarProp</code>
object</span>.</p>

<p>The <dfn title="dom-window-menubar"><code>menubar</code></dfn>
attribute must return <span>the menu bar <code>BarProp</code>
object</span>.</p>

<p>The <dfn
title="dom-window-personalbar"><code>personalbar</code></dfn>
attribute must return <span>the personal bar <code>BarProp</code>
object</span>.</p>

<p>The <dfn
title="dom-window-scrollbars"><code>scrollbars</code></dfn>
attribute must return <span>the scrollbar <code>BarProp</code>
object</span>.</p>

<p>The <dfn
title="dom-window-statusbar"><code>statusbar</code></dfn> attribute
must return <span>the status bar <code>BarProp</code>
object</span>.</p>

<p>The <dfn title="dom-window-toolbar"><code>toolbar</code></dfn>
attribute must return <span>the tool bar <code>BarProp</code>
object</span>.</p>

<!--
<p>For legacy reasons, the <dfn
title="dom-window-directories"><code>directories</code></dfn>
attribute must also return <span>the personal bar
<code>BarProp</code> object</span>.</p>
-->


<h3>Origin</h3>
<!-- Hallowed are the Ori -->

0 comments on commit abadd69

Please sign in to comment.