Plusプラン限定レッスン

リストレンダリングについて学習しよう

ウェブサイトには、「ナビゲーションのメニュー」や「記事一覧」といったリスト形式で表示する画面UIが存在します。ulタグとliタグを使ってHTMLコーディングをしている方も多いでしょう。リスト形式は要素を繰り返すことが多いのですが、Vueには繰り返しを効率良く記述するための構文があります。今回はv-forディレクティブの使い方を説明します。

本レッスンでは以下の内容を学習します。

  • v-forの書き方
  • keyについて

v-forの書き方

たとえばAppコンポーネントが以下のようなitemsデータを持っているとします。itemsデータでは配列であり、4つの果物の種類が格納されています。

▼App.vue

<script>
export default {
  name: "App",
  data() {
    return {
      items: ["apple", "orange", "lemon", "banana"],
    };
  },
};
</script>

配列データを描画するときは、Vueのテンプレート側に以下のように記述します。v-forディレクティブにitem in itemsと記述します。右辺の◯◯ in □□の記法について、□□には配列を指定、◯◯は配列内の要素を変数として定義します。

<template>
  <div id="app">
    <ul>
      <li v-for="item in items" v-bind:key="item">{{ item }}</li>
    </ul>
  </div>
</template>

※v-forを記述する際、あわせてkeyを設定する必要があります。注意点としてkeyには不変で重複しない値をbindする必要があります。

上記のコードを実行すると、ブラウザには要素がliタグで列挙されます。以下はレンダリング結果(一部省略)を示したものです。

<div id="app">
  <ul>
    <li>apple</li>
    <li>orange</li>
    <li>lemon</li>
    <li>banana</li>
  </ul>
</div>

また、v-forディレクティブは配列のインデックス(順番)を受け取ることもできます(下記のコードを参照ください)。v-for="(item, index) in items"と記載しており、indexが配列のインデックスを示します。配列の1番目の要素ではindexは「0」となり、2番目は「1」となります(配列は0からカウントする)。

このインデックスをv-bind:keyに割り当てることも一応できます。

<template>
  <div id="app">
    <ul>
      <li v-for="(item, index) in items" v-bind:key="item">{{ index }}:{{ item }}</li>
    </ul>
  </div>
</template>

▼レンダリング結果

<ul>
  <li>1:apple</li>
  <li>2:orange</li>
  <li>3:lemon</li>
  <li>4:banana</li>
</ul>

※ただ、インデックスをkeyにするのは望ましくないとされています。keyは配列内のアイテムと一対一で対応するものですが、インデックスは配列の変更(削除や並び替え)によって対応付けが変わってしまうからです。

この続きはPlusプラン限定です