基礎から学ぶJavaScript入門 90日コース | 最終制作 - Day 87:追加機能

JavaScript 90日で身につけるJavaScript
スポンサーリンク
スポンサーリンク

Day 87:追加機能

Day 87では、基本機能が完成したアプリに、必要な追加機能を選んで加えます。例として、学習管理アプリに「キーワード検索」「日付フィルター」「並べ替え」「ダークモード」を追加します。

追加機能は、数を増やすことが目的ではありません。利用者が記録を探しやすくなる、画面を使いやすくなるなど、アプリの目的に役立つものを選びます。Day 86までに実装した追加・一覧・編集・削除が安定して動くことを確認してから進めましょう。

追加機能を選ぶ

学習管理アプリでは、次のように考えられます。

  • 検索:学習内容やメモから、記録を探しやすくします。
  • フィルター:今日や直近7日間など、条件に合う記録だけを表示します。
  • ソート:日付や学習時間で記録を並べ替えます。
  • ダークモード:画面の配色を暗いテーマに切り替えます。
  • データ保存:Day 86で`localStorage`を実装済みなら、追加で重複実装する必要はありません。
  • API連携:外部サービスの情報が必要なアプリで使います。学習記録を端末内に保存するだけなら、必須ではありません。

今回は検索・フィルター・ソート・ダークモードを実装します。データ保存とAPI連携は、必要な場合の考え方も後半で説明します。

ステップ1:画面に検索・フィルター・ソート欄を追加する

Day 83のHTMLで、学習履歴の見出しの下、一覧の上に次の部品を追加します。idは、後でJavaScriptから要素を取得するために使います。

<!-- 学習記録を探したり、並べ替えたりする操作欄 -->
<div class="record-controls">
  <div class="form-field">
    <label for="search-input">キーワード検索</label>
    <input
      id="search-input"
      type="search"
      placeholder="学習内容やメモで検索"
    >
  </div>

  <div class="form-field">
    <label for="date-filter">期間</label>
    <select id="date-filter">
      <option value="all">すべて</option>
      <option value="today">今日</option>
      <option value="last7days">直近7日間</option>
    </select>
  </div>

  <div class="form-field">
    <label for="sort-order">並べ替え</label>
    <select id="sort-order">
      <option value="newest">日付が新しい順</option>
      <option value="oldest">日付が古い順</option>
      <option value="longest">学習時間が長い順</option>
    </select>
  </div>
</div>

<!-- 絞り込み後に何件表示しているかを示す -->
<p id="result-count" aria-live="polite"></p>

<select>は複数の選択肢から条件を選ぶ入力欄です。日付フィルターや並べ替えのように、決まった選択肢から選ぶ操作に向いています。

ステップ2:検索・フィルター・ソート用の要素を取得する

app.jsの要素取得部分に、次のコードを追加します。同じ変数をすでに宣言している場合は、重複して書かないでください。

// 検索・フィルター・並べ替えの入力欄を取得する
const searchInput = document.getElementById("search-input");
const dateFilter = document.getElementById("date-filter");
const sortOrder = document.getElementById("sort-order");
const resultCount = document.getElementById("result-count");
JavaScript

ステップ3:表示する記録を絞り込む

検索、期間フィルター、並べ替えの処理を、一覧を描画する処理から分けます。まず、すべての記録から表示対象だけを選ぶ関数を作ります。

// Dateをローカルの日付のYYYY-MM-DD形式にする
function toLocalDateString(date) {
  const year = date.getFullYear();
  const month = String(date.getMonth() + 1).padStart(2, "0");
  const day = String(date.getDate()).padStart(2, "0");

  return `${year}-${month}-${day}`;
}

