[e] (0) Clarify rules for drawing focus rings

Affected topics: Canvas git-svn-id: http://svn.whatwg.org/webapps@8227 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Oct 16, 2013 · a580aec · a580aec
1 parent d0832ff
commit a580aec
Show file tree

Hide file tree

Showing 3 changed files with 33 additions and 4 deletions.
diff --git a/complete.html b/complete.html
@@ -256,7 +256,7 @@
 
   <header class=head id=head><p><a href=http://www.whatwg.org/ class=logo><img width=101 src=/images/logo alt=WHATWG height=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 15 October 2013</h2>
+    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 16 October 2013</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -37232,7 +37232,16 @@ <h6 id=drawing-paths-to-the-canvas><span class=secno>4.8.11.2.13 </span>Drawing
 
    <li><p>Return <var title="">result</var>.</li>
 
-  </ol><p>The <dfn id=dom-context-2d-scrollpathintoview title=dom-context-2d-scrollPathIntoView><code>scrollPathIntoView()</code></dfn>
+  </ol><p>User agents should not implicitly close open subpaths in the intended path when drawing the
+  focus ring.</p>
+
+  <p class=note>This might be a moot point, however. For example, if the focus ring is drawn as an
+  axis-aligned bounding rectangle around the points in the intended path, then whether the subpaths
+  are closed or not has no effect. This specification intentionally does not specify precisely how
+  focus rings are to be drawn: user agents are expected to honor their platform's native
+  conventions.</p>
+
+  <hr><p>The <dfn id=dom-context-2d-scrollpathintoview title=dom-context-2d-scrollPathIntoView><code>scrollPathIntoView()</code></dfn>
   method, when invoked, if the <code><a href=#canvasrenderingcontext2d>CanvasRenderingContext2D</a></code> object's <a href=#concept-canvas-context-bitmap-mode title=concept-canvas-context-bitmap-mode>context bitmap mode</a> is <a href=#concept-canvas-fixed title=concept-canvas-fixed>fixed</a>, must run the following steps; and otherwise, must add
   instructions to the <a href=#scratch-bitmap>scratch bitmap</a>'s <a href=#list-of-pending-interface-actions>list of pending interface actions</a>
   that run the following steps:</p>

diff --git a/index b/index
@@ -256,7 +256,7 @@
 
   <header class=head id=head><p><a href=http://www.whatwg.org/ class=logo><img width=101 src=/images/logo alt=WHATWG height=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 15 October 2013</h2>
+    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 16 October 2013</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -37232,7 +37232,16 @@ v6DVT (also check for '- -' bits in the part above) --><p>The <dfn id=dom-contex
 
    <li><p>Return <var title="">result</var>.</li>
 
-  </ol><p>The <dfn id=dom-context-2d-scrollpathintoview title=dom-context-2d-scrollPathIntoView><code>scrollPathIntoView()</code></dfn>
+  </ol><p>User agents should not implicitly close open subpaths in the intended path when drawing the
+  focus ring.</p>
+
+  <p class=note>This might be a moot point, however. For example, if the focus ring is drawn as an
+  axis-aligned bounding rectangle around the points in the intended path, then whether the subpaths
+  are closed or not has no effect. This specification intentionally does not specify precisely how
+  focus rings are to be drawn: user agents are expected to honor their platform's native
+  conventions.</p>
+
+  <hr><p>The <dfn id=dom-context-2d-scrollpathintoview title=dom-context-2d-scrollPathIntoView><code>scrollPathIntoView()</code></dfn>
   method, when invoked, if the <code><a href=#canvasrenderingcontext2d>CanvasRenderingContext2D</a></code> object's <a href=#concept-canvas-context-bitmap-mode title=concept-canvas-context-bitmap-mode>context bitmap mode</a> is <a href=#concept-canvas-fixed title=concept-canvas-fixed>fixed</a>, must run the following steps; and otherwise, must add
   instructions to the <a href=#scratch-bitmap>scratch bitmap</a>'s <a href=#list-of-pending-interface-actions>list of pending interface actions</a>
   that run the following steps:</p>

diff --git a/source b/source
@@ -40607,6 +40607,17 @@ v6DVT (also check for '- -' bits in the part above) -->
 
   </ol>
 
+  <p>User agents should not implicitly close open subpaths in the intended path when drawing the
+  focus ring.</p>
+
+  <p class="note">This might be a moot point, however. For example, if the focus ring is drawn as an
+  axis-aligned bounding rectangle around the points in the intended path, then whether the subpaths
+  are closed or not has no effect. This specification intentionally does not specify precisely how
+  focus rings are to be drawn: user agents are expected to honor their platform's native
+  conventions.</p>
+
+  <hr>
+
   <p>The <dfn title="dom-context-2d-scrollPathIntoView"><code>scrollPathIntoView()</code></dfn>
   method, when invoked, if the <code>CanvasRenderingContext2D</code> object's <span
   title="concept-canvas-context-bitmap-mode">context bitmap mode</span> is <span