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 |
<v/> |
E (a1="valor1" a2="valor2") |
<E a1 = "valor1" a2 = "valor2" /> |
P { h1(a1="valor1") } |
<P ><h1 a1 = "valor1" /> </P> |
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" ) |
<prefijo:Persona nombre = "Juan" prefijo:apellido = "López" /> |
Mascota ("nombre"="Firulais" "prefijo:"Propietario"="Juan López") |
<Mascota nombre = "Firulais" prefijo:Propietario = "Juan López" /> |
Personas(cantidad="3"){ Persona(nombre="Juan") Persona(nombre="Pedro") Persona(nombre="Camila") } |
<Personas cantidad = "3" > <Persona nombre = "Juan" / <Persona nombre = "Pedro" /> <Persona nombre = "Camila" /> </Personas> |
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:
Datos { "Algún texto > que otro texto" }
Produce
<Datos> Algún texto > que otro texto </Datos>
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
Datos {!"Algún texto > que otro texto"}
Produce
<Datos> <![CDATA[Algún texto > que otro texto]]> </Datos>
Por su parte, el carácter $ precediendo a la cadena coloca el texto sin escapado.
Datos {$"Algún texto > que otro texto" }
Produce
<Datos> Algún texto > que otro texto</Datos>
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. |