// 入力された条件に合う記録を選び、指定順に並べる
function getVisibleRecords() {
  const keyword = searchInput.value.trim().toLowerCase();
  const selectedPeriod = dateFilter.value;
  const selectedSort = sortOrder.value;

  // まずキーワードと期間で絞り込む
  const filteredRecords = studyRecords.filter(function (record) {
    const title = record.title.toLowerCase();
    const note = (record.note ?? "").toLowerCase();

    // 学習内容かメモに検索語が含まれているか確認する
    const matchesKeyword =
      keyword === "" ||
      title.includes(keyword) ||
      note.includes(keyword);

    let matchesPeriod = true;

    if (selectedPeriod === "today") {
      // 今日の日付と一致する記録だけを残す
      matchesPeriod = record.date === toLocalDateString(new Date());
    } else if (selectedPeriod === "last7days") {
      // 今日を含めた直近7日間の開始日を計算する
      const startDate = new Date();
      startDate.setHours(0, 0, 0, 0);
      startDate.setDate(startDate.getDate() - 6);

      const startDateText = toLocalDateString(startDate);
      const todayText = toLocalDateString(new Date());

      // YYYY-MM-DD形式なら文字列の比較で期間を判定できる
      matchesPeriod =
        record.date >= startDateText &&
        record.date <= todayText;
    }

    return matchesKeyword && matchesPeriod;
  });

  // 元の配列を直接並べ替えないよう、コピーしてからsortする
  const sortedRecords = [...filteredRecords];

  if (selectedSort === "newest") {
    sortedRecords.sort(function (a, b) {
      return b.date.localeCompare(a.date);
    });
  } else if (selectedSort === "oldest") {
    sortedRecords.sort(function (a, b) {
      return a.date.localeCompare(b.date);
    });
  } else if (selectedSort === "longest") {
    sortedRecords.sort(function (a, b) {
      return b.minutes - a.minutes;
    });
  }

  return sortedRecords;
}
JavaScript

sort()は、呼び出した配列自体を並べ替えます。そこで、[...filteredRecords]でコピーを作ってから並べ替えています。元のstudyRecordsを不用意に変更しないための工夫です。

ステップ4:一覧の描画関数を更新する

Day 86のrenderStudyRecords()を、次の内容に置き換えます。検索やフィルターの条件に合う記録を表示し、0件の場合は状況に合った案内を出します。

// 条件に合う学習記録を一覧に表示する
function renderStudyRecords() {
  const visibleRecords = getVisibleRecords();

  // 前回の一覧を消し、最新の条件で表示し直す
  studyList.replaceChildren();

  if (studyRecords.length === 0) {
    // アプリ全体に記録がない場合
    emptyMessage.textContent =
      "まだ記録がありません。最初の学習内容を入力してみましょう。";
    emptyMessage.hidden = false;
  } else if (visibleRecords.length === 0) {
    // 記録はあるが、検索や期間の条件に一致しない場合
    emptyMessage.textContent =
      "条件に合う記録がありません。検索語や期間を変更してください。";
    emptyMessage.hidden = false;
  } else {
    emptyMessage.hidden = true;
  }

  // 条件に合う記録だけを一覧に追加する
  visibleRecords.forEach(function (record) {
    const listItem = document.createElement("li");
    listItem.className = "study-item";

    const content = document.createElement("div");
    content.className = "study-item-content";

    const title = document.createElement("h3");

    // 入力内容はHTMLとしてではなく、文字列として表示する
    title.textContent = record.title;

    const meta = document.createElement("p");
    meta.className = "study-meta";
    meta.textContent = `${record.date} ・ ${record.minutes}分`;

    content.append(title, meta);

    if (record.note) {
      const note = document.createElement("p");
      note.className = "study-note";
      note.textContent = record.note;
      content.appendChild(note);
    }

    const actions = document.createElement("div");
    actions.className = "record-actions";

    const editButton = document.createElement("button");
    editButton.className = "button button-secondary";
    editButton.type = "button";
    editButton.textContent = "編集";
    editButton.dataset.action = "edit";
    editButton.dataset.id = record.id;

    const deleteButton = document.createElement("button");
    deleteButton.className = "button button-danger";
    deleteButton.type = "button";
    deleteButton.textContent = "削除";
    deleteButton.dataset.action = "delete";
    deleteButton.dataset.id = record.id;

    actions.append(editButton, deleteButton);
    listItem.append(content, actions);
    studyList.appendChild(listItem);
  });

  // 絞り込み後に表示している件数と、全記録数を表示する
  resultCount.textContent =
    `${visibleRecords.length}件表示 / 全${studyRecords.length}件`;

  // 合計時間はフィルターに関係なく、すべての記録を対象にする
  const totalMinutes = studyRecords.reduce(function (total, record) {
    return total + record.minutes;
  }, 0);

  totalTime.textContent = `合計 ${totalMinutes} 分`;
}
JavaScript

