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:
<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
<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') }}" />
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:
<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.
<InnerBlocks tag="section" />
template
A template tulajdonsággal sablont adhat meg az InnerBlocks összetevőhöz.
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
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:
{
"$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.
{
"$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 $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>
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.
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 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:
{
"$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.