[mediaqueries] Add the 'updates' media feature

Author: Florian Rivoal

mediaqueries/Overview.html

@@ -54,7 +54,7 @@
 </p>
   <h1 class="p-name no-ref" id=title>Media Queries Level 4</h1>
   <h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>Editor’s Draft,
-    <span class=dt-updated><span class=value-title title=20140104>4 January 2014</span></span></span></h2>
+    <span class=dt-updated><span class=value-title title=20140126>26 January 2014</span></span></span></h2>
   <div data-fill-with=spec-metadata><dl><dt>This version:<dd><a class=u-url href=http://dev.w3.org/csswg/mediaqueries4/>http://dev.w3.org/csswg/mediaqueries4/</a><dt>Editor’s Draft:<dd><a href=http://dev.w3.org/csswg/mediaqueries4/>http://dev.w3.org/csswg/mediaqueries4/</a>
     <dt>Feedback:</dt>
         <dd><a href="mailto:www-style@w3.org?subject=%5Bmediaqueries%5D%20feedback">www-style@w3.org</a>
@@ -135,7 +135,7 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=contents><span class
 Display Quality Media Features</a><ul class=toc><li><a href=#resolution><span class=secno>5.1</span>
 resolution</a><li><a href=#scan><span class=secno>5.2</span>
 scan</a><li><a href=#grid><span class=secno>5.3</span>
-grid</a></ul><li><a href=#mf-colors><span class=secno>6</span>
+grid</a><li><a href=#updates><span class=secno>5.4</span>Updates</a></ul><li><a href=#mf-colors><span class=secno>6</span>
 Color Media Features</a><ul class=toc><li><a href=#color><span class=secno>6.1</span>
 color</a><li><a href=#color-index><span class=secno>6.2</span>
 color-index</a><li><a href=#monochrome><span class=secno>6.3</span>
@@ -742,7 +742,7 @@ <h4 class="heading settled heading" data-level=2.4.1 id=mq-ranges><span class=se
 	take their values from a set.
 	The values may be keywords
 	or boolean numbers (0 and 1),
-	but the common factor is that there’s no intrinsic “order” to them—<wbr></wbr>none of the values are “less than” or “greater than” each other.
+	but the common factor is that there’s no intrinsic “order” to them—<wbr>none of the values are “less than” or “greater than” each other.
 
 <p>	“Range” media features like <a class=property data-link-type=propdesc href=#descdef-width title=width>width</a>, on the other hand,
 	take their values from a range.
@@ -751,7 +751,7 @@ <h4 class="heading settled heading" data-level=2.4.1 id=mq-ranges><span class=se
 <p>	The only significant difference between the two types is that “range” <a data-link-type=dfn href=#media-feature title="media features">media features</a>
 	can be evaluated in a <a data-link-type=dfn href=#range-context title="range context">range context</a>
 	and accept “min-” and “max-” prefixes on their name.
-	Doing either of these changes the meaning of the feature—<wbr></wbr>rather than the <a data-link-type=dfn href=#media-feature title="media feature">media feature</a> being true when the feature exactly matches the given value,
+	Doing either of these changes the meaning of the feature—<wbr>rather than the <a data-link-type=dfn href=#media-feature title="media feature">media feature</a> being true when the feature exactly matches the given value,
 	it matches when the feature is greater than/less than/equal to the given value.
 
 	<div class=example>
@@ -806,7 +806,7 @@ <h4 class="heading settled heading" data-level=2.4.2 id=mq-boolean-context><span
 		Only some of the <a data-link-type=dfn href=#media-feature title="media features">media features</a> that accept keywords are meaningful in a <a data-link-type=dfn href=#boolean-context title="boolean context">boolean context</a>.
 
 <p>		For example, <span class=css data-link-type=maybe title=(pointer)>(pointer)</span> is useful,
