Přejít k obsahu

InnerBlocks

Vnitřní bloky umožňují vkládat do bloků další bloky. Na pozadí Blockstudio používá komponentu InnerBlocks. Upozorňujeme, že v každém bloku lze použít pouze jednu komponentu InnerBlocks; jde o omezení WordPress.

Základní použití

Chcete-li používat InnerBlocks, přidejte do šablony bloku komponentu <InnerBlocks />:

PHP
<InnerBlocks />

Skladbu můžete zvolit sami. Komponentu InnerBlocks můžete vnořit do libovolné hloubky, nebo ji použít samostatně.

Vlastnosti

allowedBlocks

Pomocí vlastnosti allowedBlocks lze určit, které bloky lze vkládat do komponenty 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 přijímá také tokeny rozbalované na serveru. Tokeny se rozbalí před předáním šablony editoru, zatímco doslovné názvy bloků zůstanou beze změny.

Token Popis
namespace/* Každý registrovaný blok v daném jmenném prostoru
category:<slug> Každý registrovaný blok v kategorii bloků WordPress
@theme Každý blok Blockstudio registrovaný z aktivního motivu

Rozbalené položky se deduplikují v pořadí určeném autorem:

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

Tokeny, které neodpovídají žádným blokům, se ignorují. Výstup frontendu zůstane beze změny, protože allowedBlocks se používá pouze v editoru.

tag

Ve výchozím nastavení se komponenta InnerBlocks vykreslí jako prvek div. Změnit to můžete pomocí vlastnosti tag.

PHP
<InnerBlocks tag="section" />

template

Pomocí vlastnosti template lze definovat šablonu pro 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

Pomocí vlastnosti templateLock lze určit, zda lze šablonu upravovat.

Hodnota Popis
contentOnly Zakáže všechny operace. Typy bloků bez obsahu se v zobrazení seznamu skryjí. Potomek toto nastavení nemůže změnit.
all Zakáže všechny operace. Bloky nelze vkládat, přesouvat ani mazat.
insert Zakáže vkládání a odebírání bloků, ale umožní přesouvat stávající bloky.
false Zakáže nastavení zámku, i když nadřazený blok zámek obsahuje.

renderAppender

Pomocí vlastnosti renderAppender lze určit typ přidávače bloků.

Hodnota Popis
default Zobrazí výchozí přidávací prvek bloku (přidávací prvek ve stylu odstavce, pokud je povolen blok odstavce)
button Zobrazí tlačítko s ikonou + jako přidávací prvek

useBlockProps

useBlockProps odstraní vnější obal komponenty InnerBlocks v editoru. Další informace najdete v useBlockProps.

Kontext

Registrace

Blockstudio podporuje kontext pro komponentu InnerBlocks. Díky tomu můžete předávat data z nadřazeného bloku do podřízených bloků. Na pozadí využívá základní mechanismus kontextu WordPress, ale Blockstudio nabízí pohodlnější API.

Místo toho, abyste museli samostatně definovat všechny atributy, které se mají předávat v kontextu, můžete jednoduše odebírat všechny atributy nadřazeného bloku.

Každý podřízený blok dostává hodnoty svého vlastního nadřazeného bloku, a to i při prvním předem načteném vykreslení v editoru. Aktualizace polí poskytovatele aktualizuje jeho podřízené bloky v editoru, i když se stále načítá předchozí vykreslení. Stejné podřízené bloky pod různými poskytovateli mají oddělená vykreslení uložená v mezipaměti s ohledem na kontext.

Představme si, že máte nastavený kontejnerový blok takto:

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

V podřízeném bloku jednoduše použijte vlastnost usesContext s názvem nadřazeného bloku, abyste získali přístup ke všem atributům nadřazeného bloku v šabloně 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
}

Šablony

Proměnné $context a $c jsou dostupné v šablonách bloků a umožňují přístup ke všem atributům nadřazeného bloku. Pokud se změní data nadřazeného bloku, podřízené bloky se v editoru automaticky znovu načtou.

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>

Obal na frontendu

InnerBlocks musí v editoru vykreslit obalový prvek kolem svých podřízených prvků. Na frontendu ho však lze odstranit pomocí filtru 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);

Předčasné ukončení

Pokud chcete předčasně ukončit metodu render svého bloku, můžete zkontrolovat, zda je proměnná $innerBlocks prázdná. Hodí se to, pokud nechcete nic vykreslit, když nejsou k dispozici žádné vnitřní bloky.

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

Protože <InnerBlocks/> vždy vykreslí prázdný odstavec, můžete pomocí funkce strip_tags zkontrolovat, zda je obsah prázdný.

Dynamické šablony

Typy polí Select a Radio podporují dynamické generování šablony InnerBlocks podle hodnoty pole. To se hodí, pokud chcete uživateli umožnit vybrat jinou šablonu pro komponentu InnerBlocks.

Stačí přidat klíč innerBlocks do pole možností a přiřadit mu šablonu:

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

Kontext a komunikace bloků

Zjistěte, jak si nadřazené a podřízené bloky předávají data pomocí kontextu.