InnerBlocks
Notranji bloki omogočajo vstavljanje dodatnih blokov v vaše bloke. V ozadju Blockstudio uporablja komponento InnerBlocks. Upoštevajte, da je v posameznem bloku mogoče uporabiti samo eno komponento InnerBlocks; to je omejitev WordPress.
Osnovna uporaba
Če želite uporabiti InnerBlocks, dodajte komponento <InnerBlocks /> v predlogo bloka:
<InnerBlocks />
Sestava je prepuščena vam. Komponento InnerBlocks lahko ugnezdite poljubno globoko ali pa jo uporabite samostojno.
Lastnosti
allowedBlocks
Lastnost allowedBlocks omogoča določitev blokov, ki jih je mogoče vstaviti v komponento 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 sprejema tudi žetone, razširjene na strežniku. Žetoni se razširijo, preden predloga prispe do urejevalnika, medtem ko dobesedna imena blokov ostanejo nespremenjena.
| Žeton | Opis |
|---|---|
namespace/* |
Vsak registriran blok v tem imenskem prostoru |
category:<slug> |
Vsak registriran blok v tej kategoriji blokov WordPress |
@theme |
Vsak blok Blockstudio, registriran iz aktivne teme |
Razširjeni vnosi se odstranijo kot dvojniki po vrstnem redu avtorja:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Žetoni, ki se ne razrešijo v noben blok, so prezrti. Izhod na sprednjem delu ostane nespremenjen, ker allowedBlocks uporablja samo urejevalnik.
oznaka
Komponenta InnerBlocks se privzeto izriše kot element div. To lahko spremenite z lastnostjo tag.
<InnerBlocks tag="section" />
predloga
Lastnost template omogoča določitev predloge za komponento 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
Lastnost templateLock omogoča določitev, ali je predlogo mogoče spreminjati.
| Vrednost | Opis |
|---|---|
contentOnly |
Prepreči vse operacije. Vrste blokov brez vsebine so v pogledu seznama skrite. Podrejeni bloki tega ne morejo preglasiti. |
all |
Prepreči vse operacije. Blokov ni mogoče vstaviti, premakniti ali izbrisati. |
insert |
Prepreči vstavljanje ali odstranjevanje blokov, vendar omogoča premikanje obstoječih. |
false |
Prepreči uporabo zaklepanja, tudi če nadrejeni blok vsebuje nastavitev zaklepanja. |
renderAppender
Lastnost renderAppender omogoča določitev vrste dodajalnika blokov.
| Vrednost | Opis |
|---|---|
default |
Prikaže privzeti dodatek bloka (dodatek v slogu odstavka, kadar je dovoljen blok odstavka) |
button |
Prikaže gumb z ikono + kot dodatek |
useBlockProps
useBlockProps bo odstranil zunanji ovoj komponente InnerBlocks
v urejevalniku. Za več informacij glejte useBlockProps.
Kontekst
Registracija
Blockstudio podpira kontekst za komponento InnerBlocks. To vam omogoča, da posredujete podatke iz nadrejenega bloka podrejenim blokom. Čeprav v ozadju uporablja mehanizem za kontekst jedra , Blockstudio ponuja priročnejši API. WordPress
Namesto da bi morali ločeno določiti vse atribute, ki jih želite posredovati v kontekstu, se lahko preprosto naročite na vse atribute nadrejenega bloka.
Vsak podrejeni blok prejme vrednosti svojega nadrejenega bloka, tudi pri prvem vnaprej naloženem izrisu v urejevalniku. Posodobitev polj ponudnika posodobi njegove podrejene bloke v urejevalniku, tudi če se še nalaga prejšnji izris. Enaki podrejeni bloki pri različnih ponudnikih ohranijo ločene predpomnjene izrise, ki upoštevajo kontekst.
Recimo, da imate nastavljen vsebniški blok, kot sledi:
{
"$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 podrejenem bloku preprosto uporabite lastnost usesContext z imenom
nadrejenega bloka, da v predlogi bloka dostopate do vseh atributov nadrejenega bloka.
{
"$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
}
Predloge
Spremenljivki $context in $c sta na voljo v predlogah blokov
za dostop do vseh atributov nadrejenega bloka. Podrejeni bloki se bodo v urejevalniku
samodejno znova naložili, če se podatki nadrejenega bloka spremenijo.
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>
Ovoj na spletnem mestu
InnerBlocks mora v urejevalniku okoli svojih podrejenih elementov izrisati ovoj,
lahko pa ga s filtrom blockstudio/blocks/components/inner_blocks/frontend/wrap odstranite na spletnem mestu.
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
return false; // Remove wrapper
}, 10, 2);
Zgodnja vrnitev
Če želite iz metode render bloka predčasno vrniti rezultat, lahko
preverite, ali je spremenljivka $innerBlocks prazna. To je uporabno, če ne želite
izrisati ničesar, kadar ni notranjih blokov.
<?php if (strip_tags($innerBlocks) === '') {
return;
} ?>
<InnerBlocks tag="section" />
Ker bo <InnerBlocks/> vedno izrisal prazno oznako odstavka, lahko s funkcijo
strip_tags preverite, ali je vsebina prazna.
Dinamične predloge
Vrsti polj Izbirni seznam in
Izbirni gumbi podpirata dinamično
ustvarjanje predloge InnerBlocks glede na vrednost polja. To je
uporabno, če želite uporabniku omogočiti izbiro druge predloge za komponento
InnerBlocks.
To storite tako, da matriki možnosti preprosto dodate ključ innerBlocks s predlogo:
{
"$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 blokov in komunikacija
Naučite se, kako si nadrejeni in podrejeni bloki delijo podatke prek konteksta.