Tipuri de câmpuri
Blockstudio oferă o varietate de tipuri de câmpuri pentru crearea interfețelor de blocuri.
Proiectele își pot înregistra și propriile tipuri de câmpuri cu spațiu de nume folosind
blockstudio/field_types. Folosiți această opțiune
când aveți nevoie de un control nou pentru editor sau de o structură de valori. Folosiți
câmpuri custom/{name} când aveți nevoie doar
de reutilizarea unui grup de câmpuri existente.
Rețetarul modelelor de câmpuri
Rețete practice: grupuri condiționale, selecții inteligente, repetitoare și stocare interogabilă.
Proprietăți generale
Tabelul de mai jos enumeră proprietățile comune și opțiunile uzuale pentru valori. default și fallback sunt acceptate acolo unde sunt enumerate în tabelul Proprietăți pentru fiecare tip de câmp.
| Proprietate | Tip | Descriere |
|---|---|---|
id |
string | Identificator unic pentru atribut |
type |
string | Tipul câmpului |
label |
string | Eticheta afișată în editor |
description |
string | Textul descriptiv afișat sub câmp |
default |
mixed | Valoarea implicită pentru câmp |
fallback |
mixed | Valoarea de rezervă folosită când câmpul este gol |
help |
string | Text de ajutor afișat ca indicație contextuală lângă etichetă |
hidden |
boolean | Ascunde câmpul din UI |
switch |
boolean | Afișează un comutator care poate dezactiva câmpul. Valoarea implicită este false. |
translate |
boolean | Setați la false pentru a exclude câmpul din configurația WPML |
conditions |
array | Reguli de logică condițională |
Câmpurile de tip fișier cu "returnFormat": "id" păstrează referințele de șir importate, inclusiv valorile individuale din repetoare. Numele nerezolvate afișează carduri de rezervă fără miniaturi; Blockstudio nu le rezolvă la ID-uri de atașament. Pentru detalii, consultați referințele media portabile.
Pentru solicitările selectorului, reîncercări și subseturi de pictograme, consultați Încărcarea pictogramelor.
attributes
Redă câmpurile de introducere pentru atributele de date.
{
"type": "attributes"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
array |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
array |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
link |
boolean |
Permite selectarea linkurilor dintr-un meniu derulant. |
media |
boolean |
Permite selectarea fișierelor media dintr-un meniu derulant. |
bloc
Face referire la un alt bloc Blockstudio, extinzându-i câmpurile în linie. În șabloane, valoarea returnează rezultatul randat al blocului.
{
"type": "block"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
block |
string |
Numele blocului la care se face referire (e.g, „mytheme/card”). |
returnFormat |
string |
Modul în care trebuie returnată valoarea în șabloane. |
checkbox
Randează un set de câmpuri de bifare.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
array | string | number |
Valoare implicită care trebuie aplicată la prima adăugare a blocului. |
fallback |
array | string | number |
Valoare de rezervă care va fi afișată când valoarea câmpului este goală. |
options |
array |
Opțiuni din care puteți alege. |
returnFormat |
string |
Specifică formatul valorii returnate. |
populate |
object |
|
toggle |
boolean | string |
Adaugă deasupra opțiunilor o casetă de selectare care le selectează sau le deselectează pe toate. Un șir este folosit ca etichetă, iar valoarea true folosește eticheta implicită. |
classes
Randează un câmp pentru selectarea claselor CSS.
{
"type": "classes"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
string |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
tailwind |
boolean |
Dacă se activează clasele Tailwind pentru acest câmp de intrare. |
code
Randează un editor de cod.
{
"type": "code"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea implicită aplicată la adăugarea inițială a blocului. |
fallback |
string |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
autoCompletion |
boolean |
Dacă se activează sau nu completarea automată. |
foldGutter |
boolean |
Dacă se afișează sau nu zona de pliere. |
height |
string |
Înălțimea editorului. |
language |
string |
Limbajul folosit pentru evidențierea sintaxei. |
lineNumbers |
boolean |
Dacă se afișează sau nu numerele de linie. |
maxHeight |
string |
Înălțimea maximă a editorului. |
minHeight |
string |
Înălțimea minimă a editorului. |
popout |
boolean |
Dacă se afișează un buton care deschide editorul într-o fereastră pop-up. |
asset |
boolean |
Redă CSS, SCSS sau JavaScript din câmp ca resursă a blocului, astfel încât șablonul să nu fie nevoit să afișeze eticheta de stil sau de script. |
color
Randează o paletă de culori și un selector de culori.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea opțiunii selectate la adăugarea inițială a blocului. |
fallback |
string |
Valoarea opțiunii afișate când valoarea câmpului este goală. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Dacă paleta trebuie să aibă sau nu un buton de ștergere. |
disableCustomColors |
boolean |
Dacă se permite sau nu o culoare personalizată. |
date
Randează un selector de date.
{
"type": "date"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
string |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
startOfWeek |
number |
Ziua în care trebuie să înceapă săptămâna. 0 pentru duminică, 1 pentru luni etc. |
datetime
Randează un selector de dată și oră.
{
"type": "datetime"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
string |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
is12Hour |
boolean |
Dacă se folosește formatul de 12 ore. În acest format se afișează un selector AM/PM, iar formatul orei este presupus a fi MM-DD-YYYY (spre deosebire de formatul implicit DD-MM-YYYY). |
files
Randează un buton către biblioteca media. Elementele selectate pot fi reordonate în linie.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
array | object | number |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
array | object | number |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
addToGallery |
boolean |
Dacă este true, fereastra media a galeriei se deschide direct în biblioteca media, unde utilizatorul poate adăuga imagini. Dacă este false, fereastra media a galeriei se deschide în modul de editare, unde utilizatorul poate edita imaginile existente reordonându-le, eliminându-le sau modificându-le atributele. Se aplică numai dacă gallery === true. |
allowedTypes |
array | string |
O listă de tipuri media care pot fi încărcate/selectate din biblioteca media. Fiecare tip este un șir care poate conține tipul MIME general e.g: ‘image’, ‘audio’, ‘text’ sau tipul MIME complet e.g: ‘audio/mpeg’, ‘image/gif’. Dacă allowedTypes nu este setat, sunt permise toate tipurile MIME. |
gallery |
boolean |
Dacă este true, componenta va inițializa toate stările necesare pentru a reprezenta o galerie. În mod implicit, fereastra media se deschide în cadrul de editare a galeriei, dar acest lucru poate fi schimbat folosind addToGalleryflag. |
max |
number |
Numărul maxim de fișiere care pot fi adăugate. |
min |
number |
Numărul minim de fișiere care pot fi adăugate. |
multiple |
boolean |
Dacă sunt permise selecții multiple. |
size |
boolean |
Adaugă un meniu derulant pentru dimensiunea media la câmp. |
textMediaButton |
string |
Textul butonului media. |
title |
string |
Titlul afișat în fereastra media. |
returnFormat |
string |
Specifică formatul valorii returnate. |
returnSize |
string |
Dimensiunea media returnată când se folosește formatul de returnare URL. |
gradient
Randează o paletă de degradeuri și un selector de degradeuri.
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea opțiunii selectate la adăugarea inițială a blocului. |
fallback |
string |
Valoarea opțiunii afișate când valoarea câmpului este goală. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Dacă paleta trebuie să aibă sau nu un buton de ștergere. |
disableCustomGradients |
boolean |
Dacă se permite sau nu o culoare personalizată. |
group
Randează mai multe câmpuri într-un container care poate fi restrâns opțional.
{
"type": "group"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
title |
string |
Textul titlului. Este afișat chiar și când componenta este închisă. |
opened |
boolean |
Când este setat la true, componenta va rămâne deschisă indiferent de proprietatea initialOpen și de |
initialOpen |
boolean |
Dacă panoul începe sau nu în stare deschisă. |
scrollAfterOpen |
boolean |
Derulează conținutul în zona vizibilă. |
class |
string |
Clasă CSS personalizată, aplicată grupului. |
style |
object |
Stiluri CSS personalizate, aplicate grupului. |
attributes |
array |
Acceptă toate celelalte tipuri de câmp, cu excepția unui alt set de file. |
html-tag
Randează un selector de etichete HTML. Util pentru alegerea nivelurilor de titlu sau a elementelor semantice.
{
"type": "html-tag"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
string |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
tags |
string | array |
Ce etichete să includă. Folosiți un șir presetat sau o listă de nume de etichete. |
exclude |
array |
Etichete de exclus din presetare. Se aplică numai când se folosește un șir presetat pentru etichete. |
icon
Randează o pictogramă SVG dintr-un set de pictograme.
{
"type": "icon"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
object |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
object |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
sets |
array | string |
Setul de pictograme de inclus. Lăsați necompletat pentru a le include pe toate. |
subSets |
array | string |
Subsetul de pictograme de inclus. Lăsați necompletat pentru a le include pe toate. |
returnFormat |
string |
Formatul în care se returnează pictograma. |
link
Randează un control pentru alegerea linkurilor interne sau externe.
{
"type": "link"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
object |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
object |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
hasRichPreviews |
boolean |
Dacă se afișează previzualizări îmbogățite la adăugarea unui URL. |
noDirectEntry |
boolean |
Dacă se permite transformarea directă a unei căutări de tip URL într-un link. |
noURLSuggestion |
boolean |
Dacă se adaugă o sugestie de rezervă care tratează căutarea ca pe un URL. |
opensInNewTab |
boolean |
Adaugă un comutator la fereastra linkului. |
showSuggestions |
boolean |
Dacă se afișează sugestii la tastarea URL. |
textButton |
string |
Text personalizat afișat în interiorul butonului de link. |
withCreateSuggestion |
boolean |
Dacă căutările de linkuri fără rezultate pot crea o sugestie pentru o pagină nouă, aflată în stadiul de ciornă. |
message
Randează un mesaj cu conținut personalizat.
{
"type": "message"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
string |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
value |
string |
Mesajul de afișat. Datele blocului și ale atributelor sunt disponibile în sintaxa cu paranteze pătrate, e.g.: {block.title} sau {attributes.text} |
number
Randează un câmp de introducere a numerelor.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
number |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
number |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
dragDirection |
string |
Stabilește axa de tragere pentru incrementarea/decrementarea valorii. |
dragThreshold |
number |
Dacă isDragEnabled este true, stabilește câți px trebuie să fie tras înainte ca valoarea să se schimbe. |
hideHTMLArrows |
boolean |
Dacă este true, săgețile implicite HTML ale câmpului de introducere vor fi ascunse. |
isShiftStepEnabled |
boolean |
Dacă este true, activează tragerea cu mouse-ul pentru a incrementa/decrementa valoarea. Ținând apăsată tasta SHIFT în timpul tragerii, valoarea va crește cu shiftStep. |
max |
number |
Lungimea maximă a valorii. |
min |
number |
Lungimea minimă a valorii. |
required |
boolean |
Dacă este true, impune o valoare numerică validă în intervalul min/max al controlului. Dacă este false, permite un șir gol ca valoare validă. |
shiftStep |
number |
Valoarea cu care se incrementează când tasta SHIFT este apăsată. Această valoare este un multiplicator al pasului. De exemplu, dacă pasul este 5 și shiftStep este 10, fiecare salt va incrementa/decrementa valoarea cu 50. |
step |
number |
Valoarea cu care se modifică numărul la incrementare/decrementare. Este folosită și la validare: valoarea trebuie să fie un multiplu al pasului (deplasat cu min, dacă este specificat) pentru a fi validă. Acceptă valoarea specială de tip șir any, care anulează constrângerea de validare și face ca acțiunile de incrementare/decrementare să modifice valoarea cu 1. |
radio
Randează un set de opțiuni radio.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string | number |
Valoarea implicită aplicată la adăugarea inițială a blocului. |
fallback |
string | number |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
options |
array |
Opțiunile disponibile pentru selectare. |
returnFormat |
string |
Specifică formatul valorii returnate. |
populate |
object |
|
display |
string |
Setați la buttonGroup pentru a afișa opțiunile ca grup de butoane în locul câmpurilor radio. |
allowNull |
boolean |
Permite utilizatorului să șteargă valoarea făcând clic din nou pe câmpul radio selectat. |
range
Randează un câmp cu glisor pentru setarea unei valori numerice între două puncte.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
number |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
number |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
allowReset |
boolean |
Dacă această proprietate este true, este afișat un buton pentru resetarea glisorului. |
initialPosition |
number |
Poziția inițială a glisorului, folosită când nu este transmisă nicio valoare. initialPosition va fi limitată la valorile min și max specificate prin proprietăți. |
isShiftStepEnabled |
boolean |
Dacă este true, activează tragerea cu mouse-ul pentru a incrementa/decrementa valoarea numerică. Ținând apăsată tasta SHIFT în timpul tragerii, valoarea va crește cu shiftStep. |
marks |
array |
Randează o reprezentare vizuală a marcajelor de pas. Marcajele personalizate pot fi furnizate sub forma unui Array. |
max |
number |
Lungimea maximă a valorii. |
min |
number |
Lungimea minimă a valorii. |
railColor |
string |
Șirul de culoare CSS folosit pentru a personaliza fundalul șinei. |
resetFallbackValue |
number |
Valoarea la care se revine dacă se apasă butonul Reset (activat prin allowReset). |
separatorType |
string |
Stabilește dacă linia separatoare de sub/deasupra rândului de control trebuie dezactivată sau să ocupe toată lățimea. În mod implicit, este plasată dedesubt, fără a include linia de sub pictograma controlului. |
shiftStep |
number |
Valoarea cu care se incrementează când tasta SHIFT este apăsată. Această valoare este un multiplicator al pasului. De exemplu, dacă pasul este 5 și shiftStep este 10, fiecare salt va incrementa/decrementa valoarea cu 50. |
showTooltip |
boolean |
Forțează afișarea sau ascunderea Tooltip UI. Această setare este suprascrisă cu false când step are valoarea specială de tip șir any. |
step |
number |
Valoarea cu care se modifică numărul la incrementare/decrementare. Este folosită și la validare: valoarea trebuie să fie un multiplu al pasului (deplasat cu min, dacă este specificat) pentru a fi validă. Acceptă valoarea specială de tip șir any, care anulează constrângerea de validare și face ca acțiunile de incrementare/decrementare să modifice valoarea cu 1. |
trackColor |
string |
Șirul de culoare CSS folosit pentru a personaliza fundalul pistei. |
withInputField |
boolean |
Stabilește dacă câmpul numeric va fi afișat lângă controlul Range. Această setare este suprascrisă cu false când step are valoarea specială de tip șir any. |
select
Randează un câmp de selecție care acceptă selecții simple sau multiple.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
array | string | number |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
array | string | number |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
multiple |
boolean |
Dacă este true, se pot selecta mai multe opțiuni. „stylisedUi” va fi activat automat. |
options |
array |
Opțiunile disponibile. |
returnFormat |
string |
Specifică formatul valorii returnate. |
populate |
object |
|
stylisedUi |
boolean |
Randează o versiune stilizată a câmpului de selecție, cu posibilitatea de a căuta printre elemente. |
allowNull |
boolean | string |
Permite utilizatorului să aleagă o opțiune goală. Dacă este true, eticheta va fi goală; în caz contrar, opțiunea va afișa șirul specificat. |
allowReset |
boolean |
Dacă această proprietate este true, este afișat un buton pentru resetarea câmpului de selecție. |
tabs
Randează o interfață cu file pentru gruparea câmpurilor.
{
"type": "tabs"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
tabs |
array |
Filele de afișat. |
text
Randează un câmp de introducere a textului pe o singură linie.
{
"type": "text",
"min": 0,
"max": 100
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
string |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
max |
number |
Lungimea maximă a valorii. |
min |
number |
Lungimea minimă a valorii. |
textarea
Randează un câmp de introducere textarea.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
string |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
max |
number |
Lungimea maximă a valorii. |
min |
number |
Lungimea minimă a valorii. |
rows |
number |
Numărul de rânduri pe care trebuie să le conțină câmpul textarea. |
toggle
Randează un comutator true/false.
{
"type": "toggle"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
boolean |
Valoarea implicită care trebuie aplicată la adăugarea inițială a blocului. |
fallback |
boolean |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
repeater
Redă un set de câmpuri care pot fi repetate.
{
"type": "repeater",
"min": 0,
"max": 100
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
array |
Rândurile inițiale ale unui bloc nou. Fiecare rând este un obiect cu valori de câmp. Are prioritate față de rândurile create de min. |
min |
number |
Numărul minim de rânduri. |
max |
number |
Numărul maxim de rânduri. |
minimized |
boolean |
Restrânge rândurile existente la deschiderea editorului. Rândurile adăugate în editor sunt extinse inițial. |
textButton |
string |
Textul butonului de adăugare. |
textMinimized |
string | object |
Textul afișat când rândurile sunt restrânse. |
textRemove |
string | boolean |
Întrebarea de confirmare afișată în editor la eliminarea unui rând repetor. Un șir nevid înlocuiește întrebarea; false elimină imediat, fără dialog. Dacă este omisă, are valoarea true sau este un șir gol, se folosește întrebarea implicită. |
attributes |
array |
Acceptă toate celelalte tipuri de câmpuri, cu excepția unui alt câmp de tip tabs. |
richtext
Câmp atribut pentru câmpurile RichText.
{
"type": "richtext"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea implicită aplicată la adăugarea inițială a blocului. |
fallback |
string |
Valoarea alternativă afișată când valoarea câmpului este goală. |
unit
Redă un câmp numeric cu un meniu derulant pentru unități.
{
"type": "unit"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea implicită aplicată la adăugarea inițială a blocului. |
fallback |
string |
Valoarea alternativă afișată când valoarea câmpului este goală. |
disableUnits |
boolean |
Dacă este true, câmpul de selectare a unității este ascuns. |
isPressEnterToChange |
boolean |
Dacă este true, apăsarea tastei ENTER este necesară pentru a declanșa onChange. Dacă opțiunea este activată, modificarea se declanșează și când părăsiți câmpul cu Tab. |
isResetValueOnUnitChange |
boolean |
Dacă este true și unitatea selectată are o valoare implicită, aceasta este setată la schimbarea unităților. |
isUnitSelectTabbable |
boolean |
Stabilește dacă se poate ajunge la câmpul de selectare a unității cu Tab. |
units |
array |
wysiwyg
Redă un editor WYSIWYG.
{
"type": "wysiwyg"
}
Proprietăți
| Proprietate | Tip | Descriere |
|---|---|---|
default |
string |
Valoarea implicită aplicată la adăugarea inițială a blocului. |
fallback |
string |
Valoarea de rezervă afișată când valoarea câmpului este goală. |
toolbar |
object |
Configurația barei de instrumente a editorului. |
mode |
string |
code deschide câmpul în vizualizarea de cod. both adaugă un buton pentru comutarea între vizualizarea vizuală și cea de cod. |
Încărcarea pictogramelor
Editorul încarcă un set de pictograme când focalizați pentru prima dată selectorul acestuia sau când schimbați setul ori subsetul, nu când selectați blocul. Câmpurile care solicită același set partajează cererea în curs. Numele pictogramei salvate rămâne vizibil înainte de încărcare, iar refocalizarea selectorului reîncearcă o cerere eșuată.
tabler-icons acceptă outline și filled. Un subset configurat explicit pentru setul ales are prioritate; în caz contrar, selectorul folosește solid, dacă este disponibil, sau primul subset al setului. Seturile fără subseturi omit subSet. Numele seturilor corespund numai fișierelor incluse. Redarea în interfața frontend memorează în cache pictograme individuale, nu stochează seturi complete de pictograme în date temporare ale bazei de date.
Valori de opțiuni importate
Casetele de selectare și listele de selecție cu "multiple": true stochează de obicei un tablou de obiecte { "value": "...", "label": "..." }. Acceptă și un singur obiect de opțiune, un șir sau număr scalar ori un tablou de valori scalare importate prin REST API sau prin instrumentele de conținut. Acest lucru funcționează și în rândurile repetorului.
Editorul afișează aceste valori ca selecții fără să le rescrie structura stocată dacă nu se fac modificări înainte de salvare. Adăugarea sau eliminarea unei selecții scrie tabloul obișnuit de obiecte de opțiuni. Valorile numerice 0 și cele de tip șir "0" sunt selecții valide. Șabloanele primesc returnFormat configurat pentru câmp, la fel ca în cazul valorilor selectate în editor. Opțiunile trebuie în continuare să corespundă alegerilor declarate sau populate ale câmpului.
Un meniu nativ cu o singură selecție, fără valoare stocată sau implicită, afișează un substituent gol dezactivat, nu prima opțiune. Alegerea explicită a primei opțiuni o stochează. După stocarea unei opțiuni, substituentul dispare. Folosiți allowNull dacă editorii trebuie să poată și șterge o selecție; un substituent gol nu permite ștergerea unei opțiuni care altfel este obligatorie.
Rândurile inițiale ale repetorului
În editor, valorile implicite includ rândurile minime imbricate înainte de inserare. Nu este necesar să deschideți setările blocului pentru a le inițializa, iar inserarea blocului nu adaugă un al doilea pas de anulare pentru aceste rânduri.
Când un repetor are min, dar nu are o valoare salvată sau default explicit, serverul
inițializează atâtea rânduri folosind valorile implicite ale câmpurilor din rând. Acest lucru se aplică și
pentru embeduri PHP, etichete de bloc și surse de pagină bazate pe fișiere care nu au fost niciodată
deschise în editor. De exemplu, "min": 2, cu un câmp text a cărui valoare implicită
este "New item", afișează două rânduri care conțin acea valoare.
Rândurile stocate și o valoare default explicită a repetorului au prioritate. O listă goală salvată explicit, false sau null nu recreează rândurile eliminate. La randare,
aceste valori implicite generate nu sunt scrise în postare. min și max
limitează controalele din editor; nu trunchiază și nu completează o listă salvată la randare.
Folosiți bs_validate_block() pentru a
semnala încălcările limitelor de rând din conținutul importat.
Câmpurile rândurilor fără default sunt false într-un rând generat, așa că un astfel de rând
nu are conținut. Rândurile adăugate de editori și lăsate goale arată la fel. Un
șablon care afișează un card, un titlu sau un element de listă pentru fiecare rând ar trebui
să omită rândurile fără conținut în afara editorului și să le păstreze în editor, astfel încât
câmpurile lor să rămână editabile:
<?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; ?>
Eliminarea repetorului
Eliminarea unui rând deschide dialogul de confirmare al editorului, cu butoanele Șterge și Anulează. Anularea sau apăsarea tastei Escape lasă rândul neschimbat. Rândul este eliminat numai după confirmare, inclusiv în repetoarele imbricate.
textRemove controlează același comportament pentru fiecare repetor:
| Valoare | Comportament |
|---|---|
Omis, true sau "" |
Afișează întrebarea de confirmare implicită. |
| Un șir nevid | Afișează întrebarea personalizată, folosind mecanismul existent de traducere a textului personalizat. |
false |
Elimină rândul imediat, fără dialog. |
De exemplu, "textRemove": "Remove this team member?" schimbă întrebarea.
Restricția existentă min împiedică în continuare eliminarea rândurilor sub numărul minim.
Imbricarea repetorului
Un rând al repetorului acceptă toate tipurile de câmpuri, cu excepția tabs. Un câmp tabs dintr-un rând,
inclusiv într-un grup fără id, afișează o notificare în editor în locul câmpurilor sale. Extensia PHPStan semnalează acest lucru pentru block.json
și field.json. Păstrați câmpurile rândului la același nivel sau mutați filele în afara
repetorului.
Linkuri WYSIWYG
Bara de instrumente pentru linkuri WYSIWYG inserează implicit linkuri care se deschid în aceeași filă, fără a adăuga target sau rel.
Activați opțiunea pentru o filă nouă cu toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
Alegerea unei file noi adaugă target="_blank" și rel="noreferrer noopener".
Dezactivarea acestei opțiuni elimină acele atribute automate. Pentru a aplica atribute tuturor
linkurilor din acel câmp, setați toolbar.formats.link.attributes, de exemplu
{ "class": "content-link", "rel": "nofollow" }. Configurația explicită este
păstrată, iar tokenurile de siguranță pentru file noi sunt adăugate la rel configurat.
Tastarea unui URL nu îl transformă automat într-un link, iar clicul pe un link existent din câmp nu părăsește editorul. Atributele linkurilor salvate anterior rămân în conținutul existent; acestea nu sunt migrate automat.