wp-includes/block-supports/block-visibility.php:20Render nothing if the block is hidden, or add viewport visibility styles.
$block_contentstring$blockarraystringfunction wp_render_block_visibility_support( $block_content, $block ) { $block_type = WP_Block_Type_Registry::get_instance()->get_registered( $block['blockName'] ); if ( ! $block_type ) { return $block_content; } $block_visibility = $block['attrs']['metadata']['blockVisibility'] ?? null; // Hide the block whenever the value is boolean false, regardless of the // block's current visibility support. This prevents blocks that previously // supported visibility from unintentionally appearing on the front end // after their support was disabled. if ( false === $block_visibility ) { return ''; } if ( ! block_has_support( $block_type, 'visibility', true ) ) { return $block_content; } if ( is_array( $block_visibility ) && ! empty( $block_visibility ) ) { $viewport_config = $block_visibility['viewport'] ?? null; if ( ! is_array( $viewport_config ) || empty( $viewport_config ) ) { return $block_content; } /* * Viewport size definitions are in several places in WordPress packages. * The following are taken from: https://github.com/WordPress/gutenberg/blob/trunk/packages/base-styles/_breakpoints.scss * The array is in a future, potential JSON format, and will be centralized * as the feature is developed. * * Viewport sizes as array items are defined sequentially. The first item's size is the max value. * Each subsequent item starts after the previous size (using > operator), and its size is the max. * The last item starts after the previous size (using > operator), and it has no max. */ $viewport_sizes = array( array( 'name' => 'Mobile', 'slug' => 'mobile', 'size' => '480px', ), array( 'name' => 'Tablet', 'slug' => 'tablet', 'size' => '782px', ), array( 'name' => 'Desktop', 'slug' => 'desktop', /* * Note: the last item in the $viewport_sizes array does not technically require a 'size' key, * as the last item's media query is calculated using `width > previous size`. * The last item is present for validating the attribute values, and in order to indicate * that this is the final viewport size, and to calculate the previous media query accordingly. */ ), ); /* * Build media queries from viewport size definitions using the CSS range syntax. * Could be absorbed into the style engine, * as well as classname building, and declaration of the display property, if required. */ $viewport_media_queries = array(); $previous_size = null; foreach ( $viewport_sizes as $index => $viewport_size ) { // First item: width <= size. if ( 0 === $index ) { $viewport_media_queries[ $viewport_size['slug'] ] = "@media (width <= {$viewport_size['size']})"; } elseif ( count( $viewport_sizes ) - 1 === $index && $previous_size ) { // Last item: width > previous size. $viewport_media_queries[ $viewport_size['slug'] ] = "@media (width > $previous_size)"; } else { // Middle items: previous size < width <= size. $viewport_media_queries[ $viewport_size['slug'] ] = "@media ({$previous_size} < width <= {$viewport_size['size']})"; } $previous_size = $viewport_size['size'] ?? null;Introduced in 6.9.0. Unchanged from 6.9.7 through 7.1.0.
Signature, return type and hooks compared across 3 parsed releases.
src/wp-includes/block-supports/block-visibility.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.