html5/spec Overview.html,1.1276,1.1277

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

Modified Files:
	Overview.html 
Log Message:
Explain how UAs are to update the <details> element in response to requests for opening/closing it. (whatwg r2104)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1276
retrieving revision 1.1277
diff -u -d -r1.1276 -r1.1277
--- Overview.html	22 Aug 2008 06:05:51 -0000	1.1276
+++ Overview.html	22 Aug 2008 07:12:49 -0000	1.1277
@@ -27272,16 +27272,17 @@
    attribute is added, the details should be shown.
 
   <p>The user should be able to request that the details be shown or hidden.
+   To honor a request for the details to be shown, the user agent must set
+   the <code title=attr-details-open><a href="#open0">open</a></code>
+   attribute on the element to the value <code title="">open</code>. To
+   honour a request for the details to be hidden, the user agent must remove
+   the <code title=attr-details-open><a href="#open0">open</a></code>
+   attribute from the element.
 
   <p>The <dfn id=open1 title=dom-details-open><code>open</code></dfn>
    attribute must <a href="#reflect">reflect</a> the <code
    title=attr-details-open><a href="#open0">open</a></code> content
-   attribute.</p>
-  <!--
-http://mail.gnome.org/archives/usability/2006-June/msg00015.html
-http://developer.apple.com/documentation/UserExperience/Conceptual/OSXHIGuidelines/XHIGControls/chapter_18_section_7.html
-https://www.google.com/base/settings
--->
+   attribute.
 
   <p class=big-issue>Rendering will be described in the Rendering section in
    due course. Basically CSS :open and :closed match the element, it's a
@@ -27292,13 +27293,11 @@
    and when it's :open it acts as if it had an XBL binding attached to it
    whose template was just <code>&lt;template>&#x25BC;&lt;content
    includes="legend:first-child"&gt;Details&lt;/content>&lt;content/>&lt;/template></code>
-   or some such.
-
-  <p class=big-issue>Clicking the legend would make it open/close (and would
-   change the content attribute). Question: Do we want the content attribute
-   to reflect the actual state like this? I think we do, the DOM not
-   reflecting state has been a pain in the neck before. But is it
-   semantically ok?
+   or some such.</p>
+  <!--
+Example ideas:
+http://mail.gnome.org/archives/usability/2006-June/msg00015.html
+-->
 
   <h4 id=datagrid><span class=secno>4.11.2 </span>The <dfn
    id=datagrid0><code>datagrid</code></dfn> element</h4>

Received on Friday, 22 August 2008 07:13:27 UTC