İçeriğe geç

Alan Türleri

Blockstudio, blok arayüzleri oluşturmak için çeşitli alan türleri sunar.

Projeler ayrıca blockstudio/field_types ile kendi ad alanlı alan türlerini kaydedebilir. Yeni bir düzenleyici kontrolüne veya yapılandırılmış değer şekline ihtiyacınız varsa bunu kullanın. Yalnızca mevcut alan grubunu yeniden kullanmanız gerekiyorsa custom/{name} alanlarını kullanın.

Alan Kalıpları Rehberi

Uygulamalı tarifler: koşullu gruplar, akıllı seçim alanları, tekrarlayıcılar ve sorgulanabilir depolama.

Genel Özellikler

Aşağıdaki tabloda paylaşılan özellikler ve yaygın değer seçenekleri listelenir. default ve fallback, her alan türünün Özellikler tablosunda belirtildikleri yerlerde desteklenir.

Özellik Tür Açıklama
id string Öznitelik için benzersiz tanımlayıcı
type string Alan türü
label string Düzenleyicide gösterilen etiket
description string Alanın altında gösterilen açıklama metni
default mixed Alanın varsayılan değeri
fallback mixed Alan boş olduğunda kullanılacak yedek değer
help string Etiketin yanında araç ipucu olarak gösterilen yardım metni
hidden boolean Alanı UI bölümünde gizle
switch boolean Alanı devre dışı bırakabilen bir açma kapama düğmesi gösterir. Varsayılan değer false.
translate boolean Alanı WPML yapılandırmasının dışında bırakmak için false olarak ayarlayın
conditions array Koşullu mantık kuralları

"returnFormat": "id" değerine sahip Dosyalar alanları, yineleyiciler içindeki tekil değerler de dahil olmak üzere içe aktarılan dize referanslarını korur. Çözümlenemeyen adlar küçük resimler olmadan yedek kartlar gösterir; Blockstudio bunları ek kimliklerine dönüştürmez. Ayrıntılar için taşınabilir medya referansları bölümüne bakın.

Seçici istekleri, yeniden denemeler ve simge alt kümeleri için Simge Yükleme bölümüne bakın.

attributes

Veri niteliği girişlerini işler.

JSON
{
  "type": "attributes"
}

Özellikler

Özellik Tür Açıklama
default array Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback array Alan değeri boş olduğunda görüntülenecek yedek değer.
link boolean Açılır listeden bağlantı seçimini etkinleştirir.
media boolean Açılır listeden medya seçimini etkinleştirir.

block

Başka bir Blockstudio bloğa başvurur ve alanlarını satır içinde genişletir. Şablonlarda değer, işlenmiş blok çıktısını döndürür.

JSON
{
  "type": "block"
}

Özellikler

Özellik Tür Açıklama
block string Başvurulacak bloğun adı (e.g., "mytheme/card").
returnFormat string Şablonlarda değerin nasıl döndürüleceği.

checkbox

Bir dizi onay kutusu girdisi oluşturur.

