Функция render_block() в WordPress: Рендеринг блока из массива данных

В этой статье мы рассмотрим функцию render_block() в WordPress, которая используется для рендеринга блока Gutenberg из массива данных. Эта функция полезна для разработчиков, желающих программно создавать и отображать блоки на своих сайтах.

Описание функции

Функция render_block() рендерит блок на основе массива данных, представляющего блок Gutenberg.

render_block( $block )

Параметры:

• $block (массив): Массив данных, представляющий блок.

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

• HTML строка, представляющая отрендеренный блок.

Примеры использования

Рассмотрим несколько примеров использования функции render_block().

Рендеринг простого текстового блока

Этот пример показывает, как программно создать и отрендерить простой текстовый блок:

function render_simple_text_block() {
    $block = array(
        'blockName' => 'core/paragraph',
        'attrs'     => array(),
        'innerHTML' => '<p>Привет, мир!</p>',
        'innerContent' => array(
            '<p>Привет, мир!</p>',
        ),
    );

    echo render_block( $block );
}

add_action( 'wp_footer', 'render_simple_text_block' );

Рендеринг блока с изображением и текстом

Создадим и отрендерим блок с изображением и текстом:

function render_image_text_block() {
    $block = array(
        'blockName' => 'core/media-text',
        'attrs'     => array(
            'mediaType' => 'image',
            'mediaUrl'  => 'https://example.com/image.jpg',
        ),
        'innerHTML' => '
            <figure class="wp-block-media-text__media">
                <img src="https://example.com/image.jpg" alt=""/>
            </figure>
            <div class="wp-block-media-text__content">
                <p>Это пример блока с изображением и текстом.</p>
            </div>',
        'innerContent' => array(
            '<figure class="wp-block-media-text__media"><img src="https://example.com/image.jpg" alt=""/></figure>',
            '<div class="wp-block-media-text__content"><p>Это пример блока с изображением и текстом.</p></div>',
        ),
    );

    echo render_block( $block );
}

add_action( 'wp_footer', 'render_image_text_block' );

Рендеринг динамического блока

Создадим и отрендерим динамический блок, который выводит текущую дату:

function render_dynamic_date_block() {
    $block = array(
        'blockName' => 'core/latest-posts',
        'attrs'     => array(),
        'innerHTML' => '<div><p>Текущая дата: ' . date( 'Y-m-d' ) . '</p></div>',
        'innerContent' => array(
            '<div><p>Текущая дата: ' . date( 'Y-m-d' ) . '</p></div>',
        ),
    );

    echo render_block( $block );
}

add_action( 'wp_footer', 'render_dynamic_date_block' );

Заключение по render_block

Функция render_block() предоставляет разработчикам простой способ программно рендерить блоки Gutenberg из массива данных. Это позволяет гибко создавать и отображать блоки на сайте, расширяя возможности динамического контента.

Используйте приведённые выше примеры, чтобы интегрировать render_block() в ваши проекты и улучшить управление контентом.