Hoppa till innehåll

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:

PHP
<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

PHP
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode(['core/heading', 'core/paragraph'])); ?>" />

Twig

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:

PHP
<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.

PHP
<InnerBlocks tag="section" />

mall

Med egenskapen template kan du definiera en mall för komponenten InnerBlocks.

PHP

PHP
<InnerBlocks template="<?php echo esc_attr(wp_json_encode([
  ['core/heading', ['placeholder' => 'Book Title']],
  ['core/paragraph', ['placeholder' => 'Summary']]
])); ?>" />

Twig

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:

JSON
{
  "$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.

JSON
{
  "$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
<?php $container = $context['blockstudio/container']; ?>

<h1>
  <?php echo $container['full-width']
      ? 'is full width'
      : 'no full width'; ?>
</h1>

Twig

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.

PHP
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
<?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:

JSON
{
  "$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.