Short URL: http://html5.org/r/2679
| SVN | Bug | Comment | Time (UTC) |
|---|---|---|---|
| 2679 | 2009-01-17 00:09 |
Index: source
===================================================================
--- source (revision 2678)
+++ source (revision 2679)
@@ -38156,6 +38156,13 @@
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 @@
+ <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 -->