Skip to content

Commit a84830b

Browse files
authored
[css-text-decor-4] Renamed text-decoration-trim to text-decoration-inset (#13039)
`text-decoration-trim` got renamed to `text-decoration-inset` and any mentions of `text-decoration-skip-inset` were either removed or replaced by `text-decoration-inset`.
1 parent 4eac4f8 commit a84830b

File tree

1 file changed

+20
-19
lines changed

1 file changed

+20
-19
lines changed

css-text-decor-4/Overview.bs

Lines changed: 20 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -859,11 +859,11 @@ Text Decoration Line Uniformity</h3>
859859
</div>
860860

861861

862-
<h4 id="text-decoration-skip-inset-property">
863-
Text Decoration Line Trimming and Extension: the 'text-decoration-trim' property</h4>
862+
<h4 id="text-decoration-inset-property">
863+
Trimming, Expanding, and Shifting Text Decoration Lines: the 'text-decoration-inset' property</h4>
864864

865865
<pre class="propdef">
866-
Name: text-decoration-trim
866+
Name: text-decoration-inset
867867
Value: <<length>>{1,2} | auto
868868
Initial: 0
869869
Applies to: all elements
@@ -873,59 +873,61 @@ Text Decoration Line Trimming and Extension: the 'text-decoration-trim' property
873873
Animation type: by computed value
874874
</pre>
875875

876-
This property adjusts the start and end points of line decorations,
877-
allowing the author to shorten, lengthen, or shift the decoration
878-
with respect to the text.
876+
This property adjusts the start and end endpoints of line decorations.
877+
Positive values move an endpoint inward, trimming the decoration;
878+
negative values move it outward, extending the decoration.
879+
879880
It controls all text decoration lines drawn by this [=decorating box=],
880881
but not any text decoration lines drawn by its ancestors.
881882
If two component values are given,
882883
the first applies to the [=start=] and the second to the [=end=].
883884
Values have the following meanings:
884885

885-
<dl dfn-type=value dfn-for=text-decoration-skip-inset>
886+
<dl dfn-type=value dfn-for=text-decoration-inset>
886887
<dt><dfn><<length>></dfn></dt>
887888
<dd>
888-
Inset (positive) or outset (negative)
889-
the start/end of the affected line decorations.
889+
Adjusts the start or end endpoint of the affected line decorations.
890+
Positive values move the endpoint inward (trimming),
891+
negative values move it outward (extending).
890892

891893
<div class="example">
892894
<p>The following example offsets an extra thick underline
893895
1em endwards with respect to the text
894896
<pre>
895897
h1 {
896898
text-decoration: underline 0.3em rgba(36,148,187,0.25);
897-
text-decoration-trim: 1em -1em;
899+
text-decoration-inset: 1em -1em;
898900
}
899901
</pre>
900902
</div>
901903

902904
<dt><dfn>auto</dfn></dt>
903905
<dd>
904-
The UA chooses a trim amount that ensures that
906+
The UA chooses an inset amount that ensures that
905907
if two identical underlined elements appear side-by-side
906908
they do not appear to have a single underline.
907909
(This is important in Chinese, where underlining is a form of punctuation.)
908910

909911
<div class="figure">
910-
<p><img title="text-decoration-skip-inset: auto"
912+
<p><img title="text-decoration-inset: auto"
911913
alt="An underline below a series of Chinese characters has a gap between two adjacent underlining elements."
912914
src="images/decoration-skip-inset.png"
913915
width="223"
914916
height="77">
915-
<p class="caption">''text-decoration-skip-inset: auto'' for <code>&lt;u>石井&lt;/u>&lt;u>艾俐俐&lt;/u></code>
917+
<p class="caption">''text-decoration-inset: auto'' for <code>&lt;u>石井&lt;/u>&lt;u>艾俐俐&lt;/u></code>
916918
</p>
917919
</div>
918920
</dl>
919921

920-
Text decoration trimming is subject to 'box-decoration-break':
922+
The adjustment of the text decoration's endpoints is subject to 'box-decoration-break':
921923
* for ''box-decoration-break/slice'' (the default)
922-
trimming is only applied to the [=start=] edge of the first fragment
924+
endpoint adjustment is only applied to the [=start=] edge of the first fragment
923925
and the [=end=] edge of the last fragment,
924-
and may accumulate to other fragments if the amount of the trim
926+
and may accumulate to other fragments if the amount of the inset
925927
is more than the length of the fragment.
926928
<!-- Percentages are relative to the total length of the [=decorating box=]. -->
927929
* for ''box-decoration-break/clone''
928-
trimming is applied to each fragment independently.
930+
endpoint adjustment is applied to each fragment independently.
929931
<!-- and percentages are relative to the length of that fragment individually -->
930932

931933
<h3 id="text-decoration-skipping">
@@ -952,7 +954,6 @@ Text Decoration Line Continuity: the 'text-decoration-skip' shorthand and its su
952954
The 'text-decoration-skip' property and its sub-properties
953955
('text-decoration-skip-self',
954956
'text-decoration-skip-box',
955-
'text-decoration-skip-inset',
956957
'text-decoration-skip-spaces',
957958
'text-decoration-skip-ink')
958959
control interruptions in line decorations
@@ -2185,7 +2186,7 @@ Changes since the 4 May 2022 Working Draft</h3>
21852186
<ul>
21862187
<li>Redesigned 'text-decoration-skip-self'.
21872188
(<a href="https://github.com/w3c/csswg-drafts/issues/2885">Issue 2885</a>)
2188-
<li>Replaced <css>text-decoration-skip-edges</css> with 'text-decoration-trim'.
2189+
<li>Replaced <css>text-decoration-skip-edges</css> with 'text-decoration-inset'.
21892190
(<a href="https://github.com/w3c/csswg-drafts/issues/4557">Issue 4557</a>)
21902191
<li>Redefined [=spacers=] for 'text-decoration-skip-spaces' to reference [=Unicode General Category=] <code>Zs</code>
21912192
and to only additionally include word separators when skipping all spaces.

0 commit comments

Comments
 (0)