Учебное Пособие По Thymeleaf: Глава 1: Введение

Для достижения этой цели Thymeleaf использует концепцию Natural Templates для внедрения своей логики в файлы шаблонов таким образом, чтобы шаблон не влиял на отображение дизайна прототипа.

Это улучшает командное взаимодействие и сокращает разрыв между командами дизайнеров и программистов.

Thymeleaf также с самого начала разрабатывался с учетом веб-стандартов, особенно HTML5 , что позволяет создавать шаблоны, полностью соответствующие стандартам.

HTML формат подразумевает стандарт HTML, включая HTML5, HTML 4 и XHTML. Проверка не выполняется, и код/структура исходного шаблона будет соблюдаться в максимально возможной степени.

Формат шаблона XML позволит вам создать шаблон XML. В этом случае ожидается, что код будет правильно сформирован, иначе синтаксический анализатор выдаст исключения без закрытых тегов, без кавычек атрибутов и т. д. Обратите внимание, что проверка DTD или XML-схемы выполняться не будет. Режим шаблона ТЕКСТ позволяет использовать специальный синтаксис для шаблонов без разметки.

Примерами таких шаблонов могут быть текстовые письма или шаблоны документов.

Обратите внимание, что шаблоны HTML или XML также могут обрабатываться как ТЕКСТ.

В этом случае разметка не анализируется, и каждый тег, DOCTYPE, комментарий и т. д. будет обрабатываться как обычный текст. Режим шаблона ЯВАСКРИПТ позволит обрабатывать файлы JavaScript в приложении Thymeleaf. Это означает возможность использовать данные модели внутри файлов JavaScript так же, как и в файлах HTML, но с интеграцией, специфичной для JavaScript, такой как специализированное экранирование или сценарии.

Режим шаблона JAVASCRIPT считается текстовым режимом и поэтому использует тот же специальный синтаксис, что и режим шаблона TEXT. Режим шаблона CSS позволяет обрабатывать файлы CSS, участвующие в приложении Thymeleaf. Как и режим JAVASCRIPT, режим шаблона CSS также является текстовым режимом и использует специальный синтаксис обработки из режима шаблона TEXT. Режим шаблона СЫРОЙ он просто не будет обрабатывать шаблоны.

Он предназначен для вставки нетронутых ресурсов (файлов, ответов на URL-адреса и т. д.) в обрабатываемые шаблоны.

Например, в шаблоны приложений можно включать внешние неконтролируемые ресурсы HTML, зная, что любой код Thymeleaf, включающий эти ресурсы, не будет выполнен.

Объект, который применяет некоторую логику к артефакту разметки (тегу, тексту, комментарию), называется процессором, а совокупность этих процессоров — плюс, возможно, некоторых дополнительных артефактов — и составляет диалект. Базовая библиотека Thymeleaf «из коробки» предоставляет диалект под названием стандартный диалект , чего должно быть достаточно для большинства пользователей.

В этом уроке рассматривается стандартный диалект. Каждый атрибут и синтаксис, о которых вы узнаете на следующих страницах, определяется этим диалектом, даже если он не упоминается явно.

Конечно, пользователи могут создавать свои собственные диалекты (даже расширяя стандартный), если они хотят определить собственную логику обработки, используя преимущества расширенных возможностей библиотеки.

Thymeleaf также можно настроить для одновременной обработки нескольких диалектов.

Официальные пакеты интеграции «thymeleaf-spring3» и «thymeleaf-spring4» определяют диалект под названием « SpringСтандартный диалект ", который по сути аналогичен стандартному диалекту, но с небольшими изменениями для более эффективного использования некоторых функций Spring Framework (таких как Spring Expression Language (SPEL) или SpringEL вместо OGNL).

Итак, если вы являетесь Spring MVC пользователь, вы не тратите свое время впустую, поскольку почти все, что вы узнаете здесь, будет полезно в ваших приложениях Spring. Большинство стандартных процессоров диалектов являются процессорами атрибутов.

Это позволяет браузерам корректно отображать HTML-шаблоны даже без их обработки, поскольку они просто игнорируют дополнительные атрибуты.

Стандартный диалект Thymeleaf позволит нам добиться функциональности с помощью:

<input type="text" name="userName" value="James Carrot" th:value="${user.name}" />

Это не только будет правильно отображаться браузерами, но также позволит нам (необязательно) присвоить ему атрибут значения («Джеймс Маррот»), который будет отображаться, когда прототип будет статически открыт в браузере и который будет заменен на значение, полученное в результате выполнения ${user.name} во время обработки шаблона.

Это помогает вашему дизайнеру и разработчику работать с одним и тем же файлом шаблона и сокращает усилия, необходимые для преобразования статического прототипа в рабочий файл шаблона.