llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

タイムリーフ

Thymeleaf は、ウェブ環境とスタンドアロン環境の両方に対応したサーバーサイド Java テンプレートエンジンです。 主な目的は、自然なテンプレートを開発ワークフローに取り入れることです — ブラウザーで正しく表示でき、静的プロトタイプとしても機能する HTML です。

基本的な構文ハイライトは、Ultimate サブスクリプションなしで IntelliJ IDEA で利用できます。

Thymeleaf プラグインが有効になっていることを確認する

  1. 設定 ダイアログ(Ctrl+Alt+S )で プラグイン | インストール済み を選択します。

  2. タイムリーフ プラグインが有効化されていることを確認してください。

    それ以外の場合は、チェックボックスを選択してプラグインを有効化します。

  3. 変更を適用して、ダイアログを閉じます。 プロンプトが表示されたら、IDE を再起動します。

詳細については、 プラグイン を参照してください。

Thymeleaf サポートの追加

プロジェクトまたはモジュールを作成するとき、または既存のプロジェクトまたはモジュールに対して、Thymeleaf サポートを追加できます。 IntelliJ IDEA は、選択した Thymeleaf ライブラリファイルをダウンロードし、対応するモジュールの依存関係に追加します。

適切な pom.xml ファイルを開いて Thymeleaf プロジェクトを作成することもできます。 この場合、Maven はプロジェクト内の依存関係を管理します。 詳細については、 Maven を参照してください。

Thymeleaf を使用した新しい Java Enterprise プロジェクトまたはモジュール

  1. メインメニューで、 ファイル | 新規 | プロジェクト または ファイル | 新規 | モジュール に移動します。

  2. 開いたダイアログで、左側のリストから Jakarta EE を選択し、 次へ をクリックします。

  3. 依存関係 リストの 実装 で、 タイムリーフ を選択し、 次へ をクリックします。

  4. プロジェクトまたはモジュールの名前を入力し、 完了 をクリックします。

Java エンタープライズプロジェクトの詳細については、 チュートリアル: 最初の Jakarta EE アプリケーション を参照してください。

Thymeleaf を使用した新しい Spring プロジェクトまたはモジュール

  1. ファイル | 新規 | プロジェクト または ファイル | 新規 | モジュール に進みます。

  2. 開いたダイアログで、左側のリストから Spring イニシャライザー を選択し、 次へ をクリックします。

  3. 依存関係 リストから テンプレートエンジン をクリックし、 タイムリーフ オプションを選択します。

    Thymeleaf を追加
  4. 作成 をクリックします。

Spring プロジェクトの詳細については、「チュートリアル: 最初の Spring アプリケーションを作成する 」を参照してください。

既存のプロジェクトに Thymeleaf を追加

  1. ビルドファイルをエディターで開きます( pom.xml または build.gradle 。プロジェクトで使用されている ビルドツールによって異なります)。

  2. 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")
  3. Ctrl+Shift+O を押して変更をインポートします。

ビルドツールの使用方法の詳細については、 Maven または Gradle を参照してください。

Thymeleaf サポート機能

IntelliJ IDEA での Thymeleaf(英語) のサポートには、次のものが含まれます。

コード補完

コード補完: 式および th:* 属性。

参照からのナビゲーション

テンプレート内の参照から、対応する getter メソッド、 .properties ファイル内のメッセージ、または別の適切なコード箇所へのナビゲーション。 移動 | 宣言または使用箇所 に移動するか、 Ctrl+B を押します。

型定義へのナビゲーション

移動 | 型宣言 に移動するか、 Ctrl+Shift+B を押します。

リファクタリング

参照されているプロパティ、getter メソッド、反復変数およびステータス変数などに対する 名前変更 リファクタリング。 リファクタリング | 名前の変更 に移動するか、 Shift+F6 を押します。

インスペクション

コードインスペクションは、式構文の未解決の参照とエラーを見つけて修正するのに役立ちます。

インテンションアクション

インテンションアクション: 未解決のメッセージ参照用の プロパティの作成 や、 import ステートメントを org.thymeleaf.* クラスに追加するための クラスのインポート など。

プロトタイプのプレビュー

プロトタイプのプレビュー (テンプレートの静的部分) をエディターからウェブブラウザーで表示します。

ブラウザーで Thymeleaf プロトタイプをプレビューする

IntelliJ IDEA を 使用すると、通常の HTML ファイルと同じように、テンプレートの静的部分を Web ブラウザーまたは組み込みプレビューでプレビューできます。

IDE エディターで作成された HTML ファイル

テンプレート内の動的なデータをプレビューする場合は、アプリケーションを実行する必要があります。 以下の例では、シンプルな Thymeleaf テンプレートを作成し、それを Spring MVC アプリケーションのビューとして使用します。

Thymeleaf テンプレートを作成する

  1. Thymeleaf サポートの追加 の説明に従って、Thymeleaf を使用して新しい Spring Boot プロジェクトを作成し、 demo という名前を付けます。

  2. プロジェクト ツールウィンドウ(Alt+1 )で、 src|main|java にある demo パッケージを右クリックし、 新規 | Java クラス を選択します。

  3. クラスに MyFirstApp という名前を付けます。

    Thymeleaf プレビュー機能の新しいクラスの作成
  4. 新しいクラスにコントローラーを追加します。例:

    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"; } }
  5. resources ディレクトリに、 templates という名前のディレクトリを作成します。

  6. templates で、 start_page という名前の HTML ファイルを作成します。

    このテンプレートは、 ${message} および ${items} 変数 (以前に追加したコントローラーで渡されます) と、日付を処理するために使用される #dates Thymeleaf オブジェクトを使用します。

    <!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 を押す) と、テンプレートに移動できます。

関連ビューに移動するアクション

テンプレートのプレビュー

  1. アプリケーションを実行します: Shift+F10 を押すか、ウィンドウヘッダーの実行ウィジェットで デモアプリケーション が選択されていることを確認して、その横にある をクリックします。

  2. ブラウザーで ローカルホスト: 8080/ ホームを開きます。

Spring は start_page テンプレートをレンダリングし、変数をその値に置き換えます。

ブラウザーで作成された HTML ファイル
2026 年 11 月 3 日