Jenis Field
Blockstudio menyediakan beragam jenis field untuk membuat antarmuka blok.
Proyek juga dapat mendaftarkan jenis field sendiri dengan namespace melalui
blockstudio/field_types. Gunakan ini
saat Anda memerlukan kontrol editor baru atau bentuk nilai terstruktur. Gunakan
field custom/{name} jika Anda hanya
perlu menggunakan kembali grup field yang sudah ada.
Panduan praktis: grup kondisional, pilihan cerdas, repeater, dan penyimpanan yang dapat dikueri.
Properti Umum
Tabel di bawah mencantumkan properti bersama dan opsi nilai umum. default dan fallback didukung jika tercantum dalam tabel Properti untuk setiap jenis field.
| Properti | Jenis | Deskripsi |
|---|---|---|
id |
string | Pengidentifikasi unik untuk atribut |
type |
string | Jenis field |
label |
string | Label tampilan yang ditampilkan di editor |
description |
string | Teks deskripsi yang ditampilkan di bawah field |
default |
mixed | Nilai default untuk field |
fallback |
mixed | Nilai cadangan saat field kosong |
help |
string | Teks bantuan yang ditampilkan sebagai tooltip di samping label |
hidden |
boolean | Sembunyikan field dari UI |
switch |
boolean | Tampilkan toggle untuk menonaktifkan field. Default-nya false. |
translate |
boolean | Atur ke false agar field tidak disertakan dalam konfigurasi WPML |
conditions |
array | Aturan logika kondisional |
Field Files dengan "returnFormat": "id" mempertahankan referensi string yang diimpor, termasuk nilai tunggal di dalam repeater. Nama yang tidak dapat ditemukan menampilkan kartu cadangan tanpa thumbnail; Blockstudio tidak mengubahnya menjadi ID lampiran. Lihat referensi media portabel untuk detailnya.
Lihat Pemuatan Ikon untuk permintaan picker, percobaan ulang, dan subset ikon.
attributes
Merender input atribut data.
{
"type": "attributes"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
array |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
array |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
link |
boolean |
Mengaktifkan pemilihan tautan dari menu tarik-turun. |
media |
boolean |
Mengaktifkan pemilihan media dari menu tarik-turun. |
block
Merujuk ke blok Blockstudio lain dan menampilkan bidang-bidangnya secara sebaris. Dalam templat, nilai ini menghasilkan output blok yang telah dirender.
{
"type": "block"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
block |
string |
Nama blok yang dirujuk (e.g., "mytheme/card"). |
returnFormat |
string |
Cara nilai dikembalikan dalam templat. |
checkbox
Merender sekumpulan input kotak centang.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Properti
| Properti | Jenis | Deskripsi |
|---|---|---|
default |
array | string | number |
Nilai default yang sebaiknya diterapkan saat pertama kali menambahkan blok. |
fallback |
array | string | number |
Nilai cadangan yang ditampilkan saat nilai field kosong. |
options |
array |
Opsi yang dapat dipilih. |
returnFormat |
string |
Menentukan format nilai yang dikembalikan. |
populate |
object |
|
toggle |
boolean | string |
Menambahkan kotak centang di atas opsi untuk memilih atau menghapus pilihan semuanya. String digunakan sebagai labelnya, sedangkan nilai true menggunakan label default. |
classes
Merender bidang untuk memilih kelas CSS.
{
"type": "classes"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
string |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
tailwind |
boolean |
Apakah akan mengaktifkan kelas Tailwind untuk bidang input ini. |
code
Merender editor kode.
{
"type": "code"
}
Properti
| Property | Type | Description |
|---|---|---|
default |
string |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string |
Nilai cadangan yang ditampilkan saat nilai field kosong. |
autoCompletion |
boolean |
Apakah pelengkapan otomatis diaktifkan. |
foldGutter |
boolean |
Apakah gutter lipat ditampilkan. |
height |
string |
Tinggi editor. |
language |
string |
Bahasa yang digunakan untuk penyorotan sintaks. |
lineNumbers |
boolean |
Apakah nomor baris ditampilkan. |
maxHeight |
string |
Tinggi maksimum editor. |
minHeight |
string |
Tinggi minimum editor. |
popout |
boolean |
Apakah tombol untuk membuka editor di jendela pop-up ditampilkan. |
asset |
boolean |
Merender CSS, SCSS, atau JavaScript dari field sebagai aset blok, sehingga templat tidak perlu mencetak tag style atau script. |
color
Merender palet warna dan pemilih warna.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Properti
| Property | Type | Description |
|---|---|---|
default |
string |
Nilai opsi yang dipilih saat pertama kali menambahkan blok. |
fallback |
string |
Nilai opsi yang ditampilkan saat nilai field kosong. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Apakah palet menyediakan tombol untuk menghapus pilihan. |
disableCustomColors |
boolean |
Apakah warna kustom diizinkan. |
date
Merender pemilih tanggal.
{
"type": "date"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
string |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
startOfWeek |
number |
Hari yang menjadi awal pekan. 0 untuk Minggu, 1 untuk Senin, dan seterusnya. |
datetime
Merender pemilih tanggal dan waktu.
{
"type": "datetime"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
string |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
is12Hour |
boolean |
Apakah menggunakan jam 12 jam. Dengan jam 12 jam, widget AM/PM ditampilkan dan format waktu diasumsikan MM-DD-YYYY (alih-alih format default DD-MM-YYYY). |
files
Merender tombol menuju pustaka media. Item yang dipilih dapat diurutkan ulang secara sebaris.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
array | object | number |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
array | object | number |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
addToGallery |
boolean |
Jika true, modal media galeri langsung terbuka di pustaka media agar pengguna dapat menambahkan gambar lain. Jika false, modal media galeri terbuka dalam mode edit sehingga pengguna dapat mengedit gambar yang ada dengan mengurutkan ulang, menghapus, atau mengubah atributnya. Hanya berlaku jika gallery === true. |
allowedTypes |
array | string |
Array berisi jenis media yang dapat diunggah/dipilih dari pustaka media. Setiap jenis berupa string yang dapat berisi jenis MIME umum e.g: ‘image’, ‘audio’, ‘text’, atau jenis MIME lengkap e.g: ‘audio/mpeg’, ‘image/gif’. Jika allowedTypes tidak ditetapkan, semua jenis MIME diizinkan. |
gallery |
boolean |
Jika true, komponen akan menginisialisasi semua status yang diperlukan untuk menampilkan galeri. Secara default, modal media terbuka pada tampilan edit galeri, tetapi ini dapat diubah menggunakan addToGalleryflag. |
max |
number |
Jumlah maksimum file yang dapat ditambahkan. |
min |
number |
Jumlah minimum file yang dapat ditambahkan. |
multiple |
boolean |
Apakah beberapa pilihan diizinkan. |
size |
boolean |
Menambahkan menu tarik-turun ukuran media ke bidang. |
textMediaButton |
string |
Teks tombol media. |
title |
string |
Judul yang ditampilkan di modal media. |
returnFormat |
string |
Menentukan format nilai yang dikembalikan. |
returnSize |
string |
Ukuran media yang dikembalikan saat menggunakan format pengembalian URL. |
gradient
Merender palet gradien dan pemilih gradien.
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Properti
| Property | Type | Description |
|---|---|---|
default |
string |
Nilai opsi yang dipilih saat pertama kali menambahkan blok. |
fallback |
string |
Nilai opsi yang ditampilkan saat nilai field kosong. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Apakah palet menyediakan tombol untuk menghapus pilihan. |
disableCustomGradients |
boolean |
Apakah warna kustom diizinkan. |
group
Merender beberapa bidang dalam kontainer yang dapat dilipat (secara opsional).
{
"type": "group"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
title |
string |
Teks judul. Teks ini tetap ditampilkan meskipun komponen ditutup. |
opened |
boolean |
Jika diatur ke true, komponen akan tetap terbuka terlepas dari prop initialOpen dan |
initialOpen |
boolean |
Apakah panel akan terbuka saat pertama kali ditampilkan. |
scrollAfterOpen |
boolean |
Menggulir konten hingga terlihat saat konten ditampilkan. |
class |
string |
Kelas CSS kustom yang diterapkan ke grup. |
style |
object |
Gaya CSS kustom yang diterapkan ke grup. |
attributes |
array |
Menerima semua jenis bidang lainnya selain tabs lain. |
html-tag
Merender pemilih tag HTML. Berguna untuk memilih tingkat heading atau elemen semantik.
{
"type": "html-tag"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
string |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
tags |
string | array |
Tag yang disertakan. Gunakan string prasetel atau array nama tag. |
exclude |
array |
Tag yang dikecualikan dari prasetel. Hanya berlaku saat menggunakan string prasetel untuk tags. |
icon
Merender ikon SVG dari kumpulan ikon.
{
"type": "icon"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
object |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
object |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
sets |
array | string |
Kumpulan ikon yang disertakan. Biarkan kosong untuk menyertakan semuanya. |
subSets |
array | string |
Subkumpulan ikon yang disertakan. Biarkan kosong untuk menyertakan semuanya. |
returnFormat |
string |
Format pengembalian ikon. |
link
Merender kontrol tautan untuk memilih tautan internal atau eksternal.
{
"type": "link"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
object |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
object |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
hasRichPreviews |
boolean |
Apakah pratinjau kaya ditampilkan saat menambahkan URL. |
noDirectEntry |
boolean |
Apakah kueri pencarian mirip URL dapat langsung diubah menjadi tautan. |
noURLSuggestion |
boolean |
Apakah saran cadangan ditambahkan untuk memperlakukan kueri pencarian sebagai URL. |
opensInNewTab |
boolean |
Menambahkan kontrol alih di modal tautan. |
showSuggestions |
boolean |
Apakah saran ditampilkan saat mengetik URL. |
textButton |
string |
Teks kustom yang ditampilkan di dalam tombol tautan. |
withCreateSuggestion |
boolean |
Apakah pencarian tautan tanpa hasil dapat membuat saran halaman draf baru. |
message
Merender pesan dengan konten kustom.
{
"type": "message"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
string |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
value |
string |
Pesan yang ditampilkan. Data blok dan atribut tersedia dalam sintaks tanda kurung siku, e.g.: {block.title} atau {attributes.text} |
number
Merender input angka.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
number |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
number |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
dragDirection |
string |
Menentukan sumbu seret untuk menaikkan/menurunkan nilai. |
dragThreshold |
number |
Jika isDragEnabled bernilai true, ini mengatur jumlah px yang harus diseret sebelum nilai berubah. |
hideHTMLArrows |
boolean |
Jika true, panah HTML input default akan disembunyikan. |
isShiftStepEnabled |
boolean |
Jika true, mengaktifkan gestur seret mouse untuk menaikkan/menurunkan nilai angka. Menahan SHIFT saat menyeret akan menaikkan nilai sebesar shiftStep. |
max |
number |
Panjang nilai maksimum. |
min |
number |
Panjang nilai minimum. |
required |
boolean |
Jika true, memastikan angka valid dalam rentang min/maks kontrol. Jika false, string kosong dianggap sebagai nilai yang valid. |
shiftStep |
number |
Jumlah kenaikan saat tombol SHIFT ditahan. Nilai shift ini merupakan pengali nilai step. Misalnya, jika nilai step adalah 5 dan shiftStep adalah 10, setiap lompatan akan menaikkan/menurunkan nilai sebesar 50. |
step |
number |
Jumlah perubahan nilai saat menaikkan/menurunkan. Nilai ini juga digunakan untuk validasi: nilai harus merupakan kelipatan step (dengan offset min, jika ditentukan) agar valid. Menerima nilai string khusus any yang meniadakan batasan validasi dan membuat tindakan step menaikkan/menurunkan nilai sebesar 1. |
radio
Merender sekumpulan input radio.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Properti
| Property | Type | Description |
|---|---|---|
default |
string | number |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string | number |
Nilai cadangan yang ditampilkan saat nilai field kosong. |
options |
array |
Opsi yang dapat dipilih. |
returnFormat |
string |
Menentukan format nilai yang dikembalikan. |
populate |
object |
|
display |
string |
Atur ke buttonGroup untuk menampilkan opsi sebagai grup tombol, bukan input radio. |
allowNull |
boolean |
Memungkinkan pengguna menghapus nilai dengan mengeklik lagi input radio yang dipilih. |
range
Merender input rentang untuk menetapkan nilai numerik di antara dua titik.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
number |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
number |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
allowReset |
boolean |
Jika properti ini true, tombol untuk mengatur ulang slider akan ditampilkan. |
initialPosition |
number |
Posisi awal slider yang digunakan jika tidak ada nilai. initialPosition akan dibatasi dalam rentang nilai prop min dan max yang diberikan. |
isShiftStepEnabled |
boolean |
Jika true, mengaktifkan gestur seret mouse untuk menaikkan/menurunkan nilai angka. Menahan SHIFT saat menyeret akan menaikkan nilai sebesar shiftStep. |
marks |
array |
Merender representasi visual tanda tick step. Indikator tanda kustom dapat diberikan sebagai Array. |
max |
number |
Panjang nilai maksimum. |
min |
number |
Panjang nilai minimum. |
railColor |
string |
String warna CSS untuk menyesuaikan latar elemen rail. |
resetFallbackValue |
number |
Nilai yang dipulihkan jika tombol Reset diklik (diaktifkan oleh allowReset) |
separatorType |
string |
Menentukan apakah garis pemisah di bawah/atas baris kontrol dinonaktifkan atau memiliki lebar penuh. Secara default, garis ditempatkan di bawah tanpa menggarisbawahi ikon kontrol. |
shiftStep |
number |
Jumlah kenaikan saat tombol SHIFT ditahan. Nilai shift ini merupakan pengali nilai step. Misalnya, jika nilai step adalah 5 dan shiftStep adalah 10, setiap lompatan akan menaikkan/menurunkan nilai sebesar 50. |
showTooltip |
boolean |
Memaksa Tooltip UI untuk ditampilkan atau disembunyikan. Nilai ini ditimpa menjadi false jika step diatur ke nilai string khusus any. |
step |
number |
Jumlah perubahan nilai saat menaikkan/menurunkan. Nilai ini juga digunakan untuk validasi: nilai harus merupakan kelipatan step (dengan offset min, jika ditentukan) agar valid. Menerima nilai string khusus any yang meniadakan batasan validasi dan membuat tindakan step menaikkan/menurunkan nilai sebesar 1. |
trackColor |
string |
String warna CSS untuk menyesuaikan latar elemen track. |
withInputField |
boolean |
Menentukan apakah bidang input angka ditampilkan di samping RangeControl. Nilai ini ditimpa menjadi false jika step diatur ke nilai string khusus any. |
select
Merender input pilihan dengan dukungan untuk memilih satu atau beberapa opsi.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
array | string | number |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
array | string | number |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
multiple |
boolean |
Jika true, beberapa opsi dapat dipilih. "stylisedUi" akan diaktifkan secara otomatis. |
options |
array |
Opsi yang dapat dipilih. |
returnFormat |
string |
Menentukan format nilai yang dikembalikan. |
populate |
object |
|
stylisedUi |
boolean |
Merender versi pilihan bergaya yang dapat digunakan untuk mencari item. |
allowNull |
boolean | string |
Memungkinkan pengguna memilih opsi kosong. Jika true, label akan kosong; jika tidak, opsi akan menampilkan string yang ditentukan. |
allowReset |
boolean |
Jika properti ini true, tombol untuk mengatur ulang pilihan akan ditampilkan. |
tabs
Merender antarmuka bertab untuk mengelompokkan bidang.
{
"type": "tabs"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
tabs |
array |
Tab yang ditampilkan. |
text
Merender input teks satu baris.
{
"type": "text",
"min": 0,
"max": 100
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
string |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
max |
number |
Panjang nilai maksimum. |
min |
number |
Panjang nilai minimum. |
textarea
Merender input area teks.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
string |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
max |
number |
Panjang nilai maksimum. |
min |
number |
Panjang nilai minimum. |
rows |
number |
Jumlah baris yang harus dimuat area teks. |
toggle
Merender toggle true/false.
{
"type": "toggle"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
boolean |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
boolean |
Nilai cadangan yang ditampilkan saat nilai bidang kosong. |
repeater
Merender sekumpulan field yang dapat diulang.
{
"type": "repeater",
"min": 0,
"max": 100
}
Properti
| Property | Type | Description |
|---|---|---|
default |
array |
Baris yang dimiliki blok baru saat dibuat. Setiap baris adalah objek berisi nilai field. Diutamakan daripada jumlah baris yang dibuat oleh min. |
min |
number |
Jumlah minimum baris. |
max |
number |
Jumlah maksimum baris. |
minimized |
boolean |
Ciutkan baris yang ada saat editor dibuka. Baris yang ditambahkan di editor akan terbuka. |
textButton |
string |
Teks untuk tombol tambah. |
textMinimized |
string | object |
Teks yang ditampilkan saat baris diciutkan. |
textRemove |
string | boolean |
Pertanyaan konfirmasi yang ditampilkan di editor saat menghapus baris repeater. String yang tidak kosong akan mengganti pertanyaan; false langsung menghapus tanpa dialog. Jika tidak dicantumkan, bernilai true, atau berupa string kosong, pertanyaan default akan digunakan. |
attributes |
array |
Menerima semua jenis field selain tabs lainnya. |
richtext
Field atribut untuk field RichText.
{
"type": "richtext"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
string |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string |
Nilai cadangan yang ditampilkan saat nilai field kosong. |
unit
Merender input angka dengan dropdown unit.
{
"type": "unit"
}
Properti
| Properti | Tipe | Deskripsi |
|---|---|---|
default |
string |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string |
Nilai cadangan yang ditampilkan saat nilai field kosong. |
disableUnits |
boolean |
Jika true, field pilihan unit disembunyikan. |
isPressEnterToChange |
boolean |
Jika true, tombol ENTER harus ditekan untuk memicu onChange. Jika diaktifkan, perubahan juga dipicu saat berpindah dengan tombol tab. |
isResetValueOnUnitChange |
boolean |
Jika true dan unit yang dipilih menyediakan nilai default, nilai ini ditetapkan saat mengganti unit. |
isUnitSelectTabbable |
boolean |
Menentukan apakah field pilihan unit dapat difokuskan dengan tombol tab. |
units |
array |
wysiwyg
Merender editor WYSIWYG.
{
"type": "wysiwyg"
}
Properti
| Property | Type | Description |
|---|---|---|
default |
string |
Nilai default yang diterapkan saat pertama kali menambahkan blok. |
fallback |
string |
Nilai cadangan yang ditampilkan saat nilai field kosong. |
toolbar |
object |
Konfigurasi toolbar editor. |
mode |
string |
code membuka field dalam tampilan kode. both menambahkan tombol untuk beralih antara tampilan visual dan tampilan kode. |
Pemuatan Ikon
Editor memuat kumpulan ikon saat Anda pertama kali memfokuskan pemilih atau mengubah kumpulan atau subset, bukan saat Anda memilih blok. Field yang meminta kumpulan yang sama berbagi permintaan yang sedang berlangsung. Nama ikon yang tersimpan tetap terlihat sebelum pemuatan, dan memfokuskan kembali pemilih akan mencoba ulang permintaan yang gagal.
tabler-icons mendukung outline dan filled. Subset yang dikonfigurasi secara eksplisit untuk kumpulan yang dipilih akan diutamakan; jika tidak, pemilih menggunakan solid jika tersedia, atau subset pertama dari kumpulan tersebut. Kumpulan tanpa subset tidak menyertakan subSet. Nama kumpulan hanya mengarah ke file yang disertakan. Perenderan frontend menyimpan ikon satu per satu dalam cache, bukan menyimpan kumpulan ikon lengkap di transient database.
Nilai Opsi yang Diimpor
Checkbox dan pilihan dengan "multiple": true biasanya menyimpan array berisi objek { "value": "...", "label": "..." }. Keduanya juga menerima satu objek opsi, string atau angka skalar, maupun array nilai skalar yang diimpor melalui REST API atau alat pengelolaan konten. Ini juga berlaku di dalam baris repeater.
Editor menampilkan nilai-nilai ini sebagai pilihan tanpa mengubah bentuk penyimpanannya saat disimpan tanpa perubahan. Menambahkan atau menghapus pilihan akan menyimpan array objek opsi seperti biasa. 0 numerik dan "0" string merupakan pilihan yang valid. Templat menerima returnFormat yang dikonfigurasi untuk field, seperti halnya nilai yang dipilih di editor. Opsi tetap harus cocok dengan pilihan yang ditetapkan atau diisi untuk field tersebut.
Pilihan tunggal native tanpa nilai tersimpan atau nilai default menampilkan placeholder kosong yang dinonaktifkan, bukan opsi pertamanya. Memilih opsi pertama secara eksplisit akan menyimpannya. Setelah pilihan tersimpan, placeholder akan menghilang. Gunakan allowNull jika editor juga perlu dapat menghapus pilihan; placeholder kosong tidak membuat pilihan yang diwajibkan dapat dihapus.
Baris Awal Repeater
Di editor, nilai default mencakup baris minimum bertingkat sebelum penyisipan. Anda tidak perlu membuka pengaturan blok untuk menginisialisasinya, dan penyisipan blok tidak menambahkan langkah urungkan kedua untuk baris tersebut.
Saat repeater memiliki min tetapi tidak memiliki nilai tersimpan atau default eksplisit, server menginisialisasi sejumlah baris tersebut menggunakan nilai default kolom baris. Hal ini juga berlaku untuk embed PHP, tag blok, dan sumber halaman berbasis file yang belum pernah dibuka di editor. Misalnya, "min": 2 dengan kolom teks yang nilai defaultnya "New item" menampilkan dua baris berisi nilai tersebut.
Baris tersimpan dan default repeater yang eksplisit memiliki prioritas. Daftar kosong yang disimpan secara eksplisit, false, atau null tidak akan membuat ulang baris yang dihapus. Perenderan tidak menyimpan nilai default yang dihasilkan ini kembali ke postingan. min dan max membatasi kontrol editor; keduanya tidak memotong atau menambah baris pada daftar tersimpan saat dirender. Gunakan laporkanbs_validate_block() pelanggaran batas baris dalam konten yang diimpor.
Kolom baris tanpa default akan false dalam baris yang dihasilkan, sehingga baris tersebut tidak memiliki konten. Baris yang ditambahkan editor lalu dibiarkan kosong akan terlihat sama. Templat yang mencetak kartu, judul, atau item daftar untuk setiap baris sebaiknya melewati baris tanpa konten di luar editor, dan tetap menampilkannya di editor agar kolomnya tetap dapat diedit:
<?php foreach ( $a['items'] as $item ) : ?>
<?php if ( ! $isEditor && ! $item['title'] && ! $item['text'] ) continue; ?>
<div class="item">
<h3><?php echo $item['title']; ?></h3>
<p><?php echo $item['text']; ?></p>
</div>
<?php endforeach; ?>
Penghapusan Repeater
Menghapus baris akan membuka dialog konfirmasi editor dengan tombol Hapus dan Batal. Memilih Batal atau menekan Escape akan membiarkan baris tetap sama. Baris hanya dihapus setelah dikonfirmasi, termasuk di dalam repeater bertingkat.
textRemove mengontrol perilaku yang sama untuk setiap repeater:
| Nilai | Perilaku |
|---|---|
Tidak dicantumkan, true, atau "" |
Tampilkan pertanyaan konfirmasi default. |
| String tidak kosong | Tampilkan pertanyaan khusus tersebut, menggunakan mekanisme terjemahan teks khusus yang sudah ada. |
false |
Hapus baris segera tanpa dialog. |
Misalnya, "textRemove": "Remove this team member?" mengubah pertanyaan.
Batasan min yang sudah ada tetap mencegah penghapusan baris di bawah jumlah minimum.
Nesting Repeater
Baris repeater menerima semua jenis kolom kecuali tabs. Kolom tabs dalam sebuah baris, termasuk di dalam grup tanpa id, akan menampilkan pemberitahuan di editor alih-alih kolomnya. Ekstensi PHPStan melaporkannya untuk block.json dan field.json. Pertahankan kolom baris dalam susunan datar, atau pindahkan tab ke luar repeater.
Tautan WYSIWYG
Toolbar tautan WYSIWYG menyisipkan tautan yang dibuka di tab yang sama tanpa menambahkan target atau rel secara default. Aktifkan opsi tab baru dengan toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
Memilih tab baru akan menambahkan target="_blank" dan rel="noreferrer noopener".
Menonaktifkannya akan menghapus atribut otomatis tersebut. Untuk menerapkan atribut ke setiap tautan di kolom itu, atur toolbar.formats.link.attributes, misalnya
{ "class": "content-link", "rel": "nofollow" }. Konfigurasi eksplisit tetap dipertahankan, dan token keamanan tab baru ditambahkan ke rel yang dikonfigurasi.
Mengetik URL tidak otomatis mengubahnya menjadi tautan, dan mengeklik tautan yang sudah ada di kolom tersebut tidak akan meninggalkan editor. Atribut tautan yang sebelumnya disimpan tetap ada dalam konten yang sudah ada; atribut tersebut tidak dimigrasikan secara otomatis.