基礎から学ぶJavaScript入門 90日コース | 最終制作 - Day 86:編集・削除機能

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

Day 86:編集・削除機能

Day 86では、Day 85で作った「学習記録の追加・一覧表示」に、編集と削除を加えます。これで、データを作成・読み取り・更新・削除する基本操作「CRUD」がそろいます。

  • Create:記録を追加します。
  • Read:記録を読み込み、一覧に表示します。
  • Update:登録済みの記録を編集します。
  • Delete:不要な記録を削除します。

ここでは、前日までの学習管理アプリを使います。フォームを追加と編集の両方に使い、どの記録を編集中かはeditingIdで管理します。

ステップ1:フォームに編集キャンセルボタンを加える

Day 83で作成したフォームのボタン部分を、次のように変更します。追加時は「記録する」、編集中は「更新する」と表示し、編集をやめるためのボタンも用意します。

<div class="form-actions">
  <!-- 追加時は「記録する」、編集中は「更新する」と表示する -->
  <button id="study-submit" class="button button-primary" type="submit">
    記録する
  </button>

  <!-- 編集中の状態を解除するボタン。通常時は隠しておく -->
  <button
    id="cancel-edit"
    class="button button-secondary"
    type="button"
    hidden
  >
    編集をキャンセル
  </button>
</div>

一覧のulは、JavaScriptが記録を描画する場所として空にしておきます。

<!-- JavaScriptが記録の一覧を作る場所 -->
<ul id="study-list" class="study-list"></ul>

ステップ2:編集状態を管理する

編集する記録のIDを保存する変数を用意します。editingIdがnullなら新規追加、IDが入っていればその記録を編集している状態です。

// 現在編集中の記録ID。編集していないときはnull
let editingId = null;
JavaScript

フォームやボタンなど、HTML要素も取得します。すでに同じ変数をDay 85のコードに用意している場合は、重複して宣言せず、必要な要素だけ追加してください。

// フォームと入力欄を取得する
const studyForm = document.getElementById("study-form");
const titleInput = document.getElementById("study-title");
const minutesInput = document.getElementById("study-minutes");
const dateInput = document.getElementById("study-date");
const noteInput = document.getElementById("study-note");

// 状態メッセージと一覧表示に使う要素を取得する
const statusMessage = document.getElementById("status-message");
const totalTime = document.getElementById("total-time");
const emptyMessage = document.getElementById("empty-message");
const studyList = document.getElementById("study-list");

// 追加・編集の状態を切り替えるボタンを取得する
const submitButton = document.getElementById("study-submit");
const cancelEditButton = document.getElementById("cancel-edit");

// 保存するときに使うlocalStorageのキー
const STORAGE_KEY = "studyRecords";
JavaScript

ステップ3:保存データを読み込む

Day 85と同様に、記録はオブジェクトの配列で管理します。保存データがない場合は空の配列を使い、JSONの読み込みに失敗した場合もアプリが停止しないようにします。

// localStorageから学習記録を読み込む
function loadStudyRecords() {
  try {
    const savedText = localStorage.getItem(STORAGE_KEY);

    // 初回など、保存データがない場合は空の配列を返す
    if (savedText === null) {
      return [];
    }

    // JSON文字列をJavaScriptの値に戻す
    const savedData = JSON.parse(savedText);

    // 配列でなければ、想定外のデータとして空の配列を返す
    if (!Array.isArray(savedData)) {
      return [];
    }

    // 一覧表示に必要な形式の記録だけを使う
    return savedData.filter(function (record) {
      return (
        record !== null &&
        typeof record.id === "string" &&
        typeof record.title === "string" &&
        typeof record.minutes === "number" &&
        typeof record.date === "string"
      );
    });
  } catch (error) {
    // 保存データの読み込みに失敗しても、アプリ全体は止めない
    console.error("学習記録を読み込めませんでした。", error);
    return [];
  }
}

// 読み込んだ記録をアプリの配列として使う
let studyRecords = loadStudyRecords();
JavaScript

ステップ4:変更を保存してから画面を更新する

追加・編集・削除では、記録の配列が変わります。変更後の配列を先にlocalStorageへ保存し、成功した場合にアプリの配列と画面を更新する関数を用意します。

// 変更後の記録を保存し、成功した場合に画面へ反映する
function applyRecords(nextRecords) {
  try {
    // localStorageには文字列として保存する
    localStorage.setItem(STORAGE_KEY, JSON.stringify(nextRecords));

    // 保存に成功したら、アプリの配列を更新する
    studyRecords = nextRecords;

    // 最新の配列から一覧と合計時間を描画する
    renderStudyRecords();

    return true;
  } catch (error) {
    // 保存に失敗したときは、現在の配列や画面を変更しない
    console.error("学習記録を保存できませんでした。", error);
    statusMessage.textContent =
      "記録を保存できませんでした。ブラウザーの保存領域を確認してください。";

    return false;
  }
}
JavaScript

