render_block_core_query_no_results

函数
render_block_core_query_no_results ( $attributes, $content, $block )
参数
  • (array) $attributes Block attributes.
    Required:
  • (string) $content Block default content.
    Required:
  • (WP_Block) $block Block instance.
    Required:
返回值
  • (string) Returns the wrapper for the no results block.
定义位置
相关方法
register_block_core_query_no_resultsrender_block_core_query_pagination_previousrender_block_core_query_titlerender_block_core_query_paginationrender_block_core_rss
引入
-
弃用
-

render_block_core_query_no_results: 这个函数用于在查询没有返回结果时,渲染一个块的HTML内容。它与WordPress中的查询块一起使用,允许用户根据某些标准来显示文章、页面或自定义文章类型。如果查询没有返回结果,该块将向用户显示一条没有匹配结果的信息: 这个函数负责渲染该信息。

渲染服务器上的`core/query-no-results`区块。

function render_block_core_query_no_results( $attributes, $content, $block ) {
	if ( empty( trim( $content ) ) ) {
		return '';
	}

	$page_key = isset( $block->context['queryId'] ) ? 'query-' . $block->context['queryId'] . '-page' : 'query-page';
	$page     = empty( $_GET[ $page_key ] ) ? 1 : (int) $_GET[ $page_key ];

	// Override the custom query with the global query if needed.
	$use_global_query = ( isset( $block->context['query']['inherit'] ) && $block->context['query']['inherit'] );
	if ( $use_global_query ) {
		global $wp_query;
		$query = $wp_query;
	} else {
		$query_args = build_query_vars_from_query_block( $block, $page );
		$query      = new WP_Query( $query_args );
	}

	if ( $query->have_posts() ) {
		return '';
	}

	if ( ! $use_global_query ) {
		wp_reset_postdata();
	}

	return sprintf(
		'<div %1$s>%2$s</div>',
		get_block_wrapper_attributes(),
		$content
	);
}

常见问题

FAQs
查看更多 >