From 2ad2a6f87bca2d848bbc9f89028b7e5fb6e6b022 Mon Sep 17 00:00:00 2001 From: Jordan Diaz Date: Thu, 20 Aug 2026 18:00:16 +0000 Subject: [PATCH] docs: data-field-show descubrible desde el summary y el cheat-sheet La seccion ya estaba escrita, pero el agente no llegaba a ella. Dos motivos: - El summary del frontmatter y el parrafo de entrada de 01-builder-fields enumeran lo que cubre el doc y no mencionaban ni el agrupado en pestanas ni la visibilidad condicional. Ese summary no es decorativo: entra en el texto que se embebe (title + summary + primeros 2000 chars) y es lo que se ve en list_docs, asi que una seccion en el char 10000 sin rastro arriba es invisible para la busqueda semantica y para el que decide que doc abrir. - 11b-rules-cheat-sheet es el doc de consulta rapida y ya tenia la linea de data-field-group; sin la hermana de data-field-show, quien mirase ahi concluia que las pestanas no se pueden condicionar. Se anade la linea al cheat-sheet con la gramatica minima y los dos errores tipicos (se referencia el nombre de variable y no el label; `campo=` es vacio). --- docs/01-builder-fields.md | 4 ++-- docs/11b-rules-cheat-sheet.md | 4 +++- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/01-builder-fields.md b/docs/01-builder-fields.md index ab11838..db5ab58 100644 --- a/docs/01-builder-fields.md +++ b/docs/01-builder-fields.md @@ -3,11 +3,11 @@ title: "Campos editables del builder" tags: [builder, twig, html, modules] load_priority: 80 load_when: [always] -summary: "Atributos data-field-* (textfield, headfield, link, upload, list, multiv2, colors, colorpicker), agrupar campos en pestañas con data-field-group, c-if/c-for/c-class, c-form, componentes built-in del builder Acai." +summary: "Atributos data-field-* (textfield, headfield, link, upload, list, multiv2, colors, colorpicker), agrupar campos en pestañas con data-field-group, mostrar u ocultar campos y pestañas segun otro campo con data-field-show y data-field-group-show, c-if/c-for/c-class, c-form, componentes built-in del builder Acai." --- # Builder Fields — Campos editables del index-base.tpl -Este documento define los campos editables que el usuario rellena desde el panel del builder de Acai. Cubre el atributo `data-field-type` con todos sus tipos (`textfield`, `headfield`, `textbox`, `wysiwyg`, `link`, `upload`, `uploadMulti`, `list`, `multiv2`, `colors`, `colorpicker`, `corners`, `ratio`), la regla `data-field-label` → nombre de variable, los atributos Acai (`c-if`, `c-else`, `c-for`, `c-class`, `c-hidden`, `c-required`), el tag ``, la inclusión de módulos, los formularios `c-form` y los componentes built-in. Léelo antes de crear o modificar cualquier `index-base.tpl`. +Este documento define los campos editables que el usuario rellena desde el panel del builder de Acai. Cubre el atributo `data-field-type` con todos sus tipos (`textfield`, `headfield`, `textbox`, `wysiwyg`, `link`, `upload`, `uploadMulti`, `list`, `multiv2`, `colors`, `colorpicker`, `corners`, `ratio`), la regla `data-field-label` → nombre de variable, el reparto en pestañas (`data-field-group`) y su visibilidad condicional (`data-field-show`, `data-field-group-show`), los atributos Acai (`c-if`, `c-else`, `c-for`, `c-class`, `c-hidden`, `c-required`), el tag ``, la inclusión de módulos, los formularios `c-form` y los componentes built-in. Léelo antes de crear o modificar cualquier `index-base.tpl`. ## Reglas de nomenclatura de variables diff --git a/docs/11b-rules-cheat-sheet.md b/docs/11b-rules-cheat-sheet.md index a95b4c2..708946d 100644 --- a/docs/11b-rules-cheat-sheet.md +++ b/docs/11b-rules-cheat-sheet.md @@ -3,7 +3,7 @@ title: "Reglas inmutables y cheat-sheet de tipos" tags: [reference, rules, cheat] load_priority: 90 load_when: [cheatsheet] -summary: "Reglas no negociables (cms_, num, _num, upload arrays, c-if/{% if %}), tipos de builder field, atributos Acai, filtros Twig, formato de datos para insert/update, errores comunes." +summary: "Reglas no negociables (cms_, num, _num, upload arrays, c-if/{% if %}), tipos de builder field, pestañas y visibilidad condicional de campos (data-field-group, data-field-show), atributos Acai, filtros Twig, formato de datos para insert/update, errores comunes." --- # Reglas inmutables y cheat-sheet @@ -47,6 +47,8 @@ Resumen ejecutable de reglas críticas, tipos de campo, filtros y formatos de da Pestañas en el panel del módulo: `data-field-group="Estilos"` en el elemento del campo (sin group → pestaña "Principal"). +Visibilidad condicional: `data-field-show="modo=1"` en el campo, y `data-field-group-show="modo=1"` en **una** var del grupo para condicionar la pestaña entera. Se referencia el NOMBRE DE VARIABLE, no el label. `modo=` significa vacío (clave de la primera opción de todo `list`), `,` es OR, `!=` niega y `;` encadena condiciones (AND). + ## Atributos Acai | Atributo | Uso | Ejemplo |