Vai al contenuto

Tipi di campo

Blockstudio offre una varietà di tipi di campo per creare interfacce dei blocchi.

I progetti possono anche registrare i propri tipi di campo con spazio dei nomi usando blockstudio/field_types. Usateli quando serve un nuovo controllo di modifica o una struttura del valore. Usate i campi custom/{name} quando dovete solo riutilizzare un gruppo di campi esistenti.

Ricettario dei modelli di campo

Ricette pratiche: gruppi condizionali, selezioni intelligenti, repeater e archiviazione interrogabile.

Proprietà generali

La tabella seguente elenca le proprietà condivise e le opzioni di valore comuni. default e fallback sono supportati dove indicato nella tabella delle proprietà di ciascun tipo di campo.

Proprietà Tipo Descrizione
id string Identificatore univoco dell’attributo
type string Tipo di campo
label string Etichetta visualizzata nell’editor
description string Testo descrittivo mostrato sotto il campo
default mixed Valore predefinito del campo
fallback mixed Valore di ripiego quando il campo è vuoto
help string Testo di aiuto visualizzato come descrizione al passaggio del mouse accanto all’etichetta
hidden boolean Nasconde il campo da UI
switch boolean Mostra un interruttore che può disattivare il campo. Il valore predefinito è false.
translate boolean Impostate su false per escludere il campo dalla configurazione WPML
conditions array Regole di logica condizionale

I campi File con "returnFormat": "id" conservano i riferimenti alle stringhe importate, inclusi i singoli valori nei ripetitori. I nomi non risolti mostrano schede di ripiego senza miniature; Blockstudio non li converte in ID degli allegati. Per i dettagli, consultate riferimenti portabili ai media.

Consultate Caricamento delle icone per le richieste del selettore, i nuovi tentativi e i sottoinsiemi di icone.

attributi

Visualizza i campi di input degli attributi data.

JSON
{
  "type": "attributes"
}

Proprietà

Proprietà Tipo Descrizione
default array Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback array Valore di fallback da visualizzare quando il valore del campo è vuoto.
link boolean Consente di selezionare un link da un menu a discesa.
media boolean Consente di selezionare un elemento multimediale da un menu a discesa.

block

Fa riferimento a un altro blocco Blockstudio, espandendone i campi in linea. Nei template, il valore restituisce l’output del blocco renderizzato.

JSON
{
  "type": "block"
}

Proprietà

Proprietà Tipo Descrizione
block string Il nome del blocco a cui fare riferimento (ad es. e.g, "mytheme/card").
returnFormat string Modalità di restituzione del valore nei template.

checkbox

Visualizza un insieme di caselle di controllo.

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

Proprietà

Proprietà Tipo Descrizione
default array | string | number Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback array | string | number Valore di ripiego da visualizzare quando il valore del campo è vuoto.
options array Opzioni tra cui scegliere.
returnFormat string Specifica il formato di restituzione del valore.
populate object
toggle boolean | string Aggiunge sopra le opzioni una casella di controllo che le seleziona o deseleziona tutte. Viene usata una stringa come etichetta; con true viene usata l’etichetta predefinita.

classes

Visualizza un campo per selezionare le classi CSS.

JSON
{
  "type": "classes"
}

Proprietà

Proprietà Tipo Descrizione
default string Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string Valore di fallback da visualizzare quando il valore del campo è vuoto.
tailwind boolean Indica se abilitare le classi Tailwind per questo campo di input.

code

Visualizza un editor di codice.

JSON
{
  "type": "code"
}

Proprietà

Proprietà Tipo Descrizione
default string Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string Valore di riserva da visualizzare quando il valore del campo è vuoto.
autoCompletion boolean Indica se abilitare o meno il completamento automatico.
foldGutter boolean Indica se mostrare o meno il margine di piegatura.
height string Altezza dell’editor.
language string Linguaggio da usare per l’evidenziazione della sintassi.
lineNumbers boolean Indica se visualizzare o meno i numeri di riga.
maxHeight string Altezza massima dell’editor.
minHeight string Altezza minima dell’editor.
popout boolean Indica se mostrare un pulsante che apre l’editor in una finestra popup.
asset boolean Rende CSS, SCSS o JavaScript del campo come risorsa del blocco, così il template non deve stampare il tag style o script.

