Skip to content

Commit 07b4284

Browse files
committed
Remove 'text-wrap: avoid' per WG resolution (Hamburg F2F)
1 parent b3f3d66 commit 07b4284

2 files changed

Lines changed: 28 additions & 235 deletions

File tree

css3-text/Overview.html

Lines changed: 17 additions & 151 deletions
Original file line numberDiff line numberDiff line change
@@ -242,10 +242,6 @@ <h2 class="no-num no-toc" id=contents> Table of Contents</h2>
242242
<ul class=toc>
243243
<li><a href="#text-wrap"><span class=secno>6.1. </span> Text Wrap
244244
Settings: the ‘<code class=property>text-wrap</code>’ property</a>
245-
<ul class=toc>
246-
<li><a href="#example-avoid"><span class=secno>6.1.1. </span>
247-
Phrase-controlled Breaking</a>
248-
</ul>
249245

250246
<li><a href="#overflow-wrap"><span class=secno>6.2. </span> Overflow
251247
Wrapping: the ‘<code class=property>overflow-wrap</code>
@@ -383,8 +379,8 @@ <h2 class="no-num no-toc" id=contents> Table of Contents</h2>
383379

384380
<li class=no-num><a href="#changes">Appendix C: Changes</a>
385381
<ul class=toc>
386-
<li class=no-num><a href="#recent-changes"> Changes from the September
387-
2011 CSS3 Text <abbr title="Working Draft">WD</abbr></a>
382+
<li class=no-num><a href="#recent-changes"> Changes from the January
383+
2012 CSS3 Text <abbr title="Working Draft">WD</abbr></a>
388384
</ul>
389385

390386
<li class=no-num><a href="#default-stylesheet">Appendix D: Default UA
@@ -899,9 +895,8 @@ <h3 id=white-space-rules><span class=secno>3.3. </span> The White Space
899895

900896
<li>If spaces or tabs at the end of a line are non-collapsible but have
901897
<a href="#text-wrap0"><code class=property>text-wrap</code></a>’ set
902-
to ‘<code class=property>normal</code>’ or ‘<code
903-
class=property>avoid</code>’ the UA may visually collapse their
904-
character advance widths.
898+
to ‘<code class=property>normal</code>’ the UA may visually collapse
899+
their character advance widths.
905900
</ol>
906901

907902
<p>White space that was not removed or collapsed during the white space
@@ -1630,7 +1625,7 @@ <h3 id=text-wrap><span class=secno>6.1. </span> Text Wrap Settings: the
16301625
<tr>
16311626
<th><a href="#values">Value</a>:
16321627

1633-
<td>normal | nowrap | avoid
1628+
<td>normal | nowrap
16341629

16351630
<tr>
16361631
<th>Initial:
@@ -1680,14 +1675,6 @@ <h3 id=text-wrap><span class=secno>6.1. </span> Text Wrap Settings: the
16801675

16811676
<dd>Lines must not wrap; content that does not fit within the block
16821677
container overflows it.
1683-
1684-
<dt><dfn id=avoid title="text-wrap:avoid"><code
1685-
class=css>avoid</code></dfn>
1686-
1687-
<dd>Line wrapping is suppressed within the element: the UA may only wrap
1688-
at a breakpoint within the element if there are no other valid
1689-
breakpoints in the line. If the text breaks, line-breaking restrictions
1690-
are honored as for ‘<code class=property>normal</code>’.
16911678
</dl>
16921679

16931680
<p>Regardless of the ‘<a href="#text-wrap0"><code
@@ -1699,8 +1686,7 @@ <h3 id=text-wrap><span class=secno>6.1. </span> Text Wrap Settings: the
16991686

17001687
<p>When <a class=property href="#text-wrap0"><code
17011688
class=property>text-wrap</code></a> is set to ‘<code
1702-
class=property>normal</code>’ or ‘<code
1703-
class=property>avoid</code>’, UAs that allow wrapping at punctuation
1689+
class=property>normal</code>’, UAs that allow wrapping at punctuation
17041690
other than spaces should prioritize breakpoints. For example, if breaks
17051691
after slashes are given a lower priority than spaces, the sequence "check
17061692
/etc" will never break between the ‘<code class=css>/</code>’ and the
@@ -1712,52 +1698,6 @@ <h3 id=text-wrap><span class=secno>6.1. </span> Text Wrap Settings: the
17121698
narrow measures.</p>
17131699
<!-- add a sample prioritization algorithm -->
17141700

