[] (0) Integration with CSS Images.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=13687 git-svn-id: http://svn.whatwg.org/webapps@6520 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Aug 22, 2011 · 1f5e10a · 1f5e10a
1 parent baed809
commit 1f5e10a
Show file tree

Hide file tree

Showing 3 changed files with 112 additions and 19 deletions.
diff --git a/complete.html b/complete.html
@@ -1525,7 +1525,7 @@ <h6 class=no-toc id=how-do-the-whatwg-and-w3c-specifications-differ?><span class
    <li>New hyperlink features: the <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute to make download links and the <code title=attr-hyperlink-ping><a href=#ping>ping</a></code> attribute for <a href=#hyperlink-auditing>hyperlink auditing</a>.</li> <!--DOWNLOAD--><!--PING-->
    <li>The <a href=#webvtt>WebVTT</a> format and some <a href=#text-track>text track</a> API features.</li> <!--TTVTT-->
    <li>Rules for <a href=#atom>converting HTML to Atom</a>.</li> <!--MD-->
-   <li>The <code title=dom-document-cssElementMap><a href=#dom-document-csselementmap>cssElementMap</a></code> feature for defining <span title="CSS element reference identifier">CSS element reference identifiers</span>.</li> <!--CSSREF-->
+   <li>The <code title=dom-document-cssElementMap><a href=#dom-document-csselementmap>cssElementMap</a></code> feature for defining <a href=#css-element-reference-identifier title="CSS element reference identifier">CSS element reference identifiers</a>.</li> <!--CSSREF-->
    <li>An experimental <code><a href=#undomanager>UndoManager</a></code> interface.</li><!--UNDO-->
    <li>An experimental specification of the legacy <code title=dom-find><a href=#dom-find>window.find()</a></code> API.</li><!--FIND-->
    <li>Some predefined <a href=#mdvocabs>Microdata vocabularies</a>.</li>
@@ -4004,6 +4004,16 @@ <h4 id=dependencies><span class=secno>2.2.2 </span>Dependencies</h4>
     cannot be parsed, as closing the open construct does not result
     in a viable value.</p>
 
+    <p>The term <dfn id=css-element-reference-identifier>CSS element reference identifier</dfn> is used as
+    defined in the <cite>CSS Image Values and Replaced Content</cite>
+    specification to define the API that declares identifiers for use
+    with the CSS 'element()' function. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
+
+    <p>Similarly, the term <dfn id=provides-a-paint-source>provides a paint source</dfn> is used
+    as defined in the <cite>CSS Image Values and Replaced
+    Content</cite> specification to define the interaction of certain
+    HTML elements with the CSS 'element()' function. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
+
    </dd>
 
 
@@ -9721,17 +9731,17 @@ <h4 id=dom-tree-accessors><span class=secno>3.1.4 </span><dfn>DOM tree accessors
    <dd>
 
     <p>Returns a <code><a href=#domelementmap>DOMElementMap</a></code> object for the
-    <code><a href=#document>Document</a></code> representing the current <span title="CSS
+    <code><a href=#document>Document</a></code> representing the current <a href=#css-element-reference-identifier title="CSS
     element reference identifier">CSS element reference
-    identifiers</span>.</p>
+    identifiers</a>.</p>
 
    </dd>
 
   </dl><div class=impl>
 
   <p>The <dfn id=dom-document-csselementmap title=dom-document-cssElementMap><code>cssElementMap</code></dfn>
-  IDL attribute allows authors to define <span title="CSS element
-  reference identifier">CSS element reference identifiers</span>,
+  IDL attribute allows authors to define <a href=#css-element-reference-identifier title="CSS element
+  reference identifier">CSS element reference identifiers</a>,
   which are used in certain CSS features to override the normal <a href=#concept-id title=concept-id>ID</a>-based mapping. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
 
   <p>When a <code><a href=#document>Document</a></code> is created, it must be associated
@@ -9743,7 +9753,7 @@ <h4 id=dom-tree-accessors><span class=secno>3.1.4 </span><dfn>DOM tree accessors
   in the list and is either <a href=#in-a-document title="in a Document">in the
   <code>Document</code></a> or is an <code><a href=#the-img-element>img</a></code>,
   <code><a href=#the-video-element>video</a></code>, or <code><a href=#the-canvas-element>canvas</a></code> element, defines a
-  <span>CSS element reference identifier</span> mapping the given name
+  <a href=#css-element-reference-identifier>CSS element reference identifier</a> mapping the given name
   to the given <code><a href=#element>Element</a></code>. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
 
   <p>On getting, the <code title=dom-document-cssElementMap><a href=#dom-document-csselementmap>cssElementMap</a></code> IDL