この関数では、保存が成功してから配列を切り替えます。そうすると、保存には失敗したのに画面上だけ記録が変わってしまう、といった食い違いを防ぎやすくなります。

ステップ5:記録を一覧表示する

一覧を毎回作り直し、各記録に「編集」と「削除」ボタンを付けます。ユーザー入力を画面に表示するときは、HTMLとして解釈させずtextContentを使います。

// 日付を読みやすい形式にして返す
function formatDate(dateText) {
  const date = new Date(`${dateText}T00:00:00`);

  // 無効な日付なら、元の値をそのまま表示する
  if (Number.isNaN(date.getTime())) {
    return dateText;
  }

  // 日本語の年月日形式にする
  return new Intl.DateTimeFormat("ja-JP", {
    year: "numeric",
    month: "long",
    day: "numeric"
  }).format(date);
}

// 学習記録の配列から一覧を描画する
function renderStudyRecords() {
  // 表示済みの項目を消し、現在の配列から作り直す
  studyList.replaceChildren();

  // 記録が0件なら空の状態の案内を表示する
  emptyMessage.hidden = studyRecords.length !== 0;

  studyRecords.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");

    // 入力された学習内容は文字列として表示する
    title.textContent = record.title;

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

    content.append(title, meta);

    // メモがある場合だけ表示する
    if (record.note !== "") {
      const note = document.createElement("p");
      note.className = "study-note";

      // メモもHTMLとしてではなく、文字列として表示する
      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);
  });

  // すべての記録の学習時間を合計する
  const totalMinutes = studyRecords.reduce(function (total, record) {
    return total + record.minutes;
  }, 0);

  // 合計時間を画面に表示する
  totalTime.textContent = `合計 ${totalMinutes} 分`;
}
JavaScript

dataset.idには対象の記録IDを入れています。配列の何番目かではなく、IDで対象を特定するため、並び順が変わっても別の記録を誤って編集・削除しにくくなります。

ステップ6:追加と編集を同じフォームで処理する

フォームの送信時に、editingIdを確認します。nullなら新しい記録を作り、IDが入っていれば該当する記録を更新します。

