Pāriet uz saturu

InnerBlocks

Iekšējie bloki ļauj ievietot papildu blokus savos blokos. Aizkulisēs Blockstudio izmanto komponentu InnerBlocks. Ņemiet vērā, ka katrā blokā var izmantot tikai vienu InnerBlocks komponentu — tā ir WordPress ierobežojums.

Pamata lietojums

Lai izmantotu InnerBlocks, pievienojiet komponentu <InnerBlocks /> sava bloka veidnei:

PHP
<InnerBlocks />

Jūs varat izvēlēties kompozīciju. Varat ligzdot komponentu InnerBlocks tik dziļi, cik vēlaties, vai arī izmantot to atsevišķi.

Rekvizīti

allowedBlocks

Īpašība allowedBlocks ļauj noteikt, kurus blokus var ievietot 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 pieņem arī serverī izvēršamus marķierus. Marķieri tiek izvērsti, pirms veidne nonāk redaktorā, bet burtiskie bloku nosaukumi paliek nemainīti.

Marķieris Apraksts
namespace/* Katrs reģistrētais bloks attiecīgajā nosaukumvietā
category:<slug> Katrs reģistrētais bloks attiecīgajā WordPress bloku kategorijā
@theme Katrs aktīvā motīva reģistrētais Blockstudio bloks

Izvērstie ieraksti tiek atdalīti no dublikātiem, saglabājot autora norādīto secību:

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

Marķieri, kas neatbilst nevienam blokam, tiek ignorēti. Priekšgala izvade nemainās, jo allowedBlocks tiek izmantots tikai redaktorā.

tag

Pēc noklusējuma komponents InnerBlocks tiek renderēts kā div elements. To var mainīt, izmantojot īpašību tag.

PHP
<InnerBlocks tag="section" />

template

Īpašība template ļauj definēt komponenta InnerBlocks veidni.

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

Īpašība templateLock ļauj noteikt, vai veidni drīkst modificēt.

Vērtība Apraksts
contentOnly Novērš visas darbības. Bloku tipi bez satura tiek paslēpti saraksta skatā. Bērnelementi to nevar atcelt.
all Novērš visas darbības. Blokus nevar ievietot, pārvietot vai dzēst.
insert Novērš bloku ievietošanu vai noņemšanu, bet ļauj pārvietot esošos blokus.
false Neļauj piemērot bloķēšanu pat tad, ja vecākbloks satur bloķēšanas iestatījumu.

renderAppender

Īpašība renderAppender ļauj noteikt bloku pievienošanas pogas veidu.

Vērtība Apraksts
default Rādīt noklusējuma bloka pievienotāju (rindkopas stila pievienotāju, ja ir atļauts rindkopas bloks)
button Rādīt pogu ar + ikonu kā pievienotāju

useBlockProps

useBlockProps noņems komponenta InnerBlocks ārējo ietvaru redaktorā. Plašāku informāciju skatiet useBlockProps.

Konteksts

Reģistrēšana

Blockstudio atbalsta komponenta InnerBlocks kontekstu. Tas ļauj nodot datus no vecākbloka pakārtotajiem blokiem. Iekšēji tiek izmantots WordPress kodola konteksta mehānisms, bet Blockstudio piedāvā ērtāku API.

Tā vietā, lai atsevišķi definētu visus atribūtus, kas jānodod kontekstā, varat vienkārši abonēt visus vecākbloka atribūtus.

Katrs pakārtotais bloks saņem sava vecākbloka vērtības, tostarp pirmajā iepriekš ielādētajā renderēšanas reizē redaktorā. Atjauninot nodrošinātāja laukus, tiek atjaunināti arī tā pakārtotie bloki redaktorā, pat ja iepriekšējā renderēšana vēl tiek ielādēta. Identiski pakārtotie bloki pie dažādiem nodrošinātājiem saglabā atsevišķus kontekstu zinošus kešotos renderējumus.

Pieņemsim, ka jums ir šāda konteinera bloka konfigurācija:

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

Pakārtotajā blokā vienkārši izmantojiet rekvizītu usesContext kopā ar vecākbloka nosaukumu, lai bloka veidnē piekļūtu visiem vecākbloka atribūtiem.

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
}

Veidnes

Bloku veidnēs ir pieejami mainīgie $context un $c, lai piekļūtu visiem vecākbloka atribūtiem. Ja vecākbloka dati mainās, pakārtotie bloki redaktorā tiek automātiski ielādēti no jauna.

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>

Priekšgala ietvars

InnerBlocks redaktorā ap bērnblokiem ir jāattēlo ietverošs elements, tomēr to var noņemt priekšgalā, izmantojot filtru 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);

Agrīna atgriešana

Ja bloka metodei render vēlaties veikt agrīnu atgriešanu, varat pārbaudīt, vai mainīgais $innerBlocks ir tukšs. Tas noder, ja nevēlaties attēlot neko, ja nav iekšējo bloku.

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

Tā kā <InnerBlocks/> vienmēr attēlo tukšu rindkopas tagu, varat izmantot funkciju strip_tags, lai pārbaudītu, vai saturs ir tukšs.

Dinamiskās veidnes

Lauku tipi Atlasīt un Radio atbalsta dinamisku veidnes InnerBlocks generēšanu atkarībā no lauka vērtības. Tas noder, ja vēlaties ļaut lietotājam izvēlēties citu komponenta InnerBlocks veidni.

Lai to izdarītu, vienkārši pievienojiet opciju masīvam atslēgu innerBlocks ar veidni:

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

Bloku konteksts un saziņa

Uzziniet, kā vecākbloki un pakārtotie bloki koplieto datus, izmantojot kontekstu.