# Vistas En modo HTML (`Accept: text/html`), CRUD-L produce la página con una **vista**: un programa DKL (o una vista de Websencia) que recibe el resultado de la operación y genera el HTML. En modo REST no se usan vistas: la respuesta es JSON. ## El contexto de la vista: @crud_context Las vistas se ejecutan con `runscript`, en un contexto distinto al del programa que atiende la petición. Reciben todo en la variable global **`@crud_context`**: | Miembro | Contenido | |---|---| | `output` | Resultado de la operación: la entidad (READ), la lista (LIST), el elemento en blanco (`_new`) o la entidad guardada | | `.` | Igual que `output`, **salvo cuando hay error**: entonces contiene los datos que envió el usuario (abajo) | | `input` | Datos de entrada (lo que envió el formulario) | | `parameters` | Parámetros de la petición, más `_operation` (`list`, `read`, `create`, `update` o `delete`) | | `error` | Nulo si todo salió bien; si no, `{"message": "..."}` | | `database` | La conexión a la base de datos | | `http` | El `@http_context` de la petición | | `script` | Texto del script asociado a la vista en el archivo `.crudl` (vea la nota en [Inyección de scripts](#inyección-de-scripts)) | `@http_context` **no existe** dentro de la vista; use `@@(@crud_context,"&http")`. Si una vista usa código que espera `@http_context`, defínalo al inicio: ```dkl if not(isset("@http_context")) { ref @http_context = ifnull(@@(@crud_context,"&http"), record.create()) } ``` ### Los datos del usuario cuando falla el guardado Si un alta o un cambio falla (validación, concurrencia), la vista de formulario se vuelve a mostrar con el error. Para que el formulario repinte **lo que el usuario capturó** y no lo guardado, el miembro `.` (punto) se sustituye por `input`. **`output` no se sustituye**: escriba sus formularios leyendo de `.`: ```dkl ref d = @@(@crud_context,"&.") ``` Comprobado en 2.0: tras un `POST` con `sys_recver` atrasado y `nombre=Cambio`, un formulario que lee `&output` repinta los campos **vacíos**, y uno que lee `&.` repinta `Cambio`. (La documentación 1.0 decía que se sustituía `output`; en el código es `.`.) ### La conexión está disponible `database` permite a la vista consultar la base, por ejemplo para llenar listas desplegables con [uie.dbSelect](/es/devkron/2.0/marcos/uie/). ## Resolución de la vista El nombre sale de `@list_view`, `@form_view` o `@error_view`; si no tiene extensión se le agrega `@dkl_view_ext` (`.dk`). Se busca, en orden: 1. La ruta declarada en el archivo `.crudl` para esa entidad y vista ([.crudl](/es/devkron/2.0/marcos/crudl/configuracion.md)). 2. La carpeta de la entidad: `{@path_root}/{@base_path}/{_entities_type}/`. 3. La carpeta de las entidades: `{@path_root}/{@base_path}/`. 4. La carpeta del marco: `@dbmvc_path` (`crudl/`). Gana la primera que exista; si ninguna, 500 (`Vista de formulario no disponible`, etc.). Así hay tres niveles: una vista por entidad, una común a todo el sistema y la genérica del marco, que solo muestra el contexto en JSON y no es una interfaz. | Operación | Éxito | Error | |---|---|---| | LIST | vista de lista | vista de error | | READ | vista de formulario | vista de error | | CREATE | redirección (PRG) | vista de formulario | | UPDATE | redirección (PRG) | vista de formulario | | DELETE | redirección (PRG) | vista de error | Con `_redirect=disabled`, alta, cambio y baja muestran la vista de formulario en lugar de redirigir ([PRG](/es/devkron/2.0/marcos/crudl/prg-y-redireccion.md)). ## Vista de lista `entidades/cliente/list.dk`. `output` es la lista de la operación LIST: ```dkl #include "dkli.dkh" #set "meta-xml-declaration" "\r\n" #$ html(lang="es") { ## #include "functions.dkh" #include "serialize.dkh" ref filas = @@(@crud_context,"&output") seleccionado = @@(@crud_context,"$parameters/_select") ## head { title{"Clientes"} } body { h1{"Clientes"} form(method="GET" action="./") { input(type="text" name="texto" value="#<@@(@crud_context,'$parameters/texto')>"){} button(type="submit"){"Filtrar"} } a(href="_new"){"Agregar"} table { thead{ tr{ th{"Código"} th{"Nombre"} th{"Estado"} } } tbody { ## for i=0; i<@count(filas) { ref f = @item(filas,i) clase = ifstr(@@(f,"$sys_pk")==seleccionado,"seleccionado","") ## tr(class="#") { td{ a(href="#<@@(f,'$sys_pk')>"){ $"#<@@(f,'$codigo')>" } } td{ $"#<@@(f,'$nombre')>" } td{ $"#<@@(f,'$estado')>" } } ## } ## } } } } ``` Salida real de `GET /tienda/cliente/?_select=1` con `Accept: text/html`: ```html Clientes

