본문으로 건너뛰기

HTML 유틸리티

때로는 CSS 또는 JS 파일에서 속성 값을 사용해야 합니다. Blockstudio는 속성을 데이터 속성 또는 CSS 변수로 렌더링하는 도우미 함수를 제공합니다.

블록 예제

다음 속성을 가진 블록을 예로 들어 보겠습니다.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "message",
        "type": "text",
        "label": "My message"
      },
      {
        "id": "color",
        "type": "color",
        "label": "My color"
      }
    ]
  }
}

데이터 속성

bs_render_attributes 함수는 속성을 데이터 속성으로 렌더링합니다.

PHP

PHP
<h1 <?php bs_render_attributes($a); ?>>
  <?php echo $a['message']; ?>
</h1>

Twig

Twig
<h1 {{ fn('bs_render_attributes', a) }}>
  {{ a.message }}
</h1>

출력:

HTML
<h1 data-message="Hello" data-color="#7C3AED">
  Hello
</h1>

속성 필터링

렌더링할 속성을 지정하려면 두 번째 매개변수를 전달하세요.

PHP

PHP
<h1 <?php bs_render_attributes($a, ['color']); ?>>
  <?php echo $a['message']; ?>
</h1>

Twig

Twig
<h1 {{ fn('bs_render_attributes', a, ['color']) }}>
  {{ a.message }}
</h1>

출력:

HTML
<h1 data-color="#7C3AED">
  Hello
</h1>

렌더링하지 않고 반환

에코하지 않고 문자열을 가져오려면 bs_attributes을 사용하세요.

PHP
<?php $attrs = bs_attributes($a); ?>

CSS 변수

bs_render_variables 함수는 속성을 CSS 변수로 렌더링합니다.

PHP

PHP
<h1 style="<?php bs_render_variables($a); ?>">
  <?php echo $a['message']; ?>
</h1>

Twig

Twig
<h1 style="{{ fn('bs_render_variables', a) }}">
  {{ a.message }}
</h1>

출력:

HTML
<h1 style="--message: Hello; --color: #7C3AED;">
  Hello
</h1>

변수 필터링

PHP
<h1 style="<?php bs_render_variables($a, ['color']); ?>">

출력:

HTML
<h1 style="--color: #7C3AED;">
  Hello
</h1>

렌더링하지 않고 반환

에코하지 않고 문자열을 가져오려면 bs_variables을 사용하세요.

PHP
<?php $vars = bs_variables($a); ?>

문자열 변환

두 함수 모두 속성 ID를 케밥 케이스로 변환합니다.

입력 출력
myAttribute my-attribute
my_attribute my-attribute
backgroundColor background-color

CSS에서 사용하기

CSS
.my-block h1 {
  color: var(--color);
}

JavaScript에서 사용하기

JavaScript
const block = document.querySelector('.my-block h1');
const color = block.dataset.color;
const message = block.dataset.message;