Skip to content

Html api/class names get post class#10215

Draft
dmsnell wants to merge 4 commits into
WordPress:trunkfrom
dmsnell:html-api/class-names--get-post-class
Draft

Html api/class names get post class#10215
dmsnell wants to merge 4 commits into
WordPress:trunkfrom
dmsnell:html-api/class-names--get-post-class

Conversation

@dmsnell
Copy link
Copy Markdown
Member

@dmsnell dmsnell commented Oct 10, 2025

Trac ticket:


This Pull Request is for code review only. Please keep all other discussion in the Trac ticket. Do not merge this Pull Request. See GitHub Pull Requests for Code Review in the Core Handbook for more details.

@github-actions
Copy link
Copy Markdown

Test using WordPress Playground

The changes in this pull request can previewed and tested using a WordPress Playground instance.

WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser.

Some things to be aware of

  • The Plugin and Theme Directories cannot be accessed within Playground.
  • All changes will be lost when closing a tab with a Playground instance.
  • All changes will be lost when refreshing the page.
  • A fresh instance is created each time the link below is clicked.
  • Every time this pull request is updated, a new ZIP file containing all changes is created. If changes are not reflected in the Playground instance,
    it's possible that the most recent build failed, or has not completed. Check the list of workflow runs to be sure.

For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation.

Test this pull request with WordPress Playground.

@dmsnell dmsnell force-pushed the html-api/class-names--get-post-class branch 3 times, most recently from 0e369a7 to 3937219 Compare October 21, 2025 09:22
@dmsnell dmsnell force-pushed the html-api/class-names--get-post-class branch from 3937219 to 118e4da Compare November 24, 2025 20:25
This patch introduces a new CSS helper module containing a new function,
`wp_split_class_names()`. This function wraps some code to rely on the
HTML API to take an HTML `class` attribute value and return a
`Generator` to iterate over the classes in that value.

Many existing functions perform ad-hoc parsing of CSS class names,
usually by splitting on a space character. However, there are issues
with this approach:

 - There is no decoding of HTML character references, which is normative
   inside HTML attributes.
 - There is no handling of null bytes.
 - Class names can be split by more than just the space character.
 - There is no handling of duplicates, and while mostly benign, code
   forgetting to account for duplicates can lead to defects.

The new function handles the nuances to let developers focus on reading
CSS class names, adding new class names, and removing class names. This
serves a middleground between legacy code interacting with CSS class
names in isolation and code processing full HTML documents.
@dmsnell dmsnell force-pushed the html-api/class-names--get-post-class branch from 118e4da to 3949fab Compare December 18, 2025 03:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant