[html5] r2104 - [] (0) Explain how UAs are to update the <details> element in response to reques [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2008-08-22 00:12:59 -0700 (Fri, 22 Aug 2008)
New Revision: 2104

Modified:
   index
   source
Log:
[] (0) Explain how UAs are to update the <details> element in response to requests for opening/closing it.

Modified: index
===================================================================
--- index	2008-08-22 06:06:00 UTC (rev 2103)
+++ index	2008-08-22 07:12:59 UTC (rev 2104)
@@ -27264,16 +27264,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
@@ -27284,14 +27285,12 @@
    and when it's :open it acts as if it had an XBL binding attached to it
    whose template was just <code><template>&#x25BC;<content
    includes="legend:first-child">Details</content><content/></template></code>
-   or some such.
+   or some such.</p>
+  <!--
+Example ideas:
+http://mail.gnome.org/archives/usability/2006-June/msg00015.html
+-->
 
-  <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?
-
   <h4 id=datagrid><span class=secno>4.11.2 </span>The <dfn
    id=datagrid0><code>datagrid</code></dfn> element</h4>
 

Modified: source
===================================================================
--- source	2008-08-22 06:06:00 UTC (rev 2103)
+++ source	2008-08-22 07:12:59 UTC (rev 2104)
@@ -24665,18 +24665,17 @@
   hidden. If the attribute is added, the details should be shown.</p>
 
   <p>The user should be able to request that the details be shown or
-  hidden.</p>
+  hidden. To honor a request for the details to be shown, the user
+  agent must set the <code title="attr-details-open">open</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">open</code> attribute
+  from the element.</p>
 
   <p>The <dfn title="dom-details-open"><code>open</code></dfn>
   attribute must <span>reflect</span> the <code
   title="attr-details-open">open</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
--->
-
   <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 block-level element by default, and when it matches
@@ -24688,14 +24687,14 @@
   includes="legend:first-child">Details</content><content/></template></code>
   or some such.</p>
 
-  <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?</p>
+<!--
+Example ideas:
+http://mail.gnome.org/archives/usability/2006-June/msg00015.html
+-->
 
 
 
+
   <h4 id="datagrid">The <dfn><code>datagrid</code></dfn> element</h4>
 
   <dl class="element">