[css3-ui] Explicit file format requirements for 'cursor'

Author: frivoal

css-ui/Overview.bs

@@ -985,6 +985,36 @@ If the user agent cannot handle any user-defined cursor,
 it must use the cursor keyword at the end of the list.
 Conforming User Agents may, instead of <<url>>, support <<image>> which is a superset.
 
+The UA must support the following image file formats:
+<ul>
+	<li>PNG, as defined in [[!PNG]]
+	<li>SVG, as defined in [[!SVG]], in <a href="http://www.w3.org/TR/svg-integration/#secure-static-mode">secure static mode</a> [[!SVG-INTEGRATION]]
+	<li>any other non-animated image file format that they support
+	for <<image>> in other properties,
+	such as the the 'background-image' property
+</ul>
+
+In addition, the UA should support the following image file formats:
+<ul>
+	<li>SVG, as defined in [[!SVG]], in <a href="http://www.w3.org/TR/svg-integration/#secure-animated-mode">secure animated mode</a> [[!SVG-INTEGRATION]]
+	<li>any other animated image file format that they support
+	for <<image>> in other properties,
+	such as the the 'background-image' property
+</ul>
+
+The UA may also support additional file formats.
+
+Note: At the time of writing this specification,
+the only file formats supported for cursors in all browsers are
+the .ico and .cur file formats, as designed by Microsoft.
+For compatibility with legacy content,
+UAs are encouraged to support these,
+even though the lack of an open specification
+makes it impossible to have a normative requirement
+about these formats.
+Some information on these formats can be found
+<a href="http://en.wikipedia.org/wiki/ICO_%28file_format%29">on wikipedia</a>.
+
 The <a>default object size</a> for cursor images is
 a UA-defined size that should be based on
 the size of a typical cursor on the UA's operating system.

css-ui/Overview.html

@@ -718,7 +718,7 @@
    <h1 class="p-name no-ref" id="title">CSS Basic User Interface Module Level 3 (CSS3 UI)</h1>
 
    <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft,
-    <time class="dt-updated" datetime="2015-04-09">9 April 2015</time></span></h2>
+    <time class="dt-updated" datetime="2015-04-10">10 April 2015</time></span></h2>
 
    <div data-fill-with="spec-metadata">
     <dl>
@@ -2721,6 +2721,47 @@ <h4 class="heading settled" data-level="6.1.1" id="cursor"><span class="secno">6
 Conforming User Agents may, instead of <a class="production css" data-link-type="type" href="http://dev.w3.org/csswg/css-values-3/#url-value" title="Expands to: ">&lt;url></a>, support <a class="production css" data-link-type="type" href="http://dev.w3.org/csswg/css-images-3/#typedef-image">&lt;image></a> which is a superset.
 
 
+     <p>The UA must support the following image file formats:</p>
+
+     <ul>
+	
+      <li>PNG, as defined in <a data-link-type="biblio" href="#biblio-png">[PNG]</a>
+	
+      <li>SVG, as defined in <a data-link-type="biblio" href="#biblio-svg">[SVG]</a>, in <a href="http://www.w3.org/TR/svg-integration/#secure-static-mode">secure static mode</a> <a data-link-type="biblio" href="#biblio-svg-integration">[SVG-INTEGRATION]</a>
+	
+      <li>any other non-animated image file format that they support
+	for <a class="production css" data-link-type="type" href="http://dev.w3.org/csswg/css-images-3/#typedef-image" title="Expands to: ">&lt;image></a> in other properties,
+	such as the the <a class="property" data-link-type="propdesc" href="http://dev.w3.org/csswg/css-backgrounds-3/#background-image">background-image</a> property
+</ul>
+
+
+     <p>In addition, the UA should support the following image file formats:</p>
+
+     <ul>
+	
+      <li>SVG, as defined in <a data-link-type="biblio" href="#biblio-svg">[SVG]</a>, in <a href="http://www.w3.org/TR/svg-integration/#secure-animated-mode">secure animated mode</a> <a data-link-type="biblio" href="#biblio-svg-integration">[SVG-INTEGRATION]</a>
+	
+      <li>any other animated image file format that they support
+	for <a class="production css" data-link-type="type" href="http://dev.w3.org/csswg/css-images-3/#typedef-image" title="Expands to: ">&lt;image></a> in other properties,
+	such as the the <a class="property" data-link-type="propdesc" href="http://dev.w3.org/csswg/css-backgrounds-3/#background-image">background-image</a> property
+</ul>
+
+
+     <p>The UA may also support additional file formats.</p>
+
+
+     <p class="note" role="note">Note: At the time of writing this specification,
+the only file formats supported for cursors in all browsers are
+the .ico and .cur file formats, as designed by Microsoft.
+For compatibility with legacy content,
+UAs are encouraged to support these,
+even though the lack of an open specification
+makes it impossible to have a normative requirement
+about these formats.
+Some information on these formats can be found
+<a href="http://en.wikipedia.org/wiki/ICO_%28file_format%29">on wikipedia</a>.</p>
+
+
      <p>The <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-images-3/#default-object-size">default object size</a> for cursor images is
 a UA-defined size that should be based on
 the size of a typical cursor on the UA’s operating system.</p>
