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...
1 parent 9179e6f commit abadd69fca28c6483db4ab6cc0511d7865da3669 @Hixie Hixie committed Jan 17, 2009
Showing with 225 additions and 3 deletions.
  1. +109 −3 index
  2. +116 −0 source
View
@@ -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
View
@@ -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.