Учебник Thymeleaf: Глава 11. Комментарии и Блоки / Blocks

habr.png

Оглавление

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 (не нужно добавлять запрещенные блоки

внутри ), и это продолжает работает нормально при открытии в браузерах в качестве прототипов!

© Habrahabr.ru