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;