- From: Rossen Atanassov via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 28 Oct 2011 06:01:54 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-exclusions
In directory hutz:/tmp/cvs-serv24635
Modified Files:
Exclusions.src.html Overview.html
Log Message:
Changed the max-width of the wrap-through example from 50% to 40% to match all other examples.
Removed the restriction of circle radius not allowed to be in %. This was a copy from the original spec and I don't see any reason to have such a rule.
Changed occurrences from <image> to <uri>
Minor spelling changes
Resolved Issue 1 and Issue 2.
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-exclusions/Overview.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -d -r1.10 -r1.11
--- Overview.html 27 Oct 2011 01:40:04 -0000 1.10
+++ Overview.html 28 Oct 2011 06:01:52 -0000 1.11
@@ -76,19 +76,19 @@
<body>
<div class=head id=div-head> <!--begin-logo-->
- <p><a href="http://www.w3.org/"><img alt=W3C height=48
+ <p id=x><a href="http://www.w3.org/"><img alt=W3C height=48
src="http://www.w3.org/Icons/w3c_home" width=72></a> <!--end-logo-->
<h1 id=css-exclusions-module>CSS exclusions and shapes</h1>
- <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 27 October
+ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 28 October
[...1390 lines suppressed...]
<h2 class=no-num id=references>References</h2>
@@ -1819,7 +1889,7 @@
title="'shape-inside', '<shape>'"><strong>4.3.2.</strong></a>
<li>‘<code class=css><uri></code>’, <a
- href="#ltimagegt"
+ href="#lturigt0"
title="'shape-inside', '<uri>'"><strong>4.3.2.</strong></a>
</ul>
@@ -1929,7 +1999,7 @@
<td>no
- <td>alpha channel of the image specified by <image>
+ <td>alpha channel of the image specified by <uri>
<td>visual
Index: Exclusions.src.html
===================================================================
RCS file: /sources/public/csswg/css3-exclusions/Exclusions.src.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -d -r1.10 -r1.11
--- Exclusions.src.html 27 Oct 2011 01:40:04 -0000 1.10
+++ Exclusions.src.html 28 Oct 2011 06:01:52 -0000 1.11
@@ -137,29 +137,34 @@
<dfn>Exclusion element</dfn>
<p>
- An element that defines an <span>exclusion area</span>s for other elements. The 'wrap-flow' property
- is used to make an element an exclusion element. An exclusion element contributes its
- <span>exclusion area</span> to its <a href="http://www.w3.org/TR/CSS2/visudet.html#containing-block-details">containing block</a>'s
- <span>wrapping context</span>
+ An element that defines an <span>exclusion area</span> for other elements. The 'wrap-flow'
+ property is used to make an element an exclusion element. An exclusion element contributes
+ its <span>exclusion area</span> to its <a href="http://www.w3.org/TR/CSS2/visudet.html#containing-block-details">
+ containing block's</a> <span>wrapping context</span>
</p>
<dfn>Exclusion area</dfn>
<p>
- The area used for excluding inline flow content around an exclusion element. By default the
- area is equivalent to the <a href="http://www.w3.org/TR/CSS2/box.html#box-dimensions">border box</a>.
- This specification's 'shape-outside' property can define arbitrary, non-rectangular exclusion areas.
+ The area used for excluding inline flow content around an exclusion element. The
+ exclusion area is equivalent to the <a href="http://www.w3.org/TR/CSS2/box.html#box-dimensions">
+ border box</a> for elements with 'float' property computed to 'none' and the
+ <a href="http://www.w3.org/TR/CSS2/box.html#box-dimensions">margin box</a> for elements
+ with 'float' property computed to a value other than 'none'. This specification's
+ 'shape-outside' property can be used to define arbitrary, non-rectangular exclusion
+ areas.
</p>
<dfn>Wrapping context</dfn>
<p>
- An element's wrapping context holds the collection of areas that an element should 'wrap around'
- when laying out its inline flow content. An element will wrap its content in the area that
- correspond to the subtraction of its wrapping context from its own <span>content area</span>.
+ The wrapping context of an element is a collection of 'exclusion areas'. The wrapping
+ context is used to wrap around inline flow content during layout. An element will
+ wrap its inline flow content in the area that corresponds to the subtraction of
+ its wrapping context from its own <span>content area</span>.
</p>
<p>
- An element inherit its
+ An element inherits its
<a href="http://www.w3.org/TR/CSS2/visudet.html#containing-block-details">containing block's</a>
wrapping context unless it specifically
resets it using the 'wrap-through' property.
@@ -175,8 +180,8 @@
<dfn title="outside-inside">Outside and inside</dfn>
<p>
- In this specification, ‘outside’ refers to DOM content that is not a descendant of an element
- while 'inside’ refers to the element's descendants.
+ In this specification, 'outside' refers to DOM content that is not a descendant of an element
+ while 'inside' refers to the element's descendants.
</p>
<h2 id="exclusions">Exclusions</h2>
@@ -552,7 +557,7 @@
</div>
</code></pre>
- <img class="singleImgExample" src="images/exclusion_wrap_through.png" alt="Example rendering of wrap-through: wrap | none" style="max-width:50%"/>
+ <img class="singleImgExample" src="images/exclusion_wrap_through.png" alt="Example rendering of wrap-through: wrap | none" style="max-width:40%"/>
</div>
<!-- End section "wrap-through property" -->
@@ -602,20 +607,17 @@
<!-- End section "Propagation of Exclusions" -->
<h3 id="exclusions-order">Exclusions order</h3>
-
- <div class="issue-marker"><p class="desc"><strong>Issue 1</strong>: z-index only applies to positioned elements. Since any element can
- be an exclusion and since they can overlap, should we say that the order of a statically positioned
- exclusion cannot be controlled?</p></div>
-
<p>
- Exclusions follow the painting order (See [[!CSS21]] Appendix E). Exclusions are applied in reverse
- to the document order in which they are defined. The last exclusion appears on top
- of all other exclusion, thus it affects the inline flow content of all other preceding
- exclusions or elements descendant of the same containing block. To change the ordering
- of positioned exclusions, z-index can be used.
+ Exclusions follow the painting order (See [[!CSS21]] Appendix E). Exclusions are
+ applied in reverse to the document order in which they are defined. The last exclusion
+ appears on top of all other exclusion, thus it affects the inline flow content of
+ all other preceding exclusions or elements descendant of the same containing block.
+ To change the ordering of exclusions with 'position' property computed to a value
+ other than 'static', 'z-index' can be used. Exclusions with 'position' property
+ computed to 'static' are not affected by the 'z-index' property, thus follow the painting
+ order.
</p>
-
-
+
<div class="example">
<p>Ordering of exclusions.</p>
<pre><code class="html">
@@ -753,7 +755,7 @@
<ul>
<li><strong>cx</strong> - The x-axis coordinate of the center of the circle</li>
<li><strong>cy</strong> - The y-axis coordinate of the center of the circle</li>
- <li><strong>r</strong> - The radius of the circle. Note, cannot be expressed as a percentage.</li>
+ <li><strong>r</strong> - The radius of the circle</li>
</ul>
</dd>
<dt>ellipse(cx, cy, rx, ry)</dt>
@@ -811,29 +813,25 @@
<div class="in-a-path">...</div>
</pre></code>
</div>
-
- <p>When using the SVG syntax or referencing SVG elements to define shapes, all the lengths expressed
- in percentages are resolved from the border box of the element. The coordinate system for the
- shape has its origin on the top-left corder of the border box with the x-axis running to the right
- and the y-axis running downwards. If the SVG element uses unitless coordinate values, they are equivalent
- to using 'px' units. If the border box of the element is dependent on auto sizing (i.e., the element's
- 'width' or 'height' property is 'auto'), then the percentage values are computed agains '0' and resolve to 0.</p>
-
- <!-- End section "Shapes from SVG Syntax -->
+ <p>
+ When using the SVG syntax or referencing SVG elements to define shapes, all the
+ lengths expressed in percentages are resolved from the border box of the element.
+ The coordinate system for the shape has its origin on the top-left corder of the
+ border box with the x-axis running to the right and the y-axis running downwards.
+ If the SVG element uses unitless coordinate values, they are equivalent to using
+ 'px' units. If the border box of the element is dependent on auto sizing (i.e.,
+ the element's 'width' or 'height' property is 'auto'), then the percentage values
+ are computed agains '0' and resolve to 0.
+ </p>
+ <!-- End section "Shapes from SVG Syntax -->
<h3 id="shapes-from-image">Shapes from Image</h3>
<p>
Another way of defining shapes is by specifying a source image whose alpha channel
- is used to compute the inside or outside shape. When shapes are computed from an image, all
- values of the 'background-image' property can be applied.
- </p>
-
- <div class="issue-marker"><p class="desc"><strong>Issue 2</strong>: Need to clarify what we mean by this last sentence.</div>
-
- <p>
- The shape is computed to be the path that encloses the area where the opacity of
- the specified image is greater than the 'shape-image-threshold' value. If the 'shape-image-threshold'
- is not specified, the initial value to be considered is 0.5.
+ is used to compute the inside or outside shape. The shape is computed to be the
+ path that encloses the area where the opacity of the specified image is greater
+ than the 'shape-image-threshold' value. If the 'shape-image-threshold' is not specified,
+ the initial value to be considered is 0.5.
</p>
<p class="note">
@@ -995,7 +993,7 @@
</dd>
</dl>
<dl>
- <dt><dfn title="'shape-inside'!!'<uri>'"><image></dfn></dt>
+ <dt><dfn title="'shape-inside'!!'<uri>'"><uri></dfn></dt>
<dd>
If the <uri> references an SVG shape element, that element defines the shape.
Otherwise, if the <uri> references an image, the shape is extracted and computed
@@ -1041,7 +1039,7 @@
</tr>
<tr>
<th>Percentages:</th>
- <td>alpha channel of the image specified by <image></td>
+ <td>alpha channel of the image specified by <uri></td>
</tr>
<tr>
<th>Media:</th>
Received on Friday, 28 October 2011 06:01:56 UTC