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 />:
<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
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode(['core/heading', 'core/paragraph'])); ?>" />
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:
<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.
<InnerBlocks tag="section" />
template
Vlastnosť template umožňuje definovať šablónu pre komponent InnerBlocks.
PHP
<InnerBlocks template="<?php echo esc_attr(wp_json_encode([
['core/heading', ['placeholder' => 'Book Title']],
['core/paragraph', ['placeholder' => 'Summary']]
])); ?>" />
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:
{
"$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.
{
"$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 $container = $context['blockstudio/container']; ?>
<h1>
<?php echo $container['full-width']
? 'is full width'
: 'no full width'; ?>
</h1>
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.
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 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:
{
"$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"
}
]
}
}
Zistite, ako si nadradené a podradené bloky vymieňajú údaje pomocou kontextu.