Gå til indhold

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:

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

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

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

PHP
<InnerBlocks tag="section" />

template

Egenskaben template lader dig definere en skabelon til 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

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:

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

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
}

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

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.

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

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"
      }
    ]
  }
}

Blokkontekst og kommunikation

Lær, hvordan overordnede og underordnede blokke deler data via kontekst.