Preskoči na vsebino

InnerBlocks

Notranji bloki omogočajo vstavljanje dodatnih blokov v vaše bloke. V ozadju Blockstudio uporablja komponento InnerBlocks. Upoštevajte, da je v posameznem bloku mogoče uporabiti samo eno komponento InnerBlocks; to je omejitev WordPress.

Osnovna uporaba

Če želite uporabiti InnerBlocks, dodajte komponento <InnerBlocks /> v predlogo bloka:

PHP
<InnerBlocks />

Sestava je prepuščena vam. Komponento InnerBlocks lahko ugnezdite poljubno globoko ali pa jo uporabite samostojno.

Lastnosti

allowedBlocks

Lastnost allowedBlocks omogoča določitev blokov, ki jih je mogoče vstaviti v komponento 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 sprejema tudi žetone, razširjene na strežniku. Žetoni se razširijo, preden predloga prispe do urejevalnika, medtem ko dobesedna imena blokov ostanejo nespremenjena.

Žeton Opis
namespace/* Vsak registriran blok v tem imenskem prostoru
category:<slug> Vsak registriran blok v tej kategoriji blokov WordPress
@theme Vsak blok Blockstudio, registriran iz aktivne teme

Razširjeni vnosi se odstranijo kot dvojniki po vrstnem redu avtorja:

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

Žetoni, ki se ne razrešijo v noben blok, so prezrti. Izhod na sprednjem delu ostane nespremenjen, ker allowedBlocks uporablja samo urejevalnik.

oznaka

Komponenta InnerBlocks se privzeto izriše kot element div. To lahko spremenite z lastnostjo tag.

PHP
<InnerBlocks tag="section" />

predloga

Lastnost template omogoča določitev predloge za komponento 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

Lastnost templateLock omogoča določitev, ali je predlogo mogoče spreminjati.

Vrednost Opis
contentOnly Prepreči vse operacije. Vrste blokov brez vsebine so v pogledu seznama skrite. Podrejeni bloki tega ne morejo preglasiti.
all Prepreči vse operacije. Blokov ni mogoče vstaviti, premakniti ali izbrisati.
insert Prepreči vstavljanje ali odstranjevanje blokov, vendar omogoča premikanje obstoječih.
false Prepreči uporabo zaklepanja, tudi če nadrejeni blok vsebuje nastavitev zaklepanja.

renderAppender

Lastnost renderAppender omogoča določitev vrste dodajalnika blokov.

Vrednost Opis
default Prikaže privzeti dodatek bloka (dodatek v slogu odstavka, kadar je dovoljen blok odstavka)
button Prikaže gumb z ikono + kot dodatek

useBlockProps

useBlockProps bo odstranil zunanji ovoj komponente InnerBlocks v urejevalniku. Za več informacij glejte useBlockProps.

Kontekst

Registracija

Blockstudio podpira kontekst za komponento InnerBlocks. To vam omogoča, da posredujete podatke iz nadrejenega bloka podrejenim blokom. Čeprav v ozadju uporablja mehanizem za kontekst jedra , Blockstudio ponuja priročnejši API. WordPress

Namesto da bi morali ločeno določiti vse atribute, ki jih želite posredovati v kontekstu, se lahko preprosto naročite na vse atribute nadrejenega bloka.

Vsak podrejeni blok prejme vrednosti svojega nadrejenega bloka, tudi pri prvem vnaprej naloženem izrisu v urejevalniku. Posodobitev polj ponudnika posodobi njegove podrejene bloke v urejevalniku, tudi če se še nalaga prejšnji izris. Enaki podrejeni bloki pri različnih ponudnikih ohranijo ločene predpomnjene izrise, ki upoštevajo kontekst.

Recimo, da imate nastavljen vsebniški blok, kot sledi:

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

V podrejenem bloku preprosto uporabite lastnost usesContext z imenom nadrejenega bloka, da v predlogi bloka dostopate do vseh atributov nadrejenega bloka.

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
}

Predloge

Spremenljivki $context in $c sta na voljo v predlogah blokov za dostop do vseh atributov nadrejenega bloka. Podrejeni bloki se bodo v urejevalniku samodejno znova naložili, če se podatki nadrejenega bloka spremenijo.

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>

Ovoj na spletnem mestu

InnerBlocks mora v urejevalniku okoli svojih podrejenih elementov izrisati ovoj, lahko pa ga s filtrom blockstudio/blocks/components/inner_blocks/frontend/wrap odstranite na spletnem mestu.

PHP
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
  return false; // Remove wrapper
}, 10, 2);

Zgodnja vrnitev

Če želite iz metode render bloka predčasno vrniti rezultat, lahko preverite, ali je spremenljivka $innerBlocks prazna. To je uporabno, če ne želite izrisati ničesar, kadar ni notranjih blokov.

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

Ker bo <InnerBlocks/> vedno izrisal prazno oznako odstavka, lahko s funkcijo strip_tags preverite, ali je vsebina prazna.

Dinamične predloge

Vrsti polj Izbirni seznam in Izbirni gumbi podpirata dinamično ustvarjanje predloge InnerBlocks glede na vrednost polja. To je uporabno, če želite uporabniku omogočiti izbiro druge predloge za komponento InnerBlocks.

To storite tako, da matriki možnosti preprosto dodate ključ innerBlocks s predlogo:

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

Kontekst blokov in komunikacija

Naučite se, kako si nadrejeni in podrejeni bloki delijo podatke prek konteksta.