render_block_core_cover

函式
render_block_core_cover ( $attributes, $content )
引數
  • (array) $attributes The block attributes.
    Required:
  • (string) $content The block rendered content.
    Required:
返回值
  • (string) Returns the cover block markup, if useFeaturedImage is true.
定義位置
相關方法
register_block_core_coverrender_block_core_archivesrender_block_core_rssrender_block_core_calendarrender_block_core_comments
引入
-
棄用
-

render_block_core_cover: 這個函式用來渲染WordPress中的封面塊。Cover塊允許使用者新增一個背景圖片或視訊,並將其與文字或其他內容疊加: 這個函式負責生成封面塊的HTML標記。

在伺服器上渲染`core/cover`區塊。

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
function render_block_core_cover( $attributes, $content ) {
if ( 'image' !== $attributes['backgroundType'] || false === $attributes['useFeaturedImage'] ) {
return $content;
}
if ( ! ( $attributes['hasParallax'] || $attributes['isRepeated'] ) ) {
$attr = array(
'class' => 'wp-block-cover__image-background',
'data-object-fit' => 'cover',
);
if ( isset( $attributes['focalPoint'] ) ) {
$object_position = round( $attributes['focalPoint']['x'] * 100 ) . '%' . ' ' . round( $attributes['focalPoint']['y'] * 100 ) . '%';
$attr['data-object-position'] = $object_position;
$attr['style'] = 'object-position: ' . $object_position;
}
$image = get_the_post_thumbnail( null, 'post-thumbnail', $attr );
/*
* Inserts the featured image between the (1st) cover 'background' `span` and 'inner_container' `div`,
* and removes eventual withespace characters between the two (typically introduced at template level)
*/
$inner_container_start = '/<divb[^>]+wp-block-cover__inner-container[s|"][^>]*>/U';
if ( 1 === preg_match( $inner_container_start, $content, $matches, PREG_OFFSET_CAPTURE ) ) {
$offset = $matches[0][1];
$content = substr( $content, 0, $offset ) . $image . substr( $content, $offset );
}
} else {
if ( in_the_loop() ) {
update_post_thumbnail_cache();
}
$current_featured_image = get_the_post_thumbnail_url();
$styles = 'background-image:url(' . esc_url( $current_featured_image ) . '); ';
if ( isset( $attributes['minHeight'] ) ) {
$height_unit = empty( $attributes['minHeightUnit'] ) ? 'px' : $attributes['minHeightUnit'];
$height = " min-height:{$attributes['minHeight']}{$height_unit}";
$styles .= $height;
}
$content = preg_replace(
'/class=".*?"/',
'${0} style="' . $styles . '"',
$content,
1
);
}
return $content;
}
function render_block_core_cover( $attributes, $content ) { if ( 'image' !== $attributes['backgroundType'] || false === $attributes['useFeaturedImage'] ) { return $content; } if ( ! ( $attributes['hasParallax'] || $attributes['isRepeated'] ) ) { $attr = array( 'class' => 'wp-block-cover__image-background', 'data-object-fit' => 'cover', ); if ( isset( $attributes['focalPoint'] ) ) { $object_position = round( $attributes['focalPoint']['x'] * 100 ) . '%' . ' ' . round( $attributes['focalPoint']['y'] * 100 ) . '%'; $attr['data-object-position'] = $object_position; $attr['style'] = 'object-position: ' . $object_position; } $image = get_the_post_thumbnail( null, 'post-thumbnail', $attr ); /* * Inserts the featured image between the (1st) cover 'background' `span` and 'inner_container' `div`, * and removes eventual withespace characters between the two (typically introduced at template level) */ $inner_container_start = '/<divb[^>]+wp-block-cover__inner-container[s|"][^>]*>/U'; if ( 1 === preg_match( $inner_container_start, $content, $matches, PREG_OFFSET_CAPTURE ) ) { $offset = $matches[0][1]; $content = substr( $content, 0, $offset ) . $image . substr( $content, $offset ); } } else { if ( in_the_loop() ) { update_post_thumbnail_cache(); } $current_featured_image = get_the_post_thumbnail_url(); $styles = 'background-image:url(' . esc_url( $current_featured_image ) . '); '; if ( isset( $attributes['minHeight'] ) ) { $height_unit = empty( $attributes['minHeightUnit'] ) ? 'px' : $attributes['minHeightUnit']; $height = " min-height:{$attributes['minHeight']}{$height_unit}"; $styles .= $height; } $content = preg_replace( '/class=".*?"/', '${0} style="' . $styles . '"', $content, 1 ); } return $content; }
function render_block_core_cover( $attributes, $content ) {
	if ( 'image' !== $attributes['backgroundType'] || false === $attributes['useFeaturedImage'] ) {
		return $content;
	}

	if ( ! ( $attributes['hasParallax'] || $attributes['isRepeated'] ) ) {
		$attr = array(
			'class'           => 'wp-block-cover__image-background',
			'data-object-fit' => 'cover',
		);

		if ( isset( $attributes['focalPoint'] ) ) {
			$object_position              = round( $attributes['focalPoint']['x'] * 100 ) . '%' . ' ' . round( $attributes['focalPoint']['y'] * 100 ) . '%';
			$attr['data-object-position'] = $object_position;
			$attr['style']                = 'object-position: ' . $object_position;
		}

		$image = get_the_post_thumbnail( null, 'post-thumbnail', $attr );

		/*
		 * Inserts the featured image between the (1st) cover 'background' `span` and 'inner_container' `div`,
		 * and removes eventual withespace characters between the two (typically introduced at template level)
		 */
		$inner_container_start = '/<divb[^>]+wp-block-cover__inner-container[s|"][^>]*>/U';
		if ( 1 === preg_match( $inner_container_start, $content, $matches, PREG_OFFSET_CAPTURE ) ) {
			$offset  = $matches[0][1];
			$content = substr( $content, 0, $offset ) . $image . substr( $content, $offset );
		}
	} else {
		if ( in_the_loop() ) {
			update_post_thumbnail_cache();
		}
		$current_featured_image = get_the_post_thumbnail_url();

		$styles = 'background-image:url(' . esc_url( $current_featured_image ) . '); ';

		if ( isset( $attributes['minHeight'] ) ) {
			$height_unit = empty( $attributes['minHeightUnit'] ) ? 'px' : $attributes['minHeightUnit'];
			$height      = " min-height:{$attributes['minHeight']}{$height_unit}";

			$styles .= $height;
		}

		$content = preg_replace(
			'/class=".*?"/',
			'${0} style="' . $styles . '"',
			$content,
			1
		);
	}

	return $content;
}

常見問題

FAQs
檢視更多 >