color

Visualizza una palette di colori e un selettore di colori.

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

Proprietà

Proprietà Tipo Descrizione
default string Valore dell’opzione da selezionare quando si aggiunge il blocco per la prima volta.
fallback string Valore dell’opzione da visualizzare quando il valore del campo è vuoto.
options array
populate object
clearable boolean Indica se la tavolozza deve avere o meno un pulsante per cancellare la selezione.
disableCustomColors boolean Indica se consentire o meno un colore personalizzato.

date

Visualizza un selettore di date.

JSON
{
  "type": "date"
}

Proprietà

Proprietà Tipo Descrizione
default string Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string Valore di fallback da visualizzare quando il valore del campo è vuoto.
startOfWeek number Giorno di inizio della settimana. 0 per domenica, 1 per lunedì e così via.

datetime

Visualizza un selettore di data e ora.

JSON
{
  "type": "datetime"
}

Proprietà

Proprietà Tipo Descrizione
default string Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string Valore di fallback da visualizzare quando il valore del campo è vuoto.
is12Hour boolean Indica se usare il formato a 12 ore. Con questo formato viene visualizzato un selettore AM/PM e si presume che il formato della data sia MM-DD-YYYY (anziché il formato predefinito DD-MM-YYYY).

files

Visualizza un pulsante che apre la libreria multimediale. Gli elementi selezionati possono essere riordinati in linea.

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

Proprietà

Proprietà Tipo Descrizione
default array | object | number Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback array | object | number Valore di fallback da visualizzare quando il valore del campo è vuoto.
addToGallery boolean Se true, la finestra multimediale della galleria si apre direttamente nella libreria multimediale, dove l’utente può aggiungere altre immagini. Se false, si apre in modalità di modifica, che consente di modificare le immagini esistenti riordinandole, rimuovendole o cambiandone gli attributi. Si applica solo se gallery === true.
allowedTypes array | string Array contenente i tipi di elementi multimediali da caricare o selezionare dalla libreria multimediale. Ogni tipo è una stringa che può contenere il tipo MIME generale e.g: ‘image’, ‘audio’, ‘text’, oppure il tipo MIME completo e.g: ‘audio/mpeg’, ‘image/gif’. Se allowedTypes non è impostato, sono consentiti tutti i tipi MIME.
gallery boolean Se true, il componente inizializza tutti gli stati necessari per rappresentare una galleria. Per impostazione predefinita, la finestra multimediale si apre nella modalità di modifica della galleria, ma è possibile cambiare questo comportamento usando il flag addToGallery.
max number Numero massimo di file aggiungibili.
min number Numero minimo di file aggiungibili.
multiple boolean Indica se consentire selezioni multiple.
size boolean Aggiunge al campo un menu a discesa per la dimensione dell’elemento multimediale.
textMediaButton string Testo del pulsante multimediale.
title string Titolo visualizzato nella finestra multimediale.
returnFormat string Specifica il formato del valore restituito.
returnSize string Dimensione dell’elemento multimediale da restituire quando si usa il formato di restituzione URL.

gradient

Visualizza una palette di gradienti e un selettore di gradienti.

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

Proprietà

Proprietà Tipo Descrizione
default string Valore dell’opzione da selezionare quando si aggiunge il blocco per la prima volta.
fallback string Valore dell’opzione da visualizzare quando il valore del campo è vuoto.
options array
populate object
clearable boolean Indica se la tavolozza deve avere o meno un pulsante per cancellare la selezione.
disableCustomGradients boolean Indica se consentire o meno un colore personalizzato.

group

Visualizza più campi in un contenitore (facoltativamente) comprimibile.

JSON
{
  "type": "group"
}

Proprietà

Proprietà Tipo Descrizione
title string Testo del titolo. Rimane visibile anche quando il componente è chiuso.
opened boolean Se impostato su true, il componente rimane aperto indipendentemente dalla proprietà initialOpen e dalla
initialOpen boolean Indica se il pannello deve essere aperto inizialmente.
scrollAfterOpen boolean Scorre il contenuto fino a renderlo visibile.
class string Classe CSS personalizzata da applicare al gruppo.
style object Stili CSS personalizzati da applicare al gruppo.
attributes array Accetta tutti gli altri tipi di campo, tranne un altro tipo tabs.