1715-
<h4 id=example-avoid><span class=secno>6.1.1. </span> Phrase-controlled
1716-
Breaking</h4>
1717-
1718-
<div class=example>
1719-
<p>Using ‘<code class=css>text-wrap: avoid</code>’, the priority of
1720-
breakpoints can be set to reflect the intended grouping of text.</p>
1721-
1722-
<p>Given the rules</p>
1723-
1724-
<pre>
1725-
<!-- -->footer { text-wrap: avoid; /* inherits to all descendants */ }
1726-
</pre>
1727-
1728-
<p>and the following markup:</p>
1729-
1730-
<pre>
1731-
<!-- -->&lt;footer>
1732-
<!-- --> &lt;venue>27th Internationalization and Unicode Conference&lt;/venue>
1733-
<!-- --> &amp;#8226; &lt;date>April 7, 2005&lt;/date> &amp;#8226;
1734-
<!-- --> &lt;place>Berlin, Germany&lt;/place>
1735-
<!-- -->&lt;/footer>
1736-
</pre>
1737-
1738-
<p>In a narrow window the footer could be broken as</p>
1739-
1740-
<pre>
1741-
<!-- -->27th Internationalization and Unicode Conference •
1742-
<!-- -->April 7, 2005 • Berlin, Germany
1743-
</pre>
1744-
1745-
<p>or in a narrower window as</p>
1746-
1747-
<pre>
1748-
<!-- -->27th Internationalization and Unicode
1749-
<!-- -->Conference • April 7, 2005 •
1750-
<!-- -->Berlin, Germany
1751-
</pre>
1752-
1753-
<p>but not as</p>
1754-
1755-
<pre>
1756-
<!-- -->27th Internationalization and Unicode Conference • April
1757-
<!-- -->7, 2005 • Berlin, Germany
1758-
</pre>
1759-
</div>
1760-
17611701
<h3 id=overflow-wrap><span class=secno>6.2. </span> Overflow Wrapping: the
17621702
<a href="#overflow-wrap0"><code
17631703
class=property>overflow-wrap</code></a>’ property</h3>
@@ -1808,9 +1748,8 @@ <h3 id=overflow-wrap><span class=secno>6.2. </span> Overflow Wrapping: the
18081748
<p>This property specifies whether the UA may break within a word to
18091749
prevent overflow when an otherwise-unbreakable string is too long to fit
18101750
within the line box. It only has an effect when ‘<a
1811-
href="#text-wrap0"><code class=property>text-wrap</code></a>’ is either
1812-
<code class=property>normal</code>’ or ‘<code
1813-
class=property>avoid</code>’. Possible values:
1751+
href="#text-wrap0"><code class=property>text-wrap</code></a>’ is
1752+
<code class=property>normal</code>’. Possible values:
18141753

18151754
<dl>
18161755
<dt><dfn id=normal3 title="overflow-wrap:normal"><code
@@ -4889,95 +4828,22 @@ <h3 class=no-num id=informative-ref>Informative references</h3>
48894828
<h2 class=no-num id=changes>Appendix C: Changes</h2>
48904829

