Changeset 63293

Timestamp:

08/13/2026 02:29:46 PM (2 months ago)

Author:

zieladam

Message:

HTML API: Make class_list() examples interactive.

Converts the WP_HTML_Processor::class_list() and WP_HTML_Tag_Processor::class_list() examples to runnable WordPress Playground snippets. Corrects the encoded closing angle bracket so the expected output matches the parsed class name.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/13034.

Props jonsurrell.
See #64896.

Location:

trunk/src/wp-includes/html-api

Files:

• class-wp-html-processor.php (modified) (1 diff)
• class-wp-html-tag-processor.php (modified) (1 diff)

trunk/src/wp-includes/html-api/class-wp-html-processor.php

@@ -5432 +5432 @@
          * This generator function is designed to be used inside a "foreach" loop.
          *
-         * Example:
-         *
-         *     $p = WP_HTML_Processor::create_fragment( "<div class='free &lt;egg&lt;\tlang-en'>" );
-         *     $p->next_tag();
-         *     foreach ( $p->class_list() as $class_name ) {
-         *         echo "{$class_name} ";
-         *     }
-         *     // Outputs: "free <egg> lang-en "
+         * ```php interactive
+         * <?php
+         * require '/wordpress/wp-load.php';
+         * $p = WP_HTML_Processor::create_fragment( "<div class='free &lt;egg&gt;\tlang-en'>" );
+         * $p->next_tag();
+         * foreach ( $p->class_list() as $class_name ) {
+         *   var_dump( $class_name );
+         * }
+         * ```
+         * ```expected-output
+         * string(4) "free"
+         * string(5) "<egg>"
+         * string(7) "lang-en"
+         * ```
          *
          * @since 6.6.0 Subclassed for the HTML Processor.

trunk/src/wp-includes/html-api/class-wp-html-tag-processor.php

@@ -1179 +1179 @@
          * This generator function is designed to be used inside a "foreach" loop.
          *
-         * Example:
-         *
-         *     $p = new WP_HTML_Tag_Processor( "<div class='free &lt;egg&lt;\tlang-en'>" );
-         *     $p->next_tag();
-         *     foreach ( $p->class_list() as $class_name ) {
-         *         echo "{$class_name} ";
-         *     }
-         *     // Outputs: "free <egg> lang-en "
+         * ```php interactive
+         * <?php
+         * require '/wordpress/wp-load.php';
+         * $p = new WP_HTML_Tag_Processor( "<div class='free &lt;egg&gt;\tlang-en'>" );
+         * $p->next_tag();
+         * foreach ( $p->class_list() as $class_name ) {
+         *   var_dump( $class_name );
+         * }
+         * ```
+         * ```expected-output
+         * string(4) "free"
+         * string(5) "<egg>"
+         * string(7) "lang-en"
+         * ```
          *
          * @since 6.4.0