# Elementos y atributos En el contexto declarativo, cada elemento DKL se traduce a un elemento XML. Es la base para generar HTML, XML de CFDI o cualquier otro documento. Convención de esta página: `a | b` significa "a o b"; `[ … ]` significa "opcional". ## Elemento ```text cadena | identificador [ (atributos) ] [ { contenido } ] ``` ## Atributos Una lista de pares `nombre = valor` separados por espacio: ```text cadena | identificador = cadena | identificador ``` Reglas: - Un elemento **sin atributos ni contenido** debe llevar llaves: `br{}`. - Un elemento con atributos pero sin contenido no necesita llaves: `E(a="1")`. - Un identificador que no se definió con [`#def`](/es/devkron/2.0/lenguaje/declarativo/directivas.md) se traduce tal cual. - Para nombres con caracteres que no son de identificador (`:`, `-`, espacios) use cadenas: `"cfdi:Emisor"`, `"data-id"="5"`. | DKL | XML | |---|---| | `v{}` | `` | | `E(a1="valor1" a2="valor2")` | `` | | `P{ h1(a1="valor1") }` | `

` | | `v` | incorrecto (falta `{}`) | | `v()` | incorrecto | | `"prefijo:Persona"(nombre="Juan" "prefijo:apellido"="López")` | `` | Ejemplo completo: ```dkl "ns:raiz"("xmlns:ns"="urn:ejemplo") { vacio{} con_attr(a="1" b="dos") padre { hijo(x="y") { nieto{} } } "ns:Persona"(nombre="Juan" "data-id"="5"){} } ``` ```text ``` Los caracteres especiales de los valores de atributo se escapan automáticamente (`&` → `&`, `<` → `<`, `"` → `"`). ## Texto dentro de elementos Un elemento puede contener, además de otros elementos, texto entre comillas. Hay tres formas: | Forma | Resultado | |---|---| | `"texto"` | texto **escapado** para XML (`>` → `>`) | | `!"texto"` | bloque **CDATA** (``) | | `$"texto"` | texto **sin escapar** (útil para HTML) | ```dkl datos { escapado { "Texto > escapado & " } cdata { !"Texto > en CDATA & " } crudo { $"Texto > sin escapar" } acentos { "ñandú €" } mixto { "uno" "dos" } } ``` ```text Texto > escapado & <b> en CDATA & ]]>Texto > sin escaparñandú €unodos ``` Las secuencias de escape de C (`\n`, `\r`, `\t`…) también funcionan en estas cadenas. Varias cadenas seguidas se concatenan. Cuándo usar cada una: - `"…"` para datos que vienen del usuario o de la base de datos: evita que un `<` rompa el documento. - `$"…"` para HTML que usted mismo escribe (`$"Total"`). **Nunca** ponga en `$"…"` datos sin validar del cliente. - `!"…"` cuando el consumidor espera CDATA (algunos XML de integración). En todas puede insertar valores calculados con [marcas `#`](/es/devkron/2.0/lenguaje/declarativo/marcas-de-expresion.md). ## Un documento HTML ```dkl #set "meta-xml-declaration" "\r\n" html { head { title{ $"Título" } } body { h1{ $"Encabezado" } p(class="nota"){ $"Párrafo" } br{} } } ``` ```text Título

Encabezado

Párrafo


``` `#set "meta-xml-declaration"` reemplaza la línea `` por la que usted indique (aquí, el `DOCTYPE` de HTML5). ## Meta-atributos Los meta-atributos son la única información que no se traduce a XML: la usa el motor en tiempo de ejecución. Se asignan con [`#set`](/es/devkron/2.0/lenguaje/declarativo/directivas.md) al elemento que sigue. | Meta-atributo | Uso | |---|---| | `dkl/perform` | Indica que el elemento se interpreta como sentencia imperativa (lo pone el motor; no hace falta escribirlo). | | `dkl/hide-element` | El elemento y todos sus hijos se omiten en la salida. | | `dkli/default-root-type` | Nombre del nodo raíz cuando, tras la ejecución, no hay un único nodo raíz. | | `meta-xml-declaration` | Texto que se escribe antes del nodo raíz, en lugar de la declaración XML. | | `devkron/output` | (2.0) Con el valor `"tree"` antes del elemento raíz, apaga la salida directa para ese programa. | ```dkl raiz { visible{} #set "dkl/hide-element" "true" oculto { hijo{} } otro{} } ``` ```text ``` > `dkli/default-root-type` se conserva por compatibilidad, pero en la práctica no da nombre a la raíz: cuando un programa imperativo produce varios elementos en el nivel superior, la salida los envuelve en una raíz sin nombre (`< >`), con o sin salida directa. Produzca siempre un único elemento raíz.