Lewati ke konten

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:

PHP
<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

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 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:

PHP
<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.

PHP
<InnerBlocks tag="section" />

template

Properti template memungkinkan Anda menentukan templat untuk komponen InnerBlocks.

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

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:

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

Di dalam blok anak, cukup gunakan properti usesContext dengan nama blok induk untuk mengakses semua atribut induk di templat blok Anda.

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
}

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
<?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>

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.

PHP
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
<?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:

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

Konteks dan Komunikasi Blok

Pelajari cara blok induk dan anak berbagi data menggunakan konteks.