# タイムリーフ

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/idea/llms.txt).

> **TL;DR**
> 必要なプラグイン:  Thymeleaf  (バンドル)

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

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

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

1. 設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）で   プラグイン | インストール済み   を選択します。

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

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

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

詳細については、 [プラグイン](managing-plugins.html)を参照してください。

## Thymeleaf サポートの追加

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

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

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

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

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

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

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

Java エンタープライズプロジェクトの詳細については、 [チュートリアル: 最初の Jakarta EE アプリケーション](creating-and-running-your-first-jakarta-ee-application.html) を参照してください。

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

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

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

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

![Thymeleaf を追加](https://resources.jetbrains.com/help/img/idea/2026.3/add_thymeleaf_new_project.png)

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

Spring プロジェクトの詳細については、「 [チュートリアル: 最初の Spring アプリケーションを作成する](your-first-spring-application.html)」を参照してください。

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

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

2. Thymeleaf の依存関係を追加し、バージョンがプロジェクト全体と一致していることを確認してください：

Maven:

```XML
<dependency>
    <groupId>org.thymeleaf</groupId>
    <artifactId>thymeleaf</artifactId>
    <version>3.1.3.RELEASE</version>
</dependency>

```

Gradle (Groovy) 版:

```GROOVY
implementation 'org.thymeleaf:thymeleaf:3.1.3.RELEASE'

```

Gradle (Kotlin) 版:

```KOTLIN
implementation("org.thymeleaf:thymeleaf:3.1.3.RELEASE")

```

3. `Ctrl+Shift+O` (Windows), `Ctrl+Shift+O` (macOS), `Ctrl+Shift+O` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift+O` (macOS System Shortcuts), `Ctrl+Shift+O` (XWin), `Ctrl+Shift+O` (GNOME), `Ctrl+Shift+O` (KDE), `Ctrl+Shift+O` (Emacs), `Ctrl+Shift+O` (Sublime Text), `Ctrl+Shift+O` (Sublime Text (macOS)), `Ctrl+Shift+O` (Visual Studio), `Ctrl+Shift+O` (Visual Studio (macOS)), `Ctrl+Shift+O` (NetBeans), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS)) を押して変更をインポートします。

ビルドツールの使用方法の詳細については、 [Maven](maven-support.html) または [Gradle](gradle.html) を参照してください。

### Thymeleaf サポート機能

IntelliJ IDEA での [Thymeleaf(英語)](https://www.thymeleaf.org/) のサポートには、次のものが含まれます。

コード補完
: [コード補完](auto-completing-code.html): 式および  `th:*`  属性。

参照からのナビゲーション
: テンプレート内の参照から、対応する getter メソッド、  `.properties`  ファイル内のメッセージ、または別の適切なコード箇所へのナビゲーション。  `移動 | 宣言または使用箇所`  に移動するか、 `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) を押します。

型定義へのナビゲーション
: `移動 | 型宣言`  に移動するか、 `Ctrl+Shift+B` (Windows), `⌘ ⇧ B` (macOS), `⌃ ⇧ B` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ B` (macOS System Shortcuts), `Ctrl+Shift+B` (XWin), `Ctrl+Shift+B` (GNOME), `Ctrl+Shift+B` (KDE), `Ctrl+Shift+B` (Emacs), `Ctrl+Shift+B` (Sublime Text), `Ctrl+Shift+B` (Sublime Text (macOS)), `Ctrl+Shift+F11` (Visual Studio), `⌘ ⇧ F11` (Visual Studio (macOS)), `Ctrl+Shift+B` (NetBeans), `Ctrl+Shift+B` (Eclipse), `Ctrl+Shift+B` (Eclipse (macOS)) を押します。

リファクタリング
: 参照されているプロパティ、getter メソッド、反復変数およびステータス変数などに対する   名前変更   リファクタリング。  `リファクタリング | 名前の変更`  に移動するか、 `Shift+F6` (Windows), `⇧ F6` (macOS), `⇧ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ R` (macOS System Shortcuts), `Shift+F6` (XWin), `Shift+F6` (GNOME), `Shift+F6` (KDE), `Shift+F6` (Emacs), `Shift+F6` (Sublime Text), `⇧ F6` (Sublime Text (macOS)), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `Ctrl+R` (NetBeans), `Alt+Shift+R` (Eclipse), `⇧ F6` (Eclipse (macOS)) を押します。

インスペクション
: [コードインスペクション](code-inspection.html)は、式構文の未解決の参照とエラーを見つけて修正するのに役立ちます。

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

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

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

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

![IDE エディターで作成された HTML ファイル](https://resources.jetbrains.com/help/img/idea/2026.3/use_preview_thymeleaf.png)

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

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

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

2. プロジェクト   ツールウィンドウ（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) ）で、  `src|main|java`  にある  `demo`  パッケージを右クリックし、  `新規 | Java クラス`  を選択します。

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

![Thymeleaf プレビュー機能の新しいクラスの作成](https://resources.jetbrains.com/help/img/idea/2026.3/use_preview_thymeleaf_1.png)

4. 新しいクラスにコントローラーを追加します。例:

```JAVA
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";
    }
}

```

> **Tip:**
> `@RequestMapping`  が未解決としてハイライトされている場合は、キャレットをアノテーションに配置し、 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押して、   'spring-boot-starter-web' をクラスパスに追加します   を選択します。

5. resources   ディレクトリに、  `templates`  という名前のディレクトリを作成します。

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

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

```HTML

<!DOCTYPE HTML>
<html lang="">
<head><link rel="canonical" href="https://www.jetbrains.com/ja-jp/help/idea/thymeleaf.html.md/" data-react-helmet="true"/>
    <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` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) を押すと、変数から宣言元のコントローラーコードに移動できるようにします。

コントローラーからテンプレートに移動することもできます:  `MyFirstApp.java`  で、ガターの ![](https://resources.jetbrains.com/help/img/idea/2026.3/spring.icons.expui.gutter.requestMapping%4014x14.svg) をクリックし、   関連する表示に移動   を選択します。  `start_page`  が下線付きのリンクとしてマークされていることに注意してください。これは、IntelliJ IDEA がプロジェクト内で該当するテンプレートを検出していることを意味します: `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (Visual Studio), `Ctrl` (Visual Studio (macOS)), `Ctrl` (NetBeans), `Ctrl` (Eclipse), `Ctrl` (Eclipse (macOS)) キーを押しながらこのリンクをクリックする (またはリンク上で `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) を押す) と、テンプレートに移動できます。

![関連ビューに移動するアクション](https://resources.jetbrains.com/help/img/idea/2026.3/spring_navigate_to_related_views.png)

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

1. アプリケーションを実行します: `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS)) を押すか、ウィンドウヘッダーの実行ウィジェットで   デモアプリケーション   が選択されていることを確認して、その横にある ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックします。

2. ブラウザーで [ローカルホスト: 8080/ ホーム](http://localhost:8080/home)を開きます。

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

![ブラウザーで作成された HTML ファイル](https://resources.jetbrains.com/help/img/idea/2026.3/thymeleaf_hello_browser.png)

