Lewati ke konten

Penimpaan

Blockstudio menyediakan kemungkinan untuk menimpa blok dengan tingkat perincian yang sangat tinggi. Ini berguna untuk pustaka blok bersama ketika Anda ingin mengubah perilaku suatu blok tanpa harus membuat blok baru dari awal.

block.json

Untuk memulai, tetapkan nama blok yang ingin Anda timpa sebagai kunci name dan tetapkan kunci override ke true.

JSON
{
  "name": "blockstudio/my-block",
  "title": "My overridden block title",
  "blockstudio": {
    "override": true
  }
}

Jika properti override ditetapkan ke true, data dari block.json baru akan digabungkan dengan data dari blok asli. Artinya, Anda dapat menimpa properti apa pun dari blok asli.

Atribut

Atribut dapat ditimpa melalui id atau ditambahkan. Misalnya, bayangkan kita ingin menimpa atribut width dari suatu blok dan menambahkan atribut height baru.

JSON
{
  "name": "blockstudio/my-block",
  "title": "My overridden block title",
  "blockstudio": {
    "override": true,
    "attributes": [
      {
        "id": "width",
        "type": "number",
        "default": 280,
        "label": "Override width"
      },
      {
        "id": "height",
        "type": "number",
        "default": 280,
        "label": "New height"
      }
    ]
  }
}

Jika ditemukan atribut dengan id yang sama, datanya akan digabungkan dengan atribut asli. Atribut yang tidak ditemukan akan ditambahkan ke blok.

Peringatan

Saat menimpa atribut, Anda harus memberikan type dari atribut asli, meskipun nilainya tetap sama.

Struktur Kompleks

Saat menimpa atribut dengan struktur kompleks (repeater, grup, tab, dan sebagainya), Anda harus memberikan struktur lengkap atribut hingga item yang akan ditimpa.

JSON
{
  "name": "blockstudio/my-block",
  "blockstudio": {
    "override": true,
    "attributes": [
      {
        "id": "tabs",
        "type": "tabs",
        "tabs": [
          {
            "id": "tab1",
            "attributes": [
              {
                "key": "group1",
                "type": "group",
                "title": "Group",
                "attributes": [
                  {
                    "id": "text",
                    "type": "text",
                    "label": "Override text"
                  }
                ]
              }
            ]
          },
          {
            "id": "tab2",
            "title": "Override tab",
            "attributes": [
              {
                "id": "group",
                "type": "group",
                "title": "Group ID",
                "attributes": [
                  {
                    "id": "text",
                    "type": "text",
                    "label": "Override text"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

Aset

Berkas aset akan diganti jika nama berkasnya cocok. Misalnya, jika ada berkas style.css di blok asli, berkas tersebut akan diganti dengan berkas style.css di blok penimpa. Berkas dengan nama yang tidak cocok dengan blok asli akan ditambahkan ke blok.

Templat Rendering

Templat rendering dapat ditimpa dengan menyediakan berkas templat baru, yaitu index.php, index.twig, atau index.blade.php.

Blok Twig

Templat Twig dapat ditimpa dengan lebih terperinci menggunakan fitur blok di Twig.

Bayangkan templat rendering berikut untuk blok gambar fiktif:

Twig
<h1>Images:</h1>
{% for image in a.images %}
  <div class="content">
    {% block image %}
      <img src="{{ image.url }}" class="image" />
    {% endblock %}
  </div>
{% endfor %}

Daripada mengganti seluruh templat, kita dapat menggunakan fitur extends milik Twig untuk menimpa bagian tertentu dari templat sambil mempertahankan bagian lainnya.

Twig
{% extends 'index.twig' %}

{% block image %}
  <figure>
    <img src="{{ image.url }}" class="image" />
    <figcaption>{{ image.caption }}</figcaption>
  </figure>
{% endblock %}