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:
<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
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode(['core/heading', 'core/paragraph'])); ?>" />
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:
<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.
<InnerBlocks tag="section" />
template
template-ominaisuuden avulla voit määrittää mallin InnerBlocks-komponentille.
PHP
<InnerBlocks template="<?php echo esc_attr(wp_json_encode([
['core/heading', ['placeholder' => 'Book Title']],
['core/paragraph', ['placeholder' => 'Summary']]
])); ?>" />
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:
{
"$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.
{
"$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 $container = $context['blockstudio/container']; ?>
<h1>
<?php echo $container['full-width']
? 'is full width'
: 'no full width'; ?>
</h1>
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.
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 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:
{
"$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"
}
]
}
}
Lue, miten ylä- ja alilohkot jakavat tietoja kontekstin avulla.