블록 필드
block 필드 유형을 사용하면 다른 Blockstudio 블록을 속성으로 참조할 수 있습니다. 참조된 블록의 필드는 사용자 지정 필드와 동일한 idStructure 및 overrides 시스템을 사용해 인라인으로 확장됩니다.
템플릿에서 값은 렌더링된 블록 출력을 반환합니다.
정의
JSON
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
이렇게 하면 참조된 블록의 필드가 인라인으로 확장됩니다. mytheme/card에 heading 및 content 필드가 있으면 호스트 블록에 card_heading 및 card_content 속성이 추가됩니다.
템플릿에서 사용
템플릿에서 필드 값은 참조된 블록의 렌더링된 HTML를 반환합니다:
Twig
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
PHP
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
반환 형식
returnFormat를 사용해 필드 값의 반환 내용을 제어합니다:
| 값 | 설명 |
|---|---|
rendered |
(기본값) 참조된 블록의 렌더링된 HTML 출력 |
data |
참조된 블록의 속성 값을 담은 연관 배열 |
both |
rendered(HTML) 및 data(속성 값)가 포함된 객체 |
JSON
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
재정의
사용자 지정 필드와 마찬가지로 참조된 블록의 개별 필드 속성을 재정의합니다:
JSON
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
호환 대상
블록 필드는 일반 블록과 컴포넌트 블록 모두에서 작동합니다. 컴포넌트 블록은 프로그래밍 방식으로 렌더링하도록 설계되었으므로 특히 잘 어울립니다.