Ver índice de contenidos del libro

12.7. Configuración de los campos

Las diferentes vistas (list, new y edit) están compuestas por campos. Un campo puede ser una columna de una clase del modelo o una columna virtual, tal y como veremos más adelante.

La sección fields del archivo de configuración permite personalizar la configuración por defecto de los campos:

# apps/backend/modules/job/config/generator.yml
config:
  fields:
    is_activated: { label: Activated?, help: Whether the user has activated the job, or not }
    is_public:    { label: Public?, help: Whether the job can also be published on affiliate websites, or not }
Aspecto de los campos configurados

Figura 12.3 Aspecto de los campos configurados

La sección fields redefine la configuración de los campos de todas las páginas, lo que significa que el valor de la opción label del campo is_activated se modifica para las páginas list, edit y new.

La configuración del generador de la parte de administración se basa en el principio de configuración en cascada. Si quieres modificar por ejemplo la opción label sólo para la página list, debes definir una opción llamada fields bajo la sección list:

# apps/backend/modules/job/config/generator.yml
config:
  list:
    fields:
      is_public:    { label: "Public? (label for the list)" }

Cualquier configuración realizada en la sección fields principal se puede redefinir en la configuración específica de cada página. Las reglas que se siguen en la configuración en cascada son las siguientes:

  • new y edit heredan de form que a su vez hereda de fields
  • list hereda de fields
  • filter hereda de fields

Nota En las secciones de formularios (form, edit y new), las opciones label y help redefinen el valor de las mismas opciones establecidas en las clases de los formularios.