InnerBlocks
Sisemised plokid võimaldavad lisada plokkidesse täiendavaid plokke. Taustal kasutab Blockstudio komponenti InnerBlocks. Pane tähele, et ploki kohta saab kasutada ainult üht InnerBlocksi komponenti; see on WordPress piirang.
Põhikasutus
InnerBlocksi kasutamiseks lisa plokimalli komponent <InnerBlocks />:
<InnerBlocks />
Koostis on sinu valida. Võid paigutada komponendi InnerBlocks nii sügavale pesastatult, kui soovid, või kasutada seda eraldi.
Omadused
allowedBlocks
Propi allowedBlocks abil saad määrata, milliseid plokke saab komponendile InnerBlocks lisada.
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 toetab ka serveris laiendatavaid tokeneid. Tokenid laiendatakse enne, kui mall jõuab redaktorisse, samas kui sõnasõnalised plokinimed jäävad muutmata.
| Token | Kirjeldus |
|---|---|
namespace/* |
Kõik registreeritud plokid selles nimeruumis |
category:<slug> |
Kõik registreeritud plokid selles WordPress plokikategoorias |
@theme |
Kõik aktiivse teema registreeritud Blockstudio plokid |
Laiendatud kirjed eemaldatakse duplikaatidest autori määratud järjekorras:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Tokenid, mis ei lahene ühekski plokiks, jäetakse tähelepanuta. Esikülje väljund jääb samaks, sest allowedBlocks-i kasutatakse ainult redaktoris.
silt
Vaikimisi renderdatakse komponent InnerBlocks elemendina div. Seda saab muuta proppi tag abil.
<InnerBlocks tag="section" />
mall
Propi template abil saad määrata komponendile InnerBlocks malli.
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
Propi templateLock abil saad määrata, kas malli saab muuta.
| Väärtus | Kirjeldus |
|---|---|
contentOnly |
Keelab kõik toimingud. Sisuta plokitüübid peidetakse loendivaates. Alamplokid ei saa seda üle kirjutada. |
all |
Keelab kõik toimingud. Plokke ei saa lisada, teisaldada ega kustutada. |
insert |
Keelab plokkide lisamise ja eemaldamise, kuid võimaldab olemasolevaid plokke teisaldada. |
false |
Takistab lukustuse rakendamist isegi siis, kui emaplokil on lukustus. |
renderAppender
Propi renderAppender abil saad määrata ploki lisaja tüübi.
| Väärtus | Kirjeldus |
|---|---|
default |
Kuva vaikimisi ploki lisajat (lõigustiilis lisaja, kui lõigublokk on lubatud) |
button |
Kuva lisajana + ikooniga nupp |
useBlockProps
useBlockProps eemaldab redaktoris komponendi InnerBlocks välise ümbrise. Lisateavet leiate useBlockProps dokumentatsioonist.
Kontekst
Registreerimine
Blockstudio toetab komponendi InnerBlocks konteksti. See võimaldab edastada andmeid ülemplokist alamplokkidele. Kuigi selle aluseks on WordPress tuuma kontekstimehhanism, pakub Blockstudio mugavamat API.
Selle asemel et määrata eraldi kõik kontekstis edastatavad atribuudid, saate lihtsalt tellida kõik ülemploki atribuudid.
Iga alamplokk saab oma ülemploki väärtused, sealhulgas redaktori esimesel eellaaditud renderdusel. Pakkuja väljade muutmine uuendab selle alamplokke redaktoris ka siis, kui eelmine renderdus on veel laadimisel. Eri pakkujate identsed alamplokid hoiavad kontekstitundlikud vahemällu salvestatud renderdused lahus.
Oletame, et teil on konteinerplokk seadistatud järgmiselt:
{
"$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"
}
]
}
}
Alamplokis kasutage plokimallis kõigile ülemploki atribuutidele juurdepääsuks lihtsalt atribuuti usesContext koos ülemploki nimega.
{
"$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
}
Mallid
Muutujad $context ja $c on plokimallides saadaval kõigile ülemploki atribuutidele juurdepääsuks. Kui ülemploki andmed muutuvad, laaditakse alamplokid redaktoris automaatselt uuesti.
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>
Esikülje ümbris
InnerBlocks peab redaktoris renderdama alamplokkide ümber ümbriselemendi, kuid filtri blockstudio/blocks/components/inner_blocks/frontend/wrap abil saab selle esiküljelt eemaldada.
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
return false; // Remove wrapper
}, 10, 2);
Varajane tagastamine
Kui soovite ploki meetodist render ennetähtaegselt väljuda, kontrollige, kas muutuja $innerBlocks on tühi. See on kasulik, kui te ei soovi midagi renderdada, kui sisemisi plokke pole.
<?php if (strip_tags($innerBlocks) === '') {
return;
} ?>
<InnerBlocks tag="section" />
Kuna <InnerBlocks/> renderdab alati tühja lõigumärgendi, saate sisu tühjuse kontrollimiseks kasutada funktsiooni strip_tags.
Dünaamilised mallid
Väljatüübid Select ja Radio toetavad malli InnerBlocks dünaamilist loomist olenevalt välja väärtusest. See on kasulik, kui soovite lubada kasutajal valida komponendile InnerBlocks teise malli.
Selleks lisage lihtsalt malliga võti innerBlocks suvandite massiivi:
{
"$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"
}
]
}
}
Vaadake, kuidas ülem- ja alamplokid konteksti abil andmeid jagavad.