html-tag

Visualizza un selettore di tag HTML. Utile per scegliere livelli di intestazione o elementi semantici.

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

Proprietà

Proprietà Tipo Descrizione
default string Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string Valore di fallback da visualizzare quando il valore del campo è vuoto.
tags string | array Tag da includere. Usa una stringa predefinita o un array di nomi di tag.
exclude array Tag da escludere dalla preimpostazione. Si applica solo quando si usa una stringa predefinita per i tag.

icon

Visualizza un’icona SVG da un set di icone.

JSON
{
  "type": "icon"
}

Proprietà

Proprietà Tipo Descrizione
default object Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback object Valore di fallback da visualizzare quando il valore del campo è vuoto.
sets array | string Set di icone da includere. Lascia vuoto per includerli tutti.
subSets array | string Sottoinsieme di icone da includere. Lascia vuoto per includerli tutti.
returnFormat string Formato in cui restituire l’icona.

Visualizza un controllo link per scegliere link interni o esterni.

JSON
{
  "type": "link"
}

Proprietà

Proprietà Tipo Descrizione
default object Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback object Valore di fallback da visualizzare quando il valore del campo è vuoto.
hasRichPreviews boolean Indica se mostrare anteprime avanzate quando si aggiunge un URL.
noDirectEntry boolean Indica se consentire la conversione diretta di una query di ricerca simile a URL in un link.
noURLSuggestion boolean Indica se aggiungere un suggerimento di fallback che tratta la query di ricerca come URL.
opensInNewTab boolean Aggiunge un controllo di attivazione alla finestra del link.
showSuggestions boolean Indica se mostrare suggerimenti durante la digitazione di URL.
textButton string Testo personalizzato da visualizzare all’interno del pulsante del link.
withCreateSuggestion boolean Indica se le ricerche di link senza risultati possono generare un suggerimento per creare una nuova pagina in bozza.

message

Visualizza un messaggio con contenuto personalizzato.

JSON
{
  "type": "message"
}

Proprietà

Proprietà Tipo Descrizione
default string Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string Valore di fallback da visualizzare quando il valore del campo è vuoto.
value string Messaggio da visualizzare. I dati del blocco e degli attributi sono disponibili con la sintassi tra parentesi quadre, e.g.: {block.title} oppure {attributes.text}

number

Visualizza un campo di input numerico.

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

Proprietà

Proprietà Tipo Descrizione
default number Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback number Valore di fallback da visualizzare quando il valore del campo è vuoto.
dragDirection string Determina l’asse di trascinamento per incrementare o decrementare il valore.
dragThreshold number Se isDragEnabled è true, specifica quanti px è necessario trascinare prima che il valore cambi.
hideHTMLArrows boolean Se true, nasconde le frecce HTML predefinite del campo di input.
isShiftStepEnabled boolean Se true, abilita il gesto di trascinamento del mouse per incrementare o decrementare il valore numerico. Tenendo premuto SHIFT durante il trascinamento, il valore aumenta in base a shiftStep.
max number Lunghezza massima del valore.
min number Lunghezza minima del valore.
required boolean Se true, impone un numero valido nell’intervallo min/max del controllo. Se false, consente una stringa vuota come valore valido.
shiftStep number Incremento applicato quando si tiene premuto il tasto SHIFT. Questo valore shift moltiplica il valore step. Ad esempio, se step è 5 e shiftStep è 10, ogni salto incrementa o decrementa il valore di 50.
step number Quantità di variazione del valore a ogni incremento o decremento. È anche usata per la convalida: il valore deve essere un multiplo di step (con scostamento pari a min, se specificato) per essere valido. Accetta il valore stringa speciale any, che annulla il vincolo di convalida e fa sì che le azioni di incremento o decremento aumentino o diminuiscano il valore di 1.

radio

Visualizza un insieme di pulsanti di opzione.

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

Proprietà

Proprietà Tipo Descrizione
default string | number Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string | number Valore di riserva da visualizzare quando il valore del campo è vuoto.
options array Opzioni tra cui scegliere.
returnFormat string Specifica il formato del valore restituito.
populate object
display string Impostare su buttonGroup per mostrare le opzioni come gruppo di pulsanti anziché come opzioni radio.
allowNull boolean Consente all’utente di cancellare il valore facendo clic di nuovo sull’opzione radio selezionata.

