InnerBlocks
Blocurile interioare vă permit să inserați blocuri suplimentare în blocurile dvs. În culise, Blockstudio folosește componenta InnerBlocks. Rețineți că se poate folosi o singură componentă InnerBlocks per bloc; aceasta este o limitare WordPress.
Utilizare de bază
Pentru a folosi InnerBlocks, adăugați componenta <InnerBlocks /> la șablonul blocului:
<InnerBlocks />
Compoziția vă aparține. Puteți imbrica componenta InnerBlocks cât de adânc doriți sau o puteți folosi singură.
Proprietăți
allowedBlocks
Proprietatea allowedBlocks vă permite să definiți ce blocuri pot fi inserate în componenta 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 acceptă și tokenuri extinse pe server. Tokenurile sunt extinse înainte ca editorul să primească șablonul, iar numele literale ale blocurilor rămân neschimbate.
| Token | Descriere |
|---|---|
namespace/* |
Fiecare bloc înregistrat în acel spațiu de nume |
category:<slug> |
Fiecare bloc înregistrat din categoria de blocuri WordPress respectivă |
@theme |
Fiecare bloc Blockstudio înregistrat din tema activă |
Elementele extinse sunt deduplicate în ordinea autorului:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Tokenurile care nu corespund niciunui bloc sunt ignorate. Rezultatul frontend rămâne neschimbat, deoarece allowedBlocks este folosit doar de editor.
tag
În mod implicit, componenta InnerBlocks este randată ca element div. Puteți schimba acest lucru folosind proprietatea tag.
<InnerBlocks tag="section" />
șablon
Proprietatea template vă permite să definiți un șablon pentru componenta 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
Proprietatea templateLock vă permite să definiți dacă șablonul poate fi modificat.
| Valoare | Descriere |
|---|---|
contentOnly |
Împiedică toate operațiunile. Tipurile de bloc fără conținut sunt ascunse din vizualizarea listei. Nu poate fi suprascris de blocurile copil. |
all |
Împiedică toate operațiunile. Blocurile nu pot fi inserate, mutate sau șterse. |
insert |
Împiedică inserarea sau eliminarea blocurilor, dar permite mutarea celor existente. |
false |
Împiedică aplicarea blocării chiar dacă un bloc părinte conține o blocare. |
renderAppender
Proprietatea renderAppender vă permite să definiți tipul de adăugare a blocurilor.
| Valoare | Descriere |
|---|---|
default |
Afișează adăugătorul implicit de blocuri (adăugătorul în stil paragraf când este permis blocul paragraf) |
button |
Afișează un buton cu pictograma + ca adăugător |
useBlockProps
useBlockProps va elimina învelișul exterior al componentei InnerBlocks
în editor. Consultați useBlockProps pentru mai multe informații.
Context
Înregistrare
Blockstudio acceptă context pentru componenta InnerBlocks. Astfel, puteți
transmite date din blocul părinte către blocurile copil. Deși folosește mecanismul
WordPress de context
nativ din nucleu, Blockstudio oferă o API mai convenabilă.
În loc să definiți separat toate atributele care trebuie transmise în context, vă puteți abona pur și simplu la toate atributele unui bloc părinte.
Fiecare bloc copil primește valorile propriului părinte, inclusiv la prima randare preîncărcată în editor. Actualizarea câmpurilor unui furnizor actualizează blocurile copil în editor, chiar și cât timp o randare anterioară încă se încarcă. Blocurile copil identice, aflate sub furnizori diferiți, păstrează randări memorate în cache separat, în funcție de context.
Să presupunem că aveți o configurație de bloc container, precum aceasta:
{
"$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"
}
]
}
}
În blocul copil, folosiți pur și simplu proprietatea usesContext împreună cu numele
blocului părinte pentru a accesa toate atributele părintelui în șablonul blocului.
{
"$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
}
Șabloane
Variabilele $context și $c sunt disponibile în șabloanele blocurilor
pentru a accesa toate atributele părintelui. Blocurile copil se reîncarcă automat în
editor dacă se modifică datele părintelui.
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>
Învelișul frontend
InnerBlocks trebuie să redea un element învelitor în jurul blocurilor copil în
editor, însă acesta poate fi eliminat din frontend folosind filtrul
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);
Returnare anticipată
Dacă doriți să returnați anticipat din metoda render a blocului, puteți
verifica dacă variabila $innerBlocks este goală. Acest lucru este util dacă nu
doriți să redați nimic atunci când nu există blocuri interioare.
<?php if (strip_tags($innerBlocks) === '') {
return;
} ?>
<InnerBlocks tag="section" />
Deoarece <InnerBlocks/> va reda întotdeauna o etichetă de paragraf goală, puteți folosi
funcția strip_tags pentru a verifica dacă conținutul este gol.
Șabloane dinamice
Tipurile de câmp Select și
Radio permit generarea dinamică a șablonului InnerBlocks
în funcție de valoarea câmpului. Acest lucru este util dacă doriți să permiteți
utilizatorului să selecteze un alt șablon pentru componenta InnerBlocks.
Pentru aceasta, adăugați pur și simplu o cheie innerBlocks în matricea de opțiuni, împreună cu șablonul:
{
"$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"
}
]
}
}
Contextul și comunicarea între blocuri
Aflați cum partajează date blocurile părinte și copil folosind contextul.