[] (0) Define 'being rendered'.

git-svn-id: http://svn.whatwg.org/webapps@3837 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Sep 14, 2009 · 5046f0f · 5046f0f
1 parent 0f4fc1b
commit 5046f0f
Show file tree

Hide file tree

Showing 2 changed files with 33 additions and 10 deletions.
diff --git a/index b/index
@@ -37889,7 +37889,7 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme
    violation reports if appropriate (e.g. if multiple radio buttons in
    a <a href=#radio-button-group title="radio button group">group</a> are marked as
    required, only one error need be reported). If one of the controls
-   is not visible to the user (e.g. it has the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute set) then user agents
+   is not <a href=#being-rendered>being rendered</a> (e.g. it has the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute set) then user agents
    may report a script error.</li>
 
    <li><p>Return a <i>negative</i> result.</li>
@@ -56209,7 +56209,7 @@ style/default.css</pre>
 
   <!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%3Cbody%3E...%3Cform%3E%0A%3Ctextarea%20name%3Dt%20cols%3D100%20rows%3D3%3E%3C%2Ftextarea%3E%3Cp%3E%0A%3Cinput%20name%3Da%20onfocus%3D%22t.value%2B%3D%27af%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27ab1%20%27%3Bb.focus()%3Bt.value%2B%3D%27ab2%20%27%3B%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22t.value%2B%3D%27bf1%20%27%3Ba.focus()%3Bt.value%2B%3D%27bf2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27bb%20%27%3B%22%3E -->
 
-  <!-- XXX
+  <!-- v2: more things to define, if no other specs define them:
    - define onfocus/onblur behaviour for Window
    - Other things to look at are IE's focus APIs (HTMLElement.setActive(),
      onBeforeActivate, onActivate, onBeforeDeactivate, onDeactivate):
@@ -56348,9 +56348,7 @@ style/default.css</pre>
   <p>An element is <dfn id=focusable>focusable</dfn> if the user agent's default
   behavior allows it to be focusable or if the element is
   <a href=#specially-focusable>specially focusable</a>, but only if the element is
-  <span>being rendered</span><!-- XXX xref, define display:none,
-  orphan nodes as not being rendered, off-screen as being rendered?
-  -->.</p>
+  <a href=#being-rendered>being rendered</a>.</p>
 
   <p>User agents should make the following elements
   <a href=#focusable>focusable</a>, unless platform conventions dictate
@@ -70811,6 +70809,18 @@ http://lxr.mozilla.org/seamonkey/search?string=nested
   language). User agents are encouraged to adapt the suggestions in
   this section to their target media.</p>
 
+  <hr><p>An element is <dfn id=being-rendered>being rendered</dfn> if it is <a href=#in-a-document>in a
+  <code>Document</code></a>, either its parent node is itself
+  <a href=#being-rendered>being rendered</a> or it is the <code>Document</code> node,
+  and it is not explicitly excluded from the rendering using the CSS
+  'display' property's 'none' value or equivalent in other styling
+  languages.</p>
+
+  <p class=note>Just being off-screen does not mean the element is
+  not <a href=#being-rendered>being rendered</a>. The presence of the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute normaly means the
+  element is not <a href=#being-rendered>being rendered</a>, though this might be
+  overriden by the style sheets.</p>
+
   </div>
 
 

diff --git a/source b/source
@@ -42433,7 +42433,7 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
    violation reports if appropriate (e.g. if multiple radio buttons in
    a <span title="radio button group">group</span> are marked as
    required, only one error need be reported). If one of the controls
-   is not visible to the user (e.g. it has the <code
+   is not <span>being rendered</span> (e.g. it has the <code
    title="attr-hidden">hidden</code> attribute set) then user agents
    may report a script error.</p></li>
 
@@ -65536,7 +65536,7 @@ interface <dfn>SQLTransactionSync</dfn> {
 
   <!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%3Cbody%3E...%3Cform%3E%0A%3Ctextarea%20name%3Dt%20cols%3D100%20rows%3D3%3E%3C%2Ftextarea%3E%3Cp%3E%0A%3Cinput%20name%3Da%20onfocus%3D%22t.value%2B%3D%27af%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27ab1%20%27%3Bb.focus()%3Bt.value%2B%3D%27ab2%20%27%3B%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22t.value%2B%3D%27bf1%20%27%3Ba.focus()%3Bt.value%2B%3D%27bf2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27bb%20%27%3B%22%3E -->
 
-  <!-- XXX
+  <!-- v2: more things to define, if no other specs define them:
    - define onfocus/onblur behaviour for Window
    - Other things to look at are IE's focus APIs (HTMLElement.setActive(),
      onBeforeActivate, onActivate, onBeforeDeactivate, onDeactivate):
@@ -65692,9 +65692,7 @@ interface <dfn>SQLTransactionSync</dfn> {
   <p>An element is <dfn>focusable</dfn> if the user agent's default
   behavior allows it to be focusable or if the element is
   <span>specially focusable</span>, but only if the element is
-  <span>being rendered</span><!-- XXX xref, define display:none,
-  orphan nodes as not being rendered, off-screen as being rendered?
-  -->.</p>
+  <span>being rendered</span>.</p>
 
   <p>User agents should make the following elements
   <span>focusable</span>, unless platform conventions dictate
@@ -84027,6 +84025,21 @@ http://lxr.mozilla.org/seamonkey/search?string=nested
   language). User agents are encouraged to adapt the suggestions in
   this section to their target media.</p>
 
+  <hr>
+
+  <p>An element is <dfn>being rendered</dfn> if it is <span>in a
+  <code>Document</code></span>, either its parent node is itself
+  <span>being rendered</span> or it is the <code>Document</code> node,
+  and it is not explicitly excluded from the rendering using the CSS
+  'display' property's 'none' value or equivalent in other styling
+  languages.</p>
+
+  <p class="note">Just being off-screen does not mean the element is
+  not <span>being rendered</span>. The presence of the <code
+  title="attr-hidden">hidden</code> attribute normaly means the
+  element is not <span>being rendered</span>, though this might be
+  overriden by the style sheets.</p>
+
   </div>