InnerBlocks
Inre block låter dig infoga fler block i dina block. Bakom kulisserna använder Blockstudio komponenten InnerBlocks. Observera att det bara går att använda en InnerBlocks-komponent per block; detta är en begränsning i WordPress.
Grundläggande användning
Lägg till komponenten <InnerBlocks /> i blockmallen för att använda InnerBlocks:
<InnerBlocks />
Du väljer själv hur den ska sättas samman. Du kan nästla komponenten InnerBlocks så djupt du vill, eller använda den fristående.
Egenskaper
allowedBlocks
Med egenskapen allowedBlocks kan du ange vilka block som får infogas 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 godtar även tokens som expanderas på servern. Tokens expanderas innan redigeraren tar emot mallen, medan bokstavliga blocknamn förblir oförändrade.
| Token | Beskrivning |
|---|---|
namespace/* |
Alla registrerade block i namnrymden |
category:<slug> |
Alla registrerade block i den blockkategori för WordPress |
@theme |
Alla Blockstudio-block som är registrerade från det aktiva temat |
Expanderade poster tas bort från dubbletter i författarens ordning:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Tokens som inte motsvarar några block ignoreras. Utdata i frontend förblir oförändrad, eftersom allowedBlocks bara används i redigeraren.
tagg
Som standard renderas komponenten InnerBlocks som ett div-element. Du kan ändra detta med egenskapen tag.
<InnerBlocks tag="section" />
mall
Med egenskapen template kan du definiera en mall för 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
Med egenskapen templateLock kan du ange om mallen får ändras eller inte.
| Värde | Beskrivning |
|---|---|
contentOnly |
Förhindrar alla åtgärder. Blocktyper utan innehåll döljs från listvyn. Barn kan inte åsidosätta detta. |
all |
Förhindrar alla åtgärder. Det går inte att infoga, flytta eller ta bort block. |
insert |
Förhindrar att block infogas eller tas bort, men tillåter att befintliga block flyttas. |
false |
Förhindrar att låsning tillämpas även om ett överordnat block innehåller låsning. |
renderAppender
Med egenskapen renderAppender kan du ange vilken typ av blocktillägg som ska användas.
| Värde | Beskrivning |
|---|---|
default |
Visa standardtillägget för block (tillägg med styckeformat när styckeblock är tillåtet) |
button |
Visa en knapp med +-ikon som tillägg |
useBlockProps
useBlockProps tar bort den yttre omslutningen av komponenten InnerBlocks
i redigeraren. Se useBlockProps för mer information.
Kontext
Registrering
Blockstudio stöder kontext för komponenten InnerBlocks. Det gör att du kan
skicka data från föräldrablocket till underordnade block. Även om det internt
använder WordPress kärnmekanism för WordPresskontext
ger Blockstudio ett smidigare API.
I stället för att separat behöva definiera alla attribut som ska skickas i kontexten kan du helt enkelt prenumerera på alla attribut i ett föräldrablock.
Varje underordnat block får värden från sin egen förälder, även vid redigerarens första förladdade återgivning. När en leverantörs fält uppdateras uppdateras dess underordnade block i redigeraren, även medan en tidigare återgivning fortfarande läses in. Identiska underordnade block hos olika leverantörer behåller separata cachade återgivningar som tar hänsyn till kontexten.
Anta att du har konfigurerat ett behållarblock så här:
{
"$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 det underordnade blocket använder du helt enkelt egenskapen usesContext med
föräldrablockets namn för att komma åt alla förälderns attribut i blockmallen.
{
"$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
}
Mallar
Variablerna $context och $c är tillgängliga i blockmallarna för att
komma åt alla attribut i föräldern. Underordnade block läses automatiskt in på
nytt i redigeraren om förälderns data ändras.
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>
Omslutning i frontend
InnerBlocks måste återge ett omslutande element runt sina underordnade element i
redigeraren, men det kan tas bort från frontend med filtret
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);
Avsluta tidigt
Om du vill avsluta metoden render för ditt block i förtid kan du
kontrollera om variabeln $innerBlocks är tom. Det är användbart om du inte vill
återge något när det saknas inre block.
<?php if (strip_tags($innerBlocks) === '') {
return;
} ?>
<InnerBlocks tag="section" />
Eftersom <InnerBlocks/> alltid återger en tom stycketagg kan du använda
funktionen strip_tags för att kontrollera om innehållet är tomt.
Dynamiska mallar
Fälttyperna Välj och
Radio stöder dynamisk generering av mallen InnerBlocks
utifrån fältvärdet. Det är användbart om du vill låta användaren välja en annan
mall för komponenten InnerBlocks.
Lägg helt enkelt till en nyckel innerBlocks i alternativarrayen tillsammans med mallen:
{
"$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"
}
]
}
}
Blockkontext och kommunikation
Lär dig hur föräldra- och underordnade block delar data via kontext.