WP_Theme_JSON::get_block_nodes( array $theme_json, array $selectors = array(), array $options = array() ): array

Compatibility

Present in every tracked release (6.7.7 to 7.1.0), and compiles on PHP 7.4 through 8.6-dev.

Parameters

$theme_jsonarray

The theme.json converted to an array.

$selectorsarrayoptional

Optional list of selectors per block.Default: array()

$optionsarrayoptional

An array of options for now used for internal purposes only (may change without notice).Default: array()

• $include_block_style_variationsbooldefault: false

  Include nodes for block style variations.

• $include_node_paths_onlybooldefault: false

  Return only block nodes node paths.

Return value

array

The block nodes in theme.json.

Performance profile

How much work a call to WP_Theme_JSON::get_block_nodes() does, and what it touches: the algorithmic scaling, the Zend instruction count per call across PHP versions, the hooks it hands control to, and the core code that calls it. Measured from the compiled opcodes, not a stopwatch, so every number is identical on any machine running the same PHP version, and every function in core is ranked by cost.

Cost class

Light

Touches nothing outside its own arguments.

Scaling

Scales with input

The body loops, so the work grows with what you pass in.

Instructions

26–27

Executed per call on PHP 8.5, depending on the branch taken. The body compiles to 524.

Plugin surface

None

Nothing here hands control to plugin code.

Called by

0

Nothing in core calls this; the cost is only what you spend yourself.

What one call costs · 1 distinct outcome

One number would be a lie: the work depends on which branch runs. These are every distinct cost WP_Theme_JSON::get_block_nodes() can have, taken from its control-flow graph on PHP 8.5.

This body has more branch combinations than are worth enumerating, so the table covers the outcomes found first rather than every one that exists.

Uses · 3

• static::get_viewport_media_queries()
• static::get_blocks_metadata()
• static::append_to_selector()

Source code

View on Trac ↗View on GitHub ↗

3519	private static function get_block_nodes( $theme_json, $selectors = array(), $options = array() ) {3520		$nodes = array();3521 3522		if ( ! isset( $theme_json['styles']['blocks'] ) ) {3523			return $nodes;3524		}3525 3526		$include_variations       = $options['include_block_style_variations'] ?? false;3527		$include_node_paths_only  = $options['include_node_paths_only'] ?? false;3528		$responsive_media_queries = static::get_viewport_media_queries( $theme_json['settings']['viewport'] ?? null );3529 3530		// If only node paths are to be returned, skip selector assignment.3531		if ( ! $include_node_paths_only ) {3532			$selectors = empty( $selectors ) ? static::get_blocks_metadata() : $selectors;3533		}3534 3535		foreach ( $theme_json['styles']['blocks'] as $name => $node ) {3536			$node_path = array( 'styles', 'blocks', $name );3537			if ( $include_node_paths_only ) {3538				$variation_paths = array();3539				if ( $include_variations && isset( $node['variations'] ) ) {3540					foreach ( $node['variations'] as $variation => $variation_node ) {3541						$variation_paths[] = array(3542							'path' => array( 'styles', 'blocks', $name, 'variations', $variation ),3543						);3544					}3545				}3546				$node = array(3547					'path' => $node_path,3548				);3549				if ( ! empty( $variation_paths ) ) {3550					$node['variations'] = $variation_paths;3551				}3552				$nodes[] = $node;3553			} else {3554				$selector = null;3555				if ( isset( $selectors[ $name ]['selector'] ) ) {3556					$selector = $selectors[ $name ]['selector'];3557				}3558 3559				$duotone_selector = null;3560				if ( isset( $selectors[ $name ]['duotone'] ) ) {3561					$duotone_selector = $selectors[ $name ]['duotone'];3562				}3563 3564				$feature_selectors = null;3565				if ( isset( $selectors[ $name ]['selectors'] ) ) {3566					$feature_selectors = $selectors[ $name ]['selectors'];3567				}3568 3569				$variation_selectors = array();3570 3571				if ( $include_variations && isset( $node['variations'] ) ) {3572					foreach ( $node['variations'] as $variation => $node ) {3573						$variation_selectors[] = array(3574							'name'     => $variation,3575							'path'     => array( 'styles', 'blocks', $name, 'variations', $variation ),3576							'selector' => $selectors[ $name ]['styleVariations'][ $variation ],3577						);3578					}3579				}3580 3581				$nodes[] = array(3582					'name'       => $name,3583					'path'       => $node_path,3584					'selector'   => $selector,3585					'selectors'  => $feature_selectors,3586					'elements'   => $selectors[ $name ]['elements'] ?? array(),3587					'duotone'    => $duotone_selector,3588					'variations' => $variation_selectors,3589					'css'        => $selector,3590				);3591 3592				// Responsive block nodes: emit one node per breakpoint that has styles.3593				// These are rendered immediately after the base block node so that3594				// the cascade order is: .block{} → @media{.block{}}3595				foreach ( array_keys( $responsive_media_queries ) as $breakpoint ) {3596					if ( isset( $theme_json['styles']['blocks'][ $name ][ $breakpoint ] ) ) {3597						$nodes[] = array(3598							'name'        => $name,

Changelog

Introduced in 6.1.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/class-wp-theme-json.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.