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 />:
<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
<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 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:
<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.
<InnerBlocks tag="section" />
template
Pomocí vlastnosti template lze definovat šablonu pro komponentu 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
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:
{
"$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.
{
"$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 $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 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.
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 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:
{
"$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"
}
]
}
}
Zjistěte, jak si nadřazené a podřízené bloky předávají data pomocí kontextu.