-		as <a class=property data-link-type=propdesc href=#descdef-pointer title=pointer>pointer</a> has a <a class=css data-link-for=pointer data-link-type=maybe href=#valuedef-none0 title=none>none</a> value to indicate there’s no pointing device at all on the device.
+		as <a class=property data-link-type=propdesc href=#descdef-pointer title=pointer>pointer</a> has a <a class=css data-link-for=pointer data-link-type=maybe href=#valuedef-none1 title=none>none</a> value to indicate there’s no pointing device at all on the device.
 		On the other hand, <span class=css data-link-type=maybe title=(scan)>(scan)</span> is just always true or always false
 		(depending on whether it applies at all to the device),
 		as there’s no value that means “false”.
@@ -1422,6 +1422,33 @@ <h3 class="heading settled heading" data-level=5.3 id=grid><span class=secno>5.3
 		<pre>@media handheld and (grid) and (max-width: 15em) { … }
 </pre>	</div>
 
+<h3 class="heading settled heading" data-level=5.4 id=updates><span class=secno>5.4 </span><span class=content>Updates</span><a class=self-link href=#updates></a></h3>
+<table class="definition descdef mq" data-dfn-for=@media><tr><th>Name:<td><dfn class=css-code data-dfn-for=@media data-dfn-type=descriptor data-export="" id=descdef-updates>updates<a class=self-link href=#descdef-updates></a></dfn><tr><th>For:<td><a class=css-code data-link-type=at-rule href=http://dev.w3.org/csswg/css-conditional-3/#at-ruledef-media title=@media>@media</a><tr><th>Value:<td>none | slow | normal<tr><th>Type:<td>discrete</table>
+<p>	The <a class=property data-link-type=propdesc href=#descdef-updates title=updates>updates</a> media feature is used to query the ability of the output device to modify the apearance of content once it has been rendered. It accepts the following values:
+
+	<dl data-dfn-for=@media/updates data-dfn-type=value>
+		<dt><dfn class=css-code data-dfn-for=@media/updates data-dfn-type=value data-export="" id=valuedef-none0>none<a class=self-link href=#valuedef-none0></a></dfn>
+		<dd>
+		Once it has been rendered, the layout can no longer be updated.
+		Example: documents printed on paper.
+
+		<dt><dfn class=css-code data-dfn-for=@media/updates data-dfn-type=value data-export="" id=valuedef-slow>slow<a class=self-link href=#valuedef-slow></a></dfn>
+		<dd>
+		The layout may change dynamically according to the usual rules
+		of CSS, but the output device is not able to render or display
+		changes quickly enough for them to be percieved as a smooth
+		animation. Example: E-ink screens or severely under-powered
+		devices.
+
+		<dt><dfn class=css-code data-dfn-for=@media/updates data-dfn-type=value data-export="" id=valuedef-normal0>normal<a class=self-link href=#valuedef-normal0></a></dfn>
+		<dd>
+		The layout may change dynamically according to the usual rules
+		of CSS, and the output device is not unusually constrained in
+		speed. Example: computer screens.
+	</dl>
+
+
+
 
 <h2 class="heading settled heading" data-level=6 id=mf-colors><span class=secno>6 </span><span class=content>
 Color Media Features</span><a class=self-link href=#mf-colors></a></h2>
@@ -1544,7 +1571,7 @@ <h3 class="heading settled heading" data-level=7.1 id=pointer><span class=secno>
 	This media query takes the following values:
 
 	<dl data-dfn-for=@media/pointer data-dfn-type=value>
-		<dt><dfn class=css-code data-dfn-for=@media/pointer data-dfn-type=value data-export="" id=valuedef-none0>none<a class=self-link href=#valuedef-none0></a></dfn>
+		<dt><dfn class=css-code data-dfn-for=@media/pointer data-dfn-type=value data-export="" id=valuedef-none1>none<a class=self-link href=#valuedef-none1></a></dfn>
 		<dd>The input mechanism of the device does not include a pointing device.
 
 		<dt><dfn class=css-code data-dfn-for=@media/pointer data-dfn-type=value data-export="" id=valuedef-coarse>coarse<a class=self-link href=#valuedef-coarse></a></dfn>
