概述

traverse_and_serialize_block() 函数用于递归遍历解析后的块树，并在序列化前后应用回调函数。它主要用于修改保存的块或向返回值注入标记，但仅限于内部使用。

关键要点

• 递归遍历块及其内部块，在序列化前应用 $pre_callback，序列化后应用 $post_callback。
• 回调函数接收当前块引用、父块和相邻块作为参数，并可修改块内容。
• 如果回调返回字符串值，将分别前置或追加到序列化块标记中。
• 序列化块包括注释分隔符和所有序列化属性。
• 此函数适用于需要修改保存块或注入标记的场景，但应优先使用 serialize_block() 准备保存到文章内容的块。

代码示例

function traverse_and_serialize_block( $block, $pre_callback = null, $post_callback = null ) {
    $block_content = '';
    $block_index   = 0;

    foreach ( $block['innerContent'] as $chunk ) {
        if ( is_string( $chunk ) ) {
            $block_content .= $chunk;
        } else {
            $inner_block = $block['innerBlocks'][ $block_index ];

            if ( is_callable( $pre_callback ) ) {
                $prev = 0 === $block_index
                    ? null
                    : $block['innerBlocks'][ $block_index - 1 ];

                $block_content .= call_user_func_array(
                    $pre_callback,
                    array( &$inner_block, &$block, $prev )
                );
            }

            if ( is_callable( $post_callback ) ) {
                $next = count( $block['innerBlocks'] ) - 1 === $block_index
                    ? null
                    : $block['innerBlocks'][ $block_index + 1 ];

                $post_markup = call_user_func_array(
                    $post_callback,
                    array( &$inner_block, &$block, $next )
                );
            }

            $block_content .= traverse_and_serialize_block( $inner_block, $pre_callback, $post_callback );
            $block_content .= isset( $post_markup ) ? $post_markup : '';

            ++$block_index;
        }
    }

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

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

注意事项

• 此函数仅用于内部使用，开发者应谨慎调用。
• 参数 $block 必须是关联数组形式的解析块对象，参考 WP_Block_Parser_Block。
• 回调函数 $pre_callback 和 $post_callback 是可选的，默认值为 null。
• 函数返回序列化块标记字符串。