본문으로 건너뛰기

재정의

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 템플릿은 블록 기능을 Twig에서 사용해 더 세밀하게 재정의할 수 있습니다.

가상의 이미지 블록에 다음 렌더링 템플릿이 있다고 가정해 보겠습니다.

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

템플릿 전체를 교체하는 대신 Twig의 extends 기능을 사용해 나머지는 그대로 두고 템플릿의 특정 부분만 재정의할 수 있습니다.

Twig
{% extends 'index.twig' %}

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