@@ -4220,6 +4261,7 @@ <h3 class="no-num heading settled" id="index-defined-elsewhere"><span class="con
   <ul class="indexlist">
    <li><a data-link-type="biblio" href="#biblio-css-backgrounds-3">[css-backgrounds-3]</a> defines the following terms:
     <ul>
+     <li><a href="http://dev.w3.org/csswg/css-backgrounds-3/#background-image">background-image</a>
      <li><a href="http://dev.w3.org/csswg/css-backgrounds-3/#border-bottom-width">border-bottom-width</a>
      <li><a href="http://dev.w3.org/csswg/css-backgrounds-3/#border-left-width">border-left-width</a>
      <li><a href="http://dev.w3.org/csswg/css-backgrounds-3/#border-radius">border-radius</a>
@@ -4309,6 +4351,10 @@ <h3 class="no-num heading settled" id="normative"><span class="content">Normativ
    <dd>Bert Bos; Elika J. Etemad; Brad Kemper. <a href="http://www.w3.org/TR/2012/CR-css3-background-20120724/">CSS Backgrounds and Borders Module Level 3</a>. 24 July 2012. W3C Candidate Recommendation. (Work in progress.) URL: <a href="http://www.w3.org/TR/2012/CR-css3-background-20120724/">http://www.w3.org/TR/2012/CR-css3-background-20120724/</a>
    <dt id="biblio-css3color"><a class="self-link" href="#biblio-css3color"></a>[CSS3COLOR]
    <dd>Tantek Çelik; Chris Lilley; L. David Baron. <a href="http://www.w3.org/TR/2011/REC-css3-color-20110607">CSS Color Module Level 3</a>. 7 June 2011. W3C Recommendation. URL: <a href="http://www.w3.org/TR/2011/REC-css3-color-20110607">http://www.w3.org/TR/2011/REC-css3-color-20110607</a>
+   <dt id="biblio-png"><a class="self-link" href="#biblio-png"></a>[PNG]
+   <dd>Tom Lane. <a href="http://www.w3.org/TR/PNG">Portable Network Graphics (PNG) Specification (Second Edition)</a>. 10 November 2003. REC. URL: <a href="http://www.w3.org/TR/PNG">http://www.w3.org/TR/PNG</a>
+   <dt id="biblio-svg"><a class="self-link" href="#biblio-svg"></a>[SVG]
+   <dd>Jon Ferraiolo. <a href="http://www.w3.org/TR/SVG/">Scalable Vector Graphics (SVG) 1.0 Specification</a>. 4 September 2001. REC. URL: <a href="http://www.w3.org/TR/SVG/">http://www.w3.org/TR/SVG/</a>
    <dt id="biblio-uax29"><a class="self-link" href="#biblio-uax29"></a>[UAX29]
    <dd>Mark Davis. <a href="http://www.unicode.org/unicode/reports/tr29/tr29-9.html">Text Boundaries</a>. 25 March 2005. Unicode Standard Annex #29. URL: <a href="http://www.unicode.org/unicode/reports/tr29/tr29-9.html">http://www.unicode.org/unicode/reports/tr29/tr29-9.html</a>
    <dt id="biblio-css-backgrounds-3"><a class="self-link" href="#biblio-css-backgrounds-3"></a>[CSS-BACKGROUNDS-3]
@@ -4331,6 +4377,8 @@ <h3 class="no-num heading settled" id="normative"><span class="content">Normativ
    <dd>CSS Object Model Level 1 URL: <a href="http://www.w3.org/TR/cssom/">http://www.w3.org/TR/cssom/</a>
    <dt id="biblio-rfc2119"><a class="self-link" href="#biblio-rfc2119"></a>[RFC2119]
    <dd>S. Bradner. <a href="https://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a>. March 1997. Best Current Practice. URL: <a href="https://tools.ietf.org/html/rfc2119">https://tools.ietf.org/html/rfc2119</a>
+   <dt id="biblio-svg-integration"><a class="self-link" href="#biblio-svg-integration"></a>[SVG-INTEGRATION]
+   <dd>Cameron McCormack; Doug Schepers; Dirk Schulze. <a href="http://www.w3.org/TR/svg-integration/">SVG Integration</a>. 17 April 2014. WD. URL: <a href="http://www.w3.org/TR/svg-integration/">http://www.w3.org/TR/svg-integration/</a>
   </dl>
   <h3 class="no-num heading settled" id="informative"><span class="content">Informative References</span><a class="self-link" href="#informative"></a></h3>
   <dl>