48914830
<h3 class=no-num id=recent-changes> Changes from the <a
4892-
href="http://www.w3.org/TR/2011/WD-css3-text-20110901/">September 2011
4893-
CSS3 Text <abbr title="Working Draft">WD</abbr></a></h3>
4894-
4895-
<p>A number of less-stable features have been deferred to Level 4:
4896-
4897-
<ul>
4898-
<li>the ‘<code class=css>discard</code>’, ‘<code
4899-
class=css>trim-inner</code>’, ‘<code
4900-
class=css>consume-before</code>’, and ‘<code
4901-
class=css>consume-after</code>’ values of ‘<a
4902-
href="#text-space-collapse"><code
4903-
class=property>text-space-collapse</code></a>
4904-
4905-
<li>the ‘<code class=property>hyphenate-character</code>’, ‘<code
4906-
class=property>hyphenate-limit-zone</code>’, ‘<code
4907-
class=property>hyphenate-limit-word</code>’, ‘<code
4908-
class=property>hyphenate-limit-lines</code>’, and ‘<code
4909-
class=property>hyphenate-limit-last</code>’ properties
4910-
4911-
<li>the ‘<a href="#hyphenation0"><code class=css>hyphenate</code></a>
4912-
value of ‘<a href="#overflow-wrap0"><code
4913-
class=property>overflow-wrap</code></a>
4914-
4915-
<li>the ‘<code class=property>text-spacing</code>’ property
4916-
4917-
<li>the ‘<code
4918-
class=css>no/replace-underline/overline/line-through</code>’ values of
4919-
<a href="#text-decoration-line0"><code
4920-
class=property>text-decoration-line</code></a>
4921-
4922-
<li>the ‘<code class=property>text-emphasis-skip</code>’ property
4923-
4924-
<li>the spread radius on ‘<a href="#text-shadow0"><code
4925-
class=property>text-shadow</code></a>
4926-
</ul>
4831+
href="http://www.w3.org/TR/2012/WD-css3-text-20120119/">January 2012 CSS3
4832+
Text <abbr title="Working Draft">WD</abbr></a></h3>
49274833

4928-
<p>Other major changes include:
4834+
<p>Major changes include:
49294835

49304836
<ul>
4931-
<li>Simplified first-line alignment feature of ‘<a
4932-
href="#text-align0"><code class=property>text-align</code></a>’ to only
4933-
allow the ‘<code class=css>start end</code>’ combination, since no
4934-
use cases were presented for any others.
4935-
4936-
<li>Removed ability to combine character-based alignment with full
4937-
justification (‘<code class=css>&lt;string> justify</code>’). Allow
4938-
reordering of ‘<a href="#text-align0"><code
4939-
class=property>text-align</code></a>’ values.
4940-
4941-
<li>Dropped percentage values of ‘<a href="#letter-spacing0"><code
4942-
class=property>letter-spacing</code></a>’ and change its definition for
4943-
<a href="#word-spacing0"><code
4944-
class=property>word-spacing</code></a>’ to be relative to the affected
4945-
character.
4946-
4947-
<li>Added back ‘<code class=css>last</code>’ value of ‘<a
4948-
href="#hanging-punctuation0"><code
4949-
class=property>hanging-punctuation</code></a>
4950-
4951-
<li>Allowed ‘<a href="#below"><code class=css>below</code></a>’, ‘<a
4952-
href="#left0"><code class=css>left</code></a>’, and ‘<a
4953-
href="#right0"><code class=css>right</code></a>’ to be specified on
4954-
their own for ‘<a href="#text-underline-position0"><code
4955-
class=property>text-underline-position</code></a>’.
4837+
<li>Removed the ‘<code class=css>avoid</code>’ value of ‘<a
4838+
href="#text-wrap0"><code class=property>text-wrap</code></a>’, since it
4839+
doesn't work very well with the fact that ‘<a href="#text-wrap0"><code
4840+
class=property>text-wrap</code></a>’ inherits.
49564841
</ul>
49574842

49584843
<p>Significant details updated:
49594844

49604845
<ul>
4961-
<li>Defined that control characters other than those honored are ignored
4962-
for rendering purposes.
4963-
4964-
<li>Defined which line-breaking controls apply for break opportunities at
4965-
element boundaries.
4966-
4967-
<li>Fixed error in ‘<a href="#text-justify0"><code
4968-
class=property>text-justify</code></a>’ table for ‘<code
4969-
class=css>distribute</code>
4970-
4971-
<li>Fixed error in single-value ‘<a href="#letter-spacing0"><code
4972-
class=property>letter-spacing</code></a>’ and ‘<a
4973-
href="#word-spacing0"><code class=property>word-spacing</code></a>
4974-
definitions
4975-
4976-
<li>Removed language-dependent behavior of ‘<code
4977-
class=css>text-underline-position: auto</code>
4978-
4979-
<li>Include &lt;narrow&gt; mappings in ‘<code class=css>text-transform:
4980-
fullwidth</code>
4846+
<li>
49814847
</ul>
49824848

49834849
<h2 class=no-num id=default-stylesheet>Appendix D: Default UA Stylesheet</h2>
@@ -5983,7 +5849,7 @@ <h2 class=no-num id=appendix-h-full-property-index>Appendix H: Full
59835849
<tr>
59845850
<th><a class=property href="#text-wrap0">text-wrap</a>
59855851

