Skip to content

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

Open
julien-deramond wants to merge 1 commit into
v6-devfrom
v6-dev-jd-drop-deprecated-link-body-emphasis
Open

Docs: change remaining deprecated .link-body-emphasis usages#42573
julien-deramond wants to merge 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).

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