# Websencia: vistas por componentes [Websencia](https://websencia.dev) es el editor visual de Induxsoft para diseñar páginas con componentes. Guarda el diseño en un archivo JSON (`.jsnwm`) con una o varias **vistas**, cada una un árbol de componentes (elemento, atributos, clases, contenido, hijos). `websencia.dkl` (dkl-web) **renderiza** esas vistas desde DKL, con los datos de su programa: el diseño lo hace quien maqueta y el programador solo entrega los datos. Se usa sola o como vista de [CRUD-L](/es/devkron/2.0/marcos/crudl/vistas.md#vistas-con-websencia) (`@list_view = "archivo$vista"`). ```dkl #include "functions.dkh" #include "serialize.dkh" #include "websencia.dkl" ``` ## Funciones | Función | Qué hace | |---|---| | `websencia.loadViewModels(archivo)` | Lee el archivo `.jsnwm` y devuelve el registro. Si la ruta no existe y hay `@http_context`, la busca junto al programa que atiende la petición. Si no la encuentra: `View models file not found` | | `websencia.renderView(&datos, &vista)` | Pinta la vista (un miembro de `views`) en la salida declarativa, con `datos` como contexto. Con vista nula: `View model can't be null` | Dentro de la vista, los datos se leen con **`@('ruta')`** (la función de un argumento de `functions.dkh`, que lee del contexto activo), con los mismos prefijos de tipo que `@@`: `$` cadena, `#` número, `&` objeto. ## Formato de una vista ```json { "views": { "tarjeta": { "styles": ".tarjeta{border:1px solid #ccc}", "jscode": "console.log('cargada');", "components": [ { "tagName": "div", "classes": ["tarjeta"], "attributes": { "id": "cli-#<@('$sys_pk')>" }, "components": [ { "tagName": "h2", "content": "#<@('$nombre')>" }, { "tagName": "p", "content": "Saldo: #" }, { "tagName": "comment", "content": "no se pinta" }, { "tagName": "img", "void": true, "attributes": { "src": "/img/logo.png", "alt": "logo" } } ] } ] } } } ``` | Miembro de la vista | Uso | |---|---| | `components` | Lista de componentes raíz | | `styles` | CSS; se emite en un `

Abarrotes López

Saldo: 1,500.50

logo
``` ## Partes dinámicas: data-dkl-dynamic Un componente con el atributo `data-dkl-dynamic` no se pinta como elemento: se **evalúa la expresión** del atributo. Hay dos funciones listas: | Expresión | Efecto | |---|---| | `@foreach(lista)` | Pinta los hijos del componente una vez por elemento, con ese elemento como contexto | | `@if(condición)` | Pinta los hijos solo si la condición es verdadera | ```json { "views": { "lista": { "components": [ { "tagName": "ul", "components": [ { "tagName": "div", "attributes": { "data-dkl-dynamic": "@foreach(@('&partidas'))" }, "components": [ { "tagName": "li", "content": "#<@('$descripcion')>: #<@('$importe')>" } ] } ] }, { "tagName": "div", "attributes": { "data-dkl-dynamic": "@if(@('#total')>1000)" }, "components": [ { "tagName": "strong", "content": "Pedido grande" } ] } ] } } } ``` Con `{"total":1450,"partidas":[{"descripcion":"Lápiz","importe":250},{"descripcion":"Goma","importe":1200}]}`, salida real: ```html
Pedido grande
``` ### Componentes propios La expresión puede llamar a una función de su programa. Durante la evaluación, `@DynamicContext` contiene: | Miembro | Contenido | |---|---| | `component` | Registro armado con los atributos del componente (ver abajo) | | `element` | El componente tal como está en el JSON | | `view` | La vista completa | | `input` | Los datos que se pasaron a `renderView` | Los atributos `data-dkl-member` y `data-dkl-property-*` arman `component`: `data-dkl-member` da el nombre del miembro y cada `data-dkl-property-x` se vuelve el campo `x` (evaluando sus marcas). `data-dkl-attributes` limita qué atributos se toman (lista separada por comas; `*` = todos). ```json { "tagName": "div", "attributes": { "data-dkl-dynamic": "mi_boton(@@(@DynamicContext,'&component'))", "data-dkl-member": "boton", "data-dkl-property-texto": "Guardar #<@('$nombre')>", "data-dkl-property-color": "verde" } } ``` ```dkl mi_boton::&c { ## button(class="#<@@(c,'$boton/color')>"){$"#<@@(c,'$boton/texto')>"} ## } ``` Con `{"nombre":"Ana"}`, `component` es `{"boton":{"texto":"Guardar Ana","color":"verde"}}` y la salida es ``. La expresión se **evalúa**, no se ejecuta como sentencia: escriba `mi_boton(...)`, no `do mi_boton(...)` (con `do` falla: `Variable 'do' no definida`). ## Descarga de imágenes Si define `@url_download_assets`, `@local_assets_folder` y `@relative_img_folder`, las imágenes cuyo `src` contenga `@url_download_assets` se descargan a `@local_assets_folder` y su `src` se cambia a `@relative_img_folder`. Sirve para publicar un diseño que apunta a imágenes del editor. Requiere salida a internet (no se probó en esta documentación). ## Generar el sitio desde websencia.dev Para convertir un `.jsnwm` en archivos HTML, súbalo con la [API FSO](/es/devkron/2.0/marcos/fso/servicios.md#archivos-jsnwm) en un campo terminado en `.jsnwm*`: el servidor lo manda a websencia.dev y descomprime el resultado. ## Errores típicos | Síntoma | Causa y solución | |---|---| | `View models file not found` | Ruta incorrecta: use ruta absoluta o relativa a la carpeta de trabajo del servidor | | Las marcas `#<...>` salen literales | `@no_dynamic` está en `@true` | | `Variable 'do' no definida` en `websencia.dkl` | En `data-dkl-dynamic` va una expresión: quite `do` | | `Variable global '@context' no definida` | Use `@('ruta')`, no `@@(@context, ...)` | | Un `textnode` de la raíz no aparece | Ponga el texto dentro de un elemento |