@@ -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> <u>石井</u><u>艾俐俐</u></code>
917+ <p class="caption"> ''text-decoration-inset: auto'' for <code> <u>石井</u><u>艾俐俐</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