Към съдържанието

InnerBlocks

Вътрешните блокове ви позволяват да вмъквате допълнителни блокове в блоковете си. Зад кулисите Blockstudio използва компонента InnerBlocks. Имайте предвид, че за всеки блок може да се използва само един компонент InnerBlocks — това е ограничение на WordPress.

Основна употреба

За да използвате InnerBlocks, добавете компонента <InnerBlocks /> към шаблона на блока си:

PHP
<InnerBlocks />

Подредбата зависи от вас. Можете да влагате компонента InnerBlocks колкото дълбоко пожелаете или да го използвате самостоятелно.

Свойства

allowedBlocks

Свойството allowedBlocks ви позволява да зададете кои блокове могат да бъдат вмъквани в компонента InnerBlocks.

PHP

PHP
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode(['core/heading', 'core/paragraph'])); ?>" />

Twig

Twig
<InnerBlocks allowedBlocks="{{ ['core/heading', 'core/paragraph']|json_encode|escape('html_attr') }}" />

allowedBlocks приема и токени, разширявани от сървъра. Токените се разширяват преди шаблонът да бъде получен от редактора, а буквалните имена на блокове остават непроменени.

Токен Описание
namespace/* Всеки регистриран блок в това пространство от имена
category:<slug> Всеки регистриран блок в тази категория блокове WordPress
@theme Всеки блок Blockstudio, регистриран от активната тема

Разширените записи се премахват дублиращите се в реда на задаването им от автора:

PHP
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
  'core/paragraph',
  'category:content',
  'bsui/field',
])); ?>" />

Токените, които не съответстват на блокове, се игнорират. Изходът във фронтенда остава непроменен, защото allowedBlocks се използва само от редактора.

етикет

По подразбиране компонентът InnerBlocks се визуализира като елемент div. Можете да промените това чрез свойството tag.

PHP
<InnerBlocks tag="section" />

шаблон

Свойството template ви позволява да зададете шаблон за компонента InnerBlocks.

PHP

PHP
<InnerBlocks template="<?php echo esc_attr(wp_json_encode([
  ['core/heading', ['placeholder' => 'Book Title']],
  ['core/paragraph', ['placeholder' => 'Summary']]
])); ?>" />

Twig

Twig
<InnerBlocks template="{{ [
  ['core/heading', { placeholder: 'Book Title' }],
  ['core/paragraph', { placeholder: 'Summary' }]
]|json_encode|escape('html_attr') }}" />

templateLock

Свойството templateLock ви позволява да зададете дали шаблонът може да бъде променян.

Стойност Описание
contentOnly Забранява всички операции. Типовете блокове без съдържание се скриват от изгледа на списъка. Дъщерните блокове не могат да отменят това ограничение.
all Забранява всички операции. Блоковете не могат да се вмъкват, местят или изтриват.
insert Забранява вмъкването и премахването на блокове, но позволява преместването на съществуващите.
false Забранява прилагането на заключване, дори ако родителски блок съдържа заключване.

renderAppender

Свойството renderAppender ви позволява да зададете типа на добавящия блок.

Стойност Описание
default Показва подразбирания апендър за блокове (апендър в стил на абзац, когато е разрешен блокът „Абзац“)
button Показва бутон с икона + като апендър

useBlockProps

useBlockProps премахва външната обвивка на компонента InnerBlocks в редактора. Вижте useBlockProps за повече информация.

Контекст

Регистриране

Blockstudio поддържа контекст за компонента InnerBlocks. Това ви позволява да предавате данни от родителския блок към дъщерните блокове. Макар да използва основния механизъм за контекст на WordPress, Blockstudio предлага по-удобен API.

Вместо да дефинирате поотделно всички атрибути, които трябва да се предават в контекста, можете просто да се абонирате за всички атрибути на родителския блок.

Всеки дъщерен блок получава стойностите на своя родител, включително при първото предварително зареждане в редактора. Промените в полетата на доставчик обновяват дъщерните блокове в редактора, дори докато предишно изобразяване все още се зарежда. Идентичните дъщерни блокове под различни доставчици запазват отделно кеширано изобразяване, съобразено с контекста.

Да предположим, че имате настройка с блок контейнер като тази:

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/container",
  "title": "Container",
  "category": "design",
  "icon": "star-filled",
  "description": "Container block.",
  "blockstudio": {
    "attributes": [
      {
        "id": "full-width",
        "type": "toggle",
        "label": "Makes section full width"
      }
    ]
  }
}

В дъщерния блок просто използвайте свойството usesContext с името на родителския блок, за да получите достъп до всички атрибути на родителя в шаблона на блока.

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/element",
  "title": "Element",
  "category": "design",
  "icon": "star-filled",
  "description": "Element block.",
  "usesContext": ["blockstudio/container"],
  "parent": ["blockstudio/container"],
  "blockstudio": true
}

Шаблони

Променливите $context и $c са налични в шаблоните на блоковете, за да имате достъп до всички атрибути на родителя. Дъщерните блокове се презареждат автоматично в редактора при промяна на данните на родителя.

PHP

PHP
<?php $container = $context['blockstudio/container']; ?>

<h1>
  <?php echo $container['full-width']
      ? 'is full width'
      : 'no full width'; ?>
</h1>

Twig

Twig
{% set container = context['blockstudio/container'] %}

<h1>
  {{ container['full-width']
      ? 'is full width'
      : 'no full width' }}
</h1>

Обвивка във фронтенда

InnerBlocks трябва да изобрази обгръщащ елемент около дъщерните блокове в редактора, но той може да бъде премахнат във фронтенда с филтъра blockstudio/blocks/components/inner_blocks/frontend/wrap.

PHP
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
  return false; // Remove wrapper
}, 10, 2);

Преждевременно връщане

Ако искате да прекратите изпълнението на метода render на блока по-рано, можете да проверите дали променливата $innerBlocks е празна. Това е полезно, ако не искате да изобразявате нищо, когато няма вътрешни блокове.

PHP
<?php if (strip_tags($innerBlocks) === '') {
  return;
} ?>
<InnerBlocks tag="section" />

Тъй като <InnerBlocks/> винаги изобразява празен таг за абзац, можете да използвате функцията strip_tags, за да проверите дали съдържанието е празно.

Динамични шаблони

Типовете полета Select и Radio поддържат динамично генериране на шаблона InnerBlocks според стойността на полето. Това е полезно, ако искате да позволите на потребителя да избира различен шаблон за компонента InnerBlocks.

За целта просто добавете ключ innerBlocks към масива с опциите и посочете шаблона:

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/dynamic-layout",
  "title": "Dynamic Layout",
  "blockstudio": {
    "attributes": [
      {
        "id": "layout",
        "type": "select",
        "label": "Layout",
        "options": [
          {
            "value": "1",
            "label": "Two Columns",
            "innerBlocks": [
              {
                "name": "core/columns",
                "innerBlocks": [
                  {
                    "name": "core/column",
                    "innerBlocks": [
                      {
                        "name": "core/heading",
                        "attributes": {
                          "content": "Left Heading",
                          "level": 1
                        }
                      }
                    ]
                  },
                  {
                    "name": "core/column",
                    "innerBlocks": [
                      {
                        "name": "core/heading",
                        "attributes": {
                          "content": "Right Heading",
                          "level": 1
                        }
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "value": "2",
            "label": "Single Column",
            "innerBlocks": [
              {
                "name": "core/heading",
                "attributes": {
                  "content": "Main Heading",
                  "level": 1
                }
              },
              {
                "name": "core/paragraph",
                "attributes": {
                  "content": "Main content goes here."
                }
              }
            ]
          }
        ],
        "allowNull": "Select a layout"
      }
    ]
  }
}

Контекст и комуникация между блокове

Научете как родителските и дъщерните блокове споделят данни чрез контекст.