Як коментувати блок тегів у XML?

Як коментувати блок тегів у XML?

Тобто як я можу прокоментувати <staticText>і все, що знаходиться всередині нього, у коді нижче?

  <detail>
    <band height="20">
      <staticText>
        <reportElement x="180" y="0" width="200" height="20"/>
        <text><![CDATA[Hello World!]]></text>
      </staticText>
    </band>
  </detail>

Я міг би використовувати, <!-- staticText-->але це лише для окремих тегів (як те, що я знаю), як //у Java та C. Я хотів би щось більше, як те, як /** comment **/можна використовувати в Java та C, щоб я міг коментувати довші блоки XML-коду.

Ви можете використовувати цей стиль коментування в декількох рядках (який також існує в 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>

Ви можете обернути текст неіснуючою інструкцією з обробки, наприклад:

<detail>
<?ignore
  <band height="20">
    <staticText>
      <reportElement x="180" y="0" width="200" height="20"/>
      <text><![CDATA[Hello World!]]></text>
    </staticText>
  </band>
?>
</detail>

Вкладені інструкції з обробки не дозволені, а "?>" Завершує інструкцію з обробки (див. Http://www.w3.org/TR/REC-xml/#sec-pi )

Якщо ви запитаєте, оскільки у вас <!-- -->виникли помилки з синтаксисом, це, швидше за все, розділ CDATA (і там ]]>частина), що потім лежить посередині коментаря. Це не повинно змінювати значення, але ідеальний і реальний світ іноді можуть бути зовсім небагато один від одного (особливо якщо мова йде про обробку XML).

Спробуйте також змінити ]]>:

  <!--detail>
    <band height="20">
      <staticText>
        <reportElement x="180" y="0" width="200" height="20"/>
        <text><![CDATA[Hello World!]--><!--]></text>
      </staticText>
    </band>
  </detail-->

Інша річ, що спадає на думку: Якщо вміст вашого XML десь містить дві дефіси, коментар тут же закінчується:

<!-- <a> This is strange -- but true!</a> -->
--------------------------^ comment ends here

Це досить поширений підводний камінь. Це успадковано від того, як SGML обробляє коментарі. ( Прочитайте специфікацію XML на цю тему )

Насправді ви можете використовувати формат <! --...--> з кількома рядками або тегами:

<!--
  ...
  ...
  ...
-->

Тут для коментарів ми повинні написати так:

<!-- Your comment here -->

Ярлики для IntelliJ Idea та Eclipse

Для Windows та Linux:

Ярлик для коментування одного рядка:

Ctrl + /

Ярлик для коментування декількох рядків:

Ctrl+ Shift+/

Для Mac:

Ярлик для коментування одного рядка:

cmnd + /

Ярлик для коментування декількох рядків:

cmnd+ Shift+/

Потрібно пам’ятати, що ви не можете коментувати атрибут тегу XML. Наприклад:

<TextView
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    <!--android:text="Hello.."-->
    android:textStyle="bold" />

Тут TextViewє тег XML і textє атрибутом цього тегу. Ви не можете коментувати атрибути тегу XML. Ви повинні прокоментувати повний тег XML. Наприклад:

<!--<TextView
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="Hello.."
    android:textStyle="bold" />-->

Ви можете легко прокоментувати дані, скориставшись цим:

<!-- 
 <data>
        <data-field1></data-field1>
        <data-field2></data-field2>
        <data-field3></data-field3>
 </data>
-->

метод коментування в xml.

Синтаксис для XML: <!--Your comment-->

напр.

   <?xml version = "1.0" encoding = "UTF-8" ?>
   <!--here is your comment :) -->
   <class_list>   
   <student>
   <name></name>
   <grade>A</grade>
   </student>
   </class_list>

Правила коментарів XML

Comments cannot appear before XML declaration.
Comments may appear anywhere in a document.
Comments must not appear within attribute values.
Comments cannot be nested inside the other comments.