Pereiti prie turinio

InnerBlocks

Vidiniai blokai leidžia įterpti papildomų blokų į savo blokus. Po gaubtu Blockstudio naudoja komponentą InnerBlocks. Atminkite, kad viename bloke galima naudoti tik vieną InnerBlocks komponentą, tai yra WordPress apribojimas.

Pagrindinis naudojimas

Norėdami naudoti InnerBlocks, įtraukite komponentą <InnerBlocks /> į savo bloko šabloną:

PHP
<InnerBlocks />

Komponentų išdėstymas priklauso nuo jūsų. Komponentą InnerBlocks galite įdėti tiek giliai, kiek norite, arba naudoti jį vieną.

Savybės

allowedBlocks

Savybė allowedBlocks leidžia apibrėžti, kuriuos blokus galima įterpti į komponentą 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 taip pat priima serverio išplečiamus žetonus. Žetonai išplečiami prieš šabloną perduodant redaktoriui, o pažodiniai blokų pavadinimai lieka nepakeisti.

Žetonas Aprašymas
namespace/* Visi registruoti blokai toje vardų srityje
category:<slug> Visi registruoti blokai toje WordPress blokų kategorijoje
@theme Visi aktyviojoje temoje registruoti Blockstudio blokai

Išplėsti įrašai surūšiuojami pagal autoriaus nurodytą tvarką, o dublikatai pašalinami:

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

Žetonai, kurie neatitinka jokių blokų, ignoruojami. Sąsajos išvestis nesikeičia, nes allowedBlocks naudojamas tik redaktoriuje.

žyma

Pagal numatytuosius nustatymus komponentas InnerBlocks atvaizduojamas kaip elementas div. Tai galite pakeisti naudodami savybę tag.

PHP
<InnerBlocks tag="section" />

šablonas

Savybė template leidžia apibrėžti komponento InnerBlocks šabloną.

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

Savybė templateLock leidžia nurodyti, ar šabloną galima keisti.

Reikšmė Aprašymas
contentOnly Užkerta kelią visoms operacijoms. Blokų tipai be turinio paslepiami sąrašo rodinyje. Vaikai šio nustatymo negali perrašyti.
all Užkerta kelią visoms operacijoms. Blokų negalima įterpti, perkelti ar ištrinti.
insert Neleidžia įterpti ar pašalinti blokų, tačiau esamus galima perkelti.
false Neleidžia taikyti užrakinimo, net jei užraktas nustatytas tėviniame bloke.

renderAppender

Savybė renderAppender leidžia apibrėžti bloko pridėjimo priemonės tipą.

Reikšmė Aprašymas
default Rodyti numatytąjį bloko pridėjimo mygtuką (pastraipos stiliaus mygtuką, jei leidžiamas pastraipos blokas)
button Rodyti mygtuką su + piktograma kaip pridėjimo mygtuką

useBlockProps

useBlockProps pašalins išorinį komponento InnerBlocks apvalkalą redaktoriuje. Daugiau informacijos rasite useBlockProps.

Kontekstas

Registravimas

Blockstudio palaiko komponento InnerBlocks kontekstą. Taip galima perduoti duomenis iš pirminio bloko antriniams blokams. Nors viduje naudojamas pagrindinis WordPress konteksto mechanizmas, Blockstudio suteikia patogesnę API.

Užuot atskirai apibrėžę visus kontekste perduodamus atributus, galite tiesiog prenumeruoti visus pirminio bloko atributus.

Kiekvienas antrinis blokas gauna savo pirminio bloko reikšmes, įskaitant pirmąjį iš anksto įkeltą atvaizdavimą redaktoriuje. Atnaujinus teikėjo laukus, atnaujinami ir jo antriniai blokai redaktoriuje, net jei ankstesnis atvaizdavimas vis dar įkeliamas. Vienodi antriniai blokai, priklausantys skirtingiems teikėjams, išsaugo atskirai talpykloje saugomus, kontekstą atitinkančius atvaizdavimus.

Tarkime, turite tokią konteinerio bloko sąranką:

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

Antriniame bloke tiesiog naudokite savybę usesContext su pirminio bloko pavadinimu, kad bloko šablone galėtumėte pasiekti visus pirminio bloko atributus.

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
}

Šablonai

Kintamieji $context ir $c pasiekiami bloko šablonuose ir leidžia pasiekti visus pirminio bloko atributus. Pasikeitus pirminio bloko duomenims, antriniai blokai redaktoriuje įkeliami iš naujo automatiškai.

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>

Išorinis apvalkalas

InnerBlocks redaktoriuje turi aplink antrinius elementus pateikti apvalkalo elementą, tačiau jį galima pašalinti iš viešosios svetainės dalies naudojant filtrą 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);

Ankstyvas grąžinimas

Jei norite anksti grįžti iš bloko metodo render, galite patikrinti, ar kintamasis $innerBlocks tuščias. Tai naudinga, jei nenorite nieko atvaizduoti, kai nėra vidinių blokų.

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

Kadangi <InnerBlocks/> visada atvaizduoja tuščią pastraipos žymą, galite naudoti funkciją strip_tags, kad patikrintumėte, ar turinys tuščias.

Dinaminiai šablonai

Laukų tipai Pasirinkimas ir Radijo mygtukas leidžia dinamiškai generuoti šabloną InnerBlocks pagal lauko reikšmę. Tai naudinga, jei norite leisti naudotojui pasirinkti kitą komponento InnerBlocks šabloną.

Tam tiesiog įtraukite raktą innerBlocks į parinkčių masyvą kartu su šablonu:

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

Blokų kontekstas ir komunikacija

Sužinokite, kaip pirminiai ir antriniai blokai dalijasi duomenimis naudodami kontekstą.