# 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ítuloEncabezado
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.