【初心者向け】Spring Boot入門体験セミナー|はじめてのWeb画面を動かす60分
Javaを少し学んだけれど、Webの画面とどうつながるのか分からない。Spring BootやThymeleafという名前は聞くものの、何から始めればよいか迷っている。そんな方に向けた体験セミナーです。 講師と一緒にS…
開催予定:2026/11/16 10:00〜 ほか
内容・開催日程を見る生徒
「Thymeleafでテキストボックスを作ったのですが、画面を開いたときから文字を表示しておくことはできますか?」
先生
「できます。HTMLのvalue属性を使う方法と、Thymeleafのth:value属性を使ってSpring Bootから受け取った値を表示する方法があります。」
生徒
「データベースに登録されている名前を、編集画面のテキストボックスに表示することもできますか?」
先生
「はい。会員情報や商品情報などの編集画面ではよく使われる方法です。それでは、テキストボックスの基本から順番に確認していきましょう。」
Thymeleafを使ったWebアプリケーションでは、入力フォームのテキストボックスに最初から文字を表示しておきたい場面があります。たとえば、会員情報の編集画面で現在登録されている氏名を表示したり、商品編集画面で登録済みの商品名を表示したりする場合です。
HTMLで一行の文字を入力できるテキストボックスを作成するときは、input要素のtype属性にtextを指定します。通常のHTMLだけで固定された初期値を設定する場合は、value属性を利用します。
<input type="text" name="username" value="山田太郎">
このHTMLをブラウザで表示すると、テキストボックスの中には最初から山田太郎という文字が表示されます。利用者は表示された文字をそのまま送信することもできますし、内容を書き換えてからフォームを送信することもできます。
ただし、実際のSpring BootとThymeleafを使ったWeb開発では、すべての利用者に同じ初期値を表示するケースはそれほど多くありません。ログインしている利用者の名前や、データベースから取得した商品名など、状況によって異なる値を表示することが一般的です。
そこで利用するのがThymeleafのth:value属性です。th:valueを使えば、Spring Boot側で用意したデータをHTMLのテキストボックスへ動的に設定できます。
Thymeleafでテキストボックスへ動的な初期値を表示するときは、th:value属性を利用します。これは通常のHTMLにあるvalue属性を、Thymeleafによって動的に設定するための属性です。
たとえば、Spring Bootからnameという名前で文字列が渡されている場合は、次のように記述できます。
<form>
<div class="mb-3">
<label for="username" class="form-label">名前</label>
<input type="text"
id="username"
name="username"
class="form-control"
th:value="${name}">
</div>
</form>
この例で重要なのが${name}の部分です。Thymeleafでは、このような書き方を使ってサーバー側から渡された値を参照できます。Spring BootのControllerからnameという名前でデータが渡されていれば、その内容がテキストボックスの初期値になります。
たとえば、nameに佐藤花子という文字列が設定されていれば、ブラウザに表示されるテキストボックスにも佐藤花子と表示されます。利用者ごとに異なる名前を表示できるため、会員情報変更フォームなどにも利用できます。
Thymeleafのth:valueだけを覚えるのではなく、Spring BootのControllerからHTMLへデータが渡される流れも理解しておきましょう。Spring Bootでは、ControllerでModelを利用すると、ThymeleafのHTMLテンプレートへデータを渡すことができます。
次の例では、名前の初期値として佐藤花子という文字列をControllerから渡しています。
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 showUser(Model model) {
model.addAttribute("name", "佐藤花子");
return "user";
}
}
model.addAttributeでは、最初の引数にThymeleafから参照するときの名前を指定し、二つ目の引数に実際の値を指定します。この例ではnameという名前に佐藤花子という文字列を登録しています。
Controllerの処理が終わると、user.htmlというThymeleafテンプレートが表示されます。HTML側でth:value="${name}"と記述しておけば、Modelに登録された佐藤花子という値がテキストボックスへ設定されます。
この仕組みを理解すると、Spring BootとThymeleafの役割も整理しやすくなります。Controllerでは画面に必要なデータを準備し、Modelを使ってデータを渡します。そしてThymeleafでは、受け取ったデータをHTMLの適切な場所へ表示します。
テキストボックスだけでなく、見出しや文章、表などへデータを表示するときにも、ControllerからModelを通してThymeleafへ値を渡す考え方が基本になります。
Thymeleafを学習している初心者が迷いやすいポイントの一つが、HTMLのvalue属性とThymeleafのth:value属性の違いです。どちらもテキストボックスの値に関係しますが、目的が異なります。
value属性は通常のHTMLが持っている属性です。そのため、HTMLファイルへ直接固定値を書きたい場合に利用できます。画面を表示するたびに同じ文字列を初期値として使うのであれば、通常のvalue属性でも対応できます。
一方、th:value属性はThymeleafが処理する属性です。Controllerから渡されたデータや、オブジェクトが持っているプロパティなどを参照して値を設定できます。
| 属性 | 主な用途 | 特徴 |
|---|---|---|
value |
固定された初期値の表示 | HTMLへ直接値を記述する |
th:value |
動的な初期値の表示 | Spring Bootなどから受け取った値を表示できる |
たとえば、問い合わせフォームで都道府県の初期値を固定しておくだけなら、通常のvalue属性でも実装できます。しかし、ログインしている利用者の氏名や住所を表示する場合は、利用者によって内容が変わるためth:valueを利用する方法が適しています。
Spring BootとThymeleafを組み合わせた実務では、データベースから取得した情報を画面へ表示することが多いため、th:valueは頻繁に利用されます。登録画面だけでなく、更新画面や検索画面などでも使われる基本的な書き方です。
実際のWebアプリケーションでは、名前だけを単独の文字列として渡すのではなく、利用者情報や商品情報をオブジェクトとしてThymeleafへ渡すことがあります。この場合もth:valueを利用して、オブジェクトが持つ値をテキストボックスへ表示できます。
たとえば、利用者を表すUserクラスに名前とメールアドレスが登録されているとします。Controllerからuserという名前でオブジェクトを渡した場合、HTMLでは次のように記述できます。
<form>
<div class="mb-3">
<label for="name" class="form-label">名前</label>
<input type="text"
id="name"
name="name"
class="form-control"
th:value="${user.name}">
</div>
<div class="mb-3">
<label for="email" class="form-label">メールアドレス</label>
<input type="text"
id="email"
name="email"
class="form-control"
th:value="${user.email}">
</div>
</form>
${user.name}では、userオブジェクトが持っている名前を取得しています。同じように${user.email}と書けば、メールアドレスを取得できます。
この方法は、データベースに登録されている情報を編集フォームへ表示するときに便利です。利用者が編集画面を開いたときに現在の登録内容が表示されていれば、変更したい部分だけを書き換えることができます。
何も表示されていない空のフォームへすべて入力し直す必要がないため、利用者にとって操作しやすい画面になります。Thymeleafで編集画面を作るときには、オブジェクトのプロパティを初期値として表示する考え方を覚えておくとよいでしょう。
Spring BootとThymeleafでフォームを作成するときは、th:valueだけでなくth:objectとth:fieldを組み合わせる方法もよく利用されます。特に、フォームとJavaのオブジェクトを結び付けて入力値を受け取りたい場合に便利です。
th:objectではフォーム全体で使用するオブジェクトを指定します。そして、それぞれの入力項目にth:fieldを指定すると、オブジェクトのプロパティと入力欄を関連付けることができます。
<form th:object="${user}" method="post">
<div class="mb-3">
<label for="name" class="form-label">名前</label>
<input type="text"
id="name"
class="form-control"
th:field="*{name}">
</div>
<div class="mb-3">
<label for="email" class="form-label">メールアドレス</label>
<input type="text"
id="email"
class="form-control"
th:field="*{email}">
</div>
<button type="submit" class="btn btn-primary">送信</button>
</form>
この例では、フォーム全体でuserオブジェクトを利用しています。th:field="*{name}"を指定したテキストボックスには、userオブジェクトの名前が初期値として表示されます。
th:fieldは値を表示するだけではなく、フォームを送信したときに入力内容をJavaオブジェクトへ受け渡す処理でも利用できます。そのため、Spring Bootで登録フォームや編集フォームを作成するときには非常に便利です。
初心者のうちは、まずth:valueで一つの値を表示する仕組みを理解し、その後にth:objectとth:fieldを学ぶと、Thymeleafのフォーム処理を段階的に理解できます。
Thymeleafでテキストボックスに初期値を表示する代表的な利用場面が、データの編集画面です。会員管理システムで利用者の名前を変更したり、商品管理システムで商品名を変更したりするときには、現在データベースに保存されている値を最初に表示する必要があります。
基本的な流れは、Spring Bootでデータベースから対象データを取得し、ControllerからModelへ登録し、Thymeleafでテキストボックスに表示するという形です。
たとえば、利用者番号を使って対象の利用者情報を取得するControllerは、次のような形で作成できます。
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
@Controller
public class EditController {
@GetMapping("/edit")
public String edit(@RequestParam Integer id, Model model) {
User user = new User();
user.setName("鈴木一郎");
model.addAttribute("user", user);
return "edit";
}
}
実際のWebアプリケーションでは、固定された利用者情報を作成するのではなく、ServiceやRepositoryなどを利用してデータベースから対象データを取得することになります。ただし、Thymeleafへ値を渡す基本的な考え方は同じです。
取得したUserオブジェクトをModelへ登録しておけば、Thymeleaf側では${user.name}のように参照できます。その値をth:valueへ指定すれば、編集前の名前をテキストボックスへ初期表示できます。
編集画面を開いた利用者は、現在の登録内容を確認しながら必要な項目だけを変更できます。このように、テキストボックスへの初期値表示は単なる見た目の設定ではなく、使いやすい入力フォームを作成するうえでも重要な役割があります。
Thymeleafでth:valueを書いたにもかかわらず、テキストボックスに初期値が表示されない場合があります。このようなときは、HTMLだけを見るのではなく、Spring BootからThymeleafまで正しくデータが渡されているかを順番に確認することが大切です。
最初に確認したいのが、Controllerのmodel.addAttributeで指定した名前と、Thymeleaf側で参照している名前が一致しているかどうかです。Controllerでnameとして登録したのであれば、HTML側でも${name}として参照する必要があります。
次に確認したいのが、値そのものが正しく設定されているかどうかです。Modelへ登録する値が存在しなければ、テキストボックスにも期待した文字は表示されません。データベースから情報を取得している場合は、検索結果が正しく取得できているかも確認しましょう。
オブジェクトを利用している場合は、プロパティ名の間違いにも注意が必要です。たとえば、Java側のプロパティがnameなのに、Thymeleaf側で異なる名前を指定すると、期待した値を参照できません。
また、Thymeleafのテンプレートとして処理されているHTMLかどうかも重要です。Spring Bootの一般的な構成では、Thymeleafで処理するHTMLファイルをテンプレート用のディレクトリへ配置します。単純な静的HTMLとして表示している場合、Thymeleafの属性が期待どおりに処理されないことがあります。
ControllerからModelへ値を登録しているか確認する
Modelの属性名とThymeleafの変数名が一致しているか確認する
オブジェクトのプロパティ名が正しいか確認する
データベースから対象データを取得できているか確認する
HTMLがThymeleafのテンプレートとして処理されているか確認する
初心者のうちは、画面に値が表示されないとHTMLの書き方だけを修正しようとしてしまいがちです。しかし、Spring BootとThymeleafでは、ControllerからModelを経由してHTMLへデータが渡されます。そのため、どの段階まで値が正しく渡っているのかを順番に確認することが、原因を見つける近道になります。
テキストボックスに文字を表示する方法として、placeholder属性を見かけることもあります。しかし、placeholderとvalueやth:valueは役割が異なるため、違いを理解しておく必要があります。
placeholderは、利用者に入力内容の例や説明を見せるためのものです。テキストボックスの中に文字が見えますが、実際の入力値として設定されているわけではありません。利用者が文字を入力すると、通常は案内として表示されていた文字が見えなくなります。
<form>
<div class="mb-3">
<label for="name" class="form-label">名前</label>
<input type="text"
id="name"
name="name"
class="form-control"
placeholder="名前を入力してください">
</div>
</form>
一方、valueやth:valueで表示された文字は、テキストボックスに実際の値として設定されています。利用者が変更しなければ、その値をフォームの入力値として扱えます。
たとえば、新規会員登録画面で名前の入力方法を案内するのであれば、placeholderを利用する方法があります。すでに登録されている会員の名前を編集画面へ表示するのであれば、th:valueやth:fieldを利用する方法が適しています。
Thymeleafでフォームを作成するときは、入力例を見せたいのか、それとも実際の初期値を設定したいのかを考えて使い分けましょう。この違いを理解しておくと、Spring Bootを使った登録画面や編集画面を作成するときにも迷いにくくなります。
テキストボックスへの初期値表示は、Thymeleafのフォーム処理を理解するための基本です。単純な固定値ではHTMLのvalue属性、Controllerから渡した動的な値ではth:value属性、Javaオブジェクトとフォームを関連付ける場合にはth:objectとth:fieldというように、それぞれの役割を整理して覚えておくと実際のWebアプリケーション開発で活用しやすくなります。
Thymeleafでテキストボックスに初期値を表示する方法を理解すると、Spring Bootを使った入力フォームや編集画面を作成するときの基本的な仕組みが見えてきます。HTMLのテキストボックスは、input要素にtype属性としてtextを指定することで作成できます。そして、画面を開いた時点で文字を表示しておきたい場合には、固定された文字ならvalue属性、Spring Bootから渡された動的な値ならThymeleafのth:value属性を利用します。
まず覚えておきたいのは、value属性とth:value属性は見た目としては同じようにテキストボックスへ文字を表示できますが、値を用意する場所が異なるという点です。HTMLへ直接記述した固定値を表示するのであればvalue属性を利用できます。一方、ログインしている利用者の氏名、データベースに登録されている商品名、会員情報、住所、電話番号など、利用者やデータによって内容が変わる場合にはth:valueを利用する方法が適しています。
Spring BootとThymeleafを組み合わせる場合は、Controller、Model、Thymeleafというデータの流れを意識すると理解しやすくなります。Controllerで画面に必要なデータを準備し、Modelへ登録します。ThymeleafではModelへ登録された値を参照し、th:valueを使ってテキストボックスへ表示します。画面に値が表示されない場合も、この流れを順番に確認することで原因を見つけやすくなります。
固定値を表示するときは、通常のHTMLのvalue属性だけで対応できます。たとえば入力例として毎回同じ文字を実際の値として設定したい場合には、この方法でも問題ありません。しかし、実際の業務システムや会員管理システム、商品管理システムでは、利用者ごとに異なる情報を表示することが多いため、Thymeleafのth:valueを利用する場面が増えてきます。
<form>
<div class="mb-3">
<label for="username" class="form-label">名前</label>
<input type="text"
id="username"
name="username"
class="form-control"
th:value="${name}">
</div>
</form>
この例では、Spring Boot側からnameという名前で渡された値がテキストボックスへ初期表示されます。Controller側で佐藤花子という文字列をModelへ登録していれば、利用者が画面を開いたときには最初から佐藤花子と入力された状態になります。利用者はその値をそのまま利用することもできますし、必要に応じて書き換えることもできます。
Thymeleafの式で使われるnameという名前は、ControllerでModelへ登録した属性名と一致している必要があります。Controllerではnameという名前なのに、HTML側でusernameなど別の名前を参照すると、期待している初期値を取得できません。Spring BootとThymeleafで値が表示されないときは、Modelの属性名とテンプレート側の変数名を最初に確認するとよいでしょう。
Thymeleafのth:valueは、HTMLだけで値を作り出しているわけではありません。Spring BootのControllerで準備した値をModelへ登録し、そのModelに入っている値をThymeleafが参照しています。そのため、初期値表示を正しく理解するにはController側の処理も合わせて覚えることが大切です。
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 showUser(Model model) {
model.addAttribute("name", "佐藤花子");
return "user";
}
}
このControllerでは、Modelへnameという名前で佐藤花子という値を登録しています。その後、userというThymeleafテンプレートを表示します。user.html側でth:valueを使ってnameを参照すると、Modelへ登録された値がテキストボックスへ設定されます。このように、Controllerで値を準備し、Modelを通してThymeleafへ渡すという考え方は、Spring Bootの画面表示全体で使われる重要な基本です。
実際のWebアプリケーションでは、一つの文字列だけをModelへ渡すよりも、会員情報や商品情報などをまとめたJavaオブジェクトを渡すことが多くあります。たとえばUserオブジェクトに名前とメールアドレスが入っている場合は、Thymeleafからuserの中にある各プロパティを参照できます。
<form>
<div class="mb-3">
<label for="name" class="form-label">名前</label>
<input type="text"
id="name"
name="name"
class="form-control"
th:value="${user.name}">
</div>
<div class="mb-3">
<label for="email" class="form-label">メールアドレス</label>
<input type="text"
id="email"
name="email"
class="form-control"
th:value="${user.email}">
</div>
</form>
このような書き方を利用すると、データベースから取得した一件分の利用者情報を編集フォームへ表示できます。名前だけでなく、メールアドレス、住所、電話番号、商品名、価格など、オブジェクトが持っているさまざまな値をそれぞれの入力欄へ初期表示できます。
編集画面では特にこの仕組みが重要です。利用者が編集画面を開いたときに現在登録されている内容を表示しておけば、変更したい項目だけを書き換えられます。すべてを最初から入力し直す必要がないため、操作しやすい画面になります。Thymeleafのth:valueは、単純に文字を表示する機能だけではなく、実用的な更新フォームを作成するための重要な属性といえます。
Spring BootとThymeleafでフォーム処理を本格的に実装するときには、th:valueだけではなくth:objectとth:fieldを利用する方法も覚えておくと便利です。th:objectではフォーム全体とJavaオブジェクトを関連付け、th:fieldではそれぞれの入力項目とオブジェクトのプロパティを関連付けます。
<form th:object="${user}" method="post">
<div class="mb-3">
<label for="name" class="form-label">名前</label>
<input type="text"
id="name"
class="form-control"
th:field="*{name}">
</div>
<div class="mb-3">
<label for="email" class="form-label">メールアドレス</label>
<input type="text"
id="email"
class="form-control"
th:field="*{email}">
</div>
<button type="submit" class="btn btn-primary">送信</button>
</form>
th:fieldを利用すると、オブジェクトが持っている値をテキストボックスへ初期表示しながら、利用者が入力した値をフォーム送信時にJava側へ受け渡す処理も作りやすくなります。そのため、Spring Bootで新規登録画面や編集画面を作る場合には、フォームとJavaオブジェクトを結び付ける方法として広く利用されます。
初心者の段階では、最初からすべてを同時に覚える必要はありません。まずHTMLのvalue属性で固定値を表示する仕組みを理解し、次にThymeleafのth:valueで動的な値を表示し、その後にth:objectとth:fieldを使ったフォーム処理へ進むと、段階的に理解しやすくなります。
会員情報変更画面や商品編集画面では、データベースに保存されている情報を取得してテキストボックスへ表示する流れが基本です。Controllerで対象のデータを取得し、そのオブジェクトをModelへ登録します。その後、Thymeleafからオブジェクトのプロパティを参照して入力欄へ初期表示します。
たとえば商品編集画面であれば、商品番号をもとに対象の商品を検索し、取得した商品オブジェクトをModelへ登録します。Thymeleafでは商品名や価格などをth:valueまたはth:fieldで表示します。この流れを理解しておけば、会員編集、社員編集、注文情報変更、住所変更などさまざまな画面へ応用できます。
Controllerで編集対象のデータを取得する
取得したオブジェクトをModelへ登録する
ThymeleafでModelのオブジェクトを参照する
th:valueまたはth:fieldで登録済みの値を表示する
利用者が必要な項目だけを変更できるようにする
th:valueを記述しているのに初期値が表示されない場合は、HTMLの記述だけを確認するのではなく、ControllerからThymeleafまでのデータの流れを順番に確認しましょう。まずControllerでModelへ値を登録しているかを確認します。次にModelへ登録した属性名とThymeleaf側で参照している名前が一致しているかを確認します。
オブジェクトを利用している場合は、プロパティ名も重要です。Java側でnameというプロパティを用意しているのであれば、Thymeleaf側でも対応するnameを参照する必要があります。また、データベースから取得する処理が失敗していて、そもそも対象となるデータが取得できていない可能性もあります。
Spring BootとThymeleafでは、問題が発生した場所を一つずつ切り分けることが大切です。データベースから正しく取得できているか、Controllerまで値が届いているか、Modelへ登録されているか、Thymeleafで正しい名前を参照しているかという順番で確認すると、初期値が表示されない原因を見つけやすくなります。
input要素にはplaceholder属性もありますが、placeholderはvalueやth:valueとは意味が異なります。placeholderは利用者へ入力内容の例や案内を表示するためのものであり、実際の入力値ではありません。入力欄へ文字を入力すると案内表示は消えます。
一方、valueやth:valueで設定された文字は実際の入力値としてテキストボックスへ入っています。利用者が変更せずに送信した場合、その値をフォームの入力内容として扱えます。そのため、新規登録画面で何を入力するのか案内したい場合はplaceholder、編集画面で現在登録されている名前などを表示したい場合はth:valueやth:fieldというように目的に合わせて使い分けることが重要です。
Thymeleafでテキストボックスに初期値を表示する仕組みは、Spring Bootによるフォーム開発の基礎です。固定値、Modelから渡した文字列、データベースから取得したオブジェクト、フォームオブジェクトなど、どこから値を取得するのかによって適した方法が変わります。まずはvalueとth:valueの違いを理解し、ControllerとModelの役割、オブジェクトのプロパティ参照、th:fieldによるフォーム連携まで順番に覚えていくことで、登録画面や編集画面を自分で組み立てやすくなります。
特に実務では、編集画面を開いたときに既存データを表示し、その値を利用者が変更して再登録する処理が頻繁に登場します。Thymeleafの初期値表示を理解しておくことは、単なるHTMLの表示方法を覚えるだけではなく、Spring BootのController、Model、データベース、フォーム処理をつなげて理解することにもつながります。入力フォームが正しく表示されない場合にも、値がどこから来てどこまで届いているのかを追跡できるようになるため、Webアプリケーション開発の基礎力として役立つ知識です。
生徒
「テキストボックスに文字を表示するだけでも、valueとth:valueでは役割が違うんですね。」
先生
「そうですね。毎回同じ固定値ならvalueを使えますが、Spring Bootから渡された名前やデータベースに保存されている商品名などを表示するときはth:valueが便利です。」
生徒
「Controllerから渡した値は、直接HTMLへ届いているわけではないんですよね。」
先生
「その通りです。Controllerで必要なデータを準備してModelへ登録し、ThymeleafがそのModelの値を参照します。この流れを理解しておくと、初期値が表示されないときの確認もしやすくなります。」
生徒
「利用者情報を丸ごと渡した場合は、名前やメールアドレスをそれぞれ取り出せるんですね。」
先生
「はい。オブジェクトをModelへ登録しておけば、Thymeleafから必要なプロパティを参照できます。編集画面ではよく使う方法です。」
生徒
「th:fieldを使う方法もありましたが、th:valueとはどう考え分ければいいですか。」
先生
「一つの値を表示する仕組みを理解するならth:valueが分かりやすいです。フォーム全体をJavaオブジェクトと関連付けて、表示と送信をまとめて扱いたい場合はth:objectとth:fieldが便利です。」
生徒
「placeholderも文字が表示されますが、初期値ではないということですね。」
先生
「はい。placeholderは入力例や案内です。登録済みの氏名など、実際の値を表示したい場合にはth:valueやth:fieldを使います。ここを区別できれば、入力フォームを作るときに迷いにくくなります。」
生徒
「初期値が表示されなかったら、HTMLだけでなくControllerやModel、データベースまで順番に確認すればいいんですね。」
先生
「その考え方が大切です。Spring BootとThymeleafでは、データがどこから来て、どの名前でModelへ入り、HTMLのどこで参照されるのかを追えるようになると、フォームのトラブルにも対応しやすくなります。」
ChatGPTなどの生成AIをこれから学びたい方に向けて、AIスキルアカデミーの口コミ・評判、料金、無料セミナーの内容を詳しくまとめています。
AIスキルアカデミーの口コミ・評判を詳しく見るThymeleafを学ぶ人向けに、Spring Boot教材と画面確認しやすい開発環境を優先しています。
Spring Boot教材を確認する