@@ -1600,7 +1627,7 @@ <h3 class="heading settled heading" data-level=7.1 id=pointer><span class=secno>
 		</div>
 
 <p>	For accessibility reasons, even on devices whose pointing device can be
-	described as <a class=css data-link-type=maybe href=#valuedef-fine title=fine>fine</a>, the UA may give a value of <a class=css data-link-type=maybe href=#valuedef-coarse title=coarse>coarse</a> or <a class=css data-link-for=pointer data-link-type=maybe href=#valuedef-none0 title=none>none</a> to
+	described as <a class=css data-link-type=maybe href=#valuedef-fine title=fine>fine</a>, the UA may give a value of <a class=css data-link-type=maybe href=#valuedef-coarse title=coarse>coarse</a> or <a class=css data-link-for=pointer data-link-type=maybe href=#valuedef-none1 title=none>none</a> to
 	this media query, to indicate that the user has difficulties
 	manipulating the input device accurately or at all.
 
@@ -1623,7 +1650,7 @@ <h3 class="heading settled heading" data-level=7.2 id=hover><span class=secno>7.
 	used on the output device can hover or not.
 
 	<dl data-dfn-for=@media/hover data-dfn-type=value>
-		<dt><dfn class=css-code data-dfn-for=@media/hover data-dfn-type=value data-export="" id=valuedef-none1>none<a class=self-link href=#valuedef-none1></a></dfn>
+		<dt><dfn class=css-code data-dfn-for=@media/hover data-dfn-type=value data-export="" id=valuedef-none2>none<a class=self-link href=#valuedef-none2></a></dfn>
 		<dd>
 			Indicates that the primary pointing system can’t hover,
 			or there is no pointing system.
@@ -1646,7 +1673,7 @@ <h3 class="heading settled heading" data-level=7.2 id=hover><span class=secno>7.
 
 	<div class=example>
 		For example, on a touch screen device that can also be controlled by an optional mouse,
-		the <a class=property data-link-type=propdesc href=#descdef-hover title=hover>hover</a> <a data-link-type=dfn href=#media-feature title="media feature">media feature</a> should match <a class=css data-link-for=hover data-link-type=maybe href=#valuedef-none1 title=none>none</a>,
+		the <a class=property data-link-type=propdesc href=#descdef-hover title=hover>hover</a> <a data-link-type=dfn href=#media-feature title="media feature">media feature</a> should match <a class=css data-link-for=hover data-link-type=maybe href=#valuedef-none2 title=none>none</a>,
 		as the primary interaction mode (touching the screen) can’t hover.
 
 <p>		Authors should therefore be careful not to assume that the ':hover' pseudo class
@@ -2074,11 +2101,13 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
 <li>&lt;mf-value&gt;, <a href=#typedef-mf-value title="section 3">3</a>
 <li>monochrome, <a href=#descdef-monochrome title="section 6.3">6.3</a>
 <li>&lt;mq-boolean&gt;, <a href=#typedef-mq-boolean title="section 1.2">1.2</a>
-<li>none<ul><li>value for @media/pointer, <a href=#valuedef-none0 title="section 7.1">7.1</a>
-<li>value for @media/hover, <a href=#valuedef-none1 title="section 7.2">7.2</a>
+<li>none<ul><li>value for @media/updates, <a href=#valuedef-none0 title="section 5.4">5.4</a>
+<li>value for @media/pointer, <a href=#valuedef-none1 title="section 7.1">7.1</a>
+<li>value for @media/hover, <a href=#valuedef-none2 title="section 7.2">7.2</a>
 <li>value for @media/script, <a href=#valuedef-none title="section 9.1">9.1</a>
