InnerBlocks
Indre blokke giver dig mulighed for at indsætte flere blokke i dine blokke. Bag kulisserne bruger Blockstudio komponenten InnerBlocks. Bemærk, at det kun er muligt at bruge én InnerBlocks-komponent pr. blok; dette er en WordPress-begrænsning.
Grundlæggende brug
Brug InnerBlocks ved at føje komponenten <InnerBlocks /> til din blokskabelon:
<InnerBlocks />
Sammensætningen bestemmer du selv. Du kan indlejre komponenten InnerBlocks så dybt, du vil, eller bruge den alene.
Egenskaber
allowedBlocks
Egenskaben allowedBlocks lader dig bestemme, hvilke blokke der kan indsættes i komponenten 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 accepterer også tokens, der udvides på serveren. Tokens udvides, før editoren modtager skabelonen, mens bogstavelige bloknavne forbliver uændrede.
| Token | Beskrivelse |
|---|---|
namespace/* |
Alle registrerede blokke i det pågældende navnerum |
category:<slug> |
Alle registrerede blokke i den pågældende blokkategori WordPress |
@theme |
Alle Blockstudio-blokke, der er registreret fra det aktive tema |
Udvidede poster deduplikeres i forfatterrækkefølge:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Tokens, der ikke svarer til nogen blokke, ignoreres. Output på frontend forbliver uændret,
fordi allowedBlocks kun bruges af editoren.
tag
Som standard gengives komponenten InnerBlocks som et div-element. Du kan
ændre dette med egenskaben tag.
<InnerBlocks tag="section" />
template
Egenskaben template lader dig definere en skabelon til komponenten 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
Egenskaben templateLock lader dig bestemme, om skabelonen kan ændres eller
ikke.
| Værdi | Beskrivelse |
|---|---|
contentOnly |
Forhindrer alle handlinger. Bloktyper uden indhold skjules i listevisningen. Kan ikke tilsidesættes af underordnede blokke. |
all |
Forhindrer alle handlinger. Blokke kan ikke indsættes, flyttes eller slettes. |
insert |
Forhindrer indsættelse eller fjernelse af blokke, men tillader flytning af eksisterende blokke. |
false |
Forhindrer låsning, selvom en overordnet blok indeholder en låsning. |
renderAppender
Egenskaben renderAppender lader dig definere typen af bloktilføjer.
| Værdi | Beskrivelse |
|---|---|
default |
Vis standardbloktilføjelsen (tilføjelse i afsnitsstil, når afsnitsblokke er tilladt) |
button |
Vis en knap med et +-ikon som tilføjelse |
useBlockProps
useBlockProps fjerner den ydre wrapper omkring komponenten InnerBlocks i editoren. Se useBlockProps for at få flere oplysninger.
Kontekst
Registrering
Blockstudio understøtter kontekst for komponenten InnerBlocks. Det gør det muligt at videregive data fra den overordnede blok til underordnede blokke. Selvom den bruger kernens WordPress-mekanisme til kontekst i baggrunden, tilbyder Blockstudio en mere praktisk API.
I stedet for at definere alle attributter, der skal videregives i konteksten, hver for sig, kan du blot abonnere på alle attributterne i en overordnet blok.
Hver underordnet blok modtager værdierne fra sin egen overordnede blok, også ved editorens første forhåndsindlæste gengivelse. Når en udbyders felter opdateres, opdateres dens underordnede blokke i editoren, selv mens en tidligere gengivelse stadig indlæses. Identiske underordnede blokke under forskellige udbydere bevarer separate kontekstbevidste cachelagrede gengivelser.
Lad os sige, at du har konfigureret en containerblok sådan her:
{
"$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"
}
]
}
}
I din underordnede blok skal du blot bruge egenskaben usesContext sammen med navnet på den overordnede blok for at få adgang til alle dens attributter i din blokskabelon.
{
"$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
}
Skabeloner
Variablerne $context og $c er tilgængelige i dine blokskabeloner, så du kan få adgang til alle attributter i den overordnede blok. Underordnede blokke genindlæses automatisk i editoren, hvis dataene i den overordnede blok ændres.
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>
Wrapper i frontend
InnerBlocks skal gengive et wrapper-element omkring sine underordnede elementer i editoren, men det kan fjernes fra frontend med filteret 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);
Returnér tidligt
Hvis du vil returnere tidligt fra metodrender i din blok, kan du kontrollere, om variablen $innerBlocks er tom. Det er nyttigt, hvis du ikke vil gengive noget, når der ikke er nogen indre blokke.
<?php if (strip_tags($innerBlocks) === '') {
return;
} ?>
<InnerBlocks tag="section" />
Da <InnerBlocks/> altid gengiver et tomt afsnitstag, kan du bruge funktionen strip_tags til at kontrollere, om indholdet er tomt.
Dynamiske skabeloner
Felttyperne Select og Radio understøtter dynamisk generering af skabelonen InnerBlocks afhængigt af feltværdien. Det er nyttigt, hvis du vil lade brugeren vælge en anden skabelon til komponenten InnerBlocks.
Tilføj blot en nøgle innerBlocks til indstillingsarrayet med skabelonen:
{
"$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"
}
]
}
}
Lær, hvordan overordnede og underordnede blokke deler data via kontekst.