블록 속성
$attributes 또는 $a 변수로는 blockstudio 속성에 등록된 데이터에만 액세스할 수 있습니다. 정렬이나 타이포그래피 같은 표준 WordPress 블록 데이터에 액세스하려면 $block 또는 $b 변수를 사용하세요.
렌더링
PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>
Twig
<h1>The block is aligned: {{ block.align }}</h1>
<h1>The block is aligned: {{ b.align }}</h1>
기본값 설정
예약된 필드 ID
WordPress가 관리하는 속성은 최상위 ID가 같은 Blockstudio 필드로 선언하면 안 됩니다. anchor, className, style, lock, metadata은 예약되어 있으며, Blockstudio의 내부 blockstudio, __BLOCKSTUDIO_KEY 및 blockEditingMode 속성도 예약되어 있습니다.
사용 설정된 WordPress도 해당 속성 이름을 예약합니다. 해당하는 경우 align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow 및 ariaLabel이 이에 해당합니다. 이 속성 중 하나를 네이티브 선언으로 지정해도 해당 이름이 예약됩니다. 이를 통해 예를 들어 코어의 문자열 align이 선택 필드의 옵션 객체로 대체되는 일을 방지합니다.
충돌하는 필드는 등록 시 건너뛰고 blockstudio/error/logged를 통해 기록됩니다(활성화된 경우 WordPress 디버그 로그에도 기록). 로그에는 블록과 필드가 표시됩니다. 해당 필드의 편집기 컨트롤, 저장 핸들러, 렌더링 정의는 등록되지 않습니다. 필드 이름을 headingAlign로 바꾸거나 presentation와 같이 이름이 지정된 그룹 안에 넣어 presentation_align가 되도록 하세요. 리피터 행 필드는 해당 행 안에 있으므로 최상위 충돌에 해당하지 않습니다. 정렬 지원이 비활성화되어 있고 네이티브 align 속성이 없는 경우 일반 align 필드는 계속 유효합니다.
기존 블록을 업그레이드할 때 필드 충돌이 발생하면 필드 이름을 바꾸고 저장된 필드 값을 새 ID로 마이그레이션하세요. Blockstudio은 저장된 콘텐츠의 이름을 자동으로 바꾸거나 WordPress 지원을 제거하지 않습니다.
기본 속성값
align 같은 WordPress 속성의 기본값을 설정하려면 attributes 키 안에 default 키를 추가하세요:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/block",
"title": "Native Block",
"icon": "star-filled",
"description": "Native Block.",
"supports": {
"align": ["left", "center", "right"]
},
"attributes": {
"align": {
"type": "string",
"default": "center"
}
},
"blockstudio": true
}
사용 가능한 블록 데이터
$block / $b 변수에는 다음이 포함됩니다:
| 속성 | 설명 |
|---|---|
name |
블록 이름(e.g., my-theme/my-block) |
title |
블록 제목 |
dir |
블록 디렉터리 경로 |
url |
블록 디렉터리 URL |
align |
정렬 값(supports.align이 활성화된 경우) |
className |
사용자 지정 CSS 클래스(supports.customClassName이 활성화된 경우) |
anchor |
HTML 앵커/ID(supports.anchor가 활성화된 경우) |
WordPress 지원 기능
supports 속성을 통해 WordPress 블록 기능을 활성화합니다:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
사용 가능한 모든 옵션은 WordPress 블록 지원 기능 문서를 참조하세요.