diff --git a/css-text-decor-4/Overview.bs b/css-text-decor-4/Overview.bs
index 7a936902d0b..e24aded3887 100644
--- a/css-text-decor-4/Overview.bs
+++ b/css-text-decor-4/Overview.bs
@@ -859,11 +859,11 @@ Text Decoration Line Uniformity
-
-Text Decoration Line Trimming and Extension: the 'text-decoration-trim' property
+
+Trimming, Expanding, and Shifting Text Decoration Lines: the 'text-decoration-inset' property
- Name: text-decoration-trim
+ Name: text-decoration-inset
Value: <>{1,2} | auto
Initial: 0
Applies to: all elements
@@ -873,20 +873,22 @@ Text Decoration Line Trimming and Extension: the 'text-decoration-trim' property
Animation type: by computed value
- This property adjusts the start and end points of line decorations,
- allowing the author to shorten, lengthen, or shift the decoration
- with respect to the text.
+ This property adjusts the start and end endpoints of line decorations.
+ Positive values move an endpoint inward, trimming the decoration;
+ negative values move it outward, extending the decoration.
+
It controls all text decoration lines drawn by this [=decorating box=],
but not any text decoration lines drawn by its ancestors.
If two component values are given,
the first applies to the [=start=] and the second to the [=end=].
Values have the following meanings:
-
+
- <>
-
- Inset (positive) or outset (negative)
- the start/end of the affected line decorations.
+ Adjusts the start or end endpoint of the affected line decorations.
+ Positive values move the endpoint inward (trimming),
+ negative values move it outward (extending).
The following example offsets an extra thick underline
@@ -894,38 +896,38 @@ Text Decoration Line Trimming and Extension: the 'text-decoration-trim' property
h1 {
text-decoration: underline 0.3em rgba(36,148,187,0.25);
- text-decoration-trim: 1em -1em;
+ text-decoration-inset: 1em -1em;
}
- auto
-
- The UA chooses a trim amount that ensures that
+ The UA chooses an inset amount that ensures that
if two identical underlined elements appear side-by-side
they do not appear to have a single underline.
(This is important in Chinese, where underlining is a form of punctuation.)
- Text decoration trimming is subject to 'box-decoration-break':
+ The adjustment of the text decoration's endpoints is subject to 'box-decoration-break':
* for ''box-decoration-break/slice'' (the default)
- trimming is only applied to the [=start=] edge of the first fragment
+ endpoint adjustment is only applied to the [=start=] edge of the first fragment
and the [=end=] edge of the last fragment,
- and may accumulate to other fragments if the amount of the trim
+ and may accumulate to other fragments if the amount of the inset
is more than the length of the fragment.
* for ''box-decoration-break/clone''
- trimming is applied to each fragment independently.
+ endpoint adjustment is applied to each fragment independently.
@@ -952,7 +954,6 @@ Text Decoration Line Continuity: the 'text-decoration-skip' shorthand and its su
The 'text-decoration-skip' property and its sub-properties
('text-decoration-skip-self',
'text-decoration-skip-box',
- 'text-decoration-skip-inset',
'text-decoration-skip-spaces',
'text-decoration-skip-ink')
control interruptions in line decorations
@@ -2185,7 +2186,7 @@ Changes since the 4 May 2022 Working Draft
- Redesigned 'text-decoration-skip-self'.
(Issue 2885)
-
- Replaced text-decoration-skip-edges with 'text-decoration-trim'.
+
- Replaced text-decoration-skip-edges with 'text-decoration-inset'.
(Issue 4557)
- Redefined [=spacers=] for 'text-decoration-skip-spaces' to reference [=Unicode General Category=]
Zs
and to only additionally include word separators when skipping all spaces.