Atribut Blok
Variabel $attributes atau $a hanya memberi Anda akses ke data yang terdaftar di properti blockstudio. Untuk mengakses data blok WordPress standar seperti perataan atau tipografi, gunakan variabel $block atau $b.
Rendering
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>
Mengatur Nilai Default
ID Bidang yang Dicadangkan
Atribut yang dikelola WordPress tidak boleh dideklarasikan sebagai bidang Blockstudio dengan ID tingkat teratas yang sama. anchor, className, style, lock, dan metadata dicadangkan, begitu pula Blockstudio, atribut internal blockstudio, __BLOCKSTUDIO_KEY, dan blockEditingMode.
Dukungan WordPress yang diaktifkan juga mencadangkan nama atributnya: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow, dan ariaLabel, sesuai kebutuhan. Deklarasi native untuk salah satu atribut tersebut juga mencadangkan nama itu. Ini mencegah, misalnya, align string milik core digantikan dengan objek opsi bidang select.
Bidang yang bertentangan dilewati saat pendaftaran dan dicatat melalui blockstudio/error/logged (serta log debug WordPress jika diaktifkan), dengan menyebutkan blok dan bidangnya. Kontrol editor, handler penyimpanan, dan definisi render untuk bidang tersebut tidak didaftarkan. Ubah nama bidang menjadi headingAlign, atau letakkan di dalam grup bernama seperti presentation agar menghasilkan presentation_align. Bidang baris repeater berada di dalam barisnya dan tidak menimbulkan konflik tingkat teratas. Bidang align biasa tetap valid saat dukungan perataan dinonaktifkan dan tidak ada atribut native align.
Saat meningkatkan blok yang sudah ada dan mengalami benturan, ganti nama field-nya dan migrasikan nilai field yang tersimpan ke ID baru. Blockstudio tidak mengganti nama konten tersimpan secara diam-diam atau menghapus dukungan WordPress.
Nilai Default Atribut Native
Untuk menetapkan nilai default bagi properti WordPress seperti align, tambahkan kunci default di dalam kunci attributes:
{
"$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
}
Data Blok yang Tersedia
Variabel $block / $b berisi:
| Properti | Deskripsi |
|---|---|
name |
Nama blok (e.g., my-theme/my-block) |
title |
Judul blok |
dir |
Jalur direktori blok |
url |
Direktori blok URL |
align |
Nilai perataan (jika supports.align diaktifkan) |
className |
Kelas CSS khusus (jika supports.customClassName diaktifkan) |
anchor |
Anchor/ID HTML (jika supports.anchor diaktifkan) |
Dukungan WordPress
Aktifkan fitur blok WordPress melalui properti supports:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Lihat dokumentasi Dukungan Blok WordPress untuk semua opsi yang tersedia.