Next.jsで学ぶReact講座 90日コース | ReactのためのJavaScript基礎 - Day 10:JavaScript総合演習

React Next.jsで学ぶReact講座90日コース
スポンサーリンク
スポンサーリンク

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);
}
JavaScript

reduce()の最後にある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)}`;
}
JavaScript

replaceChildren()で前の表示を消してから、新しい結果を作ります。検索条件を変えても、古い結果が残り続けることを防げます。

また、商品名を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();
});
JavaScript

Number.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 = "商品を削除しました。";
});
JavaScript

filter()は、条件に合う要素を残した新しい配列を返します。この例では、削除対象の商品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();
JavaScript

13. アプリの動作を確認する

ページをローカルサーバーで開いて、次の操作を試してください。

  • 最初に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学習につながる重要なポイントです。

タイトルとURLをコピーしました