// 日付欄に使う今日の日付をYYYY-MM-DD形式で返す
function getLocalDateString() {
  const today = new Date();
  const year = today.getFullYear();
  const month = String(today.getMonth() + 1).padStart(2, "0");
  const day = String(today.getDate()).padStart(2, "0");

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

// 学習記録の入力値を確認する
function validateStudyInput(title, minutes, date) {
  if (title.trim() === "") {
    return "学習内容を入力してください。";
  }

  const numericMinutes = Number(minutes);

  if (!Number.isFinite(numericMinutes) || numericMinutes <= 0) {
    return "学習時間には0より大きい数値を入力してください。";
  }

  if (date === "") {
    return "学習日を入力してください。";
  }

  return "";
}

// フォーム送信時に、追加または更新を行う
studyForm.addEventListener("submit", function (event) {
  // ブラウザー標準の送信によるページ再読み込みを防ぐ
  event.preventDefault();

  const title = titleInput.value;
  const minutes = minutesInput.value;
  const date = dateInput.value;
  const note = noteInput.value;

  // 保存前に入力内容を確認する
  const validationMessage = validateStudyInput(title, minutes, date);

  if (validationMessage !== "") {
    statusMessage.textContent = validationMessage;
    return;
  }

  let nextRecords;

  if (editingId === null) {
    // 新規追加用の記録を作る
    const newRecord = {
      id: createRecordId(),
      title: title.trim(),
      minutes: Number(minutes),
      date: date,
      note: note.trim(),
      createdAt: new Date().toISOString()
    };

    // 新しい記録を配列の先頭に追加する
    nextRecords = [newRecord, ...studyRecords];
  } else {
    // 編集対象の記録だけ、入力内容で置き換える
    nextRecords = studyRecords.map(function (record) {
      if (record.id !== editingId) {
        return record;
      }

      return {
        ...record,
        title: title.trim(),
        minutes: Number(minutes),
        date: date,
        note: note.trim()
      };
    });
  }

  // 保存に成功した場合だけ、フォームを初期状態へ戻す
  if (applyRecords(nextRecords)) {
    resetForm();
    statusMessage.textContent =
      editingId === null
        ? "学習記録を追加しました。"
        : "学習記録を更新しました。";
  }
});
JavaScript

ここでは更新時にmap()を使い、対象IDと一致する記録だけを新しいオブジェクトに置き換えています。...recordは、IDや作成日時など変更しない項目を引き継ぐための書き方です。

ただし、上のコードではresetForm()を呼ぶ前にeditingIdを確認すると、関数内で状態を初期化した後には追加・更新の判定ができなくなります。正しくメッセージを分けるため、次のように編集状態を先に保存してから処理してください。

// フォーム送信時に、追加または更新を行う
studyForm.addEventListener("submit", function (event) {
  event.preventDefault();

  const title = titleInput.value;
  const minutes = minutesInput.value;
  const date = dateInput.value;
  const note = noteInput.value;

  // 送信時点で編集モードかどうかを記録しておく
  const wasEditing = editingId !== null;

  const validationMessage = validateStudyInput(title, minutes, date);

  if (validationMessage !== "") {
    statusMessage.textContent = validationMessage;
    return;
  }

  let nextRecords;

  if (!wasEditing) {
    const newRecord = {
      id: createRecordId(),
      title: title.trim(),
      minutes: Number(minutes),
      date: date,
      note: note.trim(),
      createdAt: new Date().toISOString()
    };

    nextRecords = [newRecord, ...studyRecords];
  } else {
    nextRecords = studyRecords.map(function (record) {
      if (record.id !== editingId) {
        return record;
      }

      return {
        ...record,
        title: title.trim(),
        minutes: Number(minutes),
        date: date,
        note: note.trim()
      };
    });
  }

  if (applyRecords(nextRecords)) {
    resetForm();

    // 編集前後で適切な完了メッセージを表示する
    statusMessage.textContent = wasEditing
      ? "学習記録を更新しました。"
      : "学習記録を追加しました。";
  }
});
JavaScript

実際には、同じイベントリスナーを二つ登録せず、後者のコードだけを使ってください。上の最初の例は、追加と更新の考え方を示すための説明です。

ステップ7:編集ボタンでフォームに値を入れる

「編集」ボタンを押したら、対象の記録をIDで探し、内容をフォームへ入れます。フォームのボタン表示も「更新する」に変えます。

// 編集ボタンが押されたとき、記録の内容をフォームへ読み込む
function startEditing(recordId) {
  const record = studyRecords.find(function (item) {
    return item.id === recordId;
  });

  // 対象が見つからない場合は編集を始めない
  if (!record) {
    statusMessage.textContent = "編集する記録が見つかりません。";
    return;
  }

  editingId = record.id;

  // 保存済みの値を各入力欄に設定する
  titleInput.value = record.title;
  minutesInput.value = String(record.minutes);
  dateInput.value = record.date;
  noteInput.value = record.note ?? "";

  // フォームを編集モードの表示に切り替える
  submitButton.textContent = "更新する";
  cancelEditButton.hidden = false;
  statusMessage.textContent = "記録を編集しています。";

  // 入力欄へ移動し、すぐに修正できるようにする
  titleInput.focus();
}
JavaScript

ステップ8:削除ボタンで記録を消す

削除では、対象のIDと一致しない記録だけで新しい配列を作ります。編集中の記録を削除した場合は、フォームも編集前の状態へ戻します。

// 指定したIDの記録を削除する
function deleteStudyRecord(recordId) {
  const record = studyRecords.find(function (item) {
    return item.id === recordId;
  });

  // 対象がない場合は何もしない
  if (!record) {
    statusMessage.textContent = "削除する記録が見つかりません。";
    return;
  }

  // 誤操作を防ぐため、削除前に確認する
  const shouldDelete = window.confirm(
    `「${record.title}」の記録を削除しますか?`
  );

  if (!shouldDelete) {
    return;
  }

  // 指定ID以外の記録だけを残す
  const nextRecords = studyRecords.filter(function (item) {
    return item.id !== recordId;
  });

  // 保存に成功した場合にだけ、画面へ反映する
  if (applyRecords(nextRecords)) {
    // 削除した記録を編集中だった場合は編集状態を解除する
    if (editingId === recordId) {
      resetForm();
    }

    statusMessage.textContent = "学習記録を削除しました。";
  }
}
JavaScript

ステップ9:一覧のボタン操作を受け取る

一覧の編集・削除ボタンに、それぞれ個別のイベントリスナーを付ける代わりに、一覧全体でクリックを受け取ります。これをイベント委譲といいます。JavaScriptが後から作ったボタンにも対応しやすい方法です。

// 一覧内の編集・削除ボタンのクリックをまとめて受け取る
studyList.addEventListener("click", function (event) {
  const button = event.target.closest("button[data-action]");

  // ボタン以外がクリックされた場合は終了する
  if (!button || !studyList.contains(button)) {
    return;
  }

  const recordId = button.dataset.id;
  const action = button.dataset.action;

  if (action === "edit") {
    startEditing(recordId);
  }

  if (action === "delete") {
    deleteStudyRecord(recordId);
  }
});
JavaScript

ステップ10:編集をキャンセルして初期状態に戻す

キャンセルボタンを押したら、入力欄を空にし、編集モードを解除します。

// フォームを追加モードの状態へ戻す
function resetForm() {
  studyForm.reset();

  // 編集対象のIDを消して、編集モードを解除する
  editingId = null;

  // ボタン表示を追加用に戻す
  submitButton.textContent = "記録する";

  // キャンセルボタンを隠す
  cancelEditButton.hidden = true;

  // 日付欄には今日の日付を設定する
  dateInput.value = getLocalDateString();
}

// キャンセルボタンを押したときの処理
cancelEditButton.addEventListener("click", function () {
  resetForm();
  statusMessage.textContent = "編集をキャンセルしました。";
});
JavaScript

ステップ11:IDを作る

crypto.randomUUID()が利用できる環境ではそれを使い、使えない場合は記録識別用の簡易的なIDを作ります。このIDは記録を区別するためのもので、認証情報や秘密のトークンとして使ってはいけません。

// 学習記録を区別するIDを作る
function createRecordId() {
  if (globalThis.crypto && typeof crypto.randomUUID === "function") {
    return crypto.randomUUID();
  }

  // この代替IDは学習アプリ内の識別用であり、秘密情報には使わない
  return `record-${Date.now()}-${Math.random().toString(16).slice(2)}`;
}
JavaScript

ステップ12:アプリ起動時に一覧を描画する

ページを開いたときに、保存済み記録を一覧へ表示します。日付欄にも今日の日付を設定します。

// アプリの初期表示を整える
dateInput.value = getLocalDateString();
renderStudyRecords();
JavaScript

CSSにボタン配置を追加する

Day 83のCSSに、ボタンの並び方と編集用ボタンのスタイルを追加します。

/* フォーム内の操作ボタンを横に並べる */
.form-actions {
  display: flex;
  flex-wrap: wrap;
  gap: 10px;
}

/* 編集やキャンセルに使う控えめなボタン */
.button-secondary {
  border: 1px solid #cbd5e1;
  background: #ffffff;
  color: #263449;
}

/* 記録ごとの編集・削除ボタンをまとめる */
.record-actions {
  display: flex;
  flex-wrap: wrap;
  gap: 8px;
}

CRUDの流れを確認する

完成したときのデータの流れを整理します。

  • Create:フォームの入力値を確認し、新しいオブジェクトを配列へ追加します。
  • Read:保存済みの配列を読み込み、一覧と合計時間を表示します。
  • Update:IDで対象を見つけ、編集した内容でその記録だけを置き換えます。
  • Delete:IDで対象を特定し、その記録を配列から取り除きます。

追加・編集・削除のたびに、配列を保存してから一覧を描画します。画面を直接部分的に書き換えるのではなく、配列をアプリのデータの基準として、配列から画面を作り直すと、表示と保存データの食い違いを減らせます。

よくある不具合と確認方法

  • 編集ボタンを押しても入力欄が変わらない場合は、ボタンの`data-id`と記録の`id`を確認します。
  • 更新した記録が別の記録に反映される場合は、配列の番号ではなくIDで照合しているか確認します。
  • 削除後に合計が変わらない場合は、削除後に`renderStudyRecords()`が呼び出されているか確認します。
  • 編集キャンセル後も「更新する」のままなら、`resetForm()`で編集状態とボタン表示の両方を戻しているか確認します。
  • 再読み込み後に変更が消える場合は、変更後の配列を`localStorage`へ保存しているか確認します。

記録の内容を表示するときは、innerHTMLへ入力値を直接入れず、例のようにtextContentを使います。利用者が入力した文章は、信頼できるHTMLとは限りません。

Day 86の確認項目

  • 新しい学習記録を追加できます。
  • 保存済みの記録一覧を表示できます。
  • 編集ボタンを押すと、記録の内容がフォームに入ります。
  • 更新後に、一覧と合計時間が正しく変わります。
  • 編集をキャンセルすると、追加モードに戻ります。
  • 削除前に確認が表示され、削除後に一覧と合計時間が更新されます。
  • ページを再読み込みしても、追加・編集・削除後の状態が保たれます。

まとめ

Day 86では、学習記録アプリに編集・削除を追加し、CRUDの基本を実装しました。追加、編集、削除は、対象をIDで特定し、変更後の配列を保存してから一覧を再描画する流れにすると整理しやすくなります。

編集では、追加と同じフォームを使い、editingIdで新規追加と更新を切り替えます。削除では誤操作を避ける確認を入れ、編集をキャンセルしたときにはフォームと編集状態の両方を戻します。最後に、追加・表示・編集・削除と再読み込み後の保存状態を一つずつ試し、CRUDが意図どおりに動くことを確認しましょう。

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