Re: [csswg-drafts] [css-text-decor-4] Consider renaming `text-decoration-trim` (#8402)

The CSS Working Group just discussed ``[css-text-decor-4] Consider renaming `text-decoration-trim` ``, and agreed to the following:

* `RESOLVED: name this (and gap-deco props) with -inset`

<details><summary>The full IRC log of that discussion</summary>
&lt;TabAtkins> SebastianZ: last call, we were already discussing this and decided to create a poll<br>
&lt;TabAtkins> SebastianZ: it looks like the poll settled on text-decoration-inset<br>
&lt;TabAtkins> SebastianZ: there were still some discussions around that name being perfect, tho<br>
&lt;TabAtkins> SebastianZ: there was also a suggestion to add text-dec-cap property<br>
&lt;lea> q+<br>
&lt;TabAtkins> SebastianZ: might not cover the use-case of trimming/expanding decorations, but influencing how it looks in the end, how the edges are capped<br>
&lt;astearns> ack lea<br>
&lt;TabAtkins> lea: what's the value space? a length or an offset?<br>
&lt;TabAtkins> fantasai: a length<br>
&lt;TabAtkins> jfkthame: I'd like to suggest we resolve on -inset per the poll, and make the corresponding change to the gap decorations property to match<br>
&lt;kbabbitt> q+<br>
&lt;TabAtkins> SebastianZ: we were going to change the decorations too?<br>
&lt;lea> q+<br>
&lt;TabAtkins> fantasai: yes, I wanted them in the poll since we'd be changing them too<br>
&lt;astearns> ack kbabbitt<br>
&lt;TabAtkins> SebastianZ: I mentioned them in the post at least<br>
&lt;TabAtkins> kbabbitt: wrt gap-deco, I used -outset for a few reasons about behavior<br>
&lt;astearns> also not a fan of 'outset'<br>
&lt;TabAtkins> kbabbitt: I don't super like outset, it's less common then -inset<br>
&lt;TabAtkins> kbabbitt: but since the predominant use-case is to shorten rather than lengthen, I think -inset makes more sense<br>
&lt;astearns> ack lea<br>
&lt;schenney> q+<br>
&lt;dbaron> IMO -inset versus -outset naming implies which direction positive numbers go and which direction negative numbers go!<br>
&lt;fantasai> yes<br>
&lt;TabAtkins> lea: one of my issues with these is they imply the adjustment goes a certain direction, reducing the length, but they can also increase. trim, limit, cap all reduce<br>
&lt;fantasai> but we can flip them around depending on the name, that's ifne<br>
&lt;TabAtkins> lea: in some ways length-adjust would be ideal but too long<br>
&lt;kbabbitt> +1 dbaron<br>
&lt;TabAtkins> jfkthame: length-adjust doesn't tell you which direction you're adjusting it<br>
&lt;astearns> ack schenney<br>
&lt;astearns> ack dbaron<br>
&lt;TabAtkins> schenney: regarding cap, might be worth allowing a reference to a path so you can adjust more than just the cap. so i'm inclined to defer that until a later proposal<br>
&lt;TabAtkins> dbaron: [restates what they said in IRC]<br>
&lt;TabAtkins> dbaron: there's other names where it's not clear which way is which<br>
&lt;lea> q?<br>
&lt;TabAtkins> lea: someone proposed -spread which is interesting, but didn't get votes<br>
&lt;TabAtkins> jfkthame: sounds like it would imply a blur or thickening...<br>
&lt;TabAtkins> lea: how does this affect skip-ink?<br>
&lt;noamr> text-decoration-adjust ?<br>
&lt;TabAtkins> jfkthame: it doesn't, skipping happens in the adjusted line<br>
&lt;JoshT> q+<br>
&lt;dbaron> s/[restates what they said in IRC]/I'd expect text-decoration-inset to mean positive numbers make the line shorter and negative numbers make the line longer; I'd expect text-decoration-outside to mean the reverse/<br>
&lt;TabAtkins> astearns: so all these options have drawbacks, but I think we could resolve on -inset. seems like the least worst option and has some proponents<br>
&lt;astearns> ack JoshT<br>
&lt;TabAtkins> JoshT: curve ball, did we discuss making it similar to box-shadow? where you specify inset keyword to make it inset?<br>
&lt;TabAtkins> fantasai: I think negative vs positive covers this. box-shadow doesn't have that, insets are qualitatively different than outset shadows<br>
&lt;TabAtkins> fantasai: personally I prefer outset, growing feels more natural to me. but I don't have an objection. disappointed outset wasn't in the poll<br>
&lt;TabAtkins> lea: there's been a lot of polls, don't have a great overall feel for what's voted on<br>
&lt;TabAtkins> astearns: chair hat off, i'd dislike outset. not a common word, and weird to have this one place we use outset<br>
&lt;TabAtkins> TabAtkins: I think we should try to resolve as jfkthame said, taking the poll winner<br>
&lt;TabAtkins> proposed resolution: name this (and gap-deco props) with -inset<br>
&lt;kbabbitt> +1<br>
&lt;TabAtkins> astearns: objections?<br>
&lt;TabAtkins> RESOLVED: name this (and gap-deco props) with -inset<br>
</details>


-- 
GitHub Notification of comment by css-meeting-bot
Please view or discuss this issue at https://github.com/w3c/csswg-drafts/issues/8402#issuecomment-3462630143 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Wednesday, 29 October 2025 16:39:52 UTC