# 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="3"){ 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
|Meta atributo | Uso
|------------------------|------------------------|
| 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. |