diff --git a/wp-includes/html-api/class-wp-html-processor.php b/wp-includes/html-api/class-wp-html-processor.php index 1be795c5c7..e88757ec7b 100644 --- a/wp-includes/html-api/class-wp-html-processor.php +++ b/wp-includes/html-api/class-wp-html-processor.php @@ -279,44 +279,24 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor { * form is provided because a context element may have attributes that * impact the parse, such as with a SCRIPT tag and its `type` attribute. * - * Example: + * ## Current HTML Support * - * // Usually, snippets of HTML ought to be processed in the default `` context: - * $processor = WP_HTML_Processor::create_fragment( '

Hi

' ); - * - * // Some fragments should be processed in the correct context like this SVG: - * $processor = WP_HTML_Processor::create_fragment( '', '' ); - * - * // This fragment with TD tags should be processed in a TR context: - * $processor = WP_HTML_Processor::create_fragment( - * '123', - * '' - * ); - * - * In order to create a fragment processor at the correct location, the - * provided fragment will be processed as part of a full HTML document. - * The processor will search for the last opener tag in the document and - * create a fragment processor at that location. The document will be - * forced into "no-quirks" mode by including the HTML5 doctype. - * - * For advanced usage and precise control over the context element, use - * `WP_HTML_Processor::create_full_processor()` and - * `WP_HTML_Processor::create_fragment_at_current_node()`. - * - * UTF-8 is the only allowed encoding. If working with a document that - * isn't UTF-8, first convert the document to UTF-8, then pass in the - * converted HTML. + * - The only supported context is ``, which is the default value. + * - The only supported document encoding is `UTF-8`, which is the default value. * * @since 6.4.0 * @since 6.6.0 Returns `static` instead of `self` so it can create subclass instances. - * @since 6.8.0 Can create fragments with any context element. * * @param string $html Input HTML fragment to process. - * @param string $context Context element for the fragment. Defaults to ``. + * @param string $context Context element for the fragment, must be default of ``. * @param string $encoding Text encoding of the document; must be default of 'UTF-8'. * @return static|null The created processor if successful, otherwise null. */ public static function create_fragment( $html, $context = '', $encoding = 'UTF-8' ) { + if ( '' !== $context || 'UTF-8' !== $encoding ) { + return null; + } + $context_processor = static::create_full_parser( "{$context}", $encoding ); if ( null === $context_processor ) { return null; @@ -475,7 +455,7 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor { * @param string $html Input HTML fragment to process. * @return static|null The created processor if successful, otherwise null. */ - public function create_fragment_at_current_node( string $html ) { + private function create_fragment_at_current_node( string $html ) { if ( $this->get_token_type() !== '#tag' || $this->is_tag_closer() ) { _doing_it_wrong( __METHOD__, diff --git a/wp-includes/version.php b/wp-includes/version.php index 50fa57f4fe..ba2df33454 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -16,7 +16,7 @@ * * @global string $wp_version */ -$wp_version = '6.8-alpha-59467'; +$wp_version = '6.8-alpha-59469'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.