range

Visualizza un campo di intervallo per impostare un valore numerico tra due estremi.

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

Proprietà

Proprietà Tipo Descrizione
default number Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback number Valore di fallback da visualizzare quando il valore del campo è vuoto.
allowReset boolean Se true, viene visualizzato un pulsante per reimpostare il cursore.
initialPosition number Posizione iniziale del cursore, usata quando non viene passato alcun valore. initialPosition viene limitata ai valori min e max forniti come proprietà.
isShiftStepEnabled boolean Se true, abilita il gesto di trascinamento del mouse per incrementare o decrementare il valore numerico. Tenendo premuto SHIFT durante il trascinamento, il valore aumenta in base a shiftStep.
marks array Visualizza una rappresentazione grafica delle tacche di step. È possibile specificare indicatori personalizzati con un Array.
max number Lunghezza massima del valore.
min number Lunghezza minima del valore.
railColor string Stringa di colore CSS per personalizzare lo sfondo dell’elemento rail.
resetFallbackValue number Valore da ripristinare quando si fa clic sul pulsante Reimposta (abilitato da allowReset).
separatorType string Definisce se la linea di separazione sopra o sotto la riga del controllo deve essere disabilitata o a larghezza intera. Per impostazione predefinita, è posizionata sotto e non include la sottolineatura dell’icona del controllo.
shiftStep number Incremento applicato quando si tiene premuto il tasto SHIFT. Questo valore shift moltiplica il valore step. Ad esempio, se step è 5 e shiftStep è 10, ogni salto incrementa o decrementa il valore di 50.
showTooltip boolean Forza la visualizzazione o l’occultamento del Tooltip UI. Questa impostazione viene sovrascritta con false quando step è impostato sul valore stringa speciale any.
step number Quantità di variazione del valore a ogni incremento o decremento. È anche usata per la convalida: il valore deve essere un multiplo di step (con scostamento pari a min, se specificato) per essere valido. Accetta il valore stringa speciale any, che annulla il vincolo di convalida e fa sì che le azioni di incremento o decremento aumentino o diminuiscano il valore di 1.
trackColor string Stringa di colore CSS per personalizzare lo sfondo dell’elemento track.
withInputField boolean Determina se il campo numerico viene visualizzato accanto a RangeControl. Questa impostazione viene sovrascritta con false quando step è impostato sul valore stringa speciale any.

select

Visualizza un campo di selezione che supporta selezioni singole o multiple.

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

Proprietà

Proprietà Tipo Descrizione
default array | string | number Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback array | string | number Valore di fallback da visualizzare quando il valore del campo è vuoto.
multiple boolean Se true, è possibile selezionare più opzioni. «stylisedUi» viene abilitato automaticamente.
options array Opzioni tra cui scegliere.
returnFormat string Specifica il formato del valore restituito.
populate object
stylisedUi boolean Visualizza una versione stilizzata del campo di selezione, con la possibilità di cercare tra gli elementi.
allowNull boolean | string Consente all’utente di selezionare un’opzione vuota. Se true, l’etichetta sarà vuota; altrimenti, l’opzione mostrerà la stringa specificata.
allowReset boolean Se true, viene visualizzato un pulsante per reimpostare il campo di selezione.

tabs

Visualizza un’interfaccia a schede per raggruppare i campi.

JSON
{
  "type": "tabs"
}

Proprietà

Proprietà Tipo Descrizione
tabs array Schede da visualizzare.

text

Visualizza un campo di testo su una sola riga.

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

Proprietà

Proprietà Tipo Descrizione
default string Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string Valore di fallback da visualizzare quando il valore del campo è vuoto.
max number Lunghezza massima del valore.
min number Lunghezza minima del valore.

textarea

Visualizza un campo di input textarea.

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

Proprietà

Proprietà Tipo Descrizione
default string Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string Valore di fallback da visualizzare quando il valore del campo è vuoto.
max number Lunghezza massima del valore.
min number Lunghezza minima del valore.
rows number Numero di righe da includere nell’area di testo.

