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;
}JavaScriptsort()は、呼び出した配列自体を並べ替えます。そこで、[...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 [];
}
}JavaScriptAPIキーが必要な場合、公開されるブラウザー側のJavaScriptに秘密のキーを直接書かないでください。利用するAPIの利用条件、リクエスト制限、データの扱いも事前に確認します。
よくあるつまずき
- 検索結果が出ない場合は、検索対象に`title`と`note`の両方が含まれているか確認します。
- 直近7日の記録がずれる場合は、日付の形式がすべて`YYYY-MM-DD`に統一されているか確認します。
- 並べ替えで元の順番まで変わってしまう場合は、コピーした配列を`sort()`しているか確認します。
- 追加や編集のあと一覧が条件に合わなくなる場合は、変更後に`renderStudyRecords()`を呼んでいるか確認します。
- ダークモードで文字が読みにくい場合は、本文、入力欄、一覧、ボタンなど各部品の色を確認します。
Day 87の確認項目
- 学習内容やメモの一部を入力して、該当する記録を検索できます。
- 「今日」「直近7日間」「すべて」を切り替えられます。
- 日付の新しい順、古い順、学習時間の長い順に並べ替えられます。
- 検索条件に合う記録がないとき、案内が表示されます。
- ダークモードを切り替え、再読み込み後も設定が保たれます。
- 追加・編集・削除後も、記録と保存データが正しく一致しています。
まとめ
Day 87では、学習管理アプリに検索、期間フィルター、並べ替え、ダークモードを追加しました。検索やフィルターは表示対象を選び、ソートは表示順を整えます。表示用の配列を元データと分けることで、検索結果や並べ替えが記録そのものを壊すのを防げます。
データ保存はDay 86で作った機能を活用し、API連携は外部データが必要な場合に追加します。機能を増やすときも、追加・一覧・編集・削除が安定して動くことを確かめながら、一つずつ実装していきましょう。
