Treci la conținut

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

Randează un control pentru alegerea linkurilor interne sau externe.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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:

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