HTML API: Plans for 6.5

[dmsnell]

HTML issues | Refactors | ↑ Broader Roadmap | Plans for 6.6 →

Tasks

Bug fixes and quality

• Gutenberg v17.2.3 fatal errors in WordPress 6.5 alpha due to HTML API #57216
  • not in trunk/trunk but may affect older version of the plugin. need to figure out what to resolve, if anything.
  • appears to be resolved already by means of the patch in Gutenberg, but that patch wasn't in the tested release candidate.
• HTML Api: Fix out of bounds string access wordpress-develop#5793
• Review failing tests in the html5lib and see if we can eliminate any of them.
• Generate a function that produces the output expected by the html5lib tests.

Continue adding support for more HTML tags

• WIP: HTML API: Add support for H1-H6 elements in HTML Processor wordpress-develop#5535 (HTML API: Backport updates from Core #57022)
• HTML API: Add support for list elements. wordpress-develop#5539
  • Approved and ready to merge.
  • Currently undergoing testing work. Some test is needed for the following rule, as it may be broken somehow: "If node is in the special category, but is not an address, div, or p element, then jump to the step labeled done below."
• HTML API: Add explicit handling or failure for all tags wordpress-develop#5762 (@sirreal)
  • Approved and ready to merge.

Add functionality to the HTML API

• HTML API: avoid processing incomplete tokens wordpress-develop#5725
• HTML API: Provide mechanism to scan all tokens in an HTML document, not only the tags. wordpress-develop#5683

Design work and framework improvements

• Incorporate an nth-child counter for breadcrumbs for uniquely identifying a node in the document, for future use with CSS selectors.
• HTML API: Add test suite from html5lib wordpress-develop#5794
• Create WP_HTML::render() using "funky comments" to generate HTML markup from PHP.
  • HTML API: Introduce HTML templating dmsnell/wordpress-develop#12
  • This work has been punted to the WordPress 6.6 cycle to allow for more time for design work.
  • HTML API: Introduce WP_HTML::tag() for safely creating HTML. wordpress-develop#5884
• HTML API: Replace associative array for tracking parsed attributes. wordpress-develop#5774
  • this isn't ready yet, as there may be a bug somewhere in it
• Explore storing common HTML tag names as a bit field with an "other" category. This could make certain checks in the HTML Processor much cleaner, e.g. if ( 0 !== $tag_name & (TAG_DIV | TAG_P) )
• Explore storing parsing state as bit fields; same benefit as for tag names.
• Exercise 100% test coverage for step_in_body(), but only by adding high-level usage tests that demonstrate an expected behavior.

Follow-up work to shepherd HTML API usage in Core

• Block supports: Avoid warning for non string class attributes wordpress-develop#5486
  • seems to be stalled on failing tests
• Refactor ImageCDN parsing to rely on HTML API instead of RegExps Automattic/jetpack#32700
  • need to address one point of feedback but is otherwise ready

WordPress-develop Merge Party

• HTML API: Apply linting changes. wordpress-develop#5770
• HTML API: avoid processing incomplete tokens wordpress-develop#5725

The Gutenberg PR #57241 incorporates a number of proposed changes for Core to give a preview of how they will impact the Gutenberg repo if merged. After briefly breaking the Interactivity API in Gutenberg this should be standard practice before merging new work.

Awaiting Gutenberg backport

Current backport: #57022

• WIP: HTML API: Add support for H1-H6 elements in HTML Processor wordpress-develop#5535

Backport Backlog

• Fix for STYLE and other RAWTEXT elements. (from 6.4)
  • This isn't going to be fixed but instead will be incorporated into the token-scanning PR.

WordPress 6.4

Tasks

• Add matches_breadcrumbs() to make it easier to detect location in document in next_tag() loop. [HTML API: Add matches_breadcrumbs() to HTML Processor for better querying wordpress-develop#5243]
• Continue adding support in IN BODY mode. Figure out how much to support.
  • Support LI?
• Add has_class() HTML API: Add class name utilities has_class() and class_list() wordpress-develop#5096
• Review and refine the error reporting to ensure that a failure to parse is distinguishable from reaching the end of the document.

Bug fixes

• Remove all duplicate attributes when removing them, when they exist HTML API: Remove all duplicate copies of an attribute when removing wordpress-develop#4317

Backport backlog

• Fix for STYLE and other RAWTEXT elements.
• Revert while loop change introduced in styling update.

[gziolo]

What’s the reason it’s a discussion rather than a regular issue? The description is up to date and covers the scope of changes for the WordPress 6.5 release. All other issues like that can be found under the Epic label.