Przejdź do treści

InnerBlocks

Bloki wewnętrzne umożliwiają wstawianie dodatkowych bloków do innych bloków. Pod maską Blockstudio korzysta z komponentu InnerBlocks. Pamiętaj, że w każdym bloku można użyć tylko jednego komponentu InnerBlocks — to ograniczenie WordPress.

Podstawowe użycie

Aby użyć InnerBlocks, dodaj komponent <InnerBlocks /> do szablonu bloku:

PHP
<InnerBlocks />

Sposób złożenia zależy od Ciebie. Możesz zagnieździć komponent InnerBlocks tak głęboko, jak chcesz, albo użyć go samodzielnie.

Właściwości

allowedBlocks

Właściwość allowedBlocks pozwala określić, które bloki można wstawić do komponentu 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 obsługuje również tokeny rozwijane po stronie serwera. Tokeny są rozwijane przed przekazaniem szablonu do edytora, natomiast dosłowne nazwy bloków pozostają bez zmian.

Token Opis
namespace/* Każdy zarejestrowany blok w danej przestrzeni nazw
category:<slug> Każdy zarejestrowany blok w danej kategorii bloków WordPress
@theme Każdy blok Blockstudio zarejestrowany z aktywnego motywu

Rozwinięte pozycje są pozbawiane duplikatów w kolejności autora:

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

Tokeny, które nie odpowiadają żadnym blokom, są ignorowane. Wynik na frontendzie pozostaje bez zmian, ponieważ allowedBlocks jest używane tylko w edytorze.

tag

Domyślnie komponent InnerBlocks jest renderowany jako element div. Możesz to zmienić za pomocą właściwości tag.

PHP
<InnerBlocks tag="section" />

template

Właściwość template pozwala zdefiniować szablon komponentu 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

Właściwość templateLock pozwala określić, czy szablon można modyfikować.

Wartość Opis
contentOnly Blokuje wszystkie operacje. Typy bloków bez zawartości są ukryte w widoku listy. Potomkowie nie mogą tego nadpisać.
all Blokuje wszystkie operacje. Nie można wstawiać, przenosić ani usuwać bloków.
insert Uniemożliwia wstawianie lub usuwanie bloków, ale pozwala przenosić istniejące.
false Uniemożliwia stosowanie blokady, nawet jeśli blok nadrzędny ją zawiera.

renderAppender

Właściwość renderAppender pozwala określić typ dodawania bloku.

Wartość Opis
default Wyświetla domyślny dodatek bloku (dodatek w stylu akapitu, gdy dozwolony jest blok akapitu)
button Wyświetla przycisk z ikoną + jako dodatek

useBlockProps

useBlockProps usuwa zewnętrzny kontener komponentu InnerBlocks wewnątrz edytora. Więcej informacji znajdziesz w sekcji useBlockProps.

Kontekst

Rejestrowanie

Blockstudio obsługuje kontekst dla komponentu InnerBlocks. Umożliwia to przekazywanie danych z bloku nadrzędnego do bloków podrzędnych. Choć pod spodem wykorzystuje mechanizm kontekstu z rdzenia WordPress, Blockstudio zapewnia wygodniejszy API.

Zamiast osobno definiować wszystkie atrybuty, które mają być przekazywane w kontekście, możesz po prostu zasubskrybować wszystkie atrybuty bloku nadrzędnego.

Każdy blok podrzędny otrzymuje wartości własnego bloku nadrzędnego, również podczas pierwszego wstępnie załadowanego renderowania w edytorze. Aktualizacja pól dostawcy kontekstu aktualizuje jego bloki podrzędne w edytorze, nawet gdy poprzednie renderowanie wciąż trwa. Identyczne bloki podrzędne pod różnymi dostawcami zachowują osobne renderowania w pamięci podręcznej, uwzględniające kontekst.

Załóżmy, że konfiguracja bloku kontenera wygląda tak:

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"
      }
    ]
  }
}

W bloku podrzędnym użyj po prostu właściwości usesContext z nazwą bloku nadrzędnego, aby uzyskać dostęp do wszystkich jego atrybutów w szablonie bloku.

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
}

Szablony

Zmienne $context i $c są dostępne w szablonach bloków, aby uzyskać dostęp do wszystkich atrybutów bloku nadrzędnego. Bloki podrzędne zostaną automatycznie ponownie załadowane w edytorze po zmianie danych bloku nadrzędnego.

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>

Kontener interfejsu witryny

InnerBlocks musi renderować element kontenera wokół swoich bloków podrzędnych w edytorze, ale można go usunąć z interfejsu witryny za pomocą filtra 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);

Wczesny powrót

Aby wcześniej zakończyć metodę render bloku, możesz sprawdzić, czy zmienna $innerBlocks jest pusta. Przydaje się to, gdy nie chcesz nic renderować, jeśli blok nie zawiera bloków wewnętrznych.

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

Ponieważ <InnerBlocks/> zawsze renderuje pusty znacznik akapitu, możesz użyć funkcji strip_tags, aby sprawdzić, czy treść jest pusta.

Szablony dynamiczne

Typy pól Select i Radio obsługują dynamiczne generowanie szablonu InnerBlocks w zależności od wartości pola. Przydaje się to, gdy chcesz pozwolić użytkownikowi wybrać inny szablon dla komponentu InnerBlocks.

W tym celu dodaj klucz innerBlocks do tablicy opcji wraz z szablonem:

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"
      }
    ]
  }
}

Kontekst i komunikacja między blokami

Dowiedz się, jak bloki nadrzędne i podrzędne współdzielą dane za pomocą kontekstu.