Changeset 60511 for trunk/src/wp-includes/class-wp-block.php

Timestamp:

07/25/2025 02:57:09 PM (6 months ago)

Author:

johnbillion

Message:

Docs: Improve the documented return type for parsed blocks.

The blockName property can be null, for example when a section of HTML outside of a block is encountered. This corrects the docs to reflect that.

Props jeremyfelt, pmbaldha, johnbillion.

Fixes #63663

File:

• trunk/src/wp-includes/class-wp-block.php (modified) (2 diffs)

trunk/src/wp-includes/class-wp-block.php

@@ -30 +30 @@
      *
      * @since 5.5.0
-     * @var string
+     * @var string|null
      */
     public $name;
@@ -115 +115 @@
      *     An associative array of a single parsed block object. See WP_Block_Parser_Block.
      *
-     *     @type string   $blockName    Name of block.
-     *     @type array    $attrs        Attributes from block comment delimiters.
-     *     @type array    $innerBlocks  List of inner blocks. An array of arrays that
-     *                                  have the same structure as this one.
-     *     @type string   $innerHTML    HTML from inside block comment delimiters.
-     *     @type array    $innerContent List of string fragments and null markers where inner blocks were found.
+     *     @type string|null $blockName    Name of block.
+     *     @type array       $attrs        Attributes from block comment delimiters.
+     *     @type array       $innerBlocks  List of inner blocks. An array of arrays that
+     *                                     have the same structure as this one.
+     *     @type string      $innerHTML    HTML from inside block comment delimiters.
+     *     @type array       $innerContent List of string fragments and null markers where inner blocks were found.
      * }
      * @param array                  $available_context Optional array of ancestry context values.