# Elementos y atributos
Para describir la sintaxis de esta sección se utiliza la siguiente convención:
**opción1 | opción2 El carácter pipe, indica que se usa la opción1 o la opción2, pero obligatoriamente alguna de ellas.**
**[Sintaxis opcional] Las sintaxis indicadas entre corchetes [] indica que puede incluirse o no (es absolutamente opcional).**
### Elemento
**cadena | identificador [ (atributos)] [ {declaraciones o sentencias}]**
### Atributos
Lista clave y valor separado por un espacio en blanco en la siguiente forma:
**cadena | identificador = cadena | Identificador**
Los elementos vacíos (que no tienen atributos ni elementos internos) deben declararse con las dos llaves {}.
Los elementos que tienen atributos, pero no contienen otros elementos no necesitan las dos llaves.
Ejemplos:
| DKL | XML |
|-----|-----|
| v { } //Elemento vacío | `````` |
| E (a1="valor1" a2="valor2") | ``` |
| P { h1(a1="valor1") } | ```
``` |
| v | INCORRECTO |
| v() | INCORRECTO |
| v() { h1(a1="valor1") } | INCORRECTO |
En DKL se pueden usar identificadores sin declarar o cadenas como nombres de elementos o atributos. La regla es que, si el identificador no ha sido declarado previamente con una sentencia #def, se traducirá tal cual en XML.
| DKL | XML |
|-----|-----|
| "prefijo:Persona" ( nombre="Juan" "prefijo:apellido"="López" ) | |
| Mascota ("nombre"="Firulais" "prefijo:"Propietario"="Juan López") | `` |
| Personas(cantidad="5") { Persona(nombre="Juan") Persona(nombre="Pedro") Persona(nombre="Camila") } | |
### Bloques de texto
Un elemento puede contener además de otros elementos, texto o bloques CDATA.
Puede incluir texto entre comillas dentro del cuerpo de los elementos, en cuyo caso al convertirse a XML se realizará el “escapado” de caracteres.
Por ejemplo:
```DKL
Datos { "Algún texto > que otro texto" }
```
Produce
```DKL
Algún texto > que otro texto
```
Recuerde que puede usar las secuencias de escape de C (\n\r,...) en las cadenas y estas se traducirán en la salida XML según corresponda.
En algunos casos puede que necesite evitar el escapado de caracteres de XML, por lo que tiene dos alternativas: declara el texto como bloque CDATA o bien explícitamente evitar el escapado.
El carácter! al inicio de una cadena indica que se produzca un CDATA
```DKL
Datos {!"Algún texto > que otro texto"}
```
Produce
```DKL
que otro texto]]>
```
Por su parte, el carácter $ precediendo a la cadena coloca el texto sin escapado.
```DKL
Datos {$"Algún texto > que otro texto" }
```
Produce
```DKL
Algún texto > que otro texto
```
La omisión del escapado XML puede resultar útil si está produciendo HTML, por ejemplo.
### Meta atributos
Los meta-atributos son la única información que no se puede mapear a o desde XML.
Se utilizan para asociar información a un nodo (elemento) en particular que sea usada por los motores en tiempo de ejecución de Devkron.
Meta-atributos predefinidos
| dkl/perform | Indica que el elemento debe ser interpretado imperativamente |
|------------------------|------------------------|
| dkl/hide-element | Indica al generador de la salida XML que el nodo y todos sus hijos deben omitirse (ocultarse) |
| dkli/default-root-type | Nombre predeterminado del nodo raíz en caso que tras la ejecución imperativa no se pueda determinar un solo nodo raíz. |
| meta-xml-declaration | Establece una cadena de texto que se inserta justo antes de la declaración del nodo raíz. |