InnerBlocks
Bloki wewnętrzne umożliwiają wstawianie dodatkowych bloków do innych bloków. Pod maską Blockstudio korzysta z komponentu InnerBlocks. Pamiętaj, że w każdym bloku można użyć tylko jednego komponentu InnerBlocks — to ograniczenie WordPress.
Podstawowe użycie
Aby użyć InnerBlocks, dodaj komponent <InnerBlocks /> do szablonu bloku:
<InnerBlocks />
Sposób złożenia zależy od Ciebie. Możesz zagnieździć komponent InnerBlocks tak głęboko, jak chcesz, albo użyć go samodzielnie.
Właściwości
allowedBlocks
Właściwość allowedBlocks pozwala określić, które bloki można wstawić 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 obsługuje również tokeny rozwijane po stronie serwera. Tokeny są rozwijane przed przekazaniem szablonu do edytora, natomiast dosłowne nazwy bloków pozostają bez zmian.
| Token | Opis |
|---|---|
namespace/* |
Każdy zarejestrowany blok w danej przestrzeni nazw |
category:<slug> |
Każdy zarejestrowany blok w danej kategorii bloków WordPress |
@theme |
Każdy blok Blockstudio zarejestrowany z aktywnego motywu |
Rozwinięte pozycje są pozbawiane duplikatów w kolejności autora:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Tokeny, które nie odpowiadają żadnym blokom, są ignorowane. Wynik na frontendzie pozostaje bez zmian, ponieważ allowedBlocks jest używane tylko w edytorze.
tag
Domyślnie komponent InnerBlocks jest renderowany jako element div. Możesz to zmienić za pomocą właściwości tag.
<InnerBlocks tag="section" />
template
Właściwość template pozwala zdefiniować szablon 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
Właściwość templateLock pozwala określić, czy szablon można modyfikować.
| Wartość | Opis |
|---|---|
contentOnly |
Blokuje wszystkie operacje. Typy bloków bez zawartości są ukryte w widoku listy. Potomkowie nie mogą tego nadpisać. |
all |
Blokuje wszystkie operacje. Nie można wstawiać, przenosić ani usuwać bloków. |
insert |
Uniemożliwia wstawianie lub usuwanie bloków, ale pozwala przenosić istniejące. |
false |
Uniemożliwia stosowanie blokady, nawet jeśli blok nadrzędny ją zawiera. |
renderAppender
Właściwość renderAppender pozwala określić typ dodawania bloku.
| Wartość | Opis |
|---|---|
default |
Wyświetla domyślny dodatek bloku (dodatek w stylu akapitu, gdy dozwolony jest blok akapitu) |
button |
Wyświetla przycisk z ikoną + jako dodatek |
useBlockProps
useBlockProps usuwa zewnętrzny kontener komponentu InnerBlocks
wewnątrz edytora. Więcej informacji znajdziesz w sekcji useBlockProps.
Kontekst
Rejestrowanie
Blockstudio obsługuje kontekst dla komponentu InnerBlocks. Umożliwia to przekazywanie danych z bloku nadrzędnego do bloków podrzędnych. Choć pod spodem wykorzystuje mechanizm kontekstu z rdzenia WordPress, Blockstudio zapewnia wygodniejszy API.
Zamiast osobno definiować wszystkie atrybuty, które mają być przekazywane w kontekście, możesz po prostu zasubskrybować wszystkie atrybuty bloku nadrzędnego.
Każdy blok podrzędny otrzymuje wartości własnego bloku nadrzędnego, również podczas pierwszego wstępnie załadowanego renderowania w edytorze. Aktualizacja pól dostawcy kontekstu aktualizuje jego bloki podrzędne w edytorze, nawet gdy poprzednie renderowanie wciąż trwa. Identyczne bloki podrzędne pod różnymi dostawcami zachowują osobne renderowania w pamięci podręcznej, uwzględniające kontekst.
Załóżmy, że konfiguracja bloku kontenera wygląda tak:
{
"$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"
}
]
}
}
W bloku podrzędnym użyj po prostu właściwości usesContext z nazwą
bloku nadrzędnego, aby uzyskać dostęp do wszystkich jego atrybutów w szablonie 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
}
Szablony
Zmienne $context i $c są dostępne w szablonach bloków,
aby uzyskać dostęp do wszystkich atrybutów bloku nadrzędnego. Bloki podrzędne zostaną automatycznie ponownie załadowane w edytorze po zmianie danych bloku nadrzędnego.
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>
Kontener interfejsu witryny
InnerBlocks musi renderować element kontenera wokół swoich bloków podrzędnych w
edytorze, ale można go usunąć z interfejsu witryny za pomocą 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);
Wczesny powrót
Aby wcześniej zakończyć metodę render bloku, możesz
sprawdzić, czy zmienna $innerBlocks jest pusta. Przydaje się to, gdy nie chcesz
nic renderować, jeśli blok nie zawiera bloków wewnętrznych.
<?php if (strip_tags($innerBlocks) === '') {
return;
} ?>
<InnerBlocks tag="section" />
Ponieważ <InnerBlocks/> zawsze renderuje pusty znacznik akapitu, możesz użyć
funkcji strip_tags, aby sprawdzić, czy treść jest pusta.
Szablony dynamiczne
Typy pól Select i
Radio obsługują dynamiczne generowanie
szablonu InnerBlocks w zależności od wartości pola. Przydaje się to, gdy
chcesz pozwolić użytkownikowi wybrać inny szablon dla komponentu InnerBlocks.
W tym celu dodaj klucz innerBlocks do tablicy opcji wraz z szablonem:
{
"$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"
}
]
}
}
Kontekst i komunikacja między blokami
Dowiedz się, jak bloki nadrzędne i podrzędne współdzielą dane za pomocą kontekstu.