InnerBlocks
Blok dalam memungkinkan Anda menyisipkan blok tambahan ke dalam blok Anda. Di balik layar, Blockstudio menggunakan komponen InnerBlocks. Harap diperhatikan bahwa hanya satu komponen InnerBlocks yang dapat digunakan per blok; ini adalah batasan WordPress.
Penggunaan Dasar
Untuk menggunakan InnerBlocks, tambahkan komponen <InnerBlocks /> ke templat blok Anda:
<InnerBlocks />
Komposisinya terserah Anda. Anda dapat menyarangkan komponen InnerBlocks sedalam yang diinginkan atau menggunakannya sendiri.
Properti
allowedBlocks
Properti allowedBlocks memungkinkan Anda menentukan blok mana yang dapat disisipkan ke komponen InnerBlocks.
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 juga menerima token yang diperluas di server. Token diperluas sebelum editor menerima templat, sementara nama blok literal tetap tidak berubah.
| Token | Deskripsi |
|---|---|
namespace/* |
Setiap blok terdaftar dalam namespace tersebut |
category:<slug> |
Setiap blok terdaftar dalam kategori blok WordPress tersebut |
@theme |
Setiap blok Blockstudio yang didaftarkan dari tema aktif |
Entri yang diperluas dihapus duplikasinya sesuai urutan penulis:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Token yang tidak menghasilkan blok apa pun akan diabaikan. Keluaran frontend tidak berubah, karena allowedBlocks hanya digunakan oleh editor.
tag
Secara default, komponen InnerBlocks dirender sebagai elemen div. Anda dapat mengubahnya dengan menggunakan properti tag.
<InnerBlocks tag="section" />
template
Properti template memungkinkan Anda menentukan templat untuk komponen InnerBlocks.
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
Properti templateLock memungkinkan Anda menentukan apakah templat dapat diubah atau tidak.
| Nilai | Deskripsi |
|---|---|
contentOnly |
Mencegah semua operasi. Jenis blok tanpa konten disembunyikan dari tampilan daftar. Tidak dapat ditimpa oleh blok turunan. |
all |
Mencegah semua operasi. Blok tidak dapat disisipkan, dipindahkan, atau dihapus. |
insert |
Mencegah penyisipan atau penghapusan blok, tetapi mengizinkan pemindahan blok yang sudah ada. |
false |
Mencegah penerapan penguncian meskipun blok induk memiliki penguncian. |
renderAppender
Properti renderAppender memungkinkan Anda menentukan jenis penambah blok.
| Nilai | Deskripsi |
|---|---|
default |
Tampilkan penambah blok default (penambah bergaya paragraf jika blok paragraf diizinkan) |
button |
Tampilkan tombol ikon + sebagai penambah |
useBlockProps
useBlockProps akan menghapus pembungkus luar komponen InnerBlocks
di dalam editor. Lihat useBlockProps untuk informasi selengkapnya.
Konteks
Pendaftaran
Blockstudio mendukung konteks untuk komponen InnerBlocks. Ini memungkinkan Anda
meneruskan data dari blok induk ke blok anak. Meskipun menggunakan mekanisme
konteks inti WordPress di balik layar, Blockstudio menyediakan API yang lebih praktis.
Alih-alih harus mendefinisikan secara terpisah semua atribut yang perlu diteruskan melalui konteks, Anda cukup berlangganan semua atribut dari blok induk.
Setiap blok anak menerima nilai dari induknya sendiri, termasuk saat render awal yang dimuat sebelumnya di editor. Pembaruan bidang penyedia akan memperbarui anak-anaknya di editor, bahkan saat render sebelumnya masih dimuat. Blok anak yang identik di bawah penyedia berbeda memiliki render cache yang memahami konteks secara terpisah.
Misalkan Anda memiliki penyiapan blok kontainer seperti ini:
{
"$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"
}
]
}
}
Di dalam blok anak, cukup gunakan properti usesContext dengan nama
blok induk untuk mengakses semua atribut induk di templat blok Anda.
{
"$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
}
Templat
Variabel $context dan $c tersedia di dalam templat blok Anda untuk
mengakses semua atribut induk. Blok anak akan otomatis dimuat ulang di editor
jika data induk berubah.
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>
Pembungkus Frontend
InnerBlocks harus merender elemen pembungkus di sekitar anak-anaknya di dalam
editor, tetapi elemen ini dapat dihapus dari frontend menggunakan filter
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);
Kembali Lebih Awal
Jika ingin kembali lebih awal dari metode render blok Anda, Anda dapat
memeriksa apakah variabel $innerBlocks kosong. Ini berguna jika Anda tidak
ingin merender apa pun saat tidak ada blok bagian dalam.
<?php if (strip_tags($innerBlocks) === '') {
return;
} ?>
<InnerBlocks tag="section" />
Karena <InnerBlocks/> akan selalu merender tag paragraf kosong, Anda dapat menggunakan
fungsi strip_tags untuk memeriksa apakah kontennya kosong.
Templat Dinamis
Jenis bidang Select dan
Radio mendukung pembuatan templat InnerBlocks secara dinamis,
bergantung pada nilai bidang. Ini berguna jika Anda ingin memungkinkan pengguna
memilih templat yang berbeda untuk komponen InnerBlocks.
Untuk melakukannya, cukup tambahkan kunci innerBlocks ke array opsi dengan templat tersebut:
{
"$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"
}
]
}
}
Pelajari cara blok induk dan anak berbagi data menggunakan konteks.