Ugrás a tartalomhoz

InnerBlocks

A belső blokkok lehetővé teszik további blokkok beillesztését a blokkokba. A háttérben a Blockstudio az InnerBlocks összetevőt használja. Vegye figyelembe, hogy blokkonként csak egy InnerBlocks összetevő használható; ez a WordPress korlátozása.

Alapvető használat

Az InnerBlocks használatához adja hozzá a <InnerBlocks /> összetevőt a blokksablonhoz:

PHP
<InnerBlocks />

Az összeállítás az Ön döntése. Az InnerBlocks összetevőt tetszőleges mélységben beágyazhatja, vagy önmagában is használhatja.

Tulajdonságok

allowedBlocks

A allowedBlocks tulajdonsággal megadhatja, mely blokkok illeszthetők be az InnerBlocks összetevőbe.

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') }}" />

A allowedBlocks szerveroldalon kibontott tokeneket is elfogad. A tokenek még azelőtt kibontásra kerülnek, hogy a szerkesztő megkapná a sablont, a szó szerinti blokknevek pedig változatlanok maradnak.

Token Leírás
namespace/* Az adott névtér minden regisztrált blokkja
category:<slug> Az adott WordPress blokkkategória minden regisztrált blokkja
@theme Az aktív témából regisztrált összes Blockstudio blokk

A kibontott elemek készítői sorrendben deduplikálódnak:

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

A fel nem oldható, blokkok nélküli tokeneket a rendszer figyelmen kívül hagyja. A frontend kimenete változatlan marad, mert a allowedBlocks csak a szerkesztőben használatos.

tag

Alapértelmezés szerint az InnerBlocks összetevő div elemként jelenik meg. Ezt a tag tulajdonsággal módosíthatja.

PHP
<InnerBlocks tag="section" />

template

A template tulajdonsággal sablont adhat meg az InnerBlocks összetevőhöz.

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

A templateLock tulajdonsággal megadhatja, hogy a sablon módosítható legyen-e.

Érték Leírás
contentOnly Minden műveletet megakadályoz. A tartalom nélküli blokktípusok rejtve maradnak a lista nézetben. A gyermekek nem írhatják felül.
all Minden műveletet megakadályoz. Blokkokat nem lehet beszúrni, áthelyezni vagy törölni.
insert Megakadályozza a blokkok beszúrását vagy eltávolítását, de a meglévők áthelyezését engedélyezi.
false Megakadályozza a zárolás alkalmazását akkor is, ha a szülőblokk zárolást tartalmaz.

renderAppender

A renderAppender tulajdonsággal megadhatja a blokkhozzáfűző típusát.

Érték Leírás
default Az alapértelmezett blokkbeszúró megjelenítése (bekezdésstílusú beszúró, ha a bekezdésblokk engedélyezett)
button + ikont tartalmazó gomb megjelenítése beszúróként

useBlockProps

useBlockProps eltávolítja a InnerBlocks komponens külső burkolóelemét a szerkesztőben. További információért lásd: useBlockProps.

Kontextus

Regisztrálás

A Blockstudio támogatja a InnerBlocks komponenshez tartozó kontextust. Ez lehetővé teszi, hogy adatokat adj át a szülőblokkból a gyermekblokkoknak. A háttérben a WordPress alapvető kontextusmechanizmusát használja, a Blockstudio azonban kényelmesebb API kínál.

Ahelyett, hogy külön meg kellene határoznod az összes, kontextusként továbbadandó attribútumot, egyszerűen feliratkozhatsz a szülőblokk összes attribútumára.

Minden gyermek a saját szülőjének értékeit kapja meg, a szerkesztő első, előre betöltött megjelenítésekor is. A szolgáltató mezőinek módosítása frissíti a gyermekeket a szerkesztőben akkor is, ha egy korábbi megjelenítés még betöltés alatt áll. A különböző szolgáltatók alatti azonos gyermekblokkok különálló, kontextust figyelembe vevő gyorsítótárazott megjelenítéseket kapnak.

Tegyük fel, hogy egy ilyen tárolóblokkot állítasz össze:

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

A gyermekblokkon belül egyszerűen használd a usesContext tulajdonságot a szülőblokk nevével, hogy hozzáférj a szülő összes attribútumához a blokk sablonjában.

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
}

Sablonok

A $context és $c változók elérhetők a blokk sablonjaiban, így hozzáférhetsz a szülő összes attribútumához. Ha a szülő adatai megváltoznak, a gyermekblokkok automatikusan újratöltődnek a szerkesztőben.

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>

Előtéri burkolóelem

A InnerBlocks komponensnek burkolóelemet kell megjelenítenie a gyermekei körül a szerkesztőben, az előtérből azonban eltávolítható a blockstudio/blocks/components/inner_blocks/frontend/wrap szűrővel.

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

Korai visszatérés

Ha korán szeretnél visszatérni a blokkod render metódusából, ellenőrizd, hogy a $innerBlocks változó üres-e. Ez akkor hasznos, ha nem szeretnél semmit megjeleníteni, amikor nincsenek belső blokkok.

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

Mivel a <InnerBlocks/> mindig egy üres bekezdéscímkét jelenít meg, a strip_tags függvénnyel ellenőrizheted, hogy üres-e a tartalom.

Dinamikus sablonok

A Select és a Radio mezőtípusok támogatják a InnerBlocks sablon mezőérték alapján történő dinamikus létrehozását. Ez akkor hasznos, ha lehetővé szeretnéd tenni, hogy a felhasználó másik sablont válasszon a InnerBlocks komponenshez.

Ehhez egyszerűen adj hozzá egy innerBlocks kulcsot a beállításokat tartalmazó tömbhöz, benne a sablonnal:

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

Blokkkontextus és kommunikáció

Ismerd meg, hogyan osztják meg az adatokat a szülő- és gyermekblokkok a kontextus segítségével.