Saltar al contenido

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

Muestra un control de enlace para elegir enlaces internos o externos.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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:

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