본문으로 건너뛰기

코드 필드 에셋

파일로 제공되는 정적 스타일 및 스크립트 외에도 Blockstudio는 코드 필드를 통한 동적 에셋 블록을 지원합니다. 사용 사례에 따라 블록 범위로 제한할 수 있습니다.

기본 사용법

가장 기본적으로는 템플릿에서 코드 필드 콘텐츠를 직접 렌더링할 수 있습니다.

PHP

PHP
<div useBlockProps>
  <h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>

Twig

Twig
<div useBlockProps>
  <h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>

범위가 지정된 선택자

다른 블록과의 충돌을 방지하려면 렌더링 템플릿에서 useBlockProps와 함께 코드 필드의 %selector% 변수를 사용하면 됩니다.

코드 필드에서 %selector%는 개별 블록 인스턴스를 대상으로 합니다. CSS 및 SCSS 파일에서는 %selector%가 블록 전체에 공유되는 범위 지정 클래스 대신 적용됩니다.

예제

위 예제의 h1 태그를 코드 필드에서 대상으로 지정한다고 가정해 보겠습니다.

CSS
%selector% h1 {
  color: red;
}

이제 Blockstudio는 다음 세 가지 작업을 수행합니다:

  • 해당 블록 인스턴스에 고유 ID를 생성합니다
  • %selector%를 고유 ID로 바꿉니다
  • useBlockProps가 지정된 요소에 동일한 선택자를 추가합니다

최종 출력은 다음과 같습니다:

HTML
<div data-assets="c9abe0d95c2b">
  <h1>My block</h1>
</div>
<style>
  [data-assets='c9abe0d95c2b'] h1 {
    color: red;
  }
</style>

자동 렌더링

매번 스타일 태그를 직접 렌더링해야 하면 번거로울 수 있습니다. 이 과정을 간소화하려면 코드 필드에서 asset 속성을 사용할 수 있습니다.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "code",
        "id": "code",
        "label": "Custom CSS",
        "language": "css",
        "asset": true
      }
    ]
  }
}

이렇게 하면 css로 표시된 코드 블록에 style 태그가 자동으로 생성되어 문서의 head로 이동합니다. 언어가 javascript로 표시된 필드에는 대신 script 태그가 생성되어 body의 맨 아래에 배치됩니다.

확장 기능에서

확장 기능에서 코드 필드를 사용할 때는 asset 속성이 필요하지 않습니다. 언어가 css 또는 javascript이면 Blockstudio이 코드 필드 콘텐츠를 에셋으로 자동 렌더링합니다.

예제

JSON
{
  "$schema": "https://blockstudio.dev/schema/extend",
  "name": "core/*",
  "blockstudio": {
    "extend": true,
    "attributes": [
      {
        "id": "customCss",
        "type": "code",
        "label": "Custom css",
        "language": "css"
      }
    ]
  }
}

추가 설정은 필요하지 않습니다. 위와 같이 사이드바의 각 core/* 블록에 코드 필드가 표시되며, 콘텐츠가 페이지의 에셋으로 자동 렌더링됩니다.

SCSS

코드 필드는 SCSS 컴파일을 지원합니다. 언어를 scss로 설정하면 렌더링 전에 Blockstudio가 ScssPhp을 통해 값을 컴파일하여 CSS로 출력합니다.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "code",
        "id": "styles",
        "label": "Styles",
        "language": "scss",
        "asset": true
      }
    ]
  }
}

SCSS의 변수, 중첩, 믹스인 같은 기능을 모두 사용할 수 있습니다:

Scss
%selector% {
  $primary: #3b82f6;

  h1 {
    color: $primary;
  }

  &:hover {
    background: lighten($primary, 40%);
  }
}

편집기에서는 입력하는 동안 결과를 확인할 수 있도록 SCSS가 서버 측에서 실시간으로 컴파일됩니다. 프런트엔드에서는 블록을 렌더링할 때 컴파일이 이루어집니다.