Skip to content

Commit 769f4ae

Browse files
committed
[css-text-decor-3] Clarify some definitions of text-decoration-skip.
1 parent 772efae commit 769f4ae

File tree

3 files changed

+40
-21
lines changed

3 files changed

+40
-21
lines changed

css-text-decor-3/Overview.html

Lines changed: 21 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -153,8 +153,7 @@ <h2 class="no-num no-toc" id=status>Status of this document</h2>
153153

154154
<ul>
155155
<li>the ‘<a href="#text-decoration-skip"><code
156-
class=property>text-decoration-skip</code></a>’ property / ‘<code
157-
class=css>ink</code>’ value
156+
class=property>text-decoration-skip</code></a>’ property
158157

159158
<li>the <a href="#line-position">line positioning rules</a>
160159

@@ -777,14 +776,14 @@ <h3 id=text-decoration-skip-property><span class=secno>2.5. </span> Text
777776
<dt><dfn id=none0 title="text-decoration-skip:none"><code
778777
class=css>none</code></dfn>
779778

780-
<dd>Skip nothing: text-decoration is drawn for all text content and for
781-
inline replaced elements.
779+
<dd>Skip nothing: text-decoration is drawn for all text content and across
780+
atomic inline-level boxes.
782781

783782
<dt><dfn id=objects title="text-decoration-skip:objects"><code
784783
class=css>objects</code></dfn>
785784

786-
<dd>Skip this element if it is an atomic inline (such as an image or
787-
inline-block).
785+
<dd>Skip this element (its entire margin box) if it is an atomic inline
786+
(such as an image or inline-block).
788787

789788
<dt><dfn id=spaces title="text-decoration-skip:spaces"><code
790789
class=css>spaces</code></dfn>
@@ -813,11 +812,20 @@ <h3 id=text-decoration-skip-property><span class=secno>2.5. </span> Text
813812
<dt><dfn id=edges title="text-decoration-skip:edges"><code
814813
class=css>edges</code></dfn>
815814

816-
<dd>The UA should place the start and end of the line inwards from the
817-
content edge of the <i>decorating element</i> so that, e.g. two
818-
underlined elements side-by-side do not appear to have a single
819-
underline. (This is important in Chinese, where underlining is a form of
820-
punctuation.)
815+
<dd>The UA should place the start and end of the line inwards slightly
816+
(e.g. by half a line thickness) from the content edge of the
817+
<i>decorating element</i> so that, e.g. two underlined elements
818+
side-by-side do not appear to have a single underline. (This is important
819+
in Chinese, where underlining is a form of punctuation.)
820+
<div class=figure>
821+
<p><img
822+
alt="An underline below a series of Chinese characters has a gap between two adjacent underlining elements."
823+
src=decoration-skip-edges.png title="text-decoration-skip: edges">
824+
825+
<p class=caption><code class=css>text-decoration-skip:
826+
edges</code>’ for
827+
<code>&lt;u>石井&lt;/u>&lt;u>艾俐俐&lt;/u></code>
828+
</div>
821829

822830
<dt><dfn id=box-decoration
823831
title="text-decoration-skip:box-decoration"><code
@@ -833,7 +841,8 @@ <h3 id=text-decoration-skip-property><span class=secno>2.5. </span> Text
833841

834842
<p class=note> Note that CSS 2.1 required skipping margins, borders, and
835843
padding always. In this level, by default only the margins, borders, and
836-
padding of the <i>decorating element</i> are skipped.
844+
padding of the <i>decorating element</i> are skipped. In the future CSS2.1
845+
may be updated to match this new default.
837846

838847
<h3 id=text-underline-position-property><span class=secno>2.6. </span> Text
839848
Underline Position: the ‘<a href="#text-underline-position"><code

css-text-decor-3/Overview.src.html

Lines changed: 19 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ <h2 class="no-num no-toc" id="status">Status of this document</h2>
105105
<p>The following features are at risk and may be cut from the spec during
106106
its CR period if there are no (correct) implementations:</p>
107107
<ul>
108-
<li>the 'text-decoration-skip' property / ''ink'' value
108+
<li>the 'text-decoration-skip' property
109109
<li>the <a href="#line-position">line positioning rules</a>
110110
<li>the ability to place both emphasis marks and ruby above the same base text
111111
</ul>
@@ -480,10 +480,10 @@ <h3 id="text-decoration-skip-property">
480480
<dl>
481481
<dt><dfn title="text-decoration-skip:none">''none''</dfn></dt>
482482
<dd>Skip nothing: text-decoration is drawn for all text content
483-
and for inline replaced elements.</dd>
483+
and across atomic inline-level boxes.</dd>
484484
<dt><dfn title="text-decoration-skip:objects">''objects''</dfn></dt>
485-
<dd>Skip this element if it is an atomic inline (such as an
486-
image or inline-block).</dd>
485+
<dd>Skip this element (its entire margin box) if it is an atomic inline
486+
(such as an image or inline-block).
487487
<dt><dfn title="text-decoration-skip:spaces">''spaces''</dfn></dt>
488488
<dd>Skip all spacing, i.e. all <i>characters</i> in Unicode general category Z [[UAX44]]
489489
and all <i>word separator characters</i>,
@@ -501,11 +501,20 @@ <h3 id="text-decoration-skip-property">
501501
<p class="caption">''text-decoration-skip: ink''</p>
502502
</div>
503503
<dt><dfn title="text-decoration-skip:edges">''edges''</dfn></dt>
504-
<dd>The UA should place the start and end of the line inwards from
505-
the content edge of the <i>decorating element</i> so that, e.g. two
506-
underlined elements side-by-side do not appear to have a single
507-
underline. (This is important in Chinese, where underlining is a
508-
form of punctuation.)</dd>
504+
<dd>The UA should place the start and end of the line inwards slightly
505+
(e.g. by half a line thickness)
506+
from the content edge of the <i>decorating element</i> so that,
507+
e.g. two underlined elements side-by-side do not appear to have a single underline.
508+
(This is important in Chinese, where underlining is a form of punctuation.)
509+
<div class="figure">
510+
<p><img title="text-decoration-skip: edges"
511+
alt="An underline below a series of Chinese characters has a gap between two adjacent underlining elements."
512+
src="decoration-skip-edges.png"
513+
>
514+
<p class="caption">''text-decoration-skip: edges'' for <code>&lt;u>石井&lt;/u>&lt;u>艾俐俐&lt;/u></code>
515+
</p>
516+
</div>
517+
509518
<dt><dfn title="text-decoration-skip:box-decoration">''box-decoration''</dfn>
510519
<dd>
511520
Skip over the box's margin, border, and padding areas.
@@ -519,6 +528,7 @@ <h3 id="text-decoration-skip-property">
519528
<p class='note'>
520529
Note that CSS 2.1 required skipping margins, borders, and padding always.
521530
In this level, by default only the margins, borders, and padding of the <i>decorating element</i> are skipped.
531+
In the future CSS2.1 may be updated to match this new default.
522532

523533
<h3 id="text-underline-position-property">
524534
Text Underline Position: the 'text-underline-position' property</h3>
4.55 KB
Loading

0 commit comments

Comments
 (0)