Day 10:JavaScript総合演習 - 商品管理ミニアプリ
Day 1からDay 9までに学んだJavaScriptを組み合わせて、商品を追加・削除・検索できるミニアプリを作ります。商品データはブラウザー内のJavaScriptで管理し、検索とカテゴリー絞り込み、表示中商品の合計金額も計算します。
この演習で使う要素は次のとおりです。
constとletで値や配列を管理します。- オブジェクトと配列で商品データを表します。
- 関数で追加、削除、検索、表示などの処理を分けます。
filter()で検索と削除を行い、reduce()で合計を計算します。- イベント処理、入力チェック、テンプレートリテラルを使います。
- 配列やオブジェクトを直接変更せず、新しいデータを作って更新します。
1. 作るアプリの仕様を決める
今回の商品データは、次の形にします。
// 商品1件分のデータ例です
const product = {
id: 1,
name: "ノート",
price: 300,
category: "文房具",
};JavaScript各プロパティの役割は次のとおりです。
id:商品を区別するための番号です。name:商品名です。price:商品の価格です。今回は円単位の整数として扱います。category:商品のカテゴリーです。
検索欄とカテゴリーの両方を指定した場合は、両方の条件に合う商品だけを表示します。合計金額は、現在画面に表示されている商品の価格合計とします。そのため検索や絞り込みを行うと、合計金額も変わります。
2. ファイルを用意する
Day 9までのプロジェクトなどに、次の2つのファイルを作成します。
day10-product-app/
├── index.html
└── app.js
この演習では、商品データをブラウザー内で管理します。ページを再読み込みすると、追加・削除したデータは最初のサンプルに戻ります。保存機能は後の発展課題で扱います。
3. HTMLで画面を作る
index.htmlに検索欄、カテゴリー選択、追加フォーム、商品一覧、合計表示を作ります。
<!doctype html>
<html lang="ja">
<head>
<!-- 日本語を正しく表示するための文字コードです -->
<meta charset="UTF-8" />
<!-- スマートフォンの画面幅に合わせて表示します -->
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<!-- ブラウザーのタブに表示するタイトルです -->
<title>商品管理ミニアプリ</title>
<!-- HTMLの読み込み後にJavaScriptを実行します -->
<script src="./app.js" defer></script>
</head>
<body>
<!-- アプリの見出しです -->
<h1>商品管理ミニアプリ</h1>
<!-- 商品の検索とカテゴリー絞り込みを行う領域です -->
<section aria-labelledby="search-heading">
<h2 id="search-heading">商品を検索する</h2>
<!-- 商品名の一部を入力します -->
<label for="search-input">商品名</label>
<input
id="search-input"
type="search"
placeholder="商品名を入力"
autocomplete="off"
/>
<!-- カテゴリーを選択します -->
<label for="category-filter">カテゴリー</label>
<select id="category-filter">
<option value="all">すべて</option>
<option value="文房具">文房具</option>
<option value="キッチン">キッチン</option>
<option value="食品">食品</option>
</select>
</section>
<!-- 商品を追加するフォームです -->
<section aria-labelledby="add-heading">
<h2 id="add-heading">商品を追加する</h2>
<form id="product-form">
<!-- 商品名を入力します -->
<label for="product-name">商品名</label>
<input
id="product-name"
name="name"
type="text"
maxlength="50"
required
/>
<!-- 価格を円単位の整数で入力します -->
<label for="product-price">価格(円)</label>
<input
id="product-price"
name="price"
type="number"
min="0"
step="1"
required
/>
<!-- 商品カテゴリーを選びます -->
<label for="product-category">カテゴリー</label>
<select id="product-category" name="category" required>
<option value="文房具">文房具</option>
<option value="キッチン">キッチン</option>
<option value="食品">食品</option>
</select>
<!-- 入力した商品を追加します -->
<button type="submit">商品を追加</button>
</form>
<!-- 入力エラーや追加完了のメッセージを表示します -->
<p id="form-message" aria-live="polite"></p>
</section>
<!-- 商品一覧と合計を表示する領域です -->
<section aria-labelledby="list-heading">
<h2 id="list-heading">商品一覧</h2>
<!-- 表示中の商品数と合計金額を表示します -->
<p id="summary" aria-live="polite"></p>
<!-- JavaScriptで商品ごとのli要素を追加します -->
<ul id="product-list"></ul>
</section>
</body>
</html>
deferを指定しているため、HTMLの読み込みが進んだあとにapp.jsが実行されます。JavaScriptが入力欄や一覧要素を探す時点で、HTMLが用意されている状態になります。
4. 商品データと画面要素を用意する
app.jsを作り、最初の商品データとHTML要素を準備します。
// 最初に表示する商品データです
let products = [
{ id: 1, name: "ノート", price: 300, category: "文房具" },
{ id: 2, name: "ペン", price: 150, category: "文房具" },
{ id: 3, name: "マグカップ", price: 1200, category: "キッチン" },
];
// 新しい商品のIDを決めるための番号です
let nextProductId = 4;
// HTMLから検索欄やフォームなどの要素を取得します
const searchInput = document.querySelector("#search-input");
const categoryFilter = document.querySelector("#category-filter");
const productForm = document.querySelector("#product-form");
const productNameInput = document.querySelector("#product-name");
const productPriceInput = document.querySelector("#product-price");
const productCategoryInput = document.querySelector("#product-category");
const productListElement = document.querySelector("#product-list");
const summaryElement = document.querySelector("#summary");
const formMessageElement = document.querySelector("#form-message");JavaScript商品一覧は、商品を追加・削除するたびに別の配列へ更新するためletで宣言しています。要素を変えないHTML参照や、後から再代入しない値にはconstを使っています。
5. 金額表示の関数を作る
価格を「1,200円」のように読みやすく表示する関数を作ります。
// 数値を日本円の表示形式に変換します
function formatYen(price) {
// 桁区切りと円表示をつけた文字列を返します
return new Intl.NumberFormat("ja-JP", {
style: "currency",
currency: "JPY",
}).format(price);
}JavaScriptこの関数は、同じ表示処理を何度も書かなくて済むようにするためのものです。関数に分けると、表示方法を変更するときも修正箇所が一か所で済みます。
6. 検索とカテゴリー絞り込みを行う
商品名の検索文字とカテゴリーをもとに、表示対象の商品だけを返す関数を作ります。
// 検索文字とカテゴリーに合う商品だけを返します
function getVisibleProducts() {
// 検索欄の前後の空白を除き、小文字に変換します
const keyword = searchInput.value.trim().toLowerCase();
// 選択されているカテゴリーを取得します
const selectedCategory = categoryFilter.value;
// 検索条件とカテゴリー条件の両方に合う商品を返します
return products.filter((product) => {
// 商品名に検索文字が含まれているかを調べます
const matchesKeyword = product.name.toLowerCase().includes(keyword);
// "all"ならカテゴリーを限定しません
const matchesCategory =
selectedCategory === "all" ||
product.category === selectedCategory;
// どちらの条件にも合う商品だけを残します
return matchesKeyword && matchesCategory;
});
}JavaScriptここでは、filter()が商品ごとに条件を確認し、条件に合うものだけを新しい配列にまとめています。
matchesKeywordとmatchesCategoryに分けているのは、条件の意味を読みやすくするためです。検索欄が空なら、文字列のincludes("")はtrueになるため、カテゴリーの条件だけで絞り込めます。
7. 合計金額を計算する
表示対象になった商品だけを使い、reduce()で合計金額を計算します。
// 商品一覧の価格を合計して返します
function calculateTotalPrice(productList) {
// 初期値を0円にして、各商品の価格を足し合わせます
return productList.reduce((total, product) => {
// 現在までの合計に、商品の価格を加えて返します
return total + product.price;
}, 0);
}JavaScriptreduce()の最後にある0は、合計の初期値です。商品が1件もない場合も、結果を0として扱えます。
8. 商品一覧を画面に表示する
表示対象の商品からli要素を作り、画面に追加します。商品名などの文字はtextContentで設定し、HTMLとして解釈させません。
// 商品一覧と合計金額を画面に表示します
function renderProducts() {
// 現在の検索条件に合う商品を取得します
const visibleProducts = getVisibleProducts();
// 前回の表示を消します
productListElement.replaceChildren();
// 商品が0件の場合は案内を表示します
if (visibleProducts.length === 0) {
const emptyItem = document.createElement("li");
// メッセージをHTMLではなく文字として設定します
emptyItem.textContent = "条件に合う商品がありません。";
// 案内を商品一覧に追加します
productListElement.append(emptyItem);
} else {
// 商品ごとに一覧項目を作ります
visibleProducts.forEach((product) => {
// 商品1件分のli要素を作成します
const item = document.createElement("li");
// 商品情報を表示するテキスト要素を作成します
const description = document.createElement("span");
// 商品名、価格、カテゴリーをテキストとして設定します
description.textContent =
`${product.name} - ${formatYen(product.price)} - ${product.category}`;
// 商品を削除するボタンを作ります
const deleteButton = document.createElement("button");
// ボタンに表示する文字を設定します
deleteButton.textContent = "削除";
// 削除対象の商品IDをdata属性に保存します
deleteButton.dataset.productId = String(product.id);
// 商品情報と削除ボタンをli要素に追加します
item.append(description, deleteButton);
// li要素を一覧に追加します
productListElement.append(item);
});
}
// 表示中商品の価格を合計します
const totalPrice = calculateTotalPrice(visibleProducts);
// 表示件数と合計金額を画面に表示します
summaryElement.textContent =
`表示中:${visibleProducts.length}件 / 合計:${formatYen(totalPrice)}`;
}JavaScriptreplaceChildren()で前の表示を消してから、新しい結果を作ります。検索条件を変えても、古い結果が残り続けることを防げます。
また、商品名をinnerHTMLではなくtextContentで表示しています。ユーザーが入力した文字をHTMLとして解釈させないためです。
9. 商品を追加する
フォームの入力内容を確認し、問題がなければ新しい商品オブジェクトを作ります。配列へ直接push()する代わりに、スプレッド構文で新しい配列を作ります。
// 商品追加フォームが送信されたときの処理です
productForm.addEventListener("submit", (event) => {
// フォーム送信によるページ再読み込みを防ぎます
event.preventDefault();
// 商品名の前後の空白を取り除きます
const name = productNameInput.value.trim();
// 入力された価格を数値に変換します
const price = Number(productPriceInput.value);
// 選択されているカテゴリーを取得します
const category = productCategoryInput.value;
// 商品名が空でないか確認します
if (name === "") {
formMessageElement.textContent = "商品名を入力してください。";
return;
}
// 価格が0以上の安全な整数か確認します
if (!Number.isSafeInteger(price) || price < 0) {
formMessageElement.textContent =
"価格は0以上の整数で入力してください。";
return;
}
// 新しい商品オブジェクトを作ります
const newProduct = {
id: nextProductId,
name,
price,
category,
};
// 商品一覧をコピーし、新しい商品を追加した配列を作ります
products = [...products, newProduct];
// 次に使うIDを1つ増やします
nextProductId += 1;
// 入力欄を初期状態に戻します
productForm.reset();
// 追加結果を画面に反映します
renderProducts();
// 追加できたことを利用者に伝えます
formMessageElement.textContent = `${name}を追加しました。`;
// 次の商品名をすぐ入力できるようにします
productNameInput.focus();
});JavaScriptNumber.isSafeInteger()は、値が安全な整数かを確認します。価格を円単位の整数として扱うため、小数や数値以外の値を受け付けないようにしています。
products = [...products, newProduct]は、元の配列を変更せずに、新しい配列を作る書き方です。この「変更前のデータを直接書き換えず、新しいデータを作る」方法は、Reactで状態を更新するときにも重要です。
10. 商品を削除する
削除ボタンが押された商品を、IDで特定して配列から除きます。商品一覧全体にイベントを登録し、どのボタンが押されたかを調べる方法を使います。
// 商品一覧の中でクリックされた要素を確認します
productListElement.addEventListener("click", (event) => {
// クリックされた場所から削除ボタンを探します
const deleteButton = event.target.closest("button[data-product-id]");
// 削除ボタン以外がクリックされた場合は何もしません
if (deleteButton === null) {
return;
}
// data属性から削除対象のIDを取得し、数値に変換します
const targetId = Number(deleteButton.dataset.productId);
// IDが対象の商品以外を残した新しい配列を作ります
products = products.filter((product) => {
// IDが異なる商品だけが新しい配列に残ります
return product.id !== targetId;
});
// 削除後の一覧と合計を画面に反映します
renderProducts();
// 削除完了をメッセージで知らせます
formMessageElement.textContent = "商品を削除しました。";
});JavaScriptfilter()は、条件に合う要素を残した新しい配列を返します。この例では、削除対象の商品IDと異なる商品だけを残しています。
11. 検索条件が変わったら再表示する
検索欄に入力したときや、カテゴリーを変更したときに、表示を更新します。
// 検索文字が入力されるたびに一覧を更新します
searchInput.addEventListener("input", () => {
// 現在の条件に合う商品を再表示します
renderProducts();
});
// カテゴリーが選び直されたときに一覧を更新します
categoryFilter.addEventListener("change", () => {
// 現在の条件に合う商品を再表示します
renderProducts();
});
// ページを開いたとき、最初の商品一覧を表示します
renderProducts();JavaScript検索欄のinputイベントは、入力内容が変わるたびに発生します。ボタンを押さなくても検索結果が変わるため、使いやすい画面になります。
12. 完成したapp.js
これまでのコードをひとつにまとめると、app.jsは次のようになります。
// 最初に表示する商品データです
let products = [
{ id: 1, name: "ノート", price: 300, category: "文房具" },
{ id: 2, name: "ペン", price: 150, category: "文房具" },
{ id: 3, name: "マグカップ", price: 1200, category: "キッチン" },
];
// 新しい商品に割り当てる次のIDです
let nextProductId = 4;
// HTML要素を取得します
const searchInput = document.querySelector("#search-input");
const categoryFilter = document.querySelector("#category-filter");
const productForm = document.querySelector("#product-form");
const productNameInput = document.querySelector("#product-name");
const productPriceInput = document.querySelector("#product-price");
const productCategoryInput = document.querySelector("#product-category");
const productListElement = document.querySelector("#product-list");
const summaryElement = document.querySelector("#summary");
const formMessageElement = document.querySelector("#form-message");
// 価格を日本円の表示形式に変換します
function formatYen(price) {
// 桁区切りを付けた円表示を返します
return new Intl.NumberFormat("ja-JP", {
style: "currency",
currency: "JPY",
}).format(price);
}
// 検索文字とカテゴリーに合う商品を返します
function getVisibleProducts() {
// 検索文字の前後の空白を取り、小文字にします
const keyword = searchInput.value.trim().toLowerCase();
// 選択中のカテゴリーを取得します
const selectedCategory = categoryFilter.value;
// すべての商品を条件に合わせて絞り込みます
return products.filter((product) => {
// 商品名に検索文字が含まれるか調べます
const matchesKeyword = product.name.toLowerCase().includes(keyword);
// "all"ならカテゴリーを限定しません
const matchesCategory =
selectedCategory === "all" ||
product.category === selectedCategory;
// 両方の条件に合う商品だけを残します
return matchesKeyword && matchesCategory;
});
}
// 商品価格の合計を計算します
function calculateTotalPrice(productList) {
// 初期値0から商品価格を加算します
return productList.reduce((total, product) => {
// 合計に商品の価格を足して返します
return total + product.price;
}, 0);
}
// 商品一覧と合計を画面に表示します
function renderProducts() {
// 検索条件に合う商品を取得します
const visibleProducts = getVisibleProducts();
// 古い表示内容を消します
productListElement.replaceChildren();
// 該当商品がなければ案内を表示します
if (visibleProducts.length === 0) {
const emptyItem = document.createElement("li");
// 案内文をテキストとして設定します
emptyItem.textContent = "条件に合う商品がありません。";
// 案内を一覧に追加します
productListElement.append(emptyItem);
} else {
// 商品ごとに一覧項目を作ります
visibleProducts.forEach((product) => {
const item = document.createElement("li");
const description = document.createElement("span");
const deleteButton = document.createElement("button");
// 商品情報をテキストとして表示します
description.textContent =
`${product.name} - ${formatYen(product.price)} - ${product.category}`;
// 削除ボタンの表示文字と対象IDを設定します
deleteButton.textContent = "削除";
deleteButton.dataset.productId = String(product.id);
// 商品情報とボタンを一覧項目に加えます
item.append(description, deleteButton);
// 一覧項目を画面に追加します
productListElement.append(item);
});
}
// 表示中の商品価格を合計します
const totalPrice = calculateTotalPrice(visibleProducts);
// 件数と合計を表示します
summaryElement.textContent =
`表示中:${visibleProducts.length}件 / 合計:${formatYen(totalPrice)}`;
}
// 商品追加フォームの処理を登録します
productForm.addEventListener("submit", (event) => {
// フォームの標準送信を止めます
event.preventDefault();
// 入力値を取り出し、商品名の空白を除きます
const name = productNameInput.value.trim();
// 価格を数値に変換します
const price = Number(productPriceInput.value);
// カテゴリーを取り出します
const category = productCategoryInput.value;
// 商品名の入力を確認します
if (name === "") {
formMessageElement.textContent = "商品名を入力してください。";
return;
}
// 価格が0以上の安全な整数か確認します
if (!Number.isSafeInteger(price) || price < 0) {
formMessageElement.textContent =
"価格は0以上の整数で入力してください。";
return;
}
// 入力値から新しい商品を作ります
const newProduct = {
id: nextProductId,
name,
price,
category,
};
// 元の配列を保ったまま、新しい商品を追加します
products = [...products, newProduct];
// 次の商品用にIDを進めます
nextProductId += 1;
// フォームの入力内容をリセットします
productForm.reset();
// 画面の一覧と合計を更新します
renderProducts();
// 追加完了メッセージを表示します
formMessageElement.textContent = `${name}を追加しました。`;
// 商品名の入力欄にフォーカスを戻します
productNameInput.focus();
});
// 商品一覧内の削除ボタンをクリックしたときの処理です
productListElement.addEventListener("click", (event) => {
// クリック箇所から商品削除ボタンを探します
const deleteButton = event.target.closest("button[data-product-id]");
// 削除ボタン以外なら処理を終えます
if (deleteButton === null) {
return;
}
// ボタンに保存したIDを数値として取得します
const targetId = Number(deleteButton.dataset.productId);
// 対象ID以外の商品で新しい配列を作ります
products = products.filter((product) => {
return product.id !== targetId;
});
// 画面を更新します
renderProducts();
// 削除完了を知らせます
formMessageElement.textContent = "商品を削除しました。";
});
// 検索文字が変わったら一覧を更新します
searchInput.addEventListener("input", () => {
renderProducts();
});
// カテゴリーが変わったら一覧を更新します
categoryFilter.addEventListener("change", () => {
renderProducts();
});
// 最初の商品一覧を表示します
renderProducts();JavaScript13. アプリの動作を確認する
ページをローカルサーバーで開いて、次の操作を試してください。
- 最初に3つの商品が表示され、件数と合計金額が出ることを確認します。
- 検索欄に「ノート」と入力し、ノートだけが表示されることを確認します。
- カテゴリーを「文房具」にして、文房具だけが表示されることを確認します。
- 商品名と価格を入力して追加し、一覧と合計が更新されることを確認します。
- 追加した商品の削除ボタンを押し、一覧と合計から商品が消えることを確認します。
- 存在しない商品名を入力し、「条件に合う商品がありません。」と表示されることを確認します。
- 価格に小数や負の数を入力できないこと、またはエラーメッセージが表示されることを確認します。
14. よくある間違い
入力値は文字列として取得される
input.valueは文字列です。価格を計算に使う前にNumber()で数値に変換します。変換後は、Number.isSafeInteger()などで値の形式を確認しましょう。
配列へ直接追加してしまう
products.push(newProduct)は元の配列を変更します。今回はproducts = [...products, newProduct]で新しい配列を作っています。この書き方はReactの状態更新を学ぶための練習にもなります。
検索とカテゴリーの条件を間違える
検索文字とカテゴリーの両方に一致させる場合は&&を使います。どちらか一方に一致すればよい検索にしたい場合は||を使います。今回の仕様では「入力した商品名にもカテゴリーにも合うもの」を表示するため、最終条件はmatchesKeyword && matchesCategoryです。
商品名をHTMLとして挿入してしまう
入力内容をinnerHTMLに入れるのではなく、textContentで表示しています。ユーザー入力をHTMLとして解釈させないことで、予期しないHTML表示やスクリプト実行につながるリスクを減らせます。
15. 発展課題
基本機能が動いたら、次の機能を追加すると理解が深まります。
- 価格の安い順・高い順に並べ替えます。
- 商品ごとの個数を追加し、価格と個数から小計を計算します。
- 全商品の合計と、検索後の表示商品の合計を両方表示します。
localStorageを使って、再読み込み後も商品データを保存します。- カテゴリーをHTMLに固定せず、商品データから一覧を作ります。
- Day 9の学習を使い、データ、表示処理、計算処理を別ファイルに分けます。
localStorageへ保存する場合、JavaScriptの配列やオブジェクトをJSON文字列に変換して保存し、読み込むときにJSONから戻す方法を使います。保存するデータに個人情報や秘密情報を含めないようにしてください。
16. Day 10のチェックリスト
- 商品をオブジェクトとして表し、配列で管理できます。
- 入力内容を取得し、名前や価格が妥当か確認できます。
- 商品を追加するとき、スプレッド構文で新しい配列を作れます。
- 商品を削除するとき、
filter()で対象以外の商品を残せます。 - 検索文字とカテゴリーの両方を使って商品を絞り込めます。
reduce()で表示中商品の価格合計を計算できます。- 処理を関数に分け、目的が分かる名前をつけられます。
- 入力された文字を
textContentで安全に表示できます。
このミニアプリでは、商品データを用意し、入力を受け取り、条件に応じてデータを絞り込み、計算結果を画面に反映しました。Reactでは、このうちデータと表示の更新をReactの状態管理に置き換えます。特に、配列を直接変更せず新しい配列を作ること、処理を役割ごとに関数へ分けること、入力値を確認してから使うことが、次のReact学習につながる重要なポイントです。

