Liigu sisu juurde

InnerBlocks

Sisemised plokid võimaldavad lisada plokkidesse täiendavaid plokke. Taustal kasutab Blockstudio komponenti InnerBlocks. Pane tähele, et ploki kohta saab kasutada ainult üht InnerBlocksi komponenti; see on WordPress piirang.

Põhikasutus

InnerBlocksi kasutamiseks lisa plokimalli komponent <InnerBlocks />:

PHP
<InnerBlocks />

Koostis on sinu valida. Võid paigutada komponendi InnerBlocks nii sügavale pesastatult, kui soovid, või kasutada seda eraldi.

Omadused

allowedBlocks

Propi allowedBlocks abil saad määrata, milliseid plokke saab komponendile InnerBlocks lisada.

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 toetab ka serveris laiendatavaid tokeneid. Tokenid laiendatakse enne, kui mall jõuab redaktorisse, samas kui sõnasõnalised plokinimed jäävad muutmata.

Token Kirjeldus
namespace/* Kõik registreeritud plokid selles nimeruumis
category:<slug> Kõik registreeritud plokid selles WordPress plokikategoorias
@theme Kõik aktiivse teema registreeritud Blockstudio plokid

Laiendatud kirjed eemaldatakse duplikaatidest autori määratud järjekorras:

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

Tokenid, mis ei lahene ühekski plokiks, jäetakse tähelepanuta. Esikülje väljund jääb samaks, sest allowedBlocks-i kasutatakse ainult redaktoris.

silt

Vaikimisi renderdatakse komponent InnerBlocks elemendina div. Seda saab muuta proppi tag abil.

PHP
<InnerBlocks tag="section" />

mall

Propi template abil saad määrata komponendile InnerBlocks malli.

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

Propi templateLock abil saad määrata, kas malli saab muuta.

Väärtus Kirjeldus
contentOnly Keelab kõik toimingud. Sisuta plokitüübid peidetakse loendivaates. Alamplokid ei saa seda üle kirjutada.
all Keelab kõik toimingud. Plokke ei saa lisada, teisaldada ega kustutada.
insert Keelab plokkide lisamise ja eemaldamise, kuid võimaldab olemasolevaid plokke teisaldada.
false Takistab lukustuse rakendamist isegi siis, kui emaplokil on lukustus.

renderAppender

Propi renderAppender abil saad määrata ploki lisaja tüübi.

Väärtus Kirjeldus
default Kuva vaikimisi ploki lisajat (lõigustiilis lisaja, kui lõigublokk on lubatud)
button Kuva lisajana + ikooniga nupp

useBlockProps

useBlockProps eemaldab redaktoris komponendi InnerBlocks välise ümbrise. Lisateavet leiate useBlockProps dokumentatsioonist.

Kontekst

Registreerimine

Blockstudio toetab komponendi InnerBlocks konteksti. See võimaldab edastada andmeid ülemplokist alamplokkidele. Kuigi selle aluseks on WordPress tuuma kontekstimehhanism, pakub Blockstudio mugavamat API.

Selle asemel et määrata eraldi kõik kontekstis edastatavad atribuudid, saate lihtsalt tellida kõik ülemploki atribuudid.

Iga alamplokk saab oma ülemploki väärtused, sealhulgas redaktori esimesel eellaaditud renderdusel. Pakkuja väljade muutmine uuendab selle alamplokke redaktoris ka siis, kui eelmine renderdus on veel laadimisel. Eri pakkujate identsed alamplokid hoiavad kontekstitundlikud vahemällu salvestatud renderdused lahus.

Oletame, et teil on konteinerplokk seadistatud järgmiselt:

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

Alamplokis kasutage plokimallis kõigile ülemploki atribuutidele juurdepääsuks lihtsalt atribuuti usesContext koos ülemploki nimega.

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
}

Mallid

Muutujad $context ja $c on plokimallides saadaval kõigile ülemploki atribuutidele juurdepääsuks. Kui ülemploki andmed muutuvad, laaditakse alamplokid redaktoris automaatselt uuesti.

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>

Esikülje ümbris

InnerBlocks peab redaktoris renderdama alamplokkide ümber ümbriselemendi, kuid filtri blockstudio/blocks/components/inner_blocks/frontend/wrap abil saab selle esiküljelt eemaldada.

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

Varajane tagastamine

Kui soovite ploki meetodist render ennetähtaegselt väljuda, kontrollige, kas muutuja $innerBlocks on tühi. See on kasulik, kui te ei soovi midagi renderdada, kui sisemisi plokke pole.

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

Kuna <InnerBlocks/> renderdab alati tühja lõigumärgendi, saate sisu tühjuse kontrollimiseks kasutada funktsiooni strip_tags.

Dünaamilised mallid

Väljatüübid Select ja Radio toetavad malli InnerBlocks dünaamilist loomist olenevalt välja väärtusest. See on kasulik, kui soovite lubada kasutajal valida komponendile InnerBlocks teise malli.

Selleks lisage lihtsalt malliga võti innerBlocks suvandite massiivi:

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

Ploki kontekst ja suhtlus

Vaadake, kuidas ülem- ja alamplokid konteksti abil andmeid jagavad.