본문으로 건너뛰기

컴포넌트

컴포넌트는 전체 파이프라인(속성, 템플릿, 에셋, RPC, Tailwind)을 거치는 Blockstudio 블록이지만, WordPress 편집기의 삽입기에 표시되지 않습니다. 프로그래밍 방식으로만 렌더링되는 재사용 가능한 UI 요소를 만들기 위해 설계되었습니다.

block.json

blockstudio 객체에서 component 속성을 true로 설정합니다:

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      {
        "id": "title",
        "type": "text",
        "label": "Title"
      },
      {
        "id": "description",
        "type": "textarea",
        "label": "Description"
      }
    ]
  }
}

렌더링

컴포넌트를 렌더링하는 방법은 두 가지입니다:

문자열 렌더러

페이지 템플릿이나 게시물 콘텐츠에서 <bs:> 태그를 사용합니다:

HTML
<bs:my-theme-card title="My Card" description="Card content." />

PHP

PHP 템플릿에서 bs_render_block() 또는 bs_block()을 사용합니다:

PHP
bs_render_block([
  'name' => 'my-theme/card',
  'attributes' => [
    'title' => 'My Card',
    'description' => 'Card content.',
  ],
]);

지원 기능

컴포넌트는 모든 Blockstudio 기능을 지원합니다:

  • 속성 및 필드 유형
  • PHP, Twig, Blade 템플릿
  • 컴포넌트 렌더링 시 로드되는 CSS/SCSS 에셋
  • Tailwind CSS
  • 서버 함수(RPC)
  • 범위가 지정된 스타일

적용되지 않는 항목

컴포넌트는 편집기에 표시되지 않으므로:

  • 블록 편집기 미리보기를 사용할 수 없습니다.
  • 블록 삽입기에서 검색되지 않습니다.
  • 컴포넌트에는 registerBlockType()가 호출되지 않습니다.