-</ul><li>normal, <a href=#valuedef-normal title="section 8.1">8.1</a>
-<li>not, <a href=#valuedef-not title="section 2.2.1">2.2.1</a>
+</ul><li>normal<ul><li>value for @media/updates, <a href=#valuedef-normal0 title="section 5.4">5.4</a>
+<li>value for @media/luminosity, <a href=#valuedef-normal title="section 8.1">8.1</a>
+</ul><li>not, <a href=#valuedef-not title="section 2.2.1">2.2.1</a>
 <li>on-demand, <a href=#valuedef-on-demand title="section 7.2">7.2</a>
 <li>only, <a href=#valuedef-only title="section 2.2.2">2.2.2</a>
 <li>orientation, <a href=#descdef-orientation title="section 4.4">4.4</a>
@@ -2092,9 +2121,11 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
 <li>scan, <a href=#descdef-scan title="section 5.2">5.2</a>
 <li>screen, <a href=#valuedef-screen title="section 2.3">2.3</a>
 <li>script, <a href=#descdef-script title="section 9.1">9.1</a>
+<li>slow, <a href=#valuedef-slow title="section 5.4">5.4</a>
 <li>speech, <a href=#valuedef-speech title="section 2.3">2.3</a>
 <li>tty, <a href=#valuedef-tty title="section 2.3">2.3</a>
 <li>tv, <a href=#valuedef-tv title="section 2.3">2.3</a>
+<li>updates, <a href=#descdef-updates title="section 5.4">5.4</a>
 <li>washed, <a href=#valuedef-washed title="section 8.1">8.1</a>
 <li>width, <a href=#descdef-width title="section 4.1">4.1</a>
 </ul></div>
@@ -2112,6 +2143,7 @@ <h2 class="no-num no-ref heading settled heading" id=property-index><span class=
 <tr><th scope-row=""><a data-property="">resolution</a><td>&lt;resolution&gt;<td><td>range
 <tr><th scope-row=""><a data-property="">scan</a><td>interlace | progressive<td><td>discrete
 <tr><th scope-row=""><a data-property="">grid</a><td>&lt;mq-boolean&gt;<td><td>discrete
+<tr><th scope-row=""><a data-property="">updates</a><td>none | slow | normal<td><td>discrete
 <tr><th scope-row=""><a data-property="">color</a><td>&lt;integer&gt;<td><td>range
 <tr><th scope-row=""><a data-property="">color-index</a><td>&lt;integer&gt;<td><td>range
 <tr><th scope-row=""><a data-property="">monochrome</a><td>&lt;integer&gt;<td><td>range

mediaqueries/Overview.src.html

@@ -1046,6 +1046,39 @@ <h3 id="grid">
 		</pre>
 	</div>
 
+<h3 id="updates">Updates</h3>
+	<pre class='descdef mq'>
+	Name: updates
+	Value: none | slow | normal
+	For: @media
+	Type: discrete
+	</pre>
+
+	The 'updates' media feature is used to query the ability of the output device to modify the apearance of content once it has been rendered. It accepts the following values:
+
+	<dl dfn-type=value dfn-for="@media/updates">
+		<dt><dfn>none</dfn>
+		<dd>
+		Once it has been rendered, the layout can no longer be updated.
+		Example: documents printed on paper.
+
+		<dt><dfn>slow</dfn>
+		<dd>
+		The layout may change dynamically according to the usual rules
+		of CSS, but the output device is not able to render or display
+		changes quickly enough for them to be percieved as a smooth
+		animation. Example: E-ink screens or severely under-powered
+		devices.
+
+		<dt><dfn>normal</dfn>
+		<dd>
+		The layout may change dynamically according to the usual rules
+		of CSS, and the output device is not unusually constrained in
+		speed. Example: computer screens.
+	</dl>
+
+
+
 
 <h2 id='mf-colors'>
 Color Media Features</h2>