Clientes

Agregar
CódigoNombreEstado
CLI-0001Abarrotes Lópezactivo
``` `_select` lo agrega la redirección después de guardar, para resaltar la fila guardada. Para tablas con agrupaciones y totales use [uie.dbTable](/es/devkron/2.0/marcos/uie/). ## Vista de formulario `entidades/cliente/form.dk`. `.` es la entidad leída, el elemento en blanco (`_new`) o lo capturado si falló el guardado. La misma vista atiende alta y edición: ```dkl #include "dkli.dkh" #set "meta-xml-declaration" "\r\n" #$ html(lang="es") { ## #include "functions.dkh" #include "serialize.dkh" ref d = @@(@crud_context,"&.") ref e = @@(@crud_context,"&error") es_nuevo = @@(@crud_context,"$parameters/_entity_id") == "_new" titulo = ifstr(es_nuevo, "Nuevo cliente", "Cliente " + @@(d,"$codigo")) ## head { title{$"#"} } body { h1{$"#"} ## if not(isnull(e)) { ## p(class="error"){ $"#<@@(e,'$message')>" } ## } ## form(method="POST" action="") { input(type="hidden" name="sys_recver" value="#<@@(d,'$sys_recver')>"){} input(type="hidden" name="---from_url" value="/tienda/cliente/?texto="){} label{"Código"} input(type="text" name="codigo" value="#<@@(d,'$codigo')>"){} label{"Nombre"} input(type="text" name="nombre" value="#<@@(d,'$nombre')>"){} button(type="submit"){"Guardar"} } } } ``` - El formulario se envía por `POST` a la URL actual (`action=""`): `.../_new` crea y `.../10` modifica (el controlador lo trata como PATCH). - **Incluya `sys_recver` como campo oculto** en la edición: sin él no funciona el control de concurrencia. - Salida real de `GET /tienda/cliente/1`: `

Cliente CLI-0001

` con `value = "3"` en `sys_recver`; de `GET /tienda/cliente/_new`: `

Nuevo cliente

` y los campos vacíos. ## Vista de error `error.dk` se usa cuando fallan LIST, READ o DELETE en modo HTML (los fallos de CREATE y UPDATE van al formulario). `error/message` trae el texto. La genérica del marco produce: ```html

Error

{404} Elemento no encontrado: {"_entities_type":"cliente","_entity_id":"99","_operation":"read"}[Ln= 98]
``` con estado 404. ## Plantilla envolvente Cuando la operación **falló** y existe la plantilla `@path_template_protected`, la salida de la vista se pone en `response/text` y se envuelve en esa plantilla (un archivo de texto con marcas `#<...>`). La plantilla se toma, en orden, del `httm_template` de la entidad en el `.crudl`, del `httm_template` general del `.crudl` o de `@path_template_protected`. Si no la define, el marco usa `{@base_path}/{@path_root}/_protected/default.htt` (observe el orden: base y luego raíz), que en la práctica casi nunca existe; fíjela usted en el punto de entrada: ```dkl @path_template_protected = "web/misitio.localhost/_protected/default.htt" ``` ```html
Tienda
#<@@(@http_context,'response/text')> ``` Resultado real de `GET /tienda/cliente/99` (no existe) con `Accept: text/html`: ```html
Tienda

Error

{404} Elemento no encontrado: ...
``` Para que la vista no traiga la línea ``, ponga `#set "meta-xml-declaration" ""` en su `error.dk`. Las vistas que terminan bien no se envuelven; si quiere que todas compartan un diseño, use una plantilla propia dentro de las vistas o [website.dkl](/es/devkron/2.0/marcos/sitios/). ## Inyección de scripts El archivo `.crudl` puede asociar un archivo de JavaScript a una vista (`entities/{entidad}/scripts/{vista}`), y la vista recibiría su texto en `script`: ```dkl script{ $"#<@@(@crud_context,'$script')>" } ``` **Defecto conocido**: en la versión actual de dkl-web, `script` llega **siempre vacío**. La función que lo lee (`script_injection` de `view.dk`) usa una variable `file` que no existe en su ámbito; el error se descarta en silencio. Comprobado en 2.0 con un `.crudl` válido: la vista alterna sí se usa, pero `