この例では合計時間を「全記録の合計」としています。検索結果だけの合計を見せたい場合は、studyRecordsではなくvisibleRecordsを使って計算します。どちらが利用者にとって自然か、アプリの仕様として決めておきましょう。

ステップ5:条件を変えたら一覧を更新する

検索欄は入力のたびに、期間と並べ替え欄は選択が変わるたびに、一覧を描画し直します。

// キーワード入力に合わせて一覧を更新する
searchInput.addEventListener("input", renderStudyRecords);

// 期間や並べ替えの選択が変わったら一覧を更新する
dateFilter.addEventListener("change", renderStudyRecords);
sortOrder.addEventListener("change", renderStudyRecords);
JavaScript

追加、編集、削除の処理でも、保存成功後にrenderStudyRecords()を呼び出してください。Day 86のapplyRecords()から描画している場合は、その呼び出しを維持すれば、変更後の一覧にも検索条件が反映されます。

ステップ6:ダークモード切り替えを作る

HTMLのヘッダーなどに、テーマ切り替えボタンを追加します。

<!-- 明るいテーマと暗いテーマを切り替える -->
<button id="theme-toggle" class="button button-secondary" type="button">
  ダークモードにする
</button>

CSSでは色をカスタムプロパティにまとめます。既存のCSSで色を直接指定している部分を、必要に応じてvar(--...)へ置き換えるとテーマを切り替えやすくなります。

/* 通常テーマの色を定義する */
:root {
  color-scheme: light;
  --page-bg: #f4f7fb;
  --panel-bg: #ffffff;
  --text-color: #202b3c;
  --muted-color: #596579;
  --border-color: #e2e8f0;
}

/* darkクラスがあるときの色を定義する */
:root.dark {
  color-scheme: dark;
  --page-bg: #141923;
  --panel-bg: #202938;
  --text-color: #edf2f8;
  --muted-color: #b0bccd;
  --border-color: #3b4758;
}

/* ページ全体にテーマの色を適用する */
body {
  background: var(--page-bg);
  color: var(--text-color);
}

/* パネルや記録項目にもテーマの色を適用する */
.panel,
.study-item,
input,
textarea,
select {
  border-color: var(--border-color);
  background: var(--panel-bg);
  color: var(--text-color);
}

/* 説明文など、補助的な文字の色 */
.app-description,
.study-meta,
.study-note,
.app-footer {
  color: var(--muted-color);
}

既存のCSSにあるbodyや.panelの色指定は、同じ要素に複数の指定が重なりすぎないよう整理してください。テーマ変更時に見えにくい箇所がないか、フォームやボタンも確認します。

ステップ7:テーマ設定を保存する

選んだテーマをlocalStorageに保存すると、ページを再読み込みしても設定を保てます。データ保存用のキーとは別の名前を使います。

// テーマ切り替えに使う要素を取得する
const themeToggle = document.getElementById("theme-toggle");
const THEME_KEY = "studyAppTheme";

// 保存済みのテーマを読み込み、ボタン表示も更新する
function applyTheme(theme) {
  const isDark = theme === "dark";

  document.documentElement.classList.toggle("dark", isDark);
  themeToggle.textContent = isDark
    ? "ライトモードにする"
    : "ダークモードにする";
}

// 保存済みのテーマがdarkなら暗いテーマで起動する
const savedTheme = localStorage.getItem(THEME_KEY);
applyTheme(savedTheme === "dark" ? "dark" : "light");

// ボタンを押したらテーマを切り替えて保存する
themeToggle.addEventListener("click", function () {
  const isDark = document.documentElement.classList.contains("dark");
  const nextTheme = isDark ? "light" : "dark";

  applyTheme(nextTheme);
  localStorage.setItem(THEME_KEY, nextTheme);
});
JavaScript

