Thymeleafのth:unlessの使い方を初心者向けに徹底解説！条件分岐を簡単に実装

Thymeleafのth:unless

先生と生徒の会話形式で理解しよう

生徒

「Thymeleafを使っているんですが、条件によって要素を非表示にする方法はありますか？」

先生

「はい、Thymeleafではth:unlessを使うことで、特定の条件が成り立たない場合に要素を表示することができます。」

生徒

「なるほど！具体的にどうやって使えばいいんですか？」

先生

「では、th:unlessの基本的な使い方とサンプルコードを見ていきましょう！」

1. th:unlessとは？

Thymeleafのth:unlessは、条件が成立しない場合にHTML要素を表示するための属性です。例えば、ユーザーがログインしていない場合に「ログインしてください」というメッセージを表示したいときに役立ちます。

この機能は条件分岐に対応しており、th:ifの逆の動作をします。つまり、th:ifが条件成立時に要素を表示するのに対し、th:unlessは条件が成立しない場合に表示します。

2. 基本的な使い方

では、具体例を見てみましょう。以下はth:unlessを使用した基本的なコードです。


<div th:unless="${user != null}">
    ユーザーがログインしていません。
</div>

このコードでは、${user != null}が成立しない（つまり、userがnullの場合）に「ユーザーがログインしていません」というメッセージが表示されます。

3. サンプルプロジェクトでの使用例

実際にJavaコードとThymeleafテンプレートを組み合わせた例を見てみましょう。

Javaコード


import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class UserController {

    @GetMapping("/user")
    public String getUserPage(Model model) {
        model.addAttribute("user", null); // ユーザー情報がnullの場合
        return "user";
    }
}

Thymeleafテンプレート


<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>ユーザー情報</title>
</head>
<body>
    <div th:unless="${user != null}">
        ユーザーがログインしていません。
    </div>
    <div th:if="${user != null}">
        ようこそ、ユーザー！
    </div>
</body>
</html>

この例では、userがnullの場合、ログインしていない旨のメッセージが表示されます。

4. th:unlessを使う上での注意点

以下は、th:unlessを使う際の注意点です：

条件式の記述：条件が複雑な場合、読みやすくするためにメソッドや変数を使って整理しましょう。
th:ifとの使い分け：特定の条件で表示・非表示を切り替える場合、th:ifとth:unlessを適切に使い分けてください。
デバッグの重要性：意図した条件式が正しく評価されるように、必要に応じてログやデバッグツールを使いましょう。

5. まとめ

この記事では、Thymeleafのth:unlessについて学びました。th:unlessは条件が成立しない場合に要素を表示する便利な属性であり、th:ifと合わせて使うことで柔軟な条件分岐を実現できます。

例えば、ユーザーがログインしていない場合に警告メッセージを表示する、在庫がない商品に「売り切れ」のラベルを付けるなど、実際のアプリケーション開発で多用される機能です。th:unlessを使いこなすことで、動的なHTMLを効率よく生成できるようになります。

再確認ポイント

th:unlessは条件が成立しない場合に要素を表示する属性。
動的な条件分岐を作る際にはth:ifとの使い分けが重要。
条件式が複雑になる場合は、簡潔で読みやすいコードを心がける。

以下に簡単なサンプルプログラムを再掲しますので、復習に役立ててください。


<div th:unless="${user != null}">
    ユーザーがログインしていません。
</div>


import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class UserController {

    @GetMapping("/user")
    public String getUserPage(Model model) {
        model.addAttribute("user", null); // ユーザー情報がnullの場合
        return "user";
    }
}

先生と生徒の振り返り会話

生徒

「この記事を読んで、th:unlessがどのように使えるか分かりました！条件分岐を考えるときに役立ちそうです。」

先生

「そうですね。特にth:ifと組み合わせることで、簡単に動的なHTMLを構築できます。条件式の記述をシンプルに保つよう心がけてください。」

生徒

「次はもっと複雑な条件式や他のThymeleaf属性も試してみたいです。」

先生

「それは良い考えですね。次回はth:eachなどの繰り返し構文も学んでみましょう。」

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

Thymeleafのth:unlessは何のために使う属性ですか？初心者でも分かるように条件分岐との関係を教えてください。