@@ -9786,8 +9796,8 @@ <h4 id=dom-tree-accessors><span class=secno>3.1.4 </span><dfn>DOM tree accessors
 
     <p>If there is an entry in the <code><a href=#document>Document</a></code>'s <a href=#css-id-overrides-list>CSS
     ID overrides list</a> whose name is the name passed to this
-    algorithm, remove it. This also undefines the <span>CSS element
-    reference identifier</span> for that name. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
+    algorithm, remove it. This also undefines the <a href=#css-element-reference-identifier>CSS element
+    reference identifier</a> for that name. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
 
    </dd>
 
@@ -12702,7 +12712,6 @@ <h3 id=interactions-with-xpath-and-xslt><span class=secno>3.3 </span>Interaction
   </div>
 
 
-
   <h3 id=dynamic-markup-insertion><span class=secno>3.4 </span><dfn>Dynamic markup insertion</dfn></h3>
 
   <p class=note>APIs for dynamically inserting markup into the
@@ -22483,6 +22492,11 @@ <h4 id=the-img-element><span class=secno>4.8.1 </span>The <dfn><code>img</code><
 
   <p>An <code><a href=#the-img-element>img</a></code> element is initially <a href=#img-none title=img-none>unavailable</a>.</p>
 
+  <p>When an <code><a href=#the-img-element>img</a></code> element is <a href=#img-yes title=img-yes>available</a>, it <a href=#provides-a-paint-source>provides a paint
+  source</a> whose width is the image's intrinsic width, whose
+  height is the image's intrinsic height, and whose appearance is the
+  intrinsic appearance of the image.</p>
+
   <p>User agents may obtain images immediately or on demand.</p>
 
   <p>A user agent that obtains images immediately must synchronously
@@ -26079,6 +26093,15 @@ <h4 id=the-video-element><span class=secno>4.8.6 </span>The <dfn id=video><code>
   element <a href=#represents title=represents>represent</a> a link to an
   external video playback utility or to the video data itself.</p>
 
+  <p>When a <code><a href=#the-video-element>video</a></code> element's <a href=#media-resource>media resource</a>
+  has a video channel, the element <a href=#provides-a-paint-source>provides a paint
+  source</a> whose width is the <a href=#media-resource>media resource</a>'s <a href=#concept-video-intrinsic-width title=concept-video-intrinsic-width>intrinsic width</a>, whose
+  height is the <a href=#media-resource>media resource</a>'s <a href=#concept-video-intrinsic-height title=concept-video-intrinsic-height>intrinsic height</a>, and
+  whose appearance is the frame of video corresponding to the <a href=#current-playback-position title="current playback position">current playback position</a>,
+  if that is available, or else (e.g. when the video is seeking or
+  buffering) its previous appearance, if any, or else (e.g. because
+  the video is still loading the first frame) blackness.</p>
+
   <hr></div>
 
   <dl class=domintro><dt><var title="">video</var> . <code title=dom-video-videoWidth><a href=#dom-video-videowidth>videoWidth</a></code></dt>
@@ -34991,6 +35014,12 @@ <h4 id=the-canvas-element><span class=secno>4.8.11 </span>The <dfn id=canvas><co
   <p>When the canvas is initialized, its bitmap must be cleared to
   transparent black.</p>
 
+  <p>When a <code><a href=#the-canvas-element>canvas</a></code> element does not represent its
+  <a href=#fallback-content>fallback content</a>, it <a href=#provides-a-paint-source>provides a paint
+  source</a> whose width is the element's intrinsic width, whose
+  height is the element's intrinsic height, and whose appearance is
+  the element's bitmap.</p>
+
   <p>The <dfn id=dom-canvas-width title=dom-canvas-width><code>width</code></dfn> and
   <dfn id=dom-canvas-height title=dom-canvas-height><code>height</code></dfn> IDL
   attributes must <a href=#reflect>reflect</a> the respective content

diff --git a/index b/index
@@ -1438,7 +1438,7 @@
    <li>New hyperlink features: the <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute to make download links and the <code title=attr-hyperlink-ping><a href=#ping>ping</a></code> attribute for <a href=#hyperlink-auditing>hyperlink auditing</a>.</li> <!--DOWNLOAD--><!--PING-->
    <li>The <a href=#webvtt>WebVTT</a> format and some <a href=#text-track>text track</a> API features.</li> <!--TTVTT-->
    <li>Rules for <a href=#atom>converting HTML to Atom</a>.</li> <!--MD-->
-   <li>The <code title=dom-document-cssElementMap><a href=#dom-document-csselementmap>cssElementMap</a></code> feature for defining <span title="CSS element reference identifier">CSS element reference identifiers</span>.</li> <!--CSSREF-->
+   <li>The <code title=dom-document-cssElementMap><a href=#dom-document-csselementmap>cssElementMap</a></code> feature for defining <a href=#css-element-reference-identifier title="CSS element reference identifier">CSS element reference identifiers</a>.</li> <!--CSSREF-->
    <li>An experimental <code><a href=#undomanager>UndoManager</a></code> interface.</li><!--UNDO-->
    <li>An experimental specification of the legacy <code title=dom-find><a href=#dom-find>window.find()</a></code> API.</li><!--FIND-->
    <li>Some predefined <a href=#mdvocabs>Microdata vocabularies</a>.</li>
