InnerBlocks
Vidiniai blokai leidžia įterpti papildomų blokų į savo blokus. Po gaubtu Blockstudio naudoja komponentą InnerBlocks. Atminkite, kad viename bloke galima naudoti tik vieną InnerBlocks komponentą, tai yra WordPress apribojimas.
Pagrindinis naudojimas
Norėdami naudoti InnerBlocks, įtraukite komponentą <InnerBlocks /> į savo bloko šabloną:
<InnerBlocks />
Komponentų išdėstymas priklauso nuo jūsų. Komponentą InnerBlocks galite įdėti tiek giliai, kiek norite, arba naudoti jį vieną.
Savybės
allowedBlocks
Savybė allowedBlocks leidžia apibrėžti, kuriuos blokus galima įterpti į komponentą 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 taip pat priima serverio išplečiamus žetonus. Žetonai išplečiami prieš šabloną perduodant redaktoriui, o pažodiniai blokų pavadinimai lieka nepakeisti.
| Žetonas | Aprašymas |
|---|---|
namespace/* |
Visi registruoti blokai toje vardų srityje |
category:<slug> |
Visi registruoti blokai toje WordPress blokų kategorijoje |
@theme |
Visi aktyviojoje temoje registruoti Blockstudio blokai |
Išplėsti įrašai surūšiuojami pagal autoriaus nurodytą tvarką, o dublikatai pašalinami:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Žetonai, kurie neatitinka jokių blokų, ignoruojami. Sąsajos išvestis nesikeičia, nes allowedBlocks naudojamas tik redaktoriuje.
žyma
Pagal numatytuosius nustatymus komponentas InnerBlocks atvaizduojamas kaip elementas div. Tai galite pakeisti naudodami savybę tag.
<InnerBlocks tag="section" />
šablonas
Savybė template leidžia apibrėžti komponento InnerBlocks šabloną.
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
Savybė templateLock leidžia nurodyti, ar šabloną galima keisti.
| Reikšmė | Aprašymas |
|---|---|
contentOnly |
Užkerta kelią visoms operacijoms. Blokų tipai be turinio paslepiami sąrašo rodinyje. Vaikai šio nustatymo negali perrašyti. |
all |
Užkerta kelią visoms operacijoms. Blokų negalima įterpti, perkelti ar ištrinti. |
insert |
Neleidžia įterpti ar pašalinti blokų, tačiau esamus galima perkelti. |
false |
Neleidžia taikyti užrakinimo, net jei užraktas nustatytas tėviniame bloke. |
renderAppender
Savybė renderAppender leidžia apibrėžti bloko pridėjimo priemonės tipą.
| Reikšmė | Aprašymas |
|---|---|
default |
Rodyti numatytąjį bloko pridėjimo mygtuką (pastraipos stiliaus mygtuką, jei leidžiamas pastraipos blokas) |
button |
Rodyti mygtuką su + piktograma kaip pridėjimo mygtuką |
useBlockProps
useBlockProps pašalins išorinį komponento InnerBlocks apvalkalą
redaktoriuje. Daugiau informacijos rasite useBlockProps.
Kontekstas
Registravimas
Blockstudio palaiko komponento InnerBlocks kontekstą. Taip galima perduoti duomenis iš pirminio bloko antriniams blokams. Nors viduje naudojamas pagrindinis WordPress
konteksto mechanizmas, Blockstudio suteikia patogesnę API.
Užuot atskirai apibrėžę visus kontekste perduodamus atributus, galite tiesiog prenumeruoti visus pirminio bloko atributus.
Kiekvienas antrinis blokas gauna savo pirminio bloko reikšmes, įskaitant pirmąjį iš anksto įkeltą atvaizdavimą redaktoriuje. Atnaujinus teikėjo laukus, atnaujinami ir jo antriniai blokai redaktoriuje, net jei ankstesnis atvaizdavimas vis dar įkeliamas. Vienodi antriniai blokai, priklausantys skirtingiems teikėjams, išsaugo atskirai talpykloje saugomus, kontekstą atitinkančius atvaizdavimus.
Tarkime, turite tokią konteinerio bloko sąranką:
{
"$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"
}
]
}
}
Antriniame bloke tiesiog naudokite savybę usesContext su pirminio
bloko pavadinimu, kad bloko šablone galėtumėte pasiekti visus pirminio bloko atributus.
{
"$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
}
Šablonai
Kintamieji $context ir $c pasiekiami bloko šablonuose ir leidžia
pasiekti visus pirminio bloko atributus. Pasikeitus pirminio bloko duomenims, antriniai blokai redaktoriuje įkeliami iš naujo automatiškai.
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>
Išorinis apvalkalas
InnerBlocks redaktoriuje turi aplink antrinius elementus pateikti apvalkalo elementą, tačiau jį galima pašalinti iš viešosios svetainės dalies naudojant filtrą 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);
Ankstyvas grąžinimas
Jei norite anksti grįžti iš bloko metodo render, galite
patikrinti, ar kintamasis $innerBlocks tuščias. Tai naudinga, jei nenorite nieko atvaizduoti, kai nėra vidinių blokų.
<?php if (strip_tags($innerBlocks) === '') {
return;
} ?>
<InnerBlocks tag="section" />
Kadangi <InnerBlocks/> visada atvaizduoja tuščią pastraipos žymą, galite naudoti
funkciją strip_tags, kad patikrintumėte, ar turinys tuščias.
Dinaminiai šablonai
Laukų tipai Pasirinkimas ir
Radijo mygtukas leidžia dinamiškai generuoti šabloną InnerBlocks pagal lauko reikšmę. Tai naudinga, jei norite leisti naudotojui pasirinkti kitą komponento InnerBlocks šabloną.
Tam tiesiog įtraukite raktą innerBlocks į parinkčių masyvą kartu su šablonu:
{
"$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"
}
]
}
}
Blokų kontekstas ir komunikacija
Sužinokite, kaip pirminiai ir antriniai blokai dalijasi duomenimis naudodami kontekstą.