toggle

Visualizza un interruttore true/false.

JSON
{
  "type": "toggle"
}

Proprietà

Proprietà Tipo Descrizione
default boolean Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback boolean Valore di fallback da visualizzare quando il valore del campo è vuoto.

repeater

Genera un insieme di campi ripetibili.

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

Proprietà

Proprietà Tipo Descrizione
default array Righe con cui inizia un nuovo blocco. Ogni riga è un oggetto di valori dei campi. Ha la precedenza sulle righe create da min.
min number Numero minimo di righe.
max number Numero massimo di righe.
minimized boolean Comprimi le righe esistenti all’apertura dell’editor. Le righe aggiunte nell’editor sono inizialmente espanse.
textButton string Testo del pulsante di aggiunta.
textMinimized string | object Testo visualizzato quando le righe sono ridotte.
textRemove string | boolean Domanda di conferma mostrata nell’editor quando si rimuove una riga del ripetitore. Una stringa non vuota modifica la domanda; false rimuove la riga subito, senza finestra di dialogo. Se il valore è omesso, true o una stringa vuota, viene usata la domanda predefinita.
attributes array Accetta tutti gli altri tipi di campo, eccetto un altro campo tabs.

richtext

Campo attributo per i campi RichText.

JSON
{
  "type": "richtext"
}

Proprietà

Proprietà Tipo Descrizione
default string Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string Valore di ripiego visualizzato quando il valore del campo è vuoto.

unit

Genera un campo numerico con un menu a discesa per l’unità.

JSON
{
  "type": "unit"
}

Proprietà

Proprietà Tipo Descrizione
default string Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string Valore di ripiego visualizzato quando il valore del campo è vuoto.
disableUnits boolean Se è true, il campo di selezione dell’unità è nascosto.
isPressEnterToChange boolean Se è true, per attivare un onChange è necessario premere il tasto ENTER. Se l’opzione è attiva, la modifica viene attivata anche quando si passa al campo successivo con Tab.
isResetValueOnUnitChange boolean Se è true e l’unità selezionata ha un valore predefinito, questo viene impostato quando si cambia unità.
isUnitSelectTabbable boolean Determina se è possibile raggiungere con Tab il campo di selezione dell’unità.
units array

wysiwyg

Genera un editor WYSIWYG.

JSON
{
  "type": "wysiwyg"
}

Proprietà

Proprietà Tipo Descrizione
default string Valore predefinito da applicare quando si aggiunge il blocco per la prima volta.
fallback string Valore di riserva da visualizzare quando il valore del campo è vuoto.
toolbar object Configurazione della barra degli strumenti dell’editor.
mode string code apre il campo nella vista codice. both aggiunge un pulsante per passare dalla vista visuale a quella codice e viceversa.

Caricamento delle icone

L’editor carica un set di icone quando si dà per la prima volta il focus al selettore o si cambia set o sottoinsieme, non quando si seleziona il blocco. I campi che richiedono lo stesso set condividono la richiesta in corso. Il nome dell’icona memorizzato resta visibile prima del caricamento e, se una richiesta non riesce, dando di nuovo il focus al selettore il caricamento viene riprovato.

tabler-icons supporta outline e filled. Un sottoinsieme configurato esplicitamente per il set scelto ha la precedenza; altrimenti, se disponibile, il selettore usa solid oppure il primo sottoinsieme del set. I set senza sottoinsiemi non includono subSet. I nomi dei set rimandano solo ai file inclusi nel pacchetto. Il rendering sul frontend memorizza nella cache le singole icone, anziché salvare set di icone completi nei transient del database.

Valori delle opzioni importati

Le caselle di controllo e i menu di selezione con "multiple": true memorizzano normalmente un array di oggetti { "value": "...", "label": "..." }. Accettano anche un singolo oggetto opzione, una stringa o un numero scalare, oppure un array di valori scalari importati tramite REST API o strumenti per i contenuti. Questo funziona anche all’interno delle righe del ripetitore.

L’editor mostra questi valori come selezioni senza modificarne la struttura memorizzata quando si salva senza apportare modifiche. Aggiungendo o rimuovendo una selezione, viene scritto il consueto array di oggetti opzione. 0 numerici e "0" stringa sono selezioni valide. I template ricevono il valore returnFormat configurato per il campo, proprio come per i valori selezionati nell’editor. Le opzioni devono comunque corrispondere alle scelte dichiarate o popolate per il campo.

