Учебник Thymeleaf: Глава 11. Комментарии и Блоки / Blocks
Оглавление
11 Комментарии и Блоки / Blocks
11.1. Стандартные HTML/XML комментарии
Стандартные HTML/XML комментарии можно использовать в любом месте шаблонов Thymeleaf. Все, что внутри этих комментариев, не будет обрабатываться Thymeleaf и будет скопировано дословно:
...
11.2. Thymeleaf блоки комментариев на уровне парсера
Parser-level комментарии — это участки кода, которые просто удаляются из шаблона при парсинге. Посмотрим на них:
Thymeleaf удалит все между , поэтому эти блоки комментариев также могут использоваться для отображения кода, когда шаблон статически открыт, зная, что он будет удален, когда Thymeleaf обработает его:
you can see me only before Thymeleaf processes me!
Это может пригодиться для прототипирования таблиц с большим количеством
...
...
...
11.3. Комментарии Thymeleaf уровня прототипирования
Thymeleaf позволяет определить специальные блоки комментариев, которые удобны при отображении прототипа дизайна, но при этом они считаются нормальной разметкой при обработке шаблона со стороны Thymeleaf.
hello!
goodbye!
Thymeleaf«s парсер просто удалит маркеры, но не их содержимое, которое будет оставлено без комментария. При обработке шаблона на выходе увидим:
hello!
...
goodbye!
Как и в блоках комментариев на уровне парсера, эта функция не зависит от диалекта.
11.4. Синтетический th: block тег
Thymeleaf«s элементный процессор (а не атрибутный) и включенный в Standard Dialects — это th: block.
th: block — это простой контейнер атрибутов, который позволяет разработчикам шаблонов указывать какие атрибуты они хотят. Thymeleaf выполнит эти атрибуты, а затем просто удалит блок, но не его содержимое.
Таким образом, это может быть полезно, например, при создании повторяющихся таблиц, для которых требуется более одного
...
...
...
И особенно полезно при использовании в сочетании с блоками комментариев только для прототипа:
...
...
...
Обратите внимание, как это решение позволяет шаблонам быть валидным HTML (не нужно добавлять запрещенные блоки