¿Cómo comento un bloque de etiquetas en XML?
¿Cómo comento un bloque de etiquetas en XML?
Es decir, ¿cómo puedo comentar <staticText>
y todo lo que contiene en el código siguiente?
<detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
</band>
</detail>
Podría usarlo <!-- staticText-->
, pero eso es solo para etiquetas individuales (que yo sepa), como //
en Java y C. Me gustaría algo más parecido a cómo /** comment **/
se puede usar en Java y C, para poder comentar bloques más largos de código XML.
Puede utilizar ese estilo de comentario en varias líneas (que también existe en HTML)
<detail>
<band height="20">
<!--
Hello,
I am a multi-line XML comment
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
-->
</band>
</detail>
Puede ajustar el texto con una instrucción de procesamiento no existente, por ejemplo:
<detail>
<?ignore
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
</band>
?>
</detail>
No se permiten instrucciones de procesamiento anidadas y '?>' finaliza la instrucción de procesamiento (consulte http://www.w3.org/TR/REC-xml/#sec-pi )
Si preguntas, porque tienes errores con la <!-- -->
sintaxis, lo más probable es que sea la sección CDATA (y ahí la ]]>
parte), que se encuentra en el medio del comentario. No debería hacer una diferencia, pero el mundo ideal y el real a veces pueden estar bastante separados (especialmente cuando se trata de procesamiento XML).
Intente cambiar el ]]>
, también:
<!--detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]--><!--]></text>
</staticText>
</band>
</detail-->
Otra cosa que me viene a la mente: si el contenido de su XML en alguna parte contiene dos guiones, el comentario termina ahí inmediatamente:
<!-- <a> This is strange -- but true!</a> -->
--------------------------^ comment ends here
Ése es un error bastante común. Se hereda de la forma en que SGML maneja los comentarios. ( Lea la especificación XML sobre este tema )