Skip to content

Docs: change remaining deprecated .link-body-emphasis usages#42573

Merged
julien-deramond merged 1 commit into
v6-devfrom
v6-dev-jd-drop-deprecated-link-body-emphasis
Jun 30, 2026
Merged

Docs: change remaining deprecated .link-body-emphasis usages#42573
julien-deramond merged 1 commit into
v6-devfrom
v6-dev-jd-drop-deprecated-link-body-emphasis

Conversation

@julien-deramond

@julien-deramond julien-deramond commented Jun 26, 2026

Copy link
Copy Markdown
Member

Description

Spotted in #42487.

This PR updates the remaining deprecated .link-body-emphasis usages.

In v5, we had a .link-body-emphasis utility that no longer exists in v6:

  • Light theme: link displayed in #000
  • Dark theme: link displayed in #fff

There does not seem to be an exact equivalent in v6. The closest match I found is the "Inverse link" utility using .theme-inverse, as mentioned in the v6 docs at https://v6-dev--twbs-bootstrap.netlify.app/docs/6.0/utilities/link/#colored-links

This results in:

  • Light theme: link displayed in a very dark gray
  • Dark theme: link displayed in a rather light gray

Would this be the expected replacement, or am I missing a better alternative?

I also considered using the .fg-* utilities, which seem to achieve the desired colors, but they are not mentioned in the docs. My understanding is that they should probably not be used here anyway, since we do not have matching .underline-{color} utilities to preserve the expected link styling behavior. Is that correct?

Live previews


<article class="blog-post">
<h2 class="display-5 link-body-emphasis mb-1">Sample blog post</h2>
<h2 class="display-5 fg-emphasis-inverse mb-1">Sample blog post</h2>

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For these titles, since they're not links, I rather used the .fg-* utility.

@coliff

coliff commented Jun 27, 2026

Copy link
Copy Markdown
Contributor

This is an improvement, good to remove the deprecated classes.

I agree with the .theme-inverse not being quite right though. I think I'd like for this to be modified so it's lighter in light mode and darker in dark mode (equivalent to bg-light and bg-dark in v5).

@julien-deramond julien-deramond force-pushed the v6-dev-jd-drop-deprecated-link-body-emphasis branch from 0982472 to d5a62c1 Compare June 30, 2026 19:39
@julien-deramond julien-deramond merged commit 2dd2ed0 into v6-dev Jun 30, 2026
12 checks passed
@julien-deramond julien-deramond deleted the v6-dev-jd-drop-deprecated-link-body-emphasis branch June 30, 2026 19:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Inbox

Development

Successfully merging this pull request may close these issues.

2 participants