Thymeleafのth:unlessは、指定した条件が成り立たないときだけHTML要素を表示するための属性で、条件分岐の一種です。th:ifが「条件が真なら表示」なのに対し、th:unlessは「条件が偽なら表示」なので、逆の動作をします。ログイン判定やメッセージ表示の切り替えなど、動的HTMLを扱うときに非常に便利です。

th:unlessとth:ifの違いは何ですか？Spring BootとThymeleafの組み合わせでどちらを使うべきか迷っています。

th:ifは条件が成立すると要素を表示し、th:unlessは条件が成立しないと要素を表示します。どちらもThymeleafが提供する条件分岐機能ですが、目的に応じて使い分けます。例えば「ユーザーがログインしていない場合にメッセージを表示したい」ならth:unlessが自然で、逆に「ログインしている場合に名前を表示したい」ならth:ifが自然です。

ログインしていないときだけメッセージを表示したいのですが、th:unlessの条件式はどのように書くのが正しいですか？

ログインしていない状態を判定するには、ユーザー情報がnullであることを条件にします。条件式では「ユーザーが存在していない」という意味で変数がnullかどうかをチェックします。条件が成立しないときだけ表示される仕組みなので、ログイン判定に最適です。

Thymeleafの条件分岐が正しく動かないときによくある原因は何ですか？

Modelに値がセットされていない、変数名の綴り間違い、条件式の誤りなどが一般的な原因です。特にJava側とテンプレート側でデータ名が一致していないケースが初心者には多いので注意してください。

スタースクール：社会人向け実務教育プロジェクト

【職業訓練講師が直接指導】

社会人向けThymeleaf入門セミナー｜Java Web画面を自在に操るテンプレートエンジンの極意

Java入門からSpring Boot実務まで。現場で絶賛される「設計の型」を最短距離で習得。

技術記事の内容を、自分の「スキル」へ変える。

職業訓練講師が最短攻略！社会人向けThymeleaf実践。Javaエンジニアのための「プロ基準」画面構築術。

Java Web開発の現場で標準採用されているThymeleaf（タイムリーフ）。本セミナーでは、HTMLの構造を壊さず開発できる「ナチュラルテンプレート」の利点を最大限に引き出し、動的表示とロジックの分離を60分で濃縮習得する、社会人のためのThymeleaf特化型講座です。

60分集中・Thymeleaf画面設計ワークショップ

【つくるもの】
「実務型データ一覧・更新画面」を構築。リストの反復表示（th:each）、条件判定（th:if）、フォームとの双方向データバインド（th:object）など、商用開発で毎日使うコア機能を、スタースクール流の最短距離でマスターします。

【開発環境】
Spring Boot 3.x環境を使用。ブラウザでそのまま確認できるThymeleafの特性を活かし、デザイナーとの協業やデバッグ効率を劇的に高める「プロの画面構築フロー」を職業訓練講師が直接伝授します。

この60分で得られる3つの革新スキル

1. ナチュラルテンプレートを活かす th:attributes 制御術

classの動的切り替えや属性制御を自在に操り、Java入門者でも「読みやすく修正しやすい」HTML構造を維持する技法を習得します。

2. フラグメント（共通部品）化による圧倒的保守性

th:fragmentを駆使し、ヘッダー・フッター・ボタン等を部品化。大規模開発でも一箇所直せば全画面に反映される「スケーラブルな設計」を学びます。

3. 実務必須の各種ユーティリティ連携（Security・Format等）

日付の整形やログイン状況に応じた表示切替など、周辺技術と「繋ぐ」ためのThymeleaf特有の記述ルール（#fieldsやsec:authorize等）を短時間で整理します。

※本講座は、Thymeleafを使いこなし「現場で重宝される画面構築力」を手に入れたい社会人向けの「フロント×バックエンド連携講座」です。スタースクールがあなたの即戦力化を全力でリードします。

社会人向けJava実務セミナーの詳細を見る

職業訓練講師による徹底指導

累計120万PV超の技術メディアが監修。理論の丸暗記ではない、
実務10年PLが実践する「一生モノの設計力」を、60分の濃縮セミナーで伝授します。