Preskočiť na obsah

InnerBlocks

Vnútorné bloky umožňujú vkladať do blokov ďalšie bloky. Na pozadí Blockstudio používa komponent InnerBlocks. Upozorňujeme, že v každom bloku možno použiť iba jeden komponent InnerBlocks; ide o obmedzenie WordPress.

Základné použitie

Ak chcete použiť InnerBlocks, pridajte do šablóny bloku komponent <InnerBlocks />:

PHP
<InnerBlocks />

Zloženie je na vás. Komponent InnerBlocks môžete vnárať ľubovoľne hlboko alebo ho použiť samostatne.

Vlastnosti

allowedBlocks

Vlastnosť allowedBlocks umožňuje určiť, ktoré bloky možno vložiť 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 prijíma aj tokeny rozbalené na serveri. Tokeny sa rozbalia skôr, než editor dostane šablónu, zatiaľ čo doslovné názvy blokov zostanú nezmenené.

Token Popis
namespace/* Každý zaregistrovaný blok v danom mennom priestore
category:<slug> Každý zaregistrovaný blok v danej kategórii blokov WordPress
@theme Každý blok Blockstudio zaregistrovaný v aktívnej téme

Rozbalené položky sa deduplikujú podľa poradia autora:

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

Tokeny, ktoré sa nerozvinú na žiadne bloky, sa ignorujú. Výstup frontendu zostáva nezmenený, pretože allowedBlocks sa používa iba v editore.

tag

Komponent InnerBlocks sa predvolene vykresľuje ako prvok div. Zmeniť to môžete pomocou vlastnosti tag.

PHP
<InnerBlocks tag="section" />

template

Vlastnosť template umožňuje definovať šablónu pre komponent 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

Vlastnosť templateLock umožňuje určiť, či možno šablónu upravovať.

Hodnota Opis
contentOnly Zabraňuje všetkým operáciám. Typy blokov bez obsahu sa v zozname nezobrazujú. Podradené bloky toto nastavenie nemôžu prepísať.
all Zabraňuje všetkým operáciám. Bloky nemožno vkladať, presúvať ani odstraňovať.
insert Zabraňuje vkladaniu a odstraňovaniu blokov, ale umožňuje presúvať existujúce bloky.
false Zabraňuje uzamknutiu aj vtedy, keď je uzamknutý nadradený blok.

renderAppender

Vlastnosť renderAppender umožňuje určiť typ pridávača blokov.

Hodnota Opis
default Zobrazí predvolený pridávač blokov (ak je povolený blok odseku, použije sa pridávač v štýle odseku).
button Zobrazí tlačidlo pridávača s ikonou +

useBlockProps

useBlockProps odstráni vonkajší obal komponentu InnerBlocks v editore. Ďalšie informácie nájdete v useBlockProps.

Kontext

Registrácia

Blockstudio podporuje kontext pre komponent InnerBlocks. Vďaka tomu môžete odovzdávať údaje z nadradeného bloku do podradených blokov. Využíva pritom základný WordPressmechanizmus kontextu, ale Blockstudio ponúka pohodlnejšie API.

Namiesto toho, aby ste museli samostatne definovať všetky atribúty, ktoré sa majú odovzdať v kontexte, môžete jednoducho odoberať všetky atribúty nadradeného bloku.

Každý podradený blok dostane hodnoty od svojho nadradeného bloku, a to aj pri prvom prednačítanom vykreslení editora. Aktualizácia polí poskytovateľa aktualizuje jeho podradené bloky v editore, aj keď sa stále načítava predchádzajúce vykreslenie. Rovnaké podradené bloky pod rôznymi poskytovateľmi majú samostatné kontextové vykreslenia vo vyrovnávacej pamäti.

Predstavme si, že máte takto nastavený blok kontajnera:

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 podradenom bloku použite vlastnosť usesContext s názvom nadradeného bloku, aby ste v šablóne bloku získali prístup ku všetkým atribútom nadradeného 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
}

Šablóny

Premenné $context a $c sú dostupné v šablónach blokov a umožňujú prístup ku všetkým atribútom nadradeného bloku. Ak sa zmenia údaje nadradeného bloku, podradené bloky sa v editore automaticky znova načítajú.

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 frontende

InnerBlocks musí v editore vykresliť okolo svojich podradených prvkov obaľovací prvok. Na frontende ho však možno odstrániť pomocou 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);

Predčasný návrat

Ak chcete z metódy render bloku predčasne vrátiť výsledok, môžete skontrolovať, či je premenná $innerBlocks prázdna. Hodí sa to, ak nechcete nič vykresliť, keď blok neobsahuje žiadne vnorené bloky.

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

Keďže <InnerBlocks/> vždy vykreslí prázdnu značku odseku, na kontrolu, či je obsah prázdny, môžete použiť funkciu strip_tags.

Dynamické šablóny

Typy polí Výber a Prepínač podporujú dynamické generovanie šablóny InnerBlocks podľa hodnoty poľa. Je to užitočné, ak chcete používateľovi umožniť vybrať inú šablónu pre komponent InnerBlocks.

Stačí pridať kľúč innerBlocks do poľa možností spolu so šablónou:

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 komunikácia blokov

Zistite, ako si nadradené a podradené bloky vymieňajú údaje pomocou kontextu.