Siirry sisältöön

InnerBlocks

Sisälohkojen avulla voit lisätä lohkoihisi uusia lohkoja. Taustalla Blockstudio käyttää InnerBlocks-komponenttia. Huomaa, että lohkoa kohden voi käyttää vain yhtä InnerBlocks-komponenttia; tämä on WordPress-rajoitus.

Peruskäyttö

Käytä InnerBlocks-lohkoja lisäämällä <InnerBlocks />-komponentti lohkomalliisi:

PHP
<InnerBlocks />

Sommittelu on sinun päätettävissäsi. Voit sisäkkäistää InnerBlocks-komponentin niin syvälle kuin haluat tai käyttää sitä sellaisenaan.

Ominaisuudet

allowedBlocks

allowedBlocks-ominaisuuden avulla voit määrittää, mitä lohkoja InnerBlocks-komponenttiin voi lisätä.

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 hyväksyy myös palvelimella laajennetut tunnisteet. Tunnisteet laajennetaan ennen kuin muokkain vastaanottaa mallin, mutta kirjaimelliset lohkojen nimet pysyvät ennallaan.

Tunniste Kuvaus
namespace/* Kaikki kyseisen nimiavaruuden rekisteröidyt lohkot
category:<slug> Kaikki rekisteröidyt lohkot kyseisessä WordPress-lohkoryhmässä
@theme Kaikki aktiivisesta teemasta rekisteröidyt Blockstudio-lohkot

Laajennetut kohteet poistetaan kaksoiskappaleista tekijän määrittämä järjestys säilyttäen:

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

Tunnisteet, joita vastaavia lohkoja ei löydy, ohitetaan. Käyttöliittymän tuloste ei muutu, koska allowedBlocks-ominaisuutta käytetään vain muokkaimessa.

tag

Oletusarvoisesti InnerBlocks-komponentti renderöidään div-elementtinä. Voit muuttaa tämän käyttämällä tag-ominaisuutta.

PHP
<InnerBlocks tag="section" />

template

template-ominaisuuden avulla voit määrittää mallin InnerBlocks-komponentille.

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

templateLock-ominaisuuden avulla voit määrittää, voiko mallia muokata.

Arvo Kuvaus
contentOnly Estää kaikki toiminnot. Sisällöttömät lohkotyypit piilotetaan luettelonäkymästä. Lapset eivät voi ohittaa asetusta.
all Estää kaikki toiminnot. Lohkoja ei voi lisätä, siirtää eikä poistaa.
insert Estää lohkojen lisäämisen ja poistamisen, mutta sallii olemassa olevien siirtämisen.
false Estää lukituksen käyttöönoton, vaikka päälohko sisältäisi lukituksen.

renderAppender

renderAppender-ominaisuuden avulla voit määrittää lohkon lisäystoiminnon tyypin.

Arvo Kuvaus
default Näytä oletuslohkon lisäin (kappaletyylinen lisäin, kun kappalelohko on sallittu)
button Näytä +-kuvakepainike lisäimenä

useBlockProps

useBlockProps poistaa komponentin InnerBlocks ulomman kääreen editorista. Lisätietoja on ohjeessa useBlockProps.

Konteksti

Rekisteröinti

Blockstudio tukee komponentin InnerBlocks kontekstia. Näin voit välittää tietoja ylälohkolta alilohkoille. Taustalla käytetään ytimen WordPress context mechanism -mekanismia, mutta Blockstudio tarjoaa kätevämmän API.

Sen sijaan, että määrittelisit erikseen kaikki kontekstiin välitettävät attribuutit, voit tilata kaikki ylälohkon attribuutit kerralla.

Kukin alilohko saa oman ylälohkonsa arvot myös editorin ensimmäisellä esiladatulla renderöintikerralla. Palveluntarjoajan kenttien päivittäminen päivittää sen alilohkot editorissa, vaikka edellinen renderöinti olisi vielä latautumassa. Eri palveluntarjoajien alla olevat samanlaiset alilohkot säilyttävät erilliset kontekstitietoiset välimuistissa olevat renderöinnit.

Oletetaan, että säilölohko on määritetty näin:

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

Käytä alilohkossa yksinkertaisesti usesContext-ominaisuutta ja ylälohkon nimeä, niin saat käyttöösi kaikki ylälohkon attribuutit lohkomallissasi.

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
}

Mallit

Muuttujat $context ja $c ovat käytettävissä lohkomalleissasi, jotta pääset käsiksi kaikkiin ylälohkon attribuutteihin. Alilohkot latautuvat editorissa automaattisesti uudelleen, jos ylälohkon tiedot muuttuvat.

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>

Käyttöliittymän kääre

InnerBlocks tarvitsee kääreelementin lastensa ympärille editorissa, mutta sen voi poistaa julkiselta sivulta käyttämällä suodatinta 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);

Varhainen palautus

Jos haluat palauttaa arvon varhain lohkosi metodista render, tarkista, onko muuttuja $innerBlocks tyhjä. Tämä on kätevää, jos et halua renderöidä mitään silloin, kun sisälohkoja ei ole.

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

Koska <InnerBlocks/> renderöi aina tyhjän kappaletunnisteen, voit tarkistaa, onko sisältö tyhjä, käyttämällä funktiota strip_tags.

Dynaamiset mallit

Kenttätyypit Select ja Radio tukevat mallin InnerBlocks dynaamista generointia kentän arvon perusteella. Tästä on hyötyä, jos haluat antaa käyttäjän valita komponentille InnerBlocks eri mallin.

Lisää tätä varten yksinkertaisesti innerBlocks-avain mallin sisältävään options-taulukkoon:

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

Lohkokonteksti ja viestintä

Lue, miten ylä- ja alilohkot jakavat tietoja kontekstin avulla.