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などの繰り返し構文も学んでみましょう。」