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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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. |
link
Visualizza un controllo link per scegliere link interni o esterni.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"type": "tabs"
}
Proprietà
| Proprietà | Tipo | Descrizione |
|---|---|---|
tabs |
array |
Schede da visualizzare. |
text
Visualizza un campo di testo su una sola riga.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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à.
{
"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.
{
"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 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.
Link WYSIWYG
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:
{
"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.