Tipos de campos
Blockstudio ofrece varios tipos de campo para crear interfaces de bloques.
Los proyectos también pueden registrar sus propios tipos de campo con espacio de nombres mediante blockstudio/field_types. Úsalo cuando necesites un nuevo control del editor o una estructura de valores. Usa los campos custom/{name} cuando solo necesites reutilizar un grupo de campos existentes.
Recetario de patrones de campos
Recetas prácticas: grupos condicionales, selectores inteligentes, repetidores y almacenamiento consultable.
Propiedades generales
La tabla siguiente enumera las propiedades compartidas y las opciones de valores habituales. default y fallback son compatibles cuando se indican en la tabla de propiedades de cada tipo de campo.
| Propiedad | Tipo | Descripción |
|---|---|---|
id |
string | Identificador único del atributo |
type |
string | El tipo de campo |
label |
string | Etiqueta que se muestra en el editor |
description |
string | Texto de descripción que se muestra debajo del campo |
default |
mixed | Valor predeterminado del campo |
fallback |
mixed | Valor alternativo cuando el campo está vacío |
help |
string | Texto de ayuda que se muestra en una información emergente junto a la etiqueta |
hidden |
boolean | Ocultar el campo del UI |
switch |
boolean | Mostrar un interruptor para desactivar el campo. El valor predeterminado es false. |
translate |
boolean | Establézcalo en false para excluir el campo de la configuración WPML |
conditions |
array | Reglas de lógica condicional |
Los campos de archivos con "returnFormat": "id" conservan las referencias de cadena importadas, incluidos los valores individuales dentro de repetidores. Los nombres sin resolver muestran tarjetas de reserva sin miniaturas; Blockstudio no los convierte en IDs de adjuntos. Consulte referencias portátiles a medios para obtener más información.
Consulte Carga de iconos para ver las solicitudes del selector, los reintentos y los subconjuntos de iconos.
attributes
Representa entradas de atributos de datos.
{
"type": "attributes"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
array |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
array |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
link |
boolean |
Permite seleccionar enlaces en un menú desplegable. |
media |
boolean |
Permite seleccionar medios en un menú desplegable. |
bloque
Hace referencia a otro bloque Blockstudio y muestra sus campos en línea. En las plantillas, el valor devuelve el contenido del bloque renderizado.
{
"type": "block"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
block |
string |
El nombre del bloque al que se hace referencia (e.g., "mytheme/card"). |
returnFormat |
string |
Cómo se debe devolver el valor en las plantillas. |
casilla de verificación
Muestra un conjunto de casillas de verificación.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
array | string | number |
Valor predeterminado que se aplicará al añadir el bloque por primera vez. |
fallback |
array | string | number |
Valor alternativo que se mostrará cuando el valor del campo esté vacío. |
options |
array |
Opciones entre las que elegir. |
returnFormat |
string |
Especifica el formato del valor devuelto. |
populate |
object |
|
toggle |
boolean | string |
Añade una casilla encima de las opciones para seleccionarlas todas o deseleccionarlas. Se usa una cadena como etiqueta; el valor true usa la etiqueta predeterminada. |
clases
Muestra un campo para seleccionar clases CSS.
{
"type": "classes"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
tailwind |
boolean |
Indica si se habilitan las clases Tailwind para este campo de entrada. |
código
Muestra un editor de código.
{
"type": "code"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
autoCompletion |
boolean |
Indica si se habilita el autocompletado. |
foldGutter |
boolean |
Indica si se muestra el margen de plegado. |
height |
string |
Altura del editor. |
language |
string |
Lenguaje que se utilizará para resaltar la sintaxis. |
lineNumbers |
boolean |
Indica si se muestran los números de línea. |
maxHeight |
string |
Altura máxima del editor. |
minHeight |
string |
Altura mínima del editor. |
popout |
boolean |
Indica si se muestra un botón para abrir el editor en una ventana emergente. |
asset |
boolean |
Renderiza CSS, SCSS o JavaScript del campo como un recurso del bloque, por lo que la plantilla no necesita imprimir la etiqueta de estilo o de script. |
color
Muestra una paleta de colores y un selector de color.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor de la opción que se seleccionará al añadir el bloque por primera vez. |
fallback |
string |
Valor de la opción que se mostrará cuando el valor del campo esté vacío. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Indica si la paleta debe incluir un botón para borrar la selección. |
disableCustomColors |
boolean |
Indica si se permite un color personalizado. |
fecha
Muestra un selector de fecha.
{
"type": "date"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
startOfWeek |
number |
Día en que debe comenzar la semana. 0 para domingo, 1 para lunes, etc. |
fecha y hora
Muestra un selector de fecha y hora.
{
"type": "datetime"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
is12Hour |
boolean |
Indica si se usa el reloj de 12 horas. Con este formato se muestra un control AM/PM y se presupone el formato de hora MM-DD-YYYY (en lugar del formato predeterminado DD-MM-YYYY). |
archivos
Muestra un botón para abrir la biblioteca de medios. Los elementos seleccionados se pueden reordenar en línea.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
array | object | number |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
array | object | number |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
addToGallery |
boolean |
Si es true, el modal de medios de la galería se abre directamente en la biblioteca de medios, donde el usuario puede añadir imágenes. Si es false, se abre en el modo de edición, donde puede editar las imágenes existentes, reordenarlas, eliminarlas o cambiar sus atributos. Solo se aplica si gallery === true. |
allowedTypes |
array | string |
Matriz con los tipos de medios que se pueden subir o seleccionar en la biblioteca. Cada tipo es una cadena que puede contener el tipo MIME general e.g: ‘image’, ‘audio’, ‘text’, o el tipo MIME completo e.g: ‘audio/mpeg’, ‘image/gif’. Si allowedTypes no está definido, se permiten todos los tipos MIME. |
gallery |
boolean |
Si es true, el componente inicia todos los estados necesarios para representar una galería. De forma predeterminada, el modal de medios se abre en el marco de edición de la galería, pero esto puede cambiarse mediante addToGalleryflag. |
max |
number |
Cantidad máxima de archivos que se pueden añadir. |
min |
number |
Cantidad mínima de archivos que se pueden añadir. |
multiple |
boolean |
Indica si se permiten varias selecciones. |
size |
boolean |
Añade al campo un menú desplegable para elegir el tamaño del medio. |
textMediaButton |
string |
Texto del botón de medios. |
title |
string |
Título que se muestra en el modal de medios. |
returnFormat |
string |
Especifica el formato del valor devuelto. |
returnSize |
string |
Tamaño del medio que se devuelve al usar el formato de retorno URL. |
degradado
Muestra una paleta de degradados y un selector de degradado.
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor de la opción que se seleccionará al añadir el bloque por primera vez. |
fallback |
string |
Valor de la opción que se mostrará cuando el valor del campo esté vacío. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Indica si la paleta debe incluir un botón para borrar la selección. |
disableCustomGradients |
boolean |
Indica si se permite un color personalizado. |
grupo
Muestra varios campos dentro de un contenedor que puede contraerse.
{
"type": "group"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
title |
string |
Texto del título. Se muestra incluso cuando el componente está cerrado. |
opened |
boolean |
Si se establece en true, el componente permanecerá abierto independientemente de la propiedad initialOpen y de la |
initialOpen |
boolean |
Indica si el panel empieza abierto. |
scrollAfterOpen |
boolean |
Desplaza el contenido hasta la vista cuando está visible. |
class |
string |
Clase CSS personalizada que se aplica al grupo. |
style |
object |
Estilos CSS personalizados que se aplican al grupo. |
attributes |
array |
Acepta todos los demás tipos de campo, excepto otro campo de pestañas. |
etiqueta HTML
Muestra un selector de etiquetas HTML. Es útil para elegir niveles de encabezado o elementos semánticos.
{
"type": "html-tag"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
tags |
string | array |
Etiquetas que se deben incluir. Usa una cadena predefinida o una matriz de nombres de etiquetas. |
exclude |
array |
Etiquetas que se deben excluir del conjunto predefinido. Solo se aplica cuando se usa una cadena predefinida para las etiquetas. |
icono
Muestra un icono SVG de un conjunto de iconos.
{
"type": "icon"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
object |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
object |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
sets |
array | string |
Conjunto de iconos que se debe incluir. Déjalo vacío para incluirlos todos. |
subSets |
array | string |
Subconjunto de iconos que se debe incluir. Déjalo vacío para incluirlos todos. |
returnFormat |
string |
Formato en que se devuelve el icono. |
enlace
Muestra un control de enlace para elegir enlaces internos o externos.
{
"type": "link"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
object |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
object |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
hasRichPreviews |
boolean |
Indica si se muestran vistas previas enriquecidas al añadir un URL. |
noDirectEntry |
boolean |
Indica si se puede convertir directamente una consulta de búsqueda similar a URL en un enlace. |
noURLSuggestion |
boolean |
Indica si se añade una sugerencia alternativa que trata la consulta de búsqueda como un URL. |
opensInNewTab |
boolean |
Añade un control de alternancia al modal de enlaces. |
showSuggestions |
boolean |
Indica si se muestran sugerencias al escribir el URL. |
textButton |
string |
Texto personalizado que se muestra dentro del botón de enlace. |
withCreateSuggestion |
boolean |
Indica si las búsquedas de enlaces sin coincidencias pueden sugerir la creación de una nueva página en borrador. |
mensaje
Muestra un mensaje con contenido personalizado.
{
"type": "message"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
value |
string |
Mensaje que se muestra. Los datos del bloque y sus atributos están disponibles mediante la sintaxis de corchetes, e.g: {block.title} o {attributes.text} |
número
Muestra un campo de entrada numérica.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
number |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
number |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
dragDirection |
string |
Determina el eje de arrastre para aumentar o reducir el valor. |
dragThreshold |
number |
Si isDragEnabled es true, controla cuántos px hay que arrastrar antes de que cambie el valor. |
hideHTMLArrows |
boolean |
Si es true, se ocultan las flechas predeterminadas HTML del campo de entrada. |
isShiftStepEnabled |
boolean |
Si es true, permite usar el gesto de arrastre del ratón para aumentar o reducir el valor numérico. Al mantener pulsada la tecla SHIFT mientras se arrastra, el valor aumenta según shiftStep. |
max |
number |
Longitud máxima del valor. |
min |
number |
Longitud mínima del valor. |
required |
boolean |
Si es true, exige un número válido dentro del rango mín./máx. del control. Si es false, permite que una cadena vacía sea un valor válido. |
shiftStep |
number |
Cantidad que se suma al mantener pulsada la tecla SHIFT. Este valor de desplazamiento multiplica el valor de step. Por ejemplo, si step es 5 y shiftStep es 10, cada salto aumenta o reduce el valor en 50. |
step |
number |
Cantidad en que cambia el valor al aumentarlo o reducirlo. También se usa para validarlo: el valor debe ser múltiplo de step (con el desplazamiento de min, si se especifica) para ser válido. Acepta la cadena especial any, que anula la restricción de validación y hace que cada acción de incremento o reducción cambie el valor en 1. |
botón de opción
Muestra un conjunto de botones de opción.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string | number |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string | number |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
options |
array |
Opciones disponibles. |
returnFormat |
string |
Especifica el formato del valor devuelto. |
populate |
object |
|
display |
string |
Establece el valor en buttonGroup para mostrar las opciones como un grupo de botones en lugar de controles de opción. |
allowNull |
boolean |
Permite al usuario borrar el valor haciendo clic de nuevo en el control de opción seleccionado. |
rango
Muestra un control deslizante para establecer un valor numérico entre dos puntos.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
number |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
number |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
allowReset |
boolean |
Si esta propiedad es true, se muestra un botón para restablecer el control deslizante. |
initialPosition |
number |
Posición inicial del control deslizante, que se usa cuando no se proporciona ningún valor. initialPosition se ajustará a los valores min y max proporcionados. |
isShiftStepEnabled |
boolean |
Si es true, permite usar el gesto de arrastre del ratón para aumentar o reducir el valor numérico. Al mantener pulsada la tecla SHIFT mientras se arrastra, el valor aumenta según shiftStep. |
marks |
array |
Muestra una representación visual de las marcas de paso. Se pueden proporcionar indicadores personalizados mediante una matriz. |
max |
number |
Longitud máxima del valor. |
min |
number |
Longitud mínima del valor. |
railColor |
string |
Cadena de color CSS para personalizar el fondo del elemento de carril. |
resetFallbackValue |
number |
Valor al que se vuelve al hacer clic en el botón de restablecimiento (habilitado mediante allowReset). |
separatorType |
string |
Define si la línea separadora debajo o encima de la fila de controles se desactiva o ocupa todo el ancho. De forma predeterminada, se coloca debajo, sin incluir el icono del control en la línea inferior. |
shiftStep |
number |
Cantidad que se suma al mantener pulsada la tecla SHIFT. Este valor de desplazamiento multiplica el valor de step. Por ejemplo, si step es 5 y shiftStep es 10, cada salto aumenta o reduce el valor en 50. |
showTooltip |
boolean |
Fuerza que se muestre u oculte la información sobre herramientas UI. Se establece en false si step tiene el valor especial any. |
step |
number |
Cantidad en que cambia el valor al aumentarlo o reducirlo. También se usa para validarlo: el valor debe ser múltiplo de step (con el desplazamiento de min, si se especifica) para ser válido. Acepta la cadena especial any, que anula la restricción de validación y hace que cada acción de incremento o reducción cambie el valor en 1. |
trackColor |
string |
Cadena de color CSS para personalizar el fondo del elemento de pista. |
withInputField |
boolean |
Determina si el campo numérico se muestra junto a RangeControl. Se establece en false si step tiene el valor especial any. |
selector
Muestra un campo de selección que admite una o varias opciones.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
array | string | number |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
array | string | number |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
multiple |
boolean |
Si es true, se pueden seleccionar varias opciones. «stylisedUi» se habilitará automáticamente. |
options |
array |
Opciones disponibles. |
returnFormat |
string |
Especifica el formato del valor devuelto. |
populate |
object |
|
stylisedUi |
boolean |
Muestra una versión estilizada de un selector con capacidad para buscar entre las opciones. |
allowNull |
boolean | string |
Permite al usuario seleccionar una opción vacía. Si es true, la etiqueta estará vacía; de lo contrario, la opción mostrará la cadena especificada. |
allowReset |
boolean |
Si esta propiedad es true, se muestra un botón para restablecer el selector. |
pestañas
Muestra una interfaz con pestañas para agrupar campos.
{
"type": "tabs"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
tabs |
array |
Pestañas que se mostrarán. |
texto
Muestra un campo de texto de una sola línea.
{
"type": "text",
"min": 0,
"max": 100
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
max |
number |
Longitud máxima del valor. |
min |
number |
Longitud mínima del valor. |
área de texto
Muestra un campo de área de texto.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
max |
number |
Longitud máxima del valor. |
min |
number |
Longitud mínima del valor. |
rows |
number |
Número de filas que debe contener el área de texto. |
alternador
Muestra un control de alternancia de verdadero/falso.
{
"type": "toggle"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
boolean |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
boolean |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
repetidor
Muestra un conjunto de campos que se pueden repetir.
{
"type": "repeater",
"min": 0,
"max": 100
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
array |
Filas con las que comienza un bloque nuevo. Cada fila es un objeto con valores de campo. Tiene prioridad sobre las filas que crea min. |
min |
number |
Número mínimo de filas. |
max |
number |
Número máximo de filas. |
minimized |
boolean |
Pliega las filas existentes al abrir el editor. Las filas añadidas en el editor aparecen desplegadas. |
textButton |
string |
Texto del botón para añadir. |
textMinimized |
string | object |
Texto que se muestra cuando las filas están minimizadas. |
textRemove |
string | boolean |
Pregunta de confirmación que se muestra en el editor al eliminar una fila del repetidor. Una cadena no vacía cambia la pregunta; false la elimina de inmediato, sin diálogo. Si se omite, se establece en true o es una cadena vacía, se utiliza la pregunta predeterminada. |
attributes |
array |
Acepta todos los demás tipos de campo, excepto otro campo de pestañas. |
richtext
Campo de atributo para campos RichText.
{
"type": "richtext"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
unit
Muestra un campo numérico con un menú desplegable de unidades.
{
"type": "unit"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
disableUnits |
boolean |
Si es verdadero, se oculta el campo de selección de unidades. |
isPressEnterToChange |
boolean |
Si es verdadero, hay que pulsar ENTER para activar onChange. Si está habilitado, también se activa al salir con el tabulador. |
isResetValueOnUnitChange |
boolean |
Si es verdadero y la unidad seleccionada proporciona un valor predeterminado, este se establece al cambiar de unidad. |
isUnitSelectTabbable |
boolean |
Determina si se puede acceder al campo de selección de unidades con el tabulador. |
units |
array |
wysiwyg
Muestra un editor WYSIWYG.
{
"type": "wysiwyg"
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
default |
string |
Valor predeterminado que se aplica al añadir el bloque por primera vez. |
fallback |
string |
Valor alternativo que se muestra cuando el valor del campo está vacío. |
toolbar |
object |
Configuración de la barra de herramientas del editor. |
mode |
string |
code abre el campo en la vista de código. both añade un botón para alternar entre la vista visual y la vista de código. |
Carga de iconos
El editor carga un conjunto de iconos cuando enfocas por primera vez su selector o cambias el conjunto o subconjunto, no al seleccionar el bloque. Los campos que solicitan el mismo conjunto comparten la solicitud en curso. El nombre del icono guardado permanece visible antes de la carga, y volver a enfocar el selector reintenta una solicitud fallida.
tabler-icons admite outline y filled. Un subconjunto configurado explícitamente para el conjunto elegido tiene prioridad; de lo contrario, el selector utiliza solid si está disponible o el primer subconjunto del conjunto. Los conjuntos sin subconjuntos omiten subSet. Los nombres de los conjuntos solo se resuelven en archivos incluidos. La representación en la interfaz de usuario almacena en caché iconos individuales en lugar de guardar conjuntos completos de iconos en transitorios de la base de datos.
Valores de opciones importados
Las casillas y los menús de selección con "multiple": true normalmente almacenan una matriz de objetos { "value": "...", "label": "..." }. También aceptan un único objeto de opción, una cadena o número escalar, o una matriz de valores escalares importados mediante las herramientas de contenido REST API. Esto también funciona dentro de las filas del repetidor.
El editor muestra estos valores como selecciones sin cambiar su estructura almacenada al guardar si no se han modificado. Al añadir o quitar una selección, se escribe la matriz habitual de objetos de opción. 0 numérico y "0" de tipo cadena son selecciones válidas. Las plantillas reciben el valor returnFormat configurado para el campo, igual que ocurre con los valores seleccionados en el editor. Las opciones deben coincidir con las opciones declaradas o rellenadas del campo.
Un menú de selección nativo de opción única sin valor almacenado ni predeterminado muestra una opción vacía deshabilitada, no la primera opción. Al elegir la primera opción explícitamente, esta se guarda. Una vez guardada una opción, desaparece la opción vacía. Usa allowNull cuando los editores también deban poder borrar una selección; una opción vacía no permite borrar una selección que, de otro modo, es obligatoria.
Filas iniciales del repetidor
En el editor, los valores predeterminados incluyen las filas mínimas anidadas antes de la inserción. No hace falta abrir la configuración del bloque para inicializarlas, y al insertar el bloque no se añade un segundo paso de deshacer para esas filas.
Cuando un repetidor tiene min pero no tiene ningún valor guardado ni un default explícito, el servidor inicializa esa cantidad de filas usando los valores predeterminados de los campos de la fila. Esto también se aplica a las inserciones de PHP, las etiquetas de bloque y las fuentes de página basadas en archivos que nunca se han abierto en el editor. Por ejemplo, "min": 2 con un campo de texto cuyo valor predeterminado es "New item" muestra dos filas con ese valor.
Las filas guardadas y un default explícito del repetidor tienen prioridad. Una lista vacía guardada explícitamente, false o null no vuelve a crear las filas eliminadas. El renderizado no guarda estos valores predeterminados generados en la entrada. min y max limitan los controles del editor; no recortan ni rellenan una lista guardada al renderizar. Usa bs_validate_block() para notificar incumplimientos de los límites de filas en el contenido importado.
Los campos de fila sin default están false en una fila generada, por lo que esa fila no tiene contenido. Las filas que los editores añaden y dejan vacías tienen el mismo aspecto. Una plantilla que imprime una tarjeta, un encabezado o un elemento de lista por cada fila debería omitir las filas sin contenido fuera del editor y mantenerlas en el editor para que sus campos sigan siendo editables:
<?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; ?>
Eliminación del repetidor
Al eliminar una fila, se abre el cuadro de confirmación del editor con los botones Eliminar y Cancelar. Al cancelar o pulsar Escape, la fila permanece sin cambios. La fila solo se elimina tras la confirmación, también dentro de repetidores anidados.
textRemove controla el mismo comportamiento para todos los repetidores:
| Valor | Comportamiento |
|---|---|
Omitido, true o "" |
Muestra la pregunta de confirmación predeterminada. |
| Una cadena no vacía | Muestra esa pregunta personalizada mediante el mecanismo de traducción de texto personalizado existente. |
false |
Elimina la fila inmediatamente, sin mostrar un cuadro de diálogo. |
Por ejemplo, "textRemove": "Remove this team member?" cambia la pregunta.
La restricción existente min sigue impidiendo eliminar filas por debajo del mínimo.
Anidamiento de repetidores
Una fila de repetidor admite todos los tipos de campo excepto tabs. Un campo tabs en una fila, también dentro de un grupo sin id, muestra un aviso en el editor en lugar de sus campos. La extensión PHPStaninforma de ello para block.json y field.json. Mantén planos los campos de la fila o mueve las pestañas fuera del repetidor.
Enlaces WYSIWYG
La barra de herramientas de enlaces WYSIWYG inserta por defecto enlaces que se abren en la misma pestaña, sin añadir target ni rel. Activa la opción para abrir en una pestaña nueva con toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
Al elegir una pestaña nueva, se añaden target="_blank" y rel="noreferrer noopener".
Al desactivar esta opción, se eliminan esos atributos automáticos. Para aplicar atributos a todos los enlaces de ese campo, establece toolbar.formats.link.attributes, por ejemplo
{ "class": "content-link", "rel": "nofollow" }. Se conserva la configuración explícita y se añaden tokens de seguridad para pestañas nuevas a los rel configurados.
Escribir un URL no lo convierte automáticamente en un enlace, y al hacer clic en un enlace existente del campo no se sale del editor. Los atributos de los enlaces guardados anteriormente se conservan en el contenido existente; no se migran automáticamente.