InnerBlocks
Iekšējie bloki ļauj ievietot papildu blokus savos blokos. Aizkulisēs Blockstudio izmanto komponentu InnerBlocks. Ņemiet vērā, ka katrā blokā var izmantot tikai vienu InnerBlocks komponentu — tā ir WordPress ierobežojums.
Pamata lietojums
Lai izmantotu InnerBlocks, pievienojiet komponentu <InnerBlocks /> sava bloka veidnei:
<InnerBlocks />
Jūs varat izvēlēties kompozīciju. Varat ligzdot komponentu InnerBlocks tik dziļi, cik vēlaties, vai arī izmantot to atsevišķi.
Rekvizīti
allowedBlocks
Īpašība allowedBlocks ļauj noteikt, kurus blokus var ievietot 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 pieņem arī serverī izvēršamus marķierus. Marķieri tiek izvērsti, pirms veidne nonāk redaktorā, bet burtiskie bloku nosaukumi paliek nemainīti.
| Marķieris | Apraksts |
|---|---|
namespace/* |
Katrs reģistrētais bloks attiecīgajā nosaukumvietā |
category:<slug> |
Katrs reģistrētais bloks attiecīgajā WordPress bloku kategorijā |
@theme |
Katrs aktīvā motīva reģistrētais Blockstudio bloks |
Izvērstie ieraksti tiek atdalīti no dublikātiem, saglabājot autora norādīto secību:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Marķieri, kas neatbilst nevienam blokam, tiek ignorēti. Priekšgala izvade nemainās,
jo allowedBlocks tiek izmantots tikai redaktorā.
tag
Pēc noklusējuma komponents InnerBlocks tiek renderēts kā div elements. To var
mainīt, izmantojot īpašību tag.
<InnerBlocks tag="section" />
template
Īpašība template ļauj definēt komponenta InnerBlocks veidni.
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
Īpašība templateLock ļauj noteikt, vai veidni drīkst modificēt.
| Vērtība | Apraksts |
|---|---|
contentOnly |
Novērš visas darbības. Bloku tipi bez satura tiek paslēpti saraksta skatā. Bērnelementi to nevar atcelt. |
all |
Novērš visas darbības. Blokus nevar ievietot, pārvietot vai dzēst. |
insert |
Novērš bloku ievietošanu vai noņemšanu, bet ļauj pārvietot esošos blokus. |
false |
Neļauj piemērot bloķēšanu pat tad, ja vecākbloks satur bloķēšanas iestatījumu. |
renderAppender
Īpašība renderAppender ļauj noteikt bloku pievienošanas pogas veidu.
| Vērtība | Apraksts |
|---|---|
default |
Rādīt noklusējuma bloka pievienotāju (rindkopas stila pievienotāju, ja ir atļauts rindkopas bloks) |
button |
Rādīt pogu ar + ikonu kā pievienotāju |
useBlockProps
useBlockProps noņems komponenta InnerBlocks ārējo ietvaru
redaktorā. Plašāku informāciju skatiet useBlockProps.
Konteksts
Reģistrēšana
Blockstudio atbalsta komponenta InnerBlocks kontekstu. Tas ļauj
nodot datus no vecākbloka pakārtotajiem blokiem. Iekšēji tiek izmantots WordPress
kodola konteksta mehānisms,
bet Blockstudio piedāvā ērtāku API.
Tā vietā, lai atsevišķi definētu visus atribūtus, kas jānodod kontekstā, varat vienkārši abonēt visus vecākbloka atribūtus.
Katrs pakārtotais bloks saņem sava vecākbloka vērtības, tostarp pirmajā iepriekš ielādētajā renderēšanas reizē redaktorā. Atjauninot nodrošinātāja laukus, tiek atjaunināti arī tā pakārtotie bloki redaktorā, pat ja iepriekšējā renderēšana vēl tiek ielādēta. Identiski pakārtotie bloki pie dažādiem nodrošinātājiem saglabā atsevišķus kontekstu zinošus kešotos renderējumus.
Pieņemsim, ka jums ir šāda konteinera bloka konfigurācija:
{
"$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"
}
]
}
}
Pakārtotajā blokā vienkārši izmantojiet rekvizītu usesContext kopā ar vecākbloka
nosaukumu, lai bloka veidnē piekļūtu visiem vecākbloka atribūtiem.
{
"$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
}
Veidnes
Bloku veidnēs ir pieejami mainīgie $context un $c, lai
piekļūtu visiem vecākbloka atribūtiem. Ja vecākbloka dati mainās, pakārtotie bloki
redaktorā tiek automātiski ielādēti no jauna.
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>
Priekšgala ietvars
InnerBlocks redaktorā ap bērnblokiem ir jāattēlo ietverošs elements,
tomēr to var noņemt priekšgalā, izmantojot filtru
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);
Agrīna atgriešana
Ja bloka metodei render vēlaties veikt agrīnu atgriešanu, varat
pārbaudīt, vai mainīgais $innerBlocks ir tukšs. Tas noder, ja nevēlaties
attēlot neko, ja nav iekšējo bloku.
<?php if (strip_tags($innerBlocks) === '') {
return;
} ?>
<InnerBlocks tag="section" />
Tā kā <InnerBlocks/> vienmēr attēlo tukšu rindkopas tagu, varat izmantot
funkciju strip_tags, lai pārbaudītu, vai saturs ir tukšs.
Dinamiskās veidnes
Lauku tipi Atlasīt un
Radio atbalsta dinamisku veidnes InnerBlocks
generēšanu atkarībā no lauka vērtības. Tas noder, ja vēlaties ļaut lietotājam
izvēlēties citu komponenta InnerBlocks veidni.
Lai to izdarītu, vienkārši pievienojiet opciju masīvam atslēgu innerBlocks ar veidni:
{
"$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"
}
]
}
}
Uzziniet, kā vecākbloki un pakārtotie bloki koplieto datus, izmantojot kontekstu.