Към съдържанието

Замени

Blockstudio позволява блоковете да се заменят с много голяма прецизност. Това е полезно за споделени библиотеки от блокове, когато искате да промените поведението на блок, без да създавате нов от нулата.

block.json

За да започнете, задайте името на блока, който искате да замените, като ключ name, а ключа override задайте на true.

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

Когато свойството override е зададено на true, данните от новия block.json се обединяват с данните от оригиналния блок. Така можете да замените всяко свойство на оригиналния блок.

Атрибути

Атрибутите могат да бъдат заменени чрез id или допълнени. Например, да си представим, че искаме да заменим атрибута width на блок и да добавим нов атрибут height.

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

Когато бъде открит атрибут със същото id, данните се обединяват с тези на оригиналния атрибут. Атрибутите, които не са открити, се добавят към блока.

Предупреждение

При замяна на атрибути трябва да предоставите type на оригиналния атрибут, дори ако той остава същият.

Сложни структури

При замяна на атрибути със сложни структури (повторители, групи, раздели и т.н.) трябва да предоставите пълната структура на атрибута до елемента, който искате да замените.

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

Ресурси

Файловете с ресурси ще бъдат заменени, когато имената им съвпадат. Например, ако в оригиналния блок има файл style.css, той ще бъде заменен от файла style.css в блока, който го заменя. Файлове с имена, които не съвпадат с тези в оригиналния блок, ще бъдат добавени към блока.

Шаблон за визуализиране

Шаблоните за визуализиране могат да бъдат заменени с предоставяне на нов файл с шаблон: index.php, index.twig или index.blade.php.

Блокове Twig

Шаблоните Twig могат да се заменят с по-голяма прецизност чрез функцията block в Twig.

Да си представим следния шаблон за визуализиране на измислен блок за изображения:

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

Вместо да заменим целия шаблон, можем да използваме функцията extends на Twig, за да заменим определени части от шаблона, като запазим останалото непроменено.

Twig
{% extends 'index.twig' %}

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