🌐 US-Proxy
class="logged-out env-production page-responsive" style="word-wrap: break-word;" >
Skip to content

Docs: move <details> usage notes out of Try It, fix ::details-content animation claim - #45218

Closed
BHUVANSH855 wants to merge 5 commits into
mdn:mainfrom
BHUVANSH855:fix-42226-details-content-animation
Closed

BHUVANSH855 wants to merge 5 commits into
mdn:mainfrom
BHUVANSH855:fix-42226-details-content-animation

Conversation

@BHUVANSH855

Copy link
Copy Markdown
Contributor

Description

Moves the descriptive prose about the <details> disclosure widget out of the "Try it" interactive-example block and into a new "Usage notes" section, and corrects the outdated claim that there's no built-in way to animate the open/closed transition.

Motivation

The "Try it" section should only contain the interactive demo, not explanatory prose — the surrounding text was left over from before MDN content moved to GitHub and predates that convention. Separately, the text stated there's "no built-in way to animate the transition between open and closed," which is no longer true: ::details-content supports this and has been Baseline since September 2025. This PR relocates the prose into a new "Usage notes" section (placed after "Events" and before "Examples") and updates the animation claim to point readers to ::details-content.

Additional details

Related issues and pull requests

Fixes #42226
From #42226 (comment)

@github-actions

github-actions Bot commented Aug 18, 2026 •

Copy link
Copy Markdown
Contributor

Preview URLs (1 page)

(comment last updated: 2026-08-23 12:29:09)

@BHUVANSH855
BHUVANSH855 marked this pull request as ready for review August 19, 2026 11:51
@BHUVANSH855
BHUVANSH855 requested a review from a team as a code owner August 19, 2026 11:51
@BHUVANSH855
BHUVANSH855 requested review from wbamberg and removed request for a team August 19, 2026 11:51
Comment thread files/en-us/web/html/reference/elements/details/index.md Outdated
Comment thread files/en-us/web/html/reference/elements/details/index.md Outdated
BHUVANSH855 and others added 2 commits August 21, 2026 01:12
Co-authored-by: wbamberg <will@bootbonnet.ca>
Co-authored-by: wbamberg <will@bootbonnet.ca>
Comment thread files/en-us/web/html/reference/elements/details/index.md Outdated
@BHUVANSH855
BHUVANSH855 requested a review from wbamberg August 22, 2026 09:31
@wbamberg

Copy link
Copy Markdown
Collaborator

The change at 8f921a1 doesn't address my comment.

@wbamberg

Copy link
Copy Markdown
Collaborator

Closing this because it still hasn't addressed my feedback.

@wbamberg wbamberg closed this Sep 16, 2026
@Josh-Cena

Copy link
Copy Markdown
Member

Which comment was this blocked on?

@wbamberg

Copy link
Copy Markdown
Collaborator

#45218 (comment) - I made a suggestion with a cssxref macro call that I wasn't sure about, and asked the author to check the syntax and make sure it worked.

@Josh-Cena

Copy link
Copy Markdown
Member

I see. The macro call was replaced with display: list-item.

FYI you just need to write {{cssxref("&lt;display-listitem&gt;")}} to make it work

@BHUVANSH855

Copy link
Copy Markdown
Contributor Author

Can it be reopened now.

@pepelsbey

Copy link
Copy Markdown
Member

Once your other PRs are merged, it will be possible to reopen this one. There's a limit of three simultaneously opened PRs.

@BHUVANSH855

Copy link
Copy Markdown
Contributor Author

Once your other PRs are merged, it will be possible to reopen this one. There's a limit of three simultaneously opened PRs.

we can reopen this as draft or i will convert other to draft whatever suits.
The issue is almost fixed in this PR and can be merged with just one more commit.

Let me know whatever i have to do.

@BHUVANSH855
BHUVANSH855 deleted the fix-42226-details-content-animation branch October 2, 2026 04:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:HTML Hypertext Markup Language docs size/s [PR only] 6-50 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

<display> docs say open/close cannot be animated; ::display-content (new) allows animation

5 participants