JSON
{
  "type": "checkbox",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Özellikler

Özellik Tür Açıklama
default array | string | number Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback array | string | number Alan değeri boş olduğunda görüntülenecek yedek değer.
options array Aralarından seçim yapılacak seçenekler.
returnFormat string Döndürülen değer biçimini belirtir.
populate object
toggle boolean | string Seçeneklerin üstüne, tümünü seçen veya seçimi kaldıran bir onay kutusu ekler. Etiketi için bir dize kullanılır; true varsayılan etiketi kullanır.

classes

CSS sınıflarını seçmek için bir alan oluşturur.

JSON
{
  "type": "classes"
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback string Alan değeri boş olduğunda görüntülenecek yedek değer.
tailwind boolean Bu giriş alanı için Tailwind sınıflarının etkinleştirilip etkinleştirilmeyeceği.

code

Bir kod düzenleyici oluşturur.

JSON
{
  "type": "code"
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde uygulanacak varsayılan değer.
fallback string Alan değeri boş olduğunda görüntülenecek yedek değer.
autoCompletion boolean Otomatik tamamlamanın etkinleştirilip etkinleştirilmeyeceği.
foldGutter boolean Katlama kenar boşluğunun gösterilip gösterilmeyeceği.
height string Düzenleyicinin yüksekliği.
language string Sözdizimi vurgulaması için kullanılacak dil.
lineNumbers boolean Satır numaralarının gösterilip gösterilmeyeceği.
maxHeight string Düzenleyicinin maksimum yüksekliği.
minHeight string Düzenleyicinin minimum yüksekliği.
popout boolean Düzenleyiciyi açılır pencerede açan bir düğmenin gösterilip gösterilmeyeceği.
asset boolean Alandaki CSS, SCSS veya JavaScript öğesini blok varlığı olarak işler; böylece şablonun stil veya komut dosyası etiketini yazdırması gerekmez.

color

Bir renk paleti ve renk seçici oluşturur.

JSON
{
  "type": "color",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde seçilmesi gereken seçenek değeri.
fallback string Alan değeri boş olduğunda görüntülenecek seçenek değeri.
options array
populate object
clearable boolean Paletin bir temizleme düğmesi olup olmayacağı.
disableCustomColors boolean Özel renge izin verilip verilmeyeceği.

date

Bir tarih seçici oluşturur.

JSON
{
  "type": "date"
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback string Alan değeri boş olduğunda görüntülenecek yedek değer.
startOfWeek number Haftanın başlayacağı gün. Pazar için 0, pazartesi için 1 vb.

datetime

Bir tarih ve saat seçici oluşturur.

JSON
{
  "type": "datetime"
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback string Alan değeri boş olduğunda görüntülenecek yedek değer.
is12Hour boolean 12 saatlik saat biçiminin kullanılıp kullanılmayacağı. 12 saatlik saat biçiminde AM/PM bileşeni gösterilir ve varsayılan DD-MM-YYYY biçimi yerine MM-DD-YYYY tarih biçimi kullanılır.

files

Medya kitaplığına açılan bir düğme oluşturur. Seçilen öğeler satır içinde yeniden sıralanabilir.

JSON
{
  "type": "files",
  "min": 0,
  "max": 100,
  "multiple": false
}

Özellikler

Özellik Tür Açıklama
default array | object | number Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback array | object | number Alan değeri boş olduğunda görüntülenecek yedek değer.
addToGallery boolean true ise galeri medya penceresi doğrudan medya kitaplığında açılır ve kullanıcının ek görüntüler eklemesine olanak tanır. false ise galeri medya penceresi düzenleme modunda açılır; burada kullanıcı mevcut görüntüleri yeniden sıralayabilir, kaldırabilir veya özniteliklerini değiştirebilir. Yalnızca gallery === true olduğunda geçerlidir.
allowedTypes array | string Medya kitaplığından yüklenecek/seçilecek medya türlerini içeren dizi. Her tür, genel MIME türünü e.g: ‘image’, ‘audio’, ‘text’ veya tam MIME türünü e.g: ‘audio/mpeg’, ‘image/gif’ içerebilen bir dizgedir. allowedTypes ayarlanmamışsa tüm MIME türlerine izin verilir.
gallery boolean true ise bileşen, galeriyi temsil etmek için gereken tüm durumları başlatır. Varsayılan olarak medya penceresi galeri düzenleme çerçevesinde açılır; ancak bu, addToGalleryflag kullanılarak değiştirilebilir.
max number Eklenebilecek maksimum dosya sayısı.
min number Eklenebilecek minimum dosya sayısı.
multiple boolean Birden fazla seçime izin verilip verilmeyeceği.
size boolean Alana medya boyutu açılır listesi ekler.
textMediaButton string Medya düğmesinin metni.
title string Medya penceresinde görüntülenen başlık.
returnFormat string Döndürme biçimi değerini belirtir.
returnSize string URL döndürme biçimi kullanılırken döndürülecek medya boyutu.

gradient

Bir degrade paleti ve degrade seçici oluşturur.

JSON
{
  "type": "gradient",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde seçilmesi gereken seçenek değeri.
fallback string Alan değeri boş olduğunda görüntülenecek seçenek değeri.
options array
populate object
clearable boolean Paletin bir temizleme düğmesi olup olmayacağı.
disableCustomGradients boolean Özel renge izin verilip verilmeyeceği.

group

Birden fazla alanı (isteğe bağlı olarak) daraltılabilir bir kapsayıcıda oluşturur.

JSON
{
  "type": "group"
}

Özellikler

Özellik Tür Açıklama
title string Başlık metni. Bileşen kapalıyken de görünür.
opened boolean true olarak ayarlandığında bileşen, initialOpen özelliğinden bağımsız olarak açık kalır ve
initialOpen boolean Panelin başlangıçta açık olup olmayacağı.
scrollAfterOpen boolean İçerik görünür olduğunda onu görünüm alanına kaydırır.
class string Gruba uygulanacak özel CSS sınıfı.
style object Gruba uygulanacak özel CSS stilleri.
attributes array Başka bir tabs türü dışındaki tüm alan türlerini kabul eder.

html-tag

Bir HTML etiketi seçici oluşturur. Başlık düzeyleri veya anlamsal öğeler seçmek için kullanışlıdır.

JSON
{
  "type": "html-tag"
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback string Alan değeri boş olduğunda görüntülenecek yedek değer.
tags string | array Dahil edilecek etiketler. Önceden ayarlanmış bir dizge veya etiket adları dizisi kullanın.
exclude array Ön ayardan hariç tutulacak etiketler. Yalnızca etiketler için ön ayar dizgesi kullanıldığında geçerlidir.

icon

Bir simge kümesinden SVG simgesi oluşturur.

JSON
{
  "type": "icon"
}

Özellikler

Özellik Tür Açıklama
default object Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback object Alan değeri boş olduğunda görüntülenecek yedek değer.
sets array | string Dahil edilecek simge kümesi. Tümünü dahil etmek için boş bırakın.
subSets array | string Dahil edilecek alt simge kümesi. Tümünü dahil etmek için boş bırakın.
returnFormat string Simgenin döndürüleceği biçim.

Dahili veya harici bağlantı seçmek için bir bağlantı denetimi oluşturur.

JSON
{
  "type": "link"
}

Özellikler

Özellik Tür Açıklama
default object Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback object Alan değeri boş olduğunda görüntülenecek yedek değer.
hasRichPreviews boolean Bir URL eklenirken zengin önizlemelerin gösterilip gösterilmeyeceği.
noDirectEntry boolean URL benzeri bir arama sorgusunun doğrudan bağlantıya dönüştürülmesine izin verilip verilmeyeceği.
noURLSuggestion boolean Arama sorgusunu URL olarak değerlendiren bir yedek öneri eklenip eklenmeyeceği.
opensInNewTab boolean Bağlantı penceresine bir geçiş denetimi ekler.
showSuggestions boolean URL yazılırken öneri sunulup sunulmayacağı.
textButton string Bağlantı düğmesinin içinde görüntülenecek özel metin.
withCreateSuggestion boolean Eşleşmeyen bağlantı aramalarının yeni bir taslak sayfa önerisi oluşturup oluşturamayacağı.

message

Özel içerikli bir ileti oluşturur.

JSON
{
  "type": "message"
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback string Alan değeri boş olduğunda görüntülenecek yedek değer.
value string Görüntülenecek ileti. Blok ve öznitelik verileri köşeli ayraç söz diziminde kullanılabilir: e.g. Örneğin {block.title} veya {attributes.text}

number

Bir sayı girişi oluşturur.

JSON
{
  "type": "number",
  "min": 0,
  "max": 100,
  "step": 1
}

Özellikler

Özellik Tür Açıklama
default number Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback number Alan değeri boş olduğunda görüntülenecek yedek değer.
dragDirection string Değeri artırıp azaltmak için sürükleme eksenini belirler.
dragThreshold number isDragEnabled true ise değerin değişmesinden önce kaç px sürüklenmesi gerektiğini belirler.
hideHTMLArrows boolean true ise varsayılan giriş HTML okları gizlenir.
isShiftStepEnabled boolean true ise sayı değerini artırıp azaltmak için fareyle sürükleme hareketini etkinleştirir. Sürüklerken SHIFT tuşunu basılı tutmak değeri shiftStep kadar artırır.
max number Maksimum değer uzunluğu.
min number Minimum değer uzunluğu.
required boolean true ise denetimin min/max aralığında geçerli bir sayı olmasını zorunlu kılar. false ise boş dizgenin geçerli bir değer olmasına izin verir.
shiftStep number SHIFT tuşu basılıyken değerin ne kadar artırılacağı. Bu kaydırma değeri, adım değerinin çarpanıdır. Örneğin adım değeri 5 ve shiftStep 10 ise her atlamada değer 50 artar/azalır.
step number Artırma/azaltma sırasında değerin ne kadar değişeceği. Değerin geçerli olması için step değerinin katı olması (belirtilmişse min değeri kadar kaydırılması) gerektiğinden, doğrulamada da kullanılır. Doğrulama kısıtlamasını kaldıran ve adımlama işlemlerinin değeri 1 artırıp azaltmasını sağlayan özel any dizge değerini kabul eder.

radio

Bir dizi radyo düğmesi girdisi oluşturur.

JSON
{
  "type": "radio",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Özellikler

Özellik Tür Açıklama
default string | number Blok ilk eklendiğinde uygulanacak varsayılan değer.
fallback string | number Alan değeri boş olduğunda görüntülenecek yedek değer.
options array Seçilebilecek seçenekler.
returnFormat string Döndürülecek değer biçimini belirtir.
populate object
display string Seçenekleri radyo girişleri yerine düğme grubu olarak göstermek için buttonGroup olarak ayarlayın.
allowNull boolean Kullanıcının seçili radyo girişine yeniden tıklayarak değeri temizlemesine olanak tanır.

range

İki nokta arasındaki sayısal bir değeri ayarlamak için aralık girişi oluşturur.

JSON
{
  "type": "range",
  "min": 0,
  "max": 100,
  "step": 1
}

Özellikler

Özellik Tür Açıklama
default number Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback number Alan değeri boş olduğunda görüntülenecek yedek değer.
allowReset boolean Bu özellik true ise kaydırıcıyı sıfırlayan bir düğme oluşturulur.
initialPosition number Değer aktarılmadığında kullanılacak kaydırıcının başlangıç konumu. initialPosition, sağlanan min ve max özellik değerleriyle sınırlandırılır.
isShiftStepEnabled boolean true ise sayı değerini artırıp azaltmak için fareyle sürükleme hareketini etkinleştirir. Sürüklerken SHIFT tuşunu basılı tutmak değeri shiftStep kadar artırır.
marks array Adım işaretlerinin görsel gösterimini oluşturur. Özel işaretçiler bir Array ile sağlanabilir.
max number Maksimum değer uzunluğu.
min number Minimum değer uzunluğu.
railColor string CSS ray öğesinin arka planını özelleştirmek için renk dizgesi.
resetFallbackValue number Sıfırla düğmesine tıklandığında (allowReset tarafından etkinleştirilmişse) geri dönülecek değer.
separatorType string Denetim satırının altındaki/üstündeki ayırıcı çizginin devre dışı bırakılıp bırakılmayacağını veya tam genişlikte olup olmayacağını belirler. Varsayılan olarak, denetim simgesinin alt çizgisi hariç altına yerleştirilir.
shiftStep number SHIFT tuşu basılıyken değerin ne kadar artırılacağı. Bu kaydırma değeri, adım değerinin çarpanıdır. Örneğin adım değeri 5 ve shiftStep 10 ise her atlamada değer 50 artar/azalır.
showTooltip boolean Araç ipucunun UI gösterilmesini veya gizlenmesini zorlar. step özel any dizge değerine ayarlandığında bu değer false olarak geçersiz kılınır.
step number Artırma/azaltma sırasında değerin ne kadar değişeceği. Değerin geçerli olması için step değerinin katı olması (belirtilmişse min değeri kadar kaydırılması) gerektiğinden, doğrulamada da kullanılır. Doğrulama kısıtlamasını kaldıran ve adımlama işlemlerinin değeri 1 artırıp azaltmasını sağlayan özel any dizge değerini kabul eder.
trackColor string CSS track öğesinin arka planını özelleştirmek için renk dizgesi.
withInputField boolean Sayı giriş alanının RangeControl yanında oluşturulup oluşturulmayacağını belirler. step özel any dizge değerine ayarlandığında bu değer false olarak geçersiz kılınır.

select

Tekli veya çoklu seçimi destekleyen bir seçim girişi oluşturur.

JSON
{
  "type": "select",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ],
  "multiple": false
}

Özellikler

Özellik Tür Açıklama
default array | string | number Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback array | string | number Alan değeri boş olduğunda görüntülenecek yedek değer.
multiple boolean true ise birden fazla seçenek seçilebilir. "stylisedUi" otomatik olarak etkinleştirilir.
options array Aralarından seçim yapılabilecek seçenekler.
returnFormat string Döndürme biçimi değerini belirtir.
populate object
stylisedUi boolean Öğeler arasında arama yapma olanağı sunan stilize bir seçim bileşeni oluşturur.
allowNull boolean | string Kullanıcının boş bir seçenek seçmesine izin verir. true ise etiket boş olur; aksi takdirde seçenek, belirtilen dizgeyi oluşturur.
allowReset boolean Bu özellik true ise seçimi sıfırlayan bir düğme oluşturulur.

tabs

Alanları gruplamak için sekmeli bir arayüz oluşturur.

JSON
{
  "type": "tabs"
}

Özellikler

Özellik Tür Açıklama
tabs array Görüntülenecek sekmeler.

text

Tek satırlı bir metin girişi oluşturur.

JSON
{
  "type": "text",
  "min": 0,
  "max": 100
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback string Alan değeri boş olduğunda görüntülenecek yedek değer.
max number Maksimum değer uzunluğu.
min number Minimum değer uzunluğu.

textarea

Bir metin alanı girişi oluşturur.

JSON
{
  "type": "textarea",
  "min": 0,
  "max": 100,
  "rows": 4
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback string Alan değeri boş olduğunda görüntülenecek yedek değer.
max number Maksimum değer uzunluğu.
min number Minimum değer uzunluğu.
rows number Metin alanının içermesi gereken satır sayısı.

toggle

Bir doğru/yanlış geçiş denetimi oluşturur.

JSON
{
  "type": "toggle"
}

Özellikler

Özellik Tür Açıklama
default boolean Blok ilk eklendiğinde uygulanması gereken varsayılan değer.
fallback boolean Alan değeri boş olduğunda görüntülenecek yedek değer.

repeater

Tekrarlanabilen bir alan kümesi oluşturur.

JSON
{
  "type": "repeater",
  "min": 0,
  "max": 100
}

Özellikler

Özellik Tür Açıklama
default array Yeni bir bloğun başlangıçta sahip olduğu satırlar. Her satır, alan değerlerinden oluşan bir nesnedir. min tarafından oluşturulan satırlara göre önceliklidir.
min number En az satır sayısı.
max number En fazla satır sayısı.
minimized boolean Düzenleyici açıldığında mevcut satırları daraltır. Düzenleyicide eklenen satırlar genişletilmiş olarak başlar.
textButton string Ekle düğmesinin metni.
textMinimized string | object Satırlar daraltıldığında görüntülenecek metin.
textRemove string | boolean Tekrarlayıcı satırı kaldırılırken düzenleyicide gösterilen onay sorusu. Boş olmayan bir dize soruyu değiştirir; false satırı iletişim kutusu olmadan hemen kaldırır. Belirtilmezse, true veya boş bir dize verilirse varsayılan soru kullanılır.
attributes array Başka bir sekme türü dışında tüm alan türlerini kabul eder.

richtext

RichText alanları için öznitelik alanı.

JSON
{
  "type": "richtext"
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde uygulanacak varsayılan değer.
fallback string Alan değeri boş olduğunda gösterilecek yedek değer.

unit

Birim açılır menüsüyle birlikte bir sayı girişi oluşturur.

JSON
{
  "type": "unit"
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde uygulanacak varsayılan değer.
fallback string Alan değeri boş olduğunda gösterilecek yedek değer.
disableUnits boolean True ise birim seçme alanı gizlenir.
isPressEnterToChange boolean True ise onChange’i tetiklemek için ENTER tuşuna basılması gerekir. Etkinleştirildiğinde, sekmeyle alandan çıkınca da değişiklik tetiklenir.
isResetValueOnUnitChange boolean True ise ve seçilen birimin varsayılan değeri varsa, birimler değiştirilirken bu değer ayarlanır.
isUnitSelectTabbable boolean Birim seçme alanına sekmeyle odaklanılıp odaklanılamayacağını belirler.
units array

wysiwyg

Bir WYSIWYG düzenleyicisi oluşturur.

JSON
{
  "type": "wysiwyg"
}

Özellikler

Özellik Tür Açıklama
default string Blok ilk eklendiğinde uygulanacak varsayılan değer.
fallback string Alan değeri boş olduğunda görüntülenecek yedek değer.
toolbar object Düzenleyicinin araç çubuğu yapılandırması.
mode string code, alanı kod görünümünde açar. both, görsel görünüm ile kod görünümü arasında geçiş yapmak için bir düğme ekler.

Simge Yükleme

Düzenleyici, simge seçicisine ilk kez odaklandığınızda veya kümeyi ya da alt kümeyi değiştirdiğinizde bir simge kümesi yükler; blok seçildiğinde yüklemez. Aynı kümeyi isteyen alanlar devam eden isteği paylaşır. Yükleme öncesinde kayıtlı simge adı görünür kalır ve seçiciye yeniden odaklanmak başarısız bir isteği yeniden dener.

tabler-icons, outline ve filled öğelerini destekler. Seçilen küme için açıkça yapılandırılmış bir alt küme önceliklidir; aksi takdirde seçici, varsa solid öğesini, yoksa kümenin ilk alt kümesini kullanır. Alt kümeleri olmayan kümelerde subSet bulunmaz. Küme adları yalnızca paketlenmiş dosyalara karşılık gelir. Ön yüz işleme, tüm simge kümelerini veritabanı geçici verilerinde saklamak yerine tek tek simgeleri önbelleğe alır.

İçe Aktarılan Seçenek Değerleri

"multiple": true içeren onay kutuları ve seçim alanları normalde { "value": "...", "label": "..." } nesnelerinden oluşan bir dizi saklar. Ayrıca REST API veya içerik araçlarıyla içe aktarılan tek bir seçenek nesnesini, skaler bir dizeyi ya da sayıyı veya skaler değerlerden oluşan bir diziyi de kabul eder. Bu, tekrarlayıcı satırlarının içinde de çalışır.

Düzenleyici, dokunulmadan kaydedilen değerlerin saklanan biçimini yeniden yazmadan bunları seçili olarak gösterir. Bir seçimin eklenmesi veya kaldırılması, olağan seçenek nesneleri dizisini yazar. Sayısal 0 ve dize "0" geçerli seçimlerdir. Şablonlar, tıpkı düzenleyicide seçilen değerlerde olduğu gibi, alanın yapılandırılmış returnFormat değerini alır. Seçeneklerin yine de alanın tanımlanmış veya doldurulmuş seçenekleriyle eşleşmesi gerekir.

Saklanan değeri veya varsayılanı olmayan yerel bir tekli seçim alanı, ilk seçeneği yerine devre dışı boş bir yer tutucu gösterir. İlk seçenek açıkça seçildiğinde saklanır. Bir seçim saklandıktan sonra yer tutucu kaybolur. Düzenleyicilerin de seçimi temizleyebilmesi gerekiyorsa allowNull kullanın; boş bir yer tutucu, başka türlü zorunlu olan bir seçimin temizlenebilmesini sağlamaz.

Tekrarlayıcı Başlangıç Satırları

Düzenleyicide varsayılanlar, ekleme öncesinde iç içe minimum satırları içerir. Bunları başlatmak için bloğun ayarlarını açmanız gerekmez ve bloğu eklemek bu satırlar için ikinci bir geri alma adımı oluşturmaz.

Yinelenen alanında min varsa ancak kaydedilmiş bir değer veya açıkça belirtilmiş default yoksa sunucu, satır alanlarının varsayılan değerlerini kullanarak bu sayıda satır başlatır. Bu, PHP gömüleri, blok etiketleri ve düzenleyicide hiç açılmamış dosya tabanlı sayfa kaynakları için de geçerlidir. Örneğin, metin alanının varsayılan değeri "New item" olan "min": 2, bu değeri içeren iki satır oluşturur.

Kaydedilmiş satırlar ve açıkça belirtilmiş bir yinelenen alan default önceliklidir. Açıkça kaydedilmiş boş bir liste, false veya null silinmiş satırları yeniden oluşturmaz. Oluşturulan varsayılan değerler, oluşturma sırasında gönderiye yazılmaz. min ve max düzenleyici kontrollerini sınırlar; oluşturma sırasında kaydedilmiş listeyi kısaltmaz veya tamamlamaz. İçe aktarılan içerikteki satır sınırı ihlallerini bildirmek için bs_validate_block() kullanın.

default içermeyen satır alanları, oluşturulan bir satırda false olur; bu nedenle böyle bir satırın içeriği yoktur. Düzenleyicilerin ekleyip boş bıraktığı satırlar da aynı görünür. Her satır için kart, başlık veya liste öğesi oluşturan bir şablon, düzenleyici dışında içerik barındırmayan satırları atlamalı; alanlarının düzenlenebilir kalması için bunları düzenleyicide tutmalıdır:

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; ?>

Yinelenen Alanı Kaldırma

Bir satır kaldırıldığında düzenleyicinin Sil ve İptal düğmelerini içeren onay iletişim kutusu açılır. İptal’e tıklamak veya Escape tuşuna basmak satırı değiştirmez. İç içe yinelenen alanlarda da satır yalnızca onaylandıktan sonra kaldırılır.

textRemove tüm yinelenen alanlarda aynı davranışı denetler:

Değer Davranış
Belirtilmemiş, true veya "" Varsayılan onay sorusunu gösterir.
Boş olmayan bir dize Mevcut özel metin çeviri mekanizmasını kullanarak bu özel soruyu gösterir.
false İletişim kutusu açmadan satırı hemen kaldırır.

Örneğin, "textRemove": "Remove this team member?" soruyu değiştirir. Mevcut min kısıtlaması, minimumun altındaki satırların kaldırılmasını engellemeye devam eder.

Yinelenen Alanlarda İç İçe Yapı

Yinelenen bir satır, tabs dışındaki tüm alan türlerini kabul eder. Satırdaki bir tabs alanı, id içermeyen bir grubun içinde olsa bile, alanları yerine düzenleyicide bir bildirim gösterir. PHPStan uzantısı bunu block.json ve field.json için bildirir. Satırın alanlarını düz tutun veya sekmeleri yinelenen alanın dışına taşıyın.

WYSIWYG bağlantı araç çubuğu, varsayılan olarak target veya rel eklemeden aynı sekmede açılan bağlantılar ekler. toolbar.formats.link.opensInNewTab ile yeni sekmede açma seçeneğini etkinleştirin:

JSON
{
  "id": "content",
  "type": "wysiwyg",
  "toolbar": {
    "formats": {
      "link": {
        "opensInNewTab": true
      }
    }
  }
}

Yeni sekme seçildiğinde target="_blank" ve rel="noreferrer noopener" eklenir. Bu seçenek kapatıldığında otomatik öznitelikler kaldırılır. Bu alandaki her bağlantıya öznitelik uygulamak için toolbar.formats.link.attributes değerini ayarlayın; örneğin { "class": "content-link", "rel": "nofollow" }. Açık yapılandırma korunur ve yeni sekme güvenlik belirteçleri yapılandırılmış rel değerine eklenir.

Bir URL yazmak onu otomatik olarak bağlantıya dönüştürmez; alandaki mevcut bir bağlantıya tıklamak da düzenleyiciden ayrılmanıza yol açmaz. Önceden kaydedilmiş bağlantı öznitelikleri mevcut içerikte kalır; otomatik olarak taşınmaz.