İçeriğe geç

Geçersiz Kılmalar

Blockstudio, blokları çok ayrıntılı düzeyde geçersiz kılma olanağı sunar. Bu, yeni bir bloğu sıfırdan oluşturmadan davranışını değiştirmek istediğiniz paylaşılan blok kitaplıklarında kullanışlı olabilir.

block.json

Başlamak için, geçersiz kılmak istediğiniz bloğun adını name anahtarı olarak ayarlayın ve override anahtarını true olarak ayarlayın.

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

override özelliği true olarak ayarlandığında, yeni block.json verileri özgün bloğun verileriyle birleştirilir. Böylece özgün bloğun herhangi bir özelliğini geçersiz kılabilirsiniz.

Öznitelikler

Öznitelikler id ile geçersiz kılınabilir veya ek olarak eklenebilir. Örneğin, bir bloğun width özniteliğini geçersiz kılmak ve yeni bir height özniteliği eklemek istediğimizi varsayalım.

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

Aynı id değerine sahip bir öznitelik bulunduğunda veriler özgün öznitelikle birleştirilir. Bulunmayan öznitelikler bloğa eklenir.

Uyarı

Öznitelikleri geçersiz kılarken, aynı kalsa bile özgün özniteliğin type değerini sağlamanız gerekir.

Karmaşık Yapılar

Öznitelikleri karmaşık yapılarla (tekrarlayıcılar, gruplar, sekmeler vb.) geçersiz kılarken, geçersiz kılınacak öğeye kadar özniteliğin tüm yapısını sağlamanız gerekir.

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

Varlıklar

Dosya adı eşleştiğinde varlık dosyaları değiştirilir. Örneğin, özgün blokta bir style.css dosyası varsa geçersiz kılan bloktaki style.css dosyasıyla değiştirilir. Adları özgün bloktaki dosyalarla eşleşmeyen dosyalar bloğa eklenir.

Oluşturma Şablonu

Yeni bir şablon dosyası sağlayarak oluşturma şablonları geçersiz kılınabilir; örneğin index.php, index.twig veya index.blade.php.

Twig Blokları

Twig şablonları, blok özelliği kullanılarak Twig içinde daha ayrıntılı düzeyde geçersiz kılınabilir.

Kurgusal bir görsel bloğu için aşağıdaki oluşturma şablonunu ele alalım:

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

Şablonun tamamını değiştirmek yerine, geri kalanını korurken belirli bölümlerini geçersiz kılmak için Twig öğesinin extends özelliğini kullanabiliriz.

Twig
{% extends 'index.twig' %}

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