serialize_block() — описание функции WordPress на русском

Сигнатура

serialize_block( array $block ): string

Описание

Следует использовать при подготовке блока к сохранению в содержимое записи.
Для подготовки блока к отображению предпочтительнее render_block. В отличие от render_block, эта функция не выполняет render_callback блока, а сохраняет разметку в том виде, в каком она была разобрана.

Оригинал (английский)

This should be used when preparing a block to be saved to post content.
Prefer render_block when preparing a block for display. Unlike render_block, this does not evaluate a block’s render_callback, and will instead preserve the markup as parsed.

Параметры

$block array обязательный

Ассоциативный массив одного разобранного объекта блока. См. WP_Block_Parser_Block. blockName string|null Имя блока. attrs array Атрибуты из разделителей-комментариев блока. innerBlocks array[] Список вложенных блоков. Массив массивов такой же структуры, как этот. innerHTML string HTML изнутри разделителей-комментариев блока. innerContent array Список строковых фрагментов и null-меток в местах, где найдены вложенные блоки.

Возвращаемое значение

string

Исходный код

wp-includes/blocks.php:1735

function serialize_block( $block ) {
	$block_content = '';

	$index = 0;
	foreach ( $block['innerContent'] as $chunk ) {
		$block_content .= is_string( $chunk ) ? $chunk : serialize_block( $block['innerBlocks'][ $index++ ] );
	}

	if ( ! is_array( $block['attrs'] ) ) {
		$block['attrs'] = array();
	}

	return get_comment_delimited_block_content(
		$block['blockName'],
		$block['attrs'],
		$block_content
	);
}

История изменений

Версия	Описание
5.3.1	Introduced.