Hoe kan ik een blok tags in XML uitcommentariëren?
Ik bedoel, hoe kan ik <staticText>
en alles daarbinnen, in de code hieronder, uitcommentariëren?
<detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
</band>
</detail>
Ik zou <!-- staticText-->
kunnen gebruiken, maar dat'is alleen voor enkele tags (voor zover ik weet), zoals //
in Java en C. Ik zou iets meer willen zoals hoe /** comment **/
kan worden gebruikt in Java en C, zodat ik langere blokken XML code kan uitcommentariëren.
Je kunt die stijl van commentaar over meerdere regels gebruiken (die ook in HTML bestaat)
<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>
Als je dat vraagt, omdat je fouten kreeg met de <!-->
syntax, dan is het hoogstwaarschijnlijk de CDATA sectie (en daar het ]]>
gedeelte), dat dan in het midden van het commentaar ligt. Het zou geen verschil moeten maken, maar ideaal en echte wereld kunnen soms nogal uit elkaar liggen (vooral als het gaat om XML verwerking).
Probeer ook de ]]>
te veranderen:
<!--detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]--><!--]></text>
</staticText>
</band>
</detail-->
Nog iets, dat in me opkomt: Als de inhoud van je XML ergens twee koppeltekens bevat, eindigt het commentaar daar meteen:
<!-- <a> This is strange -- but true!</a> -->
--------------------------^ comment ends here
Dat's een veel voorkomende valkuil. Het is een erfenis van de manier waarop SGML commentaar behandelt. (Lees de XML spec over dit onderwerp)