テーマ設定の保存に失敗しても、画面の切り替え自体は動くようにしたい場合は、保存処理をtry...catchで囲みます。localStorageの利用は、ブラウザーの設定や環境によって失敗することもあります。

データ保存はDay 86の機能を確認する

Day 86でlocalStorageを使った記録保存を実装済みなら、同じ保存処理をもう一度追加する必要はありません。次の点を確認してください。

  • 記録の追加後に配列が保存されています。
  • 編集後に更新済みの配列が保存されています。
  • 削除後に削除済みの配列が保存されています。
  • ページ起動時に保存データを読み込み、一覧に反映しています。

検索やソートは、表示順や表示件数を変えるだけにし、元の記録配列を消したり書き換えたりしないようにします。検索結果が0件でも、記録そのものは削除されていません。

API連携は必要なアプリで使う

API連携は、映画検索やレシピ検索のように、外部サービスの情報を取得するアプリに向いています。今回の学習管理アプリのように、利用者自身の記録を管理するだけなら、最初の完成版でAPIを使う必要はありません。

APIを使う場合は、通信中、成功、結果なし、通信失敗の状態を画面に表示します。基本形は次のとおりです。/api/itemsは説明用の仮のパスなので、実際には利用するサービスの正式な接続先と仕様に置き換えてください。

// APIからデータを取得する基本形
async function loadExternalItems() {
  try {
    // 通信中であることを利用者に知らせる
    statusMessage.textContent = "読み込み中です。";

    const response = await fetch("/api/items");

    // HTTPエラーを確認する
    if (!response.ok) {
      throw new Error(`通信エラー: ${response.status}`);
    }

    const items = await response.json();

    // 取得したデータの形式を確認する
    if (!Array.isArray(items)) {
      throw new Error("受け取ったデータの形式が正しくありません。");
    }

    // ここでitemsを画面表示用の処理へ渡す
    statusMessage.textContent = `${items.length}件取得しました。`;
    return items;
  } catch (error) {
    // 利用者には簡潔に、詳細は開発者向けに表示する
    statusMessage.textContent =
      "データを読み込めませんでした。時間をおいてお試しください。";
    console.error("API取得エラー:", error);
    return [];
  }
}
JavaScript

APIキーが必要な場合、公開されるブラウザー側のJavaScriptに秘密のキーを直接書かないでください。利用するAPIの利用条件、リクエスト制限、データの扱いも事前に確認します。

よくあるつまずき

  • 検索結果が出ない場合は、検索対象に`title`と`note`の両方が含まれているか確認します。
  • 直近7日の記録がずれる場合は、日付の形式がすべて`YYYY-MM-DD`に統一されているか確認します。
  • 並べ替えで元の順番まで変わってしまう場合は、コピーした配列を`sort()`しているか確認します。
  • 追加や編集のあと一覧が条件に合わなくなる場合は、変更後に`renderStudyRecords()`を呼んでいるか確認します。
  • ダークモードで文字が読みにくい場合は、本文、入力欄、一覧、ボタンなど各部品の色を確認します。

Day 87の確認項目

  • 学習内容やメモの一部を入力して、該当する記録を検索できます。
  • 「今日」「直近7日間」「すべて」を切り替えられます。
  • 日付の新しい順、古い順、学習時間の長い順に並べ替えられます。
  • 検索条件に合う記録がないとき、案内が表示されます。
  • ダークモードを切り替え、再読み込み後も設定が保たれます。
  • 追加・編集・削除後も、記録と保存データが正しく一致しています。

まとめ

Day 87では、学習管理アプリに検索、期間フィルター、並べ替え、ダークモードを追加しました。検索やフィルターは表示対象を選び、ソートは表示順を整えます。表示用の配列を元データと分けることで、検索結果や並べ替えが記録そのものを壊すのを防げます。

データ保存はDay 86で作った機能を活用し、API連携は外部データが必要な場合に追加します。機能を増やすときも、追加・一覧・編集・削除が安定して動くことを確かめながら、一つずつ実装していきましょう。

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