wp_get_first_block( array $blocks, string $block_name ): array

Parameters

$blocksarray

Array of blocks.

$block_namestring

Name of the block to find.

Return

array

Found block, or empty array if none found.

Uses · 1

• wp_get_first_block()Finds the first occurrence of a specific block in an array of blocks.

Used by · 2

• wp_get_first_block()Finds the first occurrence of a specific block in an array of blocks.
• wp_get_post_content_block_attributes()Retrieves Post Content block attributes from the current post template.

Source

View on Trac ↗View on GitHub ↗

402function wp_get_first_block( $blocks, $block_name ) {403	foreach ( $blocks as $block ) {404		if ( $block_name === $block['blockName'] ) {405			return $block;406		}407		if ( ! empty( $block['innerBlocks'] ) ) {408			$found_block = wp_get_first_block( $block['innerBlocks'], $block_name );409 410			if ( ! empty( $found_block ) ) {411				return $found_block;412			}413		}414	}415 416	return array();417}

History

Introduced in 6.3.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/block-editor.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.