wp_render_block_states_support( string $block_content, array $block ): string

Parameters

$block_contentstring

The block's rendered HTML.

$blockarray

The block data including blockName and attrs.

Return

string

Modified block content with injected state styles.

Uses · 16

• wp_get_global_settings()Gets the settings resulting of merging core, theme, and user data.
• wp_get_block_state_style_rules()Builds compiled state style rules, preserving the selector each rule targets.
• wp_get_root_state_style()Returns a style object with nested state keys removed.
• wp_get_block_state_element_selectors()Generates all element selectors for a block root selector.
• wp_get_block_css_selector()Determines the CSS selector for the block type and property provided, returning it if available.
• wp_add_block_state_style_rule()Adds a compiled state style rule to a rule list.
• wp_get_block_state_unique_class()Returns a unique class for a set of state style rules.
• wp_get_state_declarations_with_background_resets()Adds background reset declarations to prevent gradient/solid color conflicts.
• wp_build_state_selector()Builds a scoped selector from a block selector and optional pseudo-state.
• wp_get_state_declarations_with_fallback_border_styles()Adds fallback border-style declarations for visible border declarations.
• wp_style_engine_get_stylesheet_from_css_rules()Returns compiled CSS from a collection of selectors and declarations.
• WP_Block_Type_Registry::get_instance()::get_registered()

Source

View on Trac ↗View on GitHub ↗

540function wp_render_block_states_support( $block_content, $block ) {541	if ( empty( $block['blockName'] ) || empty( $block_content ) ) {542		return $block_content;543	}544 545	$block_name = $block['blockName'];546	$block_type = WP_Block_Type_Registry::get_instance()->get_registered( $block_name );547	if ( ! $block_type ) {548		return $block_content;549	}550 551	$supported_pseudo_states  = WP_Theme_JSON::VALID_BLOCK_PSEUDO_SELECTORS[ $block_name ] ?? array();552	$style                    = $block['attrs']['style'] ?? array();553	$css_rules                = array();554	$viewport_settings        = wp_get_global_settings( array( 'viewport' ) );555	$responsive_media_queries = WP_Theme_JSON::get_viewport_media_queries( $viewport_settings );556 557	foreach ( $supported_pseudo_states as $pseudo_state ) {558		if ( empty( $style[ $pseudo_state ] ) || ! is_array( $style[ $pseudo_state ] ) ) {559			continue;560		}561 562		$css_rules = array_merge(563			$css_rules,564			wp_get_block_state_style_rules(565				array( $pseudo_state => $style[ $pseudo_state ] ),566				$block_type567			)568		);569	}570 571	foreach ( $responsive_media_queries as $breakpoint => $media_query ) {572		if ( empty( $style[ $breakpoint ] ) || ! is_array( $style[ $breakpoint ] ) ) {573			continue;574		}575 576		$root_state_style = wp_get_root_state_style(577			$style[ $breakpoint ],578			array_merge( array( 'elements' ), $supported_pseudo_states )579		);580 581		if ( ! empty( $root_state_style ) ) {582			$css_rules = array_merge(583				$css_rules,584				wp_get_block_state_style_rules(585					array( '' => $root_state_style ),586					$block_type,587					$media_query588				)589			);590		}591 592		if (593			! empty( $style[ $breakpoint ]['elements'] ) &&594			is_array( $style[ $breakpoint ]['elements'] )595		) {596			$element_selectors = wp_get_block_state_element_selectors(597				wp_get_block_css_selector( $block_type )598			);599 600			foreach ( $style[ $breakpoint ]['elements'] as $element_name => $element_style ) {601				if (602					empty( $element_style ) ||603					! is_array( $element_style ) ||604					empty( $element_selectors[ $element_name ] )605				) {606					continue;607				}608 609				$element_pseudo_states = WP_Theme_JSON::VALID_ELEMENT_PSEUDO_SELECTORS[ $element_name ]610					?? array();611				$root_element_style    = wp_get_root_state_style(612					$element_style,613					$element_pseudo_states614				);615 616				wp_add_block_state_style_rule(617					$css_rules,618					'',619					$element_selectors[ $element_name ],

History

Introduced in 7.1.0.

Signature, return type and hooks compared across 1 parsed release.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/block-supports/states.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.