概述

traverse_and_serialize_blocks() 是一个 WordPress 内部函数，用于递归遍历解析后的块数组，并在序列化前后应用回调函数，最终返回拼接的序列化标记。它主要用于修改已保存的块或向返回值注入标记。

关键要点

• 函数接收解析后的块数组和两个可选回调：$pre_callback（序列化前调用）和$post_callback（序列化后调用）。
• 回调函数可以接收当前块的引用、父块以及相邻块（前一个或后一个）作为参数，并允许修改块。
• 如果回调返回字符串值，该字符串将分别前置或附加到序列化块的标记中。
• 序列化块包括注释分隔符和所有序列化属性，适用于修改保存的块或注入标记场景。
• 此函数仅供内部使用，在准备保存到文章内容时，应优先使用 serialize_blocks()。

代码示例

function traverse_and_serialize_blocks( $blocks, $pre_callback = null, $post_callback = null ) {
    $result       = '';
    $parent_block = null;

    $pre_callback_is_callable  = is_callable( $pre_callback );
    $post_callback_is_callable = is_callable( $post_callback );

    foreach ( $blocks as $index => $block ) {
        if ( $pre_callback_is_callable ) {
            $prev = 0 === $index
                ? null
                : $blocks[ $index - 1 ];

            $result .= call_user_func_array(
                $pre_callback,
                array( &$block, &$parent_block, $prev )
            );
        }

        if ( $post_callback_is_callable ) {
            $next = count( $blocks ) - 1 === $index
                ? null
                : $blocks[ $index + 1 ];

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

        $result .= traverse_and_serialize_block( $block, $pre_callback, $post_callback );
        $result .= isset( $post_markup ) ? $post_markup : '';
    }

    return $result;
}

注意事项

• 此函数是内部函数，不建议在插件或主题中直接使用，以避免兼容性问题。
• 在需要修改块内容或添加额外标记时使用，但保存到文章内容时应改用 serialize_blocks()。
• 回调函数需正确处理块引用和参数，以避免意外副作用。