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

Parameters

$block_contentstring

Rendered block content.

$blockarray

Block object.

Return

string

Filtered block content.

Uses · 13

• block_has_support()Checks whether the current block type supports the feature requested.
• wp_unique_id_from_values()Generates a unique ID based on the structure and values of a given array.
• wp_style_engine_get_stylesheet_from_css_rules()Returns compiled CSS from a collection of selectors and declarations.
• wp_get_global_settings()Gets the settings resulting of merging core, theme, and user data.
• wp_get_layout_definitions()Returns layout definitions, keyed by layout type.
• sanitize_title()Sanitizes a string into a slug, which can be used in URLs or HTML attributes.
• current_theme_supports()Checks a theme's support for a given feature.
• wp_should_skip_block_supports_serialization()Checks whether serialization of the current block's supported properties should occur.
• wp_get_layout_style()Generates the CSS corresponding to the provided layout.
• str_contains()Polyfill for `str_contains()` function added in PHP 8.0.
• WP_Block_Type_Registry::get_instance()::get_registered()
• WP_Block_Type_Registry::get_instance()Utility method to retrieve the main instance of the class.

Source

View on Trac ↗View on GitHub ↗

570function wp_render_layout_support_flag( $block_content, $block ) {571	$block_type            = WP_Block_Type_Registry::get_instance()->get_registered( $block['blockName'] );572	$block_supports_layout = block_has_support( $block_type, 'layout', false ) || block_has_support( $block_type, '__experimentalLayout', false );573	$child_layout          = isset( $block['attrs']['style']['layout'] ) ? $block['attrs']['style']['layout'] : null;574 575	if ( ! $block_supports_layout && ! $child_layout ) {576		return $block_content;577	}578 579	$outer_class_names = array();580 581	// Child layout specific logic.582	if ( $child_layout ) {583		/*584		 * Generates a unique class for child block layout styles.585		 *586		 * To ensure consistent class generation across different page renders,587		 * only properties that affect layout styling are used. These properties588		 * come from `$block['attrs']['style']['layout']` and `$block['parentLayout']`.589		 *590		 * As long as these properties coincide, the generated class will be the same.591		 */592		$container_content_class = wp_unique_id_from_values(593			array(594				'layout'       => array_intersect_key(595					$block['attrs']['style']['layout'] ?? array(),596					array_flip(597						array( 'selfStretch', 'flexSize', 'columnStart', 'columnSpan', 'rowStart', 'rowSpan' )598					)599				),600				'parentLayout' => array_intersect_key(601					$block['parentLayout'] ?? array(),602					array_flip(603						array( 'minimumColumnWidth', 'columnCount' )604					)605				),606			),607			'wp-container-content-'608		);609 610		$child_layout_declarations = array();611		$child_layout_styles       = array();612 613		$self_stretch = isset( $child_layout['selfStretch'] ) ? $child_layout['selfStretch'] : null;614 615		if ( 'fixed' === $self_stretch && isset( $child_layout['flexSize'] ) ) {616			$child_layout_declarations['flex-basis'] = $child_layout['flexSize'];617			$child_layout_declarations['box-sizing'] = 'border-box';618		} elseif ( 'fill' === $self_stretch ) {619			$child_layout_declarations['flex-grow'] = '1';620		}621 622		if ( isset( $child_layout['columnSpan'] ) ) {623			$column_span                              = $child_layout['columnSpan'];624			$child_layout_declarations['grid-column'] = "span $column_span";625		}626		if ( isset( $child_layout['rowSpan'] ) ) {627			$row_span                              = $child_layout['rowSpan'];628			$child_layout_declarations['grid-row'] = "span $row_span";629		}630		$child_layout_styles[] = array(631			'selector'     => ".$container_content_class",632			'declarations' => $child_layout_declarations,633		);634 635		/*636		 * If columnSpan is set, and the parent grid is responsive, i.e. if it has a minimumColumnWidth set,637		 * the columnSpan should be removed on small grids. If there's a minimumColumnWidth, the grid is responsive.638		 * But if the minimumColumnWidth value wasn't changed, it won't be set. In that case, if columnCount doesn't639		 * exist, we can assume that the grid is responsive.640		 */641		if ( isset( $child_layout['columnSpan'] ) && ( isset( $block['parentLayout']['minimumColumnWidth'] ) || ! isset( $block['parentLayout']['columnCount'] ) ) ) {642			$column_span_number  = floatval( $child_layout['columnSpan'] );643			$parent_column_width = isset( $block['parentLayout']['minimumColumnWidth'] ) ? $block['parentLayout']['minimumColumnWidth'] : '12rem';644			$parent_column_value = floatval( $parent_column_width );645			$parent_column_unit  = explode( $parent_column_value, $parent_column_width );646 647			/*648			 * If there is no unit, the width has somehow been mangled so we reset both unit and value649			 * to defaults.

History

Introduced in 5.8.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 6.8.8 tag, from src/wp-includes/block-supports/layout.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.