- From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 24 May 2011 22:31:58 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-images
In directory hutz:/tmp/cvs-serv8228
Modified Files:
Overview.html Overview.src.html img_scale.png
Log Message:
Removing the issue markers around 'none' and 'scale-down' for 'object-fit', as I received good use-cases for them.
Fixed the terminology and image for 'object-fit' to reflect the fact that replaced elements always clip their contents; 'overflow' has no effect.
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-images/Overview.html,v
retrieving revision 1.102
retrieving revision 1.103
diff -u -d -r1.102 -r1.103
--- Overview.html 24 May 2011 20:58:24 -0000 1.102
+++ Overview.html 24 May 2011 22:31:56 -0000 1.103
@@ -1451,7 +1451,7 @@
<tr>
<th>Value:
- <td>fill | contain | cover <span class=issue>| none | scale-down</span>
+ <td>fill | contain | cover | none | scale-down
<tr>
<th>Initial:
@@ -1554,32 +1554,26 @@
aspect ratio, so the concept of "smaller" is well-defined.</p>
</dl>
- <p class=issue>ISSUE: ‘<code class=property>none</code>’ and
- ‘<code class=property>scale-down</code>’ are a bit
- controversial. Need some discussion on use-cases for each. Particularly,
- is there existing content behavior (perhaps surrounding <object>) that
- requires one of these values?
-
<p>If the content does not completely fill the replaced element, the
- unfilled space shows the replaced element's background. The ‘<code
- class=property>overflow</code>’ property determines how to render
- parts of the replaced element's content that extend beyond the edges of
- its box. See the ‘<a href="#object-position0"><code
+ unfilled space shows the replaced element's background. Replaced elements
+ always clip their contents, similar to the effects of ‘<code
+ class=css>overflow:hidden</code>’ on non-replaced elements, so any
+ content that would extend beyond the edges of the box are simply not
+ displayed. See the ‘<a href="#object-position0"><code
class=property>object-position</code></a>’ property for positioning
the object with respect to the element's box.
<div class=figure>
<p><img alt="" src="img_scale.png" style="border: thin solid black;"></p>
- <p class=caption> An example showing how each of the four values of
- ‘<a href="#object-fit0"><code
- class=property>object-fit</code></a>’ causes the replaced element
- (blue figure) to be scaled to fit its height/width box (shown with a
- green background), with overflow ‘<code
- class=property>visible</code>’ and ‘<code
- class=property>hidden</code>’, using the initial value for
- ‘<a href="#object-position0"><code
- class=property>object-position</code></a>’.</p>
+ <p class=caption>An example showing how four of the values of ‘<a
+ href="#object-fit0"><code class=property>object-fit</code></a>’
+ cause the replaced element (blue figure) to be scaled to fit its
+ height/width box (shownwith a green background), using the initial value
+ for ‘<a href="#object-position0"><code
+ class=property>object-position</code></a>’. The fifth value,
+ ‘<code class=css><span class=css>scale-down</span>, in this case
+ looks identical to </code>’<span class=css>contain</span>.</p>
</div>
<p class=note>Note: the ‘<a href="#object-fit0"><code
Index: img_scale.png
===================================================================
RCS file: /sources/public/csswg/css3-images/img_scale.png,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
Binary files /tmp/cvsNmADS8 and /tmp/cvsOysQEx differ
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-images/Overview.src.html,v
retrieving revision 1.106
retrieving revision 1.107
diff -u -d -r1.106 -r1.107
--- Overview.src.html 24 May 2011 20:58:24 -0000 1.106
+++ Overview.src.html 24 May 2011 22:31:56 -0000 1.107
@@ -1095,7 +1095,7 @@
<td><dfn>object-fit</dfn>
<tr>
<th>Value:
- <td>fill | contain | cover <span class=issue>| none | scale-down</span>
+ <td>fill | contain | cover | none | scale-down
<tr>
<th>Initial:
<td>fill
@@ -1175,24 +1175,21 @@
</dd>
</dl>
- <p class=issue>ISSUE: 'none' and 'scale-down' are a bit controversial. Need some
- discussion on use-cases for each. Particularly, is there existing content behavior
- (perhaps surrounding <object>) that requires one of these values?</p>
-
<p>If the content does not completely fill the replaced element, the unfilled
- space shows the replaced element's background. The 'overflow' property determines
- how to render parts of the replaced element's content that extend beyond the
- edges of its box. See the 'object-position' property for positioning the object
+ space shows the replaced element's background. Replaced elements always clip
+ their contents, similar to the effects of ''overflow:hidden'' on non-replaced elements,
+ so any content that would extend beyond the edges of the box are simply not
+ displayed. See the 'object-position' property for positioning the object
with respect to the element's box.</p>
<div class="figure">
- <p><img src="img_scale.png" style="border: thin solid black;"
- alt=""></p>
- <p class="caption">
- An example showing how each of the four values of 'object-fit' causes the
- replaced element (blue figure) to be scaled to fit its height/width box (shown
- with a green background), with overflow 'visible' and 'hidden', using the
- initial value for 'object-position'.</p>
+ <p><img src="img_scale.png" style="border: thin solid black;" alt=""></p>
+
+ <p class="caption">An example showing how four of the values of
+ 'object-fit' cause the replaced element (blue figure) to be scaled to fit
+ its height/width box (shownwith a green background), using the initial
+ value for 'object-position'. The fifth value, '<span class='css'>scale-down</span>,
+ in this case looks identical to '<span class='css'>contain</span>.</p>
</div>
<p class="note">Note: the 'object-fit' property has similar semantics to
Received on Tuesday, 24 May 2011 22:32:00 UTC