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.
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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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. |
link
Dahili veya harici bağlantı seçmek için bir bağlantı denetimi oluşturur.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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ı.
{
"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.
{
"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.
{
"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 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ıları
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:
{
"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.