html5/spec Overview.html,1.1848,1.1849

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv19642

Modified Files:
	Overview.html 
Log Message:
window.toolbar and company. (whatwg r2679)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1848
retrieving revision 1.1849
diff -u -d -r1.1848 -r1.1849
--- Overview.html	16 Jan 2009 22:44:56 -0000	1.1848
+++ Overview.html	17 Jan 2009 00:09:55 -0000	1.1849
@@ -8,7 +8,7 @@
    <p><a href=http://www.w3.org/><img alt=W3C height=48 src=http://www.w3.org/Icons/w3c_home width=72></a></p>
    <h1>HTML 5</h1>
    <h2 class="no-num no-toc" id=a-vocabulary-and-associated-apis-for-html-and-xhtml>A vocabulary and associated APIs for HTML and XHTML</h2>
-   <h2 class="no-num no-toc" id=editor-s-draft-date-zzz-9-june-2008><!-- "W3C Working Draft" --> Editor's Draft <!--ZZZ-->16 January 2009</h2>
+   <h2 class="no-num no-toc" id=editor-s-draft-date-zzz-9-june-2008><!-- "W3C Working Draft" --> Editor's Draft <!--ZZZ-->17 January 2009</h2>
    <dl><!-- ZZZ: update the month/day
     <dt>This Version:</dt>
     <dd><a href="http://www.w3.org/TR/2009/WD-html5-20090610/">http://www.w3.org/TR/2009/WD-html5-20090610/</a></dd>
@@ -97,7 +97,7 @@
   specification's progress along the W3C Recommendation
   track.
   <!--ZZZ:-->
-  This specification is the 16 January 2009 <!--ZZZ "Working Draft"-->Editor's Draft.
+  This specification is the 17 January 2009 <!--ZZZ "Working Draft"-->Editor's Draft.
   <!--:ZZZ-->
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href=http://www.whatwg.org/>WHATWG</a>. The two specifications are
   identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -583,7 +583,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>
@@ -27216,6 +27217,13 @@
   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>();
@@ -27467,7 +27475,78 @@
 
    <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><!-- Hallowed are the Ori --><p>The <dfn id=origin-0>origin</dfn> of a resource and the <dfn id=effective-script-origin>effective script
+  </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>Each interface element is represented by a <code><a href=#barprop>BarProp</a></code>
+  object:<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>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).<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>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>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>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>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>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
   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 class=note>The extra data could include the certificate of the

Received on Saturday, 17 January 2009 00:10:07 UTC