HTML Standard Tracker

Filter

File a bug

SVNBugCommentTime (UTC)
2679[Gecko] [Webkit] window.toolbar and company.2009-01-17 00:09
@@ -38149,20 +38149,27 @@ explain that only direct children of the <menu> matter
   <pre class="idl">[<span title="dom-window-item">IndexGetter</span>, <span title="dom-window-namedItem">NameGetter</span>=OverrideBuiltins]
 interface <dfn>Window</dfn> {
   // the current browsing context
   readonly attribute <span>Window</span> <span title="dom-window">window</span>;
   readonly attribute <span>Window</span> <span title="dom-self">self</span>;
            attribute DOMString <span title="dom-name">name</span>;
   [PutForwards=href] readonly attribute <span>Location</span> <span title="dom-document-location">location</span>;
   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>();
 
   // other browsing contexts
   readonly attribute <span>Window</span> <span title="dom-frames">frames</span>;
   readonly attribute unsigned long <span title="dom-length">length</span>;
   readonly attribute <span>Window</span> <span title="dom-top">top</span>;
   [Replaceable] readonly attribute <span>Window</span> <span title="dom-opener">opener</span>;
   readonly attribute <span>Window</span> <span title="dom-parent">parent</span>;
@@ -38523,20 +38530,129 @@ interface <dfn>Window</dfn> {
    title="">name</var>, or</li>
 
    <li><span>HTML elements</span> elements that have an <code
    title="attr-id">id</code> content attribute whose value is <var
    title="">name</var>.</li>
 
   </ul>
 
 
 
+  <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 -->
 
   <p>The <dfn>origin</dfn> of a resource and the <dfn>effective script
   origin</dfn> of a resource are both either opaque identifiers or
   tuples consisting of a scheme component, a host component, a port
   component, and optionally extra data.</p>
 
   <p class="note">The extra data could include the certificate of the
   site when using encrypted connections, to ensure that if the site's

|