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

Сигнатура

parse_blocks( string $content ): array[]

Описание

Получив HTML-документ, эта функция полностью разбирает содержимое блоков, создавая дерево блоков и их содержимого, а также содержимое верхнего уровня, не относящееся к блокам, которое представляется как блок без blockName.
Эта функция может потреблять много памяти для некоторых документов, особенно с глубоко вложенными блоками или блоками с обширными значениями атрибутов. Кроме того, она должна разобрать весь документ за одну атомарную операцию.
Если полностью разобранный документ не нужен, рассмотрите использование WP_Block_Processor, поскольку он предоставляет потоковый и малозатратный интерфейс для поиска блоков.

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

Given an HTML document, this function fully-parses block content, producing a tree of blocks and their contents, as well as top-level non-block content, which will appear as a block with no blockName.

This function can be memory heavy for certain documents, particularly those with deeply-nested blocks or blocks with extensive attribute values. Further, this function must parse an entire document in one atomic operation.

If the entire parsed document is not necessary, consider using WP_Block_Processor instead, as it provides a streaming and low-overhead interface for finding blocks.

Параметры

$content string обязательный

Содержимое записи.

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

array[]

...$0 array An associative array of a single parsed block object. See WP_Block_Parser_Block. blockName string|nullName of block. attrs arrayAttributes from block comment delimiters. innerBlocks array[]List of inner blocks. An array of arrays that have the same structure as this one. innerHTML stringHTML from inside block comment delimiters. innerContent arrayList of string fragments and null markers where inner blocks were found. Source function parse_blocks( $content ) { /** * Filter to allow plugins to replace the server-side block parser. * * @since 5.0.0 * * @param string $parser_class Name of block parser class. */ $parser_class = apply_filters( 'block_parser_class', 'WP_Block_Parser' ); $parser = new $parser_class(); return $parser->parse( $content ); }

Исходный код

wp-includes/blocks.php:2474

function parse_blocks( $content ) {
	/**
	 * Filter to allow plugins to replace the server-side block parser.
	 *
	 * @since 5.0.0
	 *
	 * @param string $parser_class Name of block parser class.
	 */
	$parser_class = apply_filters( 'block_parser_class', 'WP_Block_Parser' );

	$parser = new $parser_class();
	return $parser->parse( $content );
}

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

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