Lewati ke konten

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.

Buku Resep Pola Field

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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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).

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

Merender kontrol tautan untuk memilih tautan internal atau eksternal.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "type": "tabs"
}

Properti

Properti Tipe Deskripsi
tabs array Tab yang ditampilkan.

text

Merender input teks satu baris.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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
<?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.

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:

JSON
{
  "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.