在服务器上呈现核心/类别块。

原型

render_block_core_categories( array $attributes )

参数

$attributes (array) (Required) 块属性。

返回值

(string)  返回类别列表/下拉标记。

源文件

路径:wp-includes/blocks/categories.php

<?php
...
function render_block_core_categories( $attributes ) {
	static $block_id = 0;
	$block_id++;
	$args = array(
		'echo'         => false,
		'hierarchical' => ! empty( $attributes['showHierarchy'] ),
		'orderby'      => 'name',
		'show_count'   => ! empty( $attributes['showPostCounts'] ),
		'title_li'     => '',
	);
	if ( ! empty( $attributes['displayAsDropdown'] ) ) {
		$id                       = 'wp-block-categories-' . $block_id;
		$args['id']               = $id;
		$args['show_option_none'] = __( 'Select Category' );
		$wrapper_markup           = '<div class="%1$s">%2$s</div>';
		$items_markup             = wp_dropdown_categories( $args );
		$type                     = 'dropdown';
		if ( ! is_admin() ) {
			$wrapper_markup .= build_dropdown_script_block_core_categories( $id );
		}
	} else {
		$wrapper_markup = '<ul class="%1$s">%2$s</ul>';
		$items_markup   = wp_list_categories( $args );
		$type           = 'list';
	}
	$class = "wp-block-categories wp-block-categories-{$type}";
	if ( isset( $attributes['align'] ) ) {
		$class .= " align{$attributes['align']}";
	}
	if ( isset( $attributes['className'] ) ) {
		$class .= " {$attributes['className']}";
	}
	$block_content = sprintf(
		$wrapper_markup,
		esc_attr( $class ),
		$items_markup
	);
	return $block_content;
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/render_block_core_categories/