5986-
<td>normal | nowrap | avoid
5852+
<td>normal | nowrap
59875853

59885854
<td>normal
59895855

css3-text/Overview.src.html

Lines changed: 11 additions & 84 deletions
Original file line numberDiff line numberDiff line change
@@ -559,7 +559,7 @@ <h3 id="white-space-rules">
559559
The <dfn>tab size</dfn> is given by the 'tab-size' property.
560560
<li>A sequence of collapsible spaces at the end of a line is removed.
561561
<li>If spaces or tabs at the end of a line are non-collapsible but
562-
have 'text-wrap' set to 'normal' or 'avoid' the UA may visually
562+
have 'text-wrap' set to 'normal' the UA may visually
563563
collapse their character advance widths.
564564
</ol>
565565

@@ -1134,7 +1134,7 @@ <h3 id="text-wrap">
11341134
</tr>
11351135
<tr>
11361136
<th><a href="#values">Value</a>:
1137-
<td>normal | nowrap | avoid</td>
1137+
<td>normal | nowrap</td>
11381138
</tr>
11391139
<tr>
11401140
<th>Initial:</th>
@@ -1174,11 +1174,6 @@ <h3 id="text-wrap">
11741174
<dt><dfn title="text-wrap:nowrap">''nowrap''</dfn></dt>
11751175
<dd>Lines must not wrap; content that does not fit within the block container
11761176
overflows it.</dd>
1177-
<dt><dfn title="text-wrap:avoid">''avoid''</dfn></dt>
1178-
<dd>Line wrapping is suppressed within the element: the UA may only wrap at
1179-
a breakpoint within the element if there are no other valid breakpoints
1180-
in the line. If the text breaks, line-breaking restrictions are honored
1181-
as for 'normal'.
11821177
</dl>
11831178

11841179
<p>Regardless of the 'text-wrap' value, lines always break at each
@@ -1187,9 +1182,8 @@ <h3 id="text-wrap">
11871182
the BK, CR, LF, CM, NL, and SG line breaking classes in [[!UAX14]]
11881183
must be honored.</p>
11891184

1190-
<p>When <span class="property">'text-wrap'</span> is set to 'normal' or
1191-
'avoid', UAs that allow wrapping at punctuation other than spaces
1192-
should prioritize breakpoints.
1185+
<p>When <span class="property">'text-wrap'</span> is set to 'normal',
1186+
UAs that allow wrapping at punctuation other than spaces should prioritize breakpoints.
11931187
For example, if breaks after slashes are given a lower priority than spaces,
11941188
the sequence "check /etc" will never break between the '/' and the 'e'.
11951189
The UA may use the width of the containing block, the text's language,
@@ -1200,44 +1194,6 @@ <h3 id="text-wrap">
12001194

12011195
<!-- add a sample prioritization algorithm -->
12021196

1203-
<h4 id="example-avoid">
1204-
Phrase-controlled Breaking</h4>
1205-
1206-
<div class="example">
1207-
<p>Using ''text-wrap: avoid'', the priority of breakpoints can be set
1208-
to reflect the intended grouping of text.</p>
1209-
1210-
<p>Given the rules</p>
1211-
<pre>
1212-
<!-- -->footer { text-wrap: avoid; /* inherits to all descendants */ }
1213-
</pre>
1214-
<p>and the following markup:</p>
1215-
<pre>
1216-
<!-- -->&lt;footer>
1217-
<!-- --> &lt;venue>27th Internationalization and Unicode Conference&lt;/venue>
1218-
<!-- --> &amp;#8226; &lt;date>April 7, 2005&lt;/date> &amp;#8226;
1219-
<!-- --> &lt;place>Berlin, Germany&lt;/place>
1220-
<!-- -->&lt;/footer>
1221-
</pre>
1222-
1223-
<p>In a narrow window the footer could be broken as</p>
1224-
<pre>
1225-
<!-- -->27th Internationalization and Unicode Conference &#8226;
1226-
<!-- -->April 7, 2005 &#8226; Berlin, Germany
1227-
</pre>
1228-
<p>or in a narrower window as</p>
1229-
<pre>
1230-
<!-- -->27th Internationalization and Unicode
1231-
<!-- -->Conference &#8226; April 7, 2005 &#8226;
1232-
<!-- -->Berlin, Germany
1233-
</pre>
1234-
<p>but not as</p>
1235-
<pre>
1236-
<!-- -->27th Internationalization and Unicode Conference &#8226; April
1237-
<!-- -->7, 2005 &#8226; Berlin, Germany
1238-
</pre>
1239-
</div>
1240-
12411197
<h3 id="overflow-wrap">
12421198
Overflow Wrapping: the 'overflow-wrap' property</h3>
12431199

