Treci la conținut

InnerBlocks

Blocurile interioare vă permit să inserați blocuri suplimentare în blocurile dvs. În culise, Blockstudio folosește componenta InnerBlocks. Rețineți că se poate folosi o singură componentă InnerBlocks per bloc; aceasta este o limitare WordPress.

Utilizare de bază

Pentru a folosi InnerBlocks, adăugați componenta <InnerBlocks /> la șablonul blocului:

PHP
<InnerBlocks />

Compoziția vă aparține. Puteți imbrica componenta InnerBlocks cât de adânc doriți sau o puteți folosi singură.

Proprietăți

allowedBlocks

Proprietatea allowedBlocks vă permite să definiți ce blocuri pot fi inserate în componenta 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 acceptă și tokenuri extinse pe server. Tokenurile sunt extinse înainte ca editorul să primească șablonul, iar numele literale ale blocurilor rămân neschimbate.

Token Descriere
namespace/* Fiecare bloc înregistrat în acel spațiu de nume
category:<slug> Fiecare bloc înregistrat din categoria de blocuri WordPress respectivă
@theme Fiecare bloc Blockstudio înregistrat din tema activă

Elementele extinse sunt deduplicate în ordinea autorului:

PHP
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
  'core/paragraph',
  'category:content',
  'bsui/field',
])); ?>" />

Tokenurile care nu corespund niciunui bloc sunt ignorate. Rezultatul frontend rămâne neschimbat, deoarece allowedBlocks este folosit doar de editor.

tag

În mod implicit, componenta InnerBlocks este randată ca element div. Puteți schimba acest lucru folosind proprietatea tag.

PHP
<InnerBlocks tag="section" />

șablon

Proprietatea template vă permite să definiți un șablon pentru componenta 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

Proprietatea templateLock vă permite să definiți dacă șablonul poate fi modificat.

Valoare Descriere
contentOnly Împiedică toate operațiunile. Tipurile de bloc fără conținut sunt ascunse din vizualizarea listei. Nu poate fi suprascris de blocurile copil.
all Împiedică toate operațiunile. Blocurile nu pot fi inserate, mutate sau șterse.
insert Împiedică inserarea sau eliminarea blocurilor, dar permite mutarea celor existente.
false Împiedică aplicarea blocării chiar dacă un bloc părinte conține o blocare.

renderAppender

Proprietatea renderAppender vă permite să definiți tipul de adăugare a blocurilor.

Valoare Descriere
default Afișează adăugătorul implicit de blocuri (adăugătorul în stil paragraf când este permis blocul paragraf)
button Afișează un buton cu pictograma + ca adăugător

useBlockProps

useBlockProps va elimina învelișul exterior al componentei InnerBlocks în editor. Consultați useBlockProps pentru mai multe informații.

Context

Înregistrare

Blockstudio acceptă context pentru componenta InnerBlocks. Astfel, puteți transmite date din blocul părinte către blocurile copil. Deși folosește mecanismul WordPress de context nativ din nucleu, Blockstudio oferă o API mai convenabilă.

În loc să definiți separat toate atributele care trebuie transmise în context, vă puteți abona pur și simplu la toate atributele unui bloc părinte.

Fiecare bloc copil primește valorile propriului părinte, inclusiv la prima randare preîncărcată în editor. Actualizarea câmpurilor unui furnizor actualizează blocurile copil în editor, chiar și cât timp o randare anterioară încă se încarcă. Blocurile copil identice, aflate sub furnizori diferiți, păstrează randări memorate în cache separat, în funcție de context.

Să presupunem că aveți o configurație de bloc container, precum aceasta:

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

În blocul copil, folosiți pur și simplu proprietatea usesContext împreună cu numele blocului părinte pentru a accesa toate atributele părintelui în șablonul blocului.

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
}

Șabloane

Variabilele $context și $c sunt disponibile în șabloanele blocurilor pentru a accesa toate atributele părintelui. Blocurile copil se reîncarcă automat în editor dacă se modifică datele părintelui.

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>

Învelișul frontend

InnerBlocks trebuie să redea un element învelitor în jurul blocurilor copil în editor, însă acesta poate fi eliminat din frontend folosind filtrul 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);

Returnare anticipată

Dacă doriți să returnați anticipat din metoda render a blocului, puteți verifica dacă variabila $innerBlocks este goală. Acest lucru este util dacă nu doriți să redați nimic atunci când nu există blocuri interioare.

PHP
<?php if (strip_tags($innerBlocks) === '') {
  return;
} ?>
<InnerBlocks tag="section" />

Deoarece <InnerBlocks/> va reda întotdeauna o etichetă de paragraf goală, puteți folosi funcția strip_tags pentru a verifica dacă conținutul este gol.

Șabloane dinamice

Tipurile de câmp Select și Radio permit generarea dinamică a șablonului InnerBlocks în funcție de valoarea câmpului. Acest lucru este util dacă doriți să permiteți utilizatorului să selecteze un alt șablon pentru componenta InnerBlocks.

Pentru aceasta, adăugați pur și simplu o cheie innerBlocks în matricea de opțiuni, împreună cu șablonul:

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

Contextul și comunicarea între blocuri

Aflați cum partajează date blocurile părinte și copil folosind contextul.