- From: Sam Ruby via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 19 Sep 2012 13:31:16 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/2dcontext
In directory hutz:/tmp/cvs-serv29731
Modified Files:
Overview.html
Log Message:
commit ff71259363203c8288d6d8f361d9fc800dbf5078
Author: Erika Doyle Navara <erika.doyle@microsoft.com>
Date: Tue Sep 18 16:25:55 2012 -0700
[HTML5 Bug 18904]: change text in 'status of this document' to remove inaccuracies
In order to prepare the upcoming heartbeat draft while still acting in
deference to the open status of ISSUE-151, making the minimal amount of
changes to clear up inaccuracies as to where to find the latest stable
version of the spec and our W3C feedback channels.
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/2dcontext/Overview.html,v
retrieving revision 1.165
retrieving revision 1.166
diff -u -d -r1.165 -r1.166
--- Overview.html 15 Sep 2012 00:43:23 -0000 1.165
+++ Overview.html 19 Sep 2012 13:31:14 -0000 1.166
@@ -62,6 +62,9 @@
.diff-chg, .diff-new { text-decoration: underline; color: green; background: transparent; }
a .diff-new { border-bottom: 1px blue solid; }
+ figure.diagrams { border: double black; background: white; padding: 1em; }
+ figure.diagrams img { display: block; margin: 1em auto; }
+
h2 { page-break-before: always; }
h1, h2, h3, h4, h5, h6 { page-break-after: avoid; }
h1 + h2, hr + h2.no-toc { page-break-before: auto; }
@@ -278,23 +281,23 @@
@font-face {
font-family: 'Essays1743';
- src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743.ttf');
+ src: url('../fonts/Essays1743.ttf');
}
@font-face {
font-family: 'Essays1743';
font-weight: bold;
- src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743-Bold.ttf');
+ src: url('../fonts/Essays1743-Bold.ttf');
}
@font-face {
font-family: 'Essays1743';
font-style: italic;
- src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743-Italic.ttf');
+ src: url('../fonts/Essays1743-Italic.ttf');
}
@font-face {
font-family: 'Essays1743';
font-style: italic;
font-weight: bold;
- src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743-BoldItalic.ttf');
+ src: url('../fonts/Essays1743-BoldItalic.ttf');
}
</style><link href=data:text/css, id=complete rel=stylesheet title="Complete specification"><link href=data:text/css,.impl%20{%20display:%20none;%20}%0Ahtml%20{%20border:%20solid%20yellow;%20}%20.domintro:before%20{%20display:%20none;%20} id=author rel="alternate stylesheet" title="Author documentation only"><link href=data:text/css,.impl%20{%20background:%20%23FFEEEE;%20}%20.domintro:before%20{%20background:%20%23FFEEEE;%20} id=highlight rel="alternate stylesheet" title="Highlight implementation requirements"><script>
@@ -321,7 +324,7 @@
<h1>HTML Canvas 2D Context</h1>
<h2 class="no-num no-toc" id=generatedID></h2>
- <h2 class="no-num no-toc" id="editor's-draft-date-1-january-1970">Editor's Draft 15 September 2012</h2>
+ <h2 class="no-num no-toc" id="editor's-draft-date-1-january-1970">Editor's Draft 19 September 2012</h2>
<dl><dt>Latest Published Version:</dt>
<dd><a href=http://www.w3.org/TR/2dcontext/>http://www.w3.org/TR/2dcontext/</a></dd>
<dt>Latest Editor's Draft:</dt>
@@ -378,82 +381,28 @@
<!-- intro boilerplate (required) -->
- <p><em>This section describes the status of this document at the
- time of its publication. Other documents may supersede this
- document. A list of current W3C publications and the
-
- most recently formally published <!-- DO NOT CHANGE THIS BACK TO THE STANDARD BOILERPLATE, AS IT IS INACCURATE -->
-
- revision of this technical report can be found in the <a href=http://www.w3.org/TR/>W3C technical reports index</a> at
- http://www.w3.org/TR/.</em></p>
+ <p><em>This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the <a href=http://www.w3.org/TR/>W3C technical reports index</a> at http://www.w3.org/TR/.</em></p>
<!-- where to send feedback (required) -->
<p>If you wish to make comments regarding this document in a manner
that is tracked by the W3C, please submit them via using <a href="http://www.w3.org/Bugs/Public/enter_bug.cgi?product=HTML%20WG">our
- public bug database</a>. If you do not have an account then you can
- enter feedback using this form:</p>
-
- <form action=http://www.whatwg.org/specs/web-apps/current-work/file-spam.cgi method=post>
- <fieldset><legend>Feedback Comments</legend>
- <input name=id type=hidden value=top><input name=component type=hidden value="HTML Canvas 2D Context (editor: Ian Hickson)"><input name=response type=hidden value=html><p><label for=feedbackBox>Please enter your feedback, carefully
- indicating the title of the section for which you are submitting
- feedback, quoting the text that's wrong today if appropriate. If
- you're suggesting a new feature, it's really important to say
- <em>what</em> the problem you're trying to solve is. That's more
- important than the solution, in fact.</label></p>
- <p><textarea cols=79 id=feedbackBox name=text rows=10></textarea></p>
- <p class=note>Please don't use section numbers as these tend to
- change rapidly and make your feedback harder to understand.</p>
- <script>
- function checkFeedbackForm(form) {
- if (form.elements.text.value.match(/^ *</)) {
- alert('Please don\'t start your feedback with an angle bracket, instead explain what topic your feedback is about first.');
- return true;
- } else if (form.elements.text.value.match(/ [^ ]+ [^ ]+ [^ ]+ [^ ]+ /)) {
- if (form.elements.text.value.match(/^Please enter your feedback, carefully/)) {
- alert('Please enter your feedback, explaining what is wrong, and without repeating the instructions. Thanks!');
- return true;
- } else if (form.elements.text.value.match(/ [^ ]+ [^ ]+ [^ ]+ [^ ]+ /)) {
- form.action = "http://www.whatwg.org/specs/web-apps/current-work/file-bug.cgi";
- return true;
- } else {
- alert('Please include significantly more detail about exactly what problem you are trying to solve.');
- return false;
- }
- }
- }
- </script><p>
- <input onclick="return checkFeedbackForm(form)" type=submit value="Submit feedback"><small>(Note: Your IP address and user agent will be publicly recorded for spam prevention purposes.)</small>
- </p>
- </fieldset></form>
-
-
- <p>If you cannot do this then you can also e-mail feedback to <a href=mailto:public-html-comments@w3.org>public-html-comments@w3.org</a>
+ public bug database</a>. If you cannot do this then you can also e-mail feedback to <a href=mailto:public-html-comments@w3.org>public-html-comments@w3.org</a>
(<a href="mailto:public-html-comments-request@w3.org?subject=subscribe">subscribe</a>,
<a href=http://lists.w3.org/Archives/Public/public-html-comments/>archives</a>),
and arrangements will be made to transpose the comments to our
- public bug database.
-
- <!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING SENTENCE TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
- Alternatively, you can e-mail feedback to <a href=mailto:whatwg@whatwg.org>whatwg@whatwg.org</a> (<a href=http://lists.whatwg.org/listinfo.cgi/whatwg-whatwg.org>subscribe</a>,
- <a href=http://lists.whatwg.org/pipermail/whatwg-whatwg.org/>archives</a>).
- The editor guarantees that all substantive feedback sent to this
- list will receive a reply. However, such feedback is not considered
- formal feedback for the W3C process.
- <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING SENTENCE TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
+ public bug database. All feedback is welcome.</p>
- All feedback is welcome.</p>
+
+
<!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
- <p>The working groups maintains <a href="http://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=exact&email1=ian%40hixie.ch&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=">a
- list of all bug reports that the editor has not yet tried to
+ <p>The working groups maintains <a href="http://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=HTML+WG&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=">a
+ list of all bug reports that the editors have not yet tried to
address</a> and <a href=http://www.w3.org/html/wg/tracker/products/1>a list of issues
- for which the chairs have not yet declared a decision</a>. The
- editor also maintains <a href=http://www.whatwg.org/issues/>a list
- of all e-mails that he has not yet tried to address</a>. These bugs,
- issues, and e-mails apply to multiple HTML-related specifications,
+ for which the chairs have not yet declared a decision</a>. These bugs and
+ issues apply to multiple HTML-related specifications,
not just this one.</p>
<!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
@@ -472,26 +421,15 @@
</div>
- <!-- not everyone agrees with this (requested before html5 fpwd) -->
- <p>The publication of this document by the W3C as a W3C Working
- Draft does not imply that all of the participants in the W3C HTML
- working group endorse the contents of the specification. Indeed, for
- any section of the specification, one can usually find many members
- of the working group or of the W3C as a whole who object strongly to
- the current text, the existence of the section at all, or the idea
- that the working group should even spend time discussing the concept
- of that section.</p>
+ <p>Publication as a Working Draft does not imply endorsement by the W3C Membership.
+ This is a draft document and may be updated, replaced or obsoleted by other documents at
+ any time. It is inappropriate to cite this document as other than work in progress.</p>
<!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
<!-- version history or list of changes (required) -->
<p>The latest stable version of the editor's draft of this
- specification is always available on <a href=http://dev.w3.org/html5/>the W3C CVS server</a> and in the <a href=http://svn.whatwg.org/webapps/>WHATWG Subversion
- repository</a>. The <a href=http://www.whatwg.org/specs/web-apps/current-work/complete.html>latest
- editor's working copy</a> (which may contain unfinished text in the
- process of being prepared) contains the latest draft text of this
- specification (amongst others). For more details, please see the <a href=http://wiki.whatwg.org/wiki/FAQ#What_are_the_various_versions_of_the_spec.3F>WHATWG
- FAQ</a>.</p>
+ specification is always available on <a href=http://dev.w3.org/html5/>the W3C CVS server</a>.</p>
<!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
<!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING LIST TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
@@ -509,7 +447,7 @@
Group</a> is the W3C working group responsible for this
specification's progress along the W3C Recommendation
track.
- This specification is the 15 September 2012 Editor's Draft.
+ This specification is the 19 September 2012 Editor's Draft.
</p>
@@ -4558,15 +4496,10 @@
<li>The <a href=#path>path</a> <var title="">source path</var>
describes a shape with no pixels.</li>
-
- <li>The <var title="">arguments</var> object's <code title=dom-HitRegionOptions-control>control</code> member is not
- null but is neither an <code>a</code> element that
- <span>represents</span> a <span>hyperlink</span>, a
- <code>button</code> element, an <code>input</code> element whose
- <code title=attr-input-type>type</code> attribute is in one of
- the <span title=attr-input-type-checkbox>Checkbox</span> or
- <span title=attr-input-type-radio>Radio Button</span> states,
- nor an <code>input</code> element that is a <span title=concept-button>button</span>.</li>
+
+ <li>The <var title="">arguments</var> object's <code title=dom-HitRegionOptions-control>control</code> member is not
+ null and is not an element that is a descendant of this <code>
+ canvas</code> element.</li>
<li>The <var title="">parent region</var> is not null but has a
<a href="#hit-region's-control" title="hit region's control">control</a>.</li>
@@ -4732,7 +4665,28 @@
<li><p>Add <var title="">region</var> to the <code>canvas</code>
element's <a href=#hit-region-list>hit region list</a>.</p></li>
- </ol><p>When the <dfn id=dom-context-2d-removehitregion title=dom-context-2d-removeHitRegion><code>removeHitRegion()</code></dfn>
+ </ol><p>If the <a href=#hit-region title="hit region">hitregion</a> is interactive
+ or requires the use of WAI-ARIA states or properties (in addition to
+ role or label), authors must not use an unbacked <var title="">
+ region</var> description (as there is no method to attach WAI-ARIA
+ states or properties to an unbacked <var title="">region</var>
+ description and unbacked <var title="">region</var> are unable to
+ receive focus and therefore cannot be in a focused state).</p>
+
+ <p>In cases where the <var title="">region</var> is functioning as an
+ interactive control it must have a <code title=dom-HitRegionOptions-control>control</code>. It is recommended
+ that the control() references an <code>html</code> <code title="Interactive content">interactive element</code> unless <code>html
+ </code> does not provide the desired features. In which case WAI-ARIA
+ role, states and properties may be used as allowed in <code>html</code>.</p>
+
+ <p> Examples of <var title="">regions</var> where a WAI-ARIA role requires
+ keyboard focus or the use of WAI-ARIA states and properties other than
+ label, are a button and a checkbox. A button has a role="button" and it
+ is required to be focusable using the keyboard. A checkbox has a role
+ ="checkbox", requires an aria-checked state and it is required to be
+ focusable using the keyboard. <a href=#refsARIA>[ARIA]</a></p>
+
+ <p>When the <dfn id=dom-context-2d-removehitregion title=dom-context-2d-removeHitRegion><code>removeHitRegion()</code></dfn>
method is invoked, the user agent must run the following steps:</p>
<ol><li><p>Let <var title="">region</var> be <a href=#the-region-identified-by-the-id>the region
Received on Wednesday, 19 September 2012 13:31:18 UTC