@@ -1281,7 +1237,7 @@ <h3 id="overflow-wrap">
12811237
<p>This property specifies whether the UA may break within a word
12821238
to prevent overflow when an otherwise-unbreakable string is too
12831239
long to fit within the line box. It only has an effect when
1284-
'text-wrap' is either 'normal' or 'avoid'. Possible values:</p>
1240+
'text-wrap' is 'normal'. Possible values:</p>
12851241

12861242
<dl>
12871243
<dt><dfn title="overflow-wrap:normal">''normal''</dfn></dt>
@@ -3641,47 +3597,18 @@ <h3 class="no-num" id="informative-ref">Informative references</h3>
36413597
<h2 class="no-num" id="changes">Appendix C:
36423598
Changes</h2>
36433599
<h3 class="no-num" id="recent-changes">
3644-
Changes from the <a href="http://www.w3.org/TR/2011/WD-css3-text-20110901/">September
3645-
2011 CSS3 Text <abbr title="Working Draft">WD</abbr></a></h3>
3646-
3647-
<p>A number of less-stable features have been deferred to Level 4:
3648-
<ul>
3649-
<li>the ''discard'', ''trim-inner'', ''consume-before'', and ''consume-after''
3650-
values of 'text-space-collapse'
3651-
<li>the 'hyphenate-character', 'hyphenate-limit-zone', 'hyphenate-limit-word',
3652-
'hyphenate-limit-lines', and 'hyphenate-limit-last' properties
3653-
<li>the ''hyphenate'' value of 'overflow-wrap'
3654-
<li>the 'text-spacing' property
3655-
<li>the ''no/replace-underline/overline/line-through'' values of 'text-decoration-line'
3656-
<li>the 'text-emphasis-skip' property
3657-
<li>the spread radius on 'text-shadow'
3658-
</ul>
3600+
Changes from the <a href="http://www.w3.org/TR/2012/WD-css3-text-20120119/">January
3601+
2012 CSS3 Text <abbr title="Working Draft">WD</abbr></a></h3>
36593602

3660-
<p>Other major changes include:</p>
3603+
<p>Major changes include:</p>
36613604
<ul>
3662-
<li>Simplified first-line alignment feature of 'text-align' to only allow
3663-
the ''start end'' combination, since no use cases were presented for any
3664-
others.
3665-
<li>Removed ability to combine character-based alignment with full
3666-
justification (''&lt;string> justify''). Allow reordering of 'text-align'
3667-
values.
3668-
<li>Dropped percentage values of 'letter-spacing' and change its
3669-
definition for 'word-spacing' to be relative to the affected character.
3670-
<li>Added back ''last'' value of 'hanging-punctuation'
3671-
<li>Allowed ''below'', ''left'', and ''right'' to be specified on their own
3672-
for 'text-underline-position'.
3605+
<li>Removed the ''avoid'' value of 'text-wrap', since it doesn't work
3606+
very well with the fact that 'text-wrap' inherits.
36733607
</ul>
36743608

36753609
<p>Significant details updated:</p>
36763610
<ul>
3677-
<li>Defined that control characters other than those honored are ignored
3678-
for rendering purposes.
3679-
<li>Defined which line-breaking controls apply for break opportunities at
3680-
element boundaries.
3681-
<li>Fixed error in 'text-justify' table for ''distribute''
3682-
<li>Fixed error in single-value 'letter-spacing' and 'word-spacing' definitions
3683-
<li>Removed language-dependent behavior of ''text-underline-position: auto''
3684-
<li>Include &lt;narrow&gt; mappings in ''text-transform: fullwidth''
3611+
<li>
36853612
</ul>
36863613

36873614
<h2 class="no-num" id="default-stylesheet">Appendix D: Default UA Stylesheet</h2>

0 commit comments

Comments
 (0)