재정의
Blockstudio에는 블록을 매우 세밀하게 재정의하는 기능이 있습니다. 새 블록을 처음부터 만들지 않고 블록의 동작을 바꾸고 싶을 때 공유 블록 라이브러리에 유용합니다.
block.json
시작하려면 재정의하려는 블록의 이름을 name 키로 설정하고 override 키를 true로 설정하세요.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
override 속성을 true로 설정하면 새 block.json의 데이터가 원래 블록의 데이터와 병합됩니다. 따라서 원래 블록의 모든 속성을 재정의할 수 있습니다.
속성
속성은 id로 재정의하거나 추가할 수 있습니다. 예를 들어 블록의 width 속성을 재정의하고 새 height 속성을 추가한다고 가정해 보겠습니다.
{
"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를 제공해야 합니다.
복합 구조
반복 필드, 그룹, 탭 등 복합 구조를 가진 속성을 재정의할 때는 재정의할 항목에 도달할 때까지 속성의 전체 구조를 제공해야 합니다.
{
"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에서 사용해 더 세밀하게 재정의할 수 있습니다.
가상의 이미지 블록에 다음 렌더링 템플릿이 있다고 가정해 보겠습니다.
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
템플릿 전체를 교체하는 대신 Twig의 extends 기능을 사용해 나머지는 그대로 두고 템플릿의 특정 부분만 재정의할 수 있습니다.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}