본문으로 건너뛰기

블록 필드

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

호환 대상

블록 필드는 일반 블록과 컴포넌트 블록 모두에서 작동합니다. 컴포넌트 블록은 프로그래밍 방식으로 렌더링하도록 설계되었으므로 특히 잘 어울립니다.