タイムリーフ
Thymeleaf は、ウェブ環境とスタンドアロン環境の両方に対応したサーバーサイド Java テンプレートエンジンです。 主な目的は、自然なテンプレートを開発ワークフローに取り入れることです — ブラウザーで正しく表示でき、静的プロトタイプとしても機能する HTML です。
基本的な構文ハイライトは、Ultimate サブスクリプションなしで IntelliJ IDEA で利用できます。
Thymeleaf プラグインが有効になっていることを確認する
設定 ダイアログ(Ctrl+Alt+S )で プラグイン | インストール済み を選択します。
タイムリーフ プラグインが有効化されていることを確認してください。
それ以外の場合は、チェックボックスを選択してプラグインを有効化します。
変更を適用して、ダイアログを閉じます。 プロンプトが表示されたら、IDE を再起動します。
詳細については、 プラグイン を参照してください。
Thymeleaf サポートの追加
プロジェクトまたはモジュールを作成するとき、または既存のプロジェクトまたはモジュールに対して、Thymeleaf サポートを追加できます。 IntelliJ IDEA は、選択した Thymeleaf ライブラリファイルをダウンロードし、対応するモジュールの依存関係に追加します。
適切な pom.xml ファイルを開いて Thymeleaf プロジェクトを作成することもできます。 この場合、Maven はプロジェクト内の依存関係を管理します。 詳細については、 Maven を参照してください。
Thymeleaf を使用した新しい Java Enterprise プロジェクトまたはモジュール
メインメニューで、 または に移動します。
開いたダイアログで、左側のリストから Jakarta EE を選択し、 次へ をクリックします。
依存関係 リストの 実装 で、 タイムリーフ を選択し、 次へ をクリックします。
プロジェクトまたはモジュールの名前を入力し、 完了 をクリックします。
Java エンタープライズプロジェクトの詳細については、 チュートリアル: 最初の Jakarta EE アプリケーション を参照してください。
Thymeleaf を使用した新しい Spring プロジェクトまたはモジュール
または に進みます。
開いたダイアログで、左側のリストから Spring イニシャライザー を選択し、 次へ をクリックします。
依存関係 リストから テンプレートエンジン をクリックし、 タイムリーフ オプションを選択します。

作成 をクリックします。
Spring プロジェクトの詳細については、「チュートリアル: 最初の Spring アプリケーションを作成する 」を参照してください。
既存のプロジェクトに Thymeleaf を追加
ビルドファイルをエディターで開きます( pom.xml または build.gradle 。プロジェクトで使用されている ビルドツールによって異なります)。
Thymeleaf の依存関係を追加し、バージョンがプロジェクト全体と一致していることを確認してください:
<dependency> <groupId>org.thymeleaf</groupId> <artifactId>thymeleaf</artifactId> <version>3.1.3.RELEASE</version> </dependency>implementation 'org.thymeleaf:thymeleaf:3.1.3.RELEASE'implementation("org.thymeleaf:thymeleaf:3.1.3.RELEASE")Ctrl+Shift+O を押して変更をインポートします。
Thymeleaf サポート機能
IntelliJ IDEA での Thymeleaf(英語) のサポートには、次のものが含まれます。
- コード補完
コード補完: 式および
th:*属性。- 参照からのナビゲーション
テンプレート内の参照から、対応する getter メソッド、 .properties ファイル内のメッセージ、または別の適切なコード箇所へのナビゲーション。 に移動するか、 Ctrl+B を押します。
- 型定義へのナビゲーション
に移動するか、 Ctrl+Shift+B を押します。
- リファクタリング
参照されているプロパティ、getter メソッド、反復変数およびステータス変数などに対する 名前変更 リファクタリング。 に移動するか、 Shift+F6 を押します。
- インスペクション
コードインスペクションは、式構文の未解決の参照とエラーを見つけて修正するのに役立ちます。
- インテンションアクション
インテンションアクション: 未解決のメッセージ参照用の プロパティの作成 や、
importステートメントをorg.thymeleaf.*クラスに追加するための クラスのインポート など。- プロトタイプのプレビュー
プロトタイプのプレビュー (テンプレートの静的部分) をエディターからウェブブラウザーで表示します。
ブラウザーで Thymeleaf プロトタイプをプレビューする
IntelliJ IDEA を 使用すると、通常の HTML ファイルと同じように、テンプレートの静的部分を Web ブラウザーまたは組み込みプレビューでプレビューできます。

テンプレート内の動的なデータをプレビューする場合は、アプリケーションを実行する必要があります。 以下の例では、シンプルな Thymeleaf テンプレートを作成し、それを Spring MVC アプリケーションのビューとして使用します。
Thymeleaf テンプレートを作成する
Thymeleaf サポートの追加 の説明に従って、Thymeleaf を使用して新しい Spring Boot プロジェクトを作成し、
demoという名前を付けます。プロジェクト ツールウィンドウ(Alt+1 )で、 src|main|java にある
demoパッケージを右クリックし、 を選択します。クラスに
MyFirstAppという名前を付けます。
新しいクラスにコントローラーを追加します。例:
package org.example.demo; import org.springframework.ui.Model; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import java.util.Arrays; @Controller public class MyFirstApp { @RequestMapping("/home") public String index(Model model) { model.addAttribute("message", "Hello Thymeleaf"); model.addAttribute("items", Arrays.asList("Item 1", "Item 2", "Item 3")); return "start_page"; } }resources ディレクトリに、
templatesという名前のディレクトリを作成します。templatesで、start_pageという名前の HTML ファイルを作成します。このテンプレートは、
${message}および${items}変数 (以前に追加したコントローラーで渡されます) と、日付を処理するために使用される#datesThymeleaf オブジェクトを使用します。<!DOCTYPE HTML> <html lang=""> <head> <title>Hello</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> </head> <body> <h1 th:text="${message}"></h1> <p>Thymeleaf Iteration:</p> <ul> <li th:each="item : ${items}" th:text="${item}"></li> </ul> <p th:text="'Current Year: ' + ${#dates.format(#dates.createNow(), 'yyyy')}"></p> </body> </html>
IntelliJ IDEA はテンプレートを認識し、 Ctrl+B を押すと、変数から宣言元のコントローラーコードに移動できるようにします。
コントローラーからテンプレートに移動することもできます: MyFirstApp.java で、ガターの をクリックし、 関連する表示に移動 を選択します。
start_page が下線付きのリンクとしてマークされていることに注意してください。これは、IntelliJ IDEA がプロジェクト内で該当するテンプレートを検出していることを意味します: Ctrl キーを押しながらこのリンクをクリックする (またはリンク上で Ctrl+B を押す) と、テンプレートに移動できます。

テンプレートのプレビュー
アプリケーションを実行します: Shift+F10 を押すか、ウィンドウヘッダーの実行ウィジェットで デモアプリケーション が選択されていることを確認して、その横にある
をクリックします。
ブラウザーで ローカルホスト: 8080/ ホームを開きます。
Spring は start_page テンプレートをレンダリングし、変数をその値に置き換えます。