@@ -3901,6 +3901,16 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
     cannot be parsed, as closing the open construct does not result
     in a viable value.</p>
 
+    <p>The term <dfn id=css-element-reference-identifier>CSS element reference identifier</dfn> is used as
+    defined in the <cite>CSS Image Values and Replaced Content</cite>
+    specification to define the API that declares identifiers for use
+    with the CSS 'element()' function. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
+
+    <p>Similarly, the term <dfn id=provides-a-paint-source>provides a paint source</dfn> is used
+    as defined in the <cite>CSS Image Values and Replaced
+    Content</cite> specification to define the interaction of certain
+    HTML elements with the CSS 'element()' function. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
+
    </dd>
 
 
@@ -9585,17 +9595,17 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
    <dd>
 
     <p>Returns a <code><a href=#domelementmap>DOMElementMap</a></code> object for the
-    <code><a href=#document>Document</a></code> representing the current <span title="CSS
+    <code><a href=#document>Document</a></code> representing the current <a href=#css-element-reference-identifier title="CSS
     element reference identifier">CSS element reference
-    identifiers</span>.</p>
+    identifiers</a>.</p>
 
    </dd>
 
   </dl><div class=impl>
 
   <p>The <dfn id=dom-document-csselementmap title=dom-document-cssElementMap><code>cssElementMap</code></dfn>
-  IDL attribute allows authors to define <span title="CSS element
-  reference identifier">CSS element reference identifiers</span>,
+  IDL attribute allows authors to define <a href=#css-element-reference-identifier title="CSS element
+  reference identifier">CSS element reference identifiers</a>,
   which are used in certain CSS features to override the normal <a href=#concept-id title=concept-id>ID</a>-based mapping. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
 
   <p>When a <code><a href=#document>Document</a></code> is created, it must be associated
@@ -9607,7 +9617,7 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
   in the list and is either <a href=#in-a-document title="in a Document">in the
   <code>Document</code></a> or is an <code><a href=#the-img-element>img</a></code>,
   <code><a href=#the-video-element>video</a></code>, or <code><a href=#the-canvas-element>canvas</a></code> element, defines a
-  <span>CSS element reference identifier</span> mapping the given name
+  <a href=#css-element-reference-identifier>CSS element reference identifier</a> mapping the given name
   to the given <code><a href=#element>Element</a></code>. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
 
   <p>On getting, the <code title=dom-document-cssElementMap><a href=#dom-document-csselementmap>cssElementMap</a></code> IDL
@@ -9650,8 +9660,8 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
 
     <p>If there is an entry in the <code><a href=#document>Document</a></code>'s <a href=#css-id-overrides-list>CSS
     ID overrides list</a> whose name is the name passed to this
-    algorithm, remove it. This also undefines the <span>CSS element
-    reference identifier</span> for that name. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
+    algorithm, remove it. This also undefines the <a href=#css-element-reference-identifier>CSS element
+    reference identifier</a> for that name. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
 
    </dd>
 
@@ -12566,7 +12576,6 @@ plaintext     = *( %x0000-2029 / %x202F-10FFFF )
   </div>
 
 
-
   <h3 id=dynamic-markup-insertion><span class=secno>3.4 </span><dfn>Dynamic markup insertion</dfn></h3>
 
   <p class=note>APIs for dynamically inserting markup into the
@@ -22347,6 +22356,11 @@ interface <dfn id=htmlimageelement>HTMLImageElement</dfn> : <a href=#htmlelement
 
   <p>An <code><a href=#the-img-element>img</a></code> element is initially <a href=#img-none title=img-none>unavailable</a>.</p>
 
+  <p>When an <code><a href=#the-img-element>img</a></code> element is <a href=#img-yes title=img-yes>available</a>, it <a href=#provides-a-paint-source>provides a paint
+  source</a> whose width is the image's intrinsic width, whose
+  height is the image's intrinsic height, and whose appearance is the
+  intrinsic appearance of the image.</p>
+
   <p>User agents may obtain images immediately or on demand.</p>
 
   <p>A user agent that obtains images immediately must synchronously
@@ -25946,6 +25960,15 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
   element <a href=#represents title=represents>represent</a> a link to an
   external video playback utility or to the video data itself.</p>
 
