EditableComponentTemplateField
EditableComponentTemplateField envuelve ComponentTemplateField en el patrón editable. En modo lectura muestra un resumen con el número de ítems de la plantilla (Cantidad de items: N). Al hacer clic en el ícono de edición se activa el editor completo de ComponentTemplateField. Al guardar, el array de configuración de la plantilla se persiste mediante la API.
Props
| Prop | Tipo | Requerido | Por defecto | Descripción |
|------|------|-----------|-------------|-------------|
| name | string | Sí | — | Nombre del campo enviado como clave en el payload de actualización. |
| value | string | Sí | "" | Valor actual de la plantilla (típicamente un array/objeto serializado). |
| updatePath | string | Sí | — | Ruta del endpoint API para persistir el cambio. |
| label | string | No | — | Etiqueta mostrada en el encabezado del campo. |
| description | string | No | — | Texto de ayuda mostrado debajo de la etiqueta. |
| modalTitle | string | No | "" | Título del modal del editor de plantilla. |
| modalSubtitle | string | No | "" | Subtítulo del modal del editor de plantilla. |
| modalZIndex | number | No | 99999999 | z-index del modal del editor de plantilla. |
| apiBaseUrl | string | No | — | URL base que se antepone a updatePath. |
| useAuthToken | boolean | No | false | Cuando es true, el request incluye el token de autorización. |
| onChange | (newValue?: string) => void | No | — | Llamado localmente cuando la plantilla cambia. |
| onEditStart | () => void | No | — | Llamado cuando comienza el modo edición. |
| onEditSuccess | (updatedValue: any, newFormData: any) => void | No | — | Llamado tras un guardado exitoso. |
| onEditError | (error: any) => void | No | — | Llamado al fallar el request; el valor se revierte. |
| onEditCancel | () => void | No | — | Llamado al cancelar; el valor se revierte. |
| editIcon | string | No | "pencil" | Nombre del ícono para el botón de edición. |
| saveIcon | string | No | "check" | Nombre del ícono para el botón de guardar. |
| cancelIcon | string | No | "close" | Nombre del ícono para el botón de cancelar. |
| containerStyle | React.CSSProperties | No | — | Estilo del contenedor externo. |
| inputStyle | React.CSSProperties | No | — | Estilo del input interno. |
| labelStyle | React.CSSProperties | No | — | Estilo del elemento <label>. |
| descriptionStyle | React.CSSProperties | No | — | Estilo del <p> de descripción. |
Uso
Básico
import React, { useState } from 'react';
import EditableComponentTemplateField from '@/components/editable-fields/EditableComponentTemplateField';
export default function Example() {
const [template, setTemplate] = useState('');
return (
<EditableComponentTemplateField
label="Component Template"
name="template"
value={template}
updatePath="/v1/components/5"
apiBaseUrl="https://api.example.com"
modalTitle="Edit Template"
modalSubtitle="Configure the component layout"
useAuthToken
onEditSuccess={(updated) => setTemplate(updated)}
/>
);
}