JavaScriptのきほん(18)「取得したデータを加工しよう(1)filterで絞り込む」

スポンサーリンク
JavaScript

前回までで、外部のデータを取得して表示し、通信の失敗にも備えられるようになった。
ところで、実務の一覧画面では、取得したデータをそのまま並べることは少ない。「未完了だけ見たい」「キーワードで探したい」「新しい順に並べたい」といった加工が、ほぼ必ず求められる。今回から3回に分けて、取得したデータの加工方法を扱う。初回は、配列から条件に合うものだけを取り出すfilterで、タスクの状態による絞り込みを作ってみよう。

filterとは

filter()は、配列の要素を1つずつ条件に照らし、trueになったものだけを集めた新しい配列を返すメソッドである。

const numbers = [1, 2, 3, 4, 5];
const evens = numbers.filter((n) => n % 2 === 0);

console.log(evens);   // [2, 4]
console.log(numbers); // [1, 2, 3, 4, 5](元の配列はそのまま)

filter()に渡している(n) => n % 2 === 0は、要素を1つ受け取ってtrueかfalseを返す関数である。このように、別の関数に渡して呼んでもらう関数を「コールバック関数」と呼ぶ。
ここで大切なのは、元の配列が変わらないことである。
ToDoリストを作ろう(2)で使ったsplice()は元の配列そのものを書き換えたが、filter()は書き換えない。

今回の作り方

取得したデータはallTodosという配列に保存しておく。絞り込みの選択を変えたときは、通信し直さず、保存したデータから画面を描き直すだけにする。通信の回数が減り、操作にもすぐ反応できる。

index.html(完成版)

前回のindex.htmlに、状態の選択欄を追加する。全体は次のとおりである

<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title>外部データを取得しよう</title>
</head>
<body>
  <h1>外部のToDoデータ</h1>
  <label>件数:
    <select id="limit-select">
      <option value="5">5件</option>
      <option value="10">10件</option>
      <option value="20">20件</option>
    </select>
  </label>
  <label>状態:
    <select id="status-select">
      <option value="all">すべて</option>
      <option value="done">完了</option>
      <option value="undone">未完了</option>
    </select>
  </label>
  <button id="reload-button">再読み込み</button>
  <p id="message"></p>
  <ul id="todo-list"></ul>
  <script src="script.js"></script>
</body>
</html>

script.js(完成版)

script.jsを、次の内容に置き換えよう。

const BASE_URL = 'https://jsonplaceholder.typicode.com/todos';
const list = document.getElementById('todo-list');
const message = document.getElementById('message');
const select = document.getElementById('limit-select');
const statusSelect = document.getElementById('status-select');
const button = document.getElementById('reload-button');

// 取得したデータを保存しておく配列(未取得・取得失敗時は null)
let allTodos = null;

// 保存したデータを絞り込んで、画面に表示する
function renderTodos() {
  // データがないとき(読み込み中・取得失敗)は何もしない
  if (allTodos === null) {
    return;
  }

  list.innerHTML = '';

  const status = statusSelect.value;
  const visibleTodos = allTodos.filter((todo) => {
    if (status === 'done') {
      return todo.completed;
    }
    if (status === 'undone') {
      return !todo.completed;
    }
    return true;
  });

  visibleTodos.forEach((todo) => {
    const li = document.createElement('li');
    li.textContent = (todo.completed ? '✅ ' : '⬜ ') + todo.title;
    list.appendChild(li);
  });

  if (visibleTodos.length === 0) {
    message.textContent = '該当するタスクはありません';
  } else {
    message.textContent = `${visibleTodos.length}件表示(全${allTodos.length}件)`;
  }
}

async function loadTodos() {
  allTodos = null;
  message.textContent = '読み込み中...';
  list.innerHTML = '';
  button.disabled = true;
  select.disabled = true;

  try {
    const response = await fetch(`${BASE_URL}?_limit=${select.value}`);
    if (!response.ok) {
      throw new Error(`HTTPエラー:${response.status}`);
    }
    allTodos = await response.json();
    renderTodos();
  } catch (error) {
    message.textContent = `取得に失敗した(${error.message})`;
  } finally {
    button.disabled = false;
    select.disabled = false;
  }
}

select.addEventListener('change', loadTodos);
statusSelect.addEventListener('change', renderTodos);
button.addEventListener('click', loadTodos);
loadTodos();

コードの解説

表示を担当するrenderTodos()を新しく作り、取得を担当するloadTodos()と役割を分けた。loadTodos()は取得したデータをallTodosに入れるだけで、表示はrenderTodos()に任せている。

renderTodos()では、選択中の状態に応じてfilter()で絞り込んでいる。コールバック関数の中で、「完了」ならtodo.completedがtrueのもの、「未完了」ならfalseのものを残し、「すべて」なら全部を残す。絞り込みの結果はvisibleTodosに入り、画面にはこれを表示している。元のallTodosは変わらないため、「すべて」に戻せば全件が表示される。

状態の選択欄はchangeイベントでrenderTodos()を呼んでいる。ここではfetchを使わないので、通信は発生しない。

該当するタスクが0件のときは、メッセージを表示している。何も出ないままだと、読み込みに失敗したのか、該当がないのかが分からないためである。
データの有無は、allTodosで区別している。取得を始めるときにnull(データなし)に戻し、成功したときだけ配列を入れる。renderTodos()は、nullのときは何もしない。そのため、取得に失敗したあとで状態の選択を変えても、エラーメッセージはそのまま残る。「取得に失敗した」状態と、「取得できたが該当が0件だった」状態(空の配列)を、混同しないための工夫である。

動作確認とまとめ

ブラウザで開き、状態の選択欄を切り替えてみよう。件数が5件のときは、完了が1件、未完了が4件と表示されるはずである。「すべて」に戻すと、全件が表示される。

今回のポイントは次のとおりである。

  • filter()は、条件に合う要素だけを集めた新しい配列を返す。
  • 元の配列は変わらないので、絞り込みを解除して元に戻せる。
  • 絞り込みは、保存したデータから描き直すだけで、通信は不要にできる。
  • 該当が0件のときの表示も、実務では忘れずに用意しておく。
  • 「取得に失敗した」状態と「該当が0件」の状態は、nullと空の配列で区別する。

次回は、map()でデータを画面用の要素に変換し、キーワード検索を加えて、絞り込みと組み合わせてみよう。

コメント

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