+  <p>When a <code><a href=#the-video-element>video</a></code> element's <a href=#media-resource>media resource</a>
+  has a video channel, the element <a href=#provides-a-paint-source>provides a paint
+  source</a> whose width is the <a href=#media-resource>media resource</a>'s <a href=#concept-video-intrinsic-width title=concept-video-intrinsic-width>intrinsic width</a>, whose
+  height is the <a href=#media-resource>media resource</a>'s <a href=#concept-video-intrinsic-height title=concept-video-intrinsic-height>intrinsic height</a>, and
+  whose appearance is the frame of video corresponding to the <a href=#current-playback-position title="current playback position">current playback position</a>,
+  if that is available, or else (e.g. when the video is seeking or
+  buffering) its previous appearance, if any, or else (e.g. because
+  the video is still loading the first frame) blackness.</p>
+
   <hr></div>
 
   <dl class=domintro><dt><var title="">video</var> . <code title=dom-video-videoWidth><a href=#dom-video-videowidth>videoWidth</a></code></dt>
@@ -34858,6 +34881,12 @@ The General Relativistic Field Equations</pre>
   <p>When the canvas is initialized, its bitmap must be cleared to
   transparent black.</p>
 
+  <p>When a <code><a href=#the-canvas-element>canvas</a></code> element does not represent its
+  <a href=#fallback-content>fallback content</a>, it <a href=#provides-a-paint-source>provides a paint
+  source</a> whose width is the element's intrinsic width, whose
+  height is the element's intrinsic height, and whose appearance is
+  the element's bitmap.</p>
+
   <p>The <dfn id=dom-canvas-width title=dom-canvas-width><code>width</code></dfn> and
   <dfn id=dom-canvas-height title=dom-canvas-height><code>height</code></dfn> IDL
   attributes must <a href=#reflect>reflect</a> the respective content

diff --git a/source b/source
@@ -2939,6 +2939,18 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
     cannot be parsed, as closing the open construct does not result
     in a viable value.</p>
 
+    <p>The term <dfn>CSS element reference identifier</dfn> is used as
+    defined in the <cite>CSS Image Values and Replaced Content</cite>
+    specification to define the API that declares identifiers for use
+    with the CSS 'element()' function. <a
+    href="#refsCSSIMAGES">[CSSIMAGES]</a></p>
+
+    <p>Similarly, the term <dfn>provides a paint source</dfn> is used
+    as defined in the <cite>CSS Image Values and Replaced
+    Content</cite> specification to define the interaction of certain
+    HTML elements with the CSS 'element()' function. <a
+    href="#refsCSSIMAGES">[CSSIMAGES]</a></p>
+
    </dd>
 
 <!--END html--><!--END dev-html--><!--END w3c-html-->
@@ -13231,7 +13243,6 @@ plaintext     = *( %x0000-2029 / %x202F-10FFFF )
   </div>
 
 
-
   <h3><dfn>Dynamic markup insertion</dfn></h3>
 
   <p class="note">APIs for dynamically inserting markup into the
@@ -24049,6 +24060,12 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
   <p>An <code>img</code> element is initially <span
   title="img-none">unavailable</span>.</p>
 
+  <p>When an <code>img</code> element is <span
+  title="img-yes">available</span>, it <span>provides a paint
+  source</span> whose width is the image's intrinsic width, whose
+  height is the image's intrinsic height, and whose appearance is the
+  intrinsic appearance of the image.</p>
+
   <p>User agents may obtain images immediately or on demand.</p>
 
   <p>A user agent that obtains images immediately must synchronously
@@ -28043,6 +28060,18 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
   element <span title="represents">represent</span> a link to an
   external video playback utility or to the video data itself.</p>
 
+  <p>When a <code>video</code> element's <span>media resource</span>
+  has a video channel, the element <span>provides a paint
+  source</span> whose width is the <span>media resource</span>'s <span
+  title="concept-video-intrinsic-width">intrinsic width</span>, whose
+  height is the <span>media resource</span>'s <span
+  title="concept-video-intrinsic-height">intrinsic height</span>, and
+  whose appearance is the frame of video corresponding to the <span
+  title="current playback position">current playback position</span>,
+  if that is available, or else (e.g. when the video is seeking or
+  buffering) its previous appearance, if any, or else (e.g. because
+  the video is still loading the first frame) blackness.</p>
+
   <hr>
 
   </div>
@@ -38457,6 +38486,12 @@ The General Relativistic Field Equations</pre>
   <p>When the canvas is initialized, its bitmap must be cleared to
   transparent black.</p>
 
+  <p>When a <code>canvas</code> element does not represent its
+  <span>fallback content</span>, it <span>provides a paint
+  source</span> whose width is the element's intrinsic width, whose
+  height is the element's intrinsic height, and whose appearance is
+  the element's bitmap.</p>
+
   <p>The <dfn title="dom-canvas-width"><code>width</code></dfn> and
   <dfn title="dom-canvas-height"><code>height</code></dfn> IDL
   attributes must <span>reflect</span> the respective content