Un menu di selezione nativo singolo senza valore memorizzato né valore predefinito mostra un segnaposto vuoto disabilitato, non la prima opzione. Se si sceglie esplicitamente la prima opzione, questa viene memorizzata. Una volta memorizzata una scelta, il segnaposto scompare. Usate allowNull quando anche gli editor devono poter cancellare una selezione; un segnaposto vuoto non permette di cancellare una scelta che altrimenti è obbligatoria.

Righe iniziali del ripetitore

Nell’editor, i valori predefiniti includono le righe minime annidate prima dell’inserimento. Non occorre aprire le impostazioni del blocco per inizializzarle e l’inserimento del blocco non aggiunge un secondo passaggio di annullamento per quelle righe.

Quando un repeater ha min ma nessun valore salvato o default esplicito, il server inizializza quel numero di righe usando i valori predefiniti dei campi della riga. Questo vale anche per gli embed PHP, i tag dei blocchi e le sorgenti di pagina basate su file che non sono mai state aperte nell’editor. Per esempio, "min": 2 con un campo di testo il cui valore predefinito è "New item" mostra due righe contenenti quel valore.

Le righe salvate e un ripetitore esplicito default hanno la precedenza. Un elenco vuoto salvato esplicitamente, false o null non ricrea le righe rimosse. Il rendering non salva questi valori predefiniti generati nel post. min e max limitano i controlli dell’editor; non troncano né riempiono un elenco salvato durante il rendering. Usate bs_validate_block() per segnalare le violazioni dei limiti di riga nei contenuti importati.

I campi delle righe senza default sono false in una riga generata, quindi tale riga non contiene contenuti. Anche le righe aggiunte dagli editor e lasciate vuote hanno lo stesso aspetto. Un template che stampa una scheda, un titolo o un elemento di elenco per ogni riga dovrebbe saltare le righe senza contenuti fuori dall’editor e mantenerle nell’editor affinché i relativi campi restino modificabili:

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

Rimozione dei repeater

Rimuovendo una riga si apre la finestra di conferma dell’editor con i pulsanti Elimina e Annulla. Annulla o Escape lascia invariata la riga. La riga viene rimossa solo dopo la conferma, anche nei repeater nidificati.

textRemove controlla lo stesso comportamento per ogni repeater:

Valore Comportamento
Omitted, true o "" Mostra la domanda di conferma predefinita.
Una stringa non vuota Mostra la domanda personalizzata, usando il meccanismo esistente di traduzione del testo personalizzato.
false Rimuove subito la riga senza finestra di dialogo.

Per esempio, "textRemove": "Remove this team member?" modifica la domanda. La restrizione esistente min impedisce comunque di rimuovere righe al di sotto del minimo.

Nidificazione dei repeater

Una riga del ripetitore accetta tutti i tipi di campo tranne tabs. Un campo tabs in una riga, anche all’interno di un gruppo senza id, mostra un avviso nell’editor invece dei suoi campi. L’estensione PHPStan segnala il problema per block.json e field.json. Mantenete piatti i campi della riga oppure spostate le schede fuori dal ripetitore.

Per impostazione predefinita, la barra degli strumenti dei link WYSIWYG inserisce link che si aprono nella stessa scheda senza aggiungere target o rel. Attivate l’opzione per la nuova scheda con toolbar.formats.link.opensInNewTab:

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

Scegliendo una nuova scheda si aggiungono target="_blank" e rel="noreferrer noopener". Disattivandola si rimuovono questi attributi automatici. Per applicare attributi a ogni link in quel campo, impostate toolbar.formats.link.attributes, per esempio { "class": "content-link", "rel": "nofollow" }. La configurazione esplicita viene mantenuta e i token di sicurezza per la nuova scheda vengono aggiunti a rel configurato.

Digitare un URL non lo trasforma automaticamente in un link e fare clic su un link esistente nel campo non porta fuori dall’editor. Gli attributi dei link salvati in precedenza restano nei contenuti esistenti; non vengono migrati automaticamente.