【第3回】Vue.js 入門 〜オプション編〜
2021.12.20
オプションを覚えよう！
宮田(株) ライトコード Webエンジニアの宮田です。
前回までで、Vue.jsの主要なディレクティブが扱えるようになりました！
今回はもう一つ、基本的な要素である 「オプション」 についてみていきたいと思います。
これまでも Vueインスタンス内に「el」や「data」「methods」 といったプロパティが出てきたと思います。
これこそが、Vue.js におけるオプションと呼ばれるものなんです！
前回の記事はこちら
オプションとは
Vueインスタンス内で使用する、オブジェクトで定義されたデータやメソッドのことを指します。
コンポーネントオプションとも呼ばれます。
準備
いつものように、「プロジェクトファイル」と「index.html ファイル」を用意します。
1 2 3 | $ mkdir vue-option $ cd vue-option $ touch index.html |
index.html の内容は、下記のように記述しておきます。
1 2 3 4 5 6 7 8 9 10 11 12 | <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>オプションの使い方</title> </head> <body> <script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.js"></script> <script> </script> </body> </html> |
まずは、お馴染みのオプションから、おさらいしながらいきましょう！
elオプション
elオプションは、 id名 または class名を指定することで Vueインスタンスを紐づける範囲の要素を指定できます。
ちなみに、el は「element」 の略です。
Vueインスタンス内に el: '#id名' または el: '.クラス名' のように記述します。
例) id名が "app" の場合： el: '#app'
1 | <div id="app"></div> |
1 2 3 | const app = new Vue({ el: '#app' }) |
これまでも、毎回必ず出てきたオプションですね。
上記の例なら、id名が app のdivエレメント内の範囲でのみ、Vue が作用を及ぼすということを定義しています。
注意点
class名でも指定できますが、下記のコードのように同一class名で要素が複数あるものに対して使用することはできません。
そのため、必ず一つしか存在しない class名を指定する必要があります。
1 2 3 4 5 6 | <div class="app"> <!-- ... --> </div> <div class="app"> <!-- ... --> </div> |
dataオプション
dataオプションには、Vueアプリケーション内で使用するデータを登録します。
こちらも、毎回お目にかかるオプションですね。
この dataに定義したプロパティの値が変更されると、Viewが再レンダリングされます。
使用例
「ようこそ、〇〇 △△ さん」とメッセージを表示するプログラムに、名前のデータを登録てみます。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | <body> <div id="app-1"> ようこそ、{{ name }} さん </div> <script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.js"></script> <script> const app1 = new Vue ({ el: '#app-1', data: { name: '山田 太郎' } }) </script> </body> |
確認
実行すると、dataに登録した名前が埋め込まれたテキストが表示されました。
methodsオプション
methodsオプションには、Vueアプリケーション内で使用する関数を定義することができます。
ここで定義した関数は、v-onディレクティブを使ってイベントリスナーを加えることで呼び出すことができます。
使用例
ボタンを押すごとにおみくじの結果が表示されるプログラムを作ってみます。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 | <body> <div id="app-2"> <h2>おみくじガチャ</h2> <p>{{ fortune }}！</p> <button @click="submit">引いてみる</button> </div> <script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.js"></script> <script> const app2 = new Vue ({ el: '#app-2', data: { items: ['大吉', '中吉', '小吉', '吉', '凶', '大凶'], fortune: 'ここに表示されるよ' }, methods: { submit: function() { const items = this.items let item = items[Math.floor(Math.random() * items.length)] this.fortune = item } } }) </script> </body> |
methods には、結果を抽選して fortuneプロパティの値を変更する処理を行う submit関数を定義しました。
v-onディレクティブのイベントリスナーで、ボタンを click したときに、submit関数を呼び出すようにしています。
確認
では、実際に動かしてみましょう！
↓
いい結果は出ましたか？
さて、ここまでは前回までに登場したオプションでした。
ここからは、まだ登場していなかったオプションです！
computedオプション（算出プロパティ）
computedオプション（算出プロパティ）は、dataの値を使って、それを関数で加工したデータを返すことができます。
プロパティですが、こちらも methods と同じように関数を使うことができます。
また computedオプションには、値に変更がない場合、キャッシュされたものがそのまま再利用されるという特徴があります。
そのため、処理が高速なことがメリットです。
使用例
フォームで入力した「あいさつ文」+「名前」+「敬称」の文字列を連結して一文を出力するプログラムを作ってみます。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 | <body> <div id="app-3"> <h2>あいさつメーカー</h2> <select v-model="greeting"> <option value="" disabled selected style="display:none">あいさつを選択</option> <option v-for="item in greetings" :value="item">{{ item }}</option> </select> <input type="text" v-model="name" placeholder="名前を入力" /> <select v-model="honorific"> <option value="" disabled selected style="display:none">敬称を選択</option> <option v-for="item in honorifics" :value="item">{{ item }}</option> </select> <p>出力 → {{ message }}</p> </div> <script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.js"></script> <script> const app3 = new Vue ({ el: '#app-3', data: { name : '', greeting: '', honorific: '', greetings: [ 'おはよう', 'こんにちは', 'こんばんは', 'おやすみ'], honorifics: ['さん', 'くん', 'ちゃん', '様', '殿'] }, computed: { message: function() { return this.greeting + ' ' + this.name + ' ' + this.honorific } } }) </script> </body> |
greetings 、 honorifics の配列にそれぞれ連結させる文字列を登録しておきました。
確認
実際に動かしてみましょう！
name 、 greeting 、 honorific のいずれかの値が書き換わったとき、連動して出力メッセージも変更されることが確認できると思います。
computed を使わず下記のように直接記述することもできますが、コードが肥大化しメンテナンス性が悪くなるため好ましくありません。
1 | <p>出力 → {{ greeting + ' ' + name + ' ' + honorific }}</p> |
複雑なロジックを用いた処理をしたい場合には {{ }} 内に処理は書かずに、computed を利用しましょう！
注意点
dataの値に変更が生じない限りキャッシュが再利用されるという特徴ですが、使用の際に注意しなければならないことがあります。
算出プロパティは、リアクティブな依存関係が更新されたときのみ再評価されます。
下記のコードの例は、return で返している値に data で定義しているプロパティが含まれていません。
この場合、値に変更が生じることがないため、再描画されても関数が実行されません。
ちなみに、methods の場合は再描画が起きると常に関数を実行するため、場面に応じて使い分ける必要があります。
1 2 3 4 5 | computed: { now: function () { return Date.now() } } |
watchオプション（監視プロパティ）
watchオプション（監視プロパティ）は、特定のプロパティの値の変更を監視し、変更時に設定した関数を実行することができます。
記法は data内のプロパティ名をキーに指定し、下記のように記述します。
1 2 3 4 5 | watch: { プロパティ名: function(変更後の値, 変更前の値) { // 処理 } } |
データが変わるのに応じて、非同期処理やコストの高い処理を実行したいときに最も便利です。
使用例
テキストボックスに入力した値を変更するたびに、前の値と次の値をアラートで表示するプログラムを作ってみます。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 | <body> <div id="app-4"> <p>最新テキスト: {{ text }}</p> <input type="text" :value="text" @keyup.enter="text = $event.target.value" /> </div> <script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.js"></script> <script> const app4 = new Vue ({ el: '#app-4', data: { text: '', }, watch: { text: function(nextText, prevText) { let prev = prevText let next = nextText if(!prev) prev = '(未入力)' if(!next) next = '(未入力)' alert('値が変更されました 前: ' + prev + ' → 次: ' + next) } } }) </script> </body> |
テキストボックスに入力し、 Enterキーを押したタイミング（ @keyup.enter）で値が変更されるように <input>内を下記のように記述します。
1 | <input type="text" :value="text" @keyup.enter="text = $event.target.value" /> |
そして、watchオプションの中身を記述していきます。
今回は、data で保持している text の値を監視したいので、watchのオブジェクトのキーを text とします。
これで、text の値に変更があった場合のみ関数が実行されます。
また watch で定義する関数の引数には、第一引数に変更後の値、第二引数に変更前の値を渡すことができます！
そのため、アラートに変更前後それぞれの値を表示してみます。
初期値など値が空文字の場合は、わかりやすいように (未入力) と表示させます。
1 2 3 4 5 6 7 8 9 10 11 12 | data: { text: '', }, watch: { text: function(nextText, prevText) { let prev = prevText let next = nextText if(!prev) prev = '(未入力)' if(!next) next = '(未入力)' alert('値が変更されました 前: ' + prev + ' → 次: ' + next) } } |
確認
試しにテキストを入力して実行してみましょう！
Enterキーを押した瞬間、このようにアラートが表示されましたね！
OK を押すと最新テキストの表示も、先ほど入力したテキストが表示されたと思います。
もう一度、別のテキストを入力してEnterキーを押してアラートを確認すると、変更前後の値がしっかり表示されていますね。
同じテキストを入力した場合は、変更が発生しないため関数も実行されずアラートも表示されません。
このように、特定のプロパティの値の変更時に実行したい処理がある場合や、変更前の値も使いたい場合などに便利です。
第4回につづく！
今回は、主要なオプションのうち、5種類をみてきました。
ですが、実はまだ他にも大きく分けて2つの系統の主要オプションがあります。
まず1つ目は、「props」「template」などの「コンポーネント」に関連するオプションです。
こちらについては、コンポーネントについての回で詳しくみていきたいと思っています。
そして2つ目が、「created」「mounted」などの「ライフサイクルフック」と呼ばれる特殊なオプションです。
次回は、この2つ目に深く関わる Vue の「ライフサイクル」と、「ライフサイクルフック」についてみていきたいと思います！
次回の記事はこちら
こちらの記事もオススメ！
書いた人はこんな人
- 「好きを仕事にするエンジニア集団」の（株）ライトコードです！
ライトコードは、福岡、東京、大阪の3拠点で事業展開するIT企業です。
現在は、国内を代表する大手IT企業を取引先にもち、ITシステムの受託事業が中心。
いずれも直取引で、月間PV数1億を超えるWebサービスのシステム開発・運営、インフラの構築・運用に携わっています。
システム開発依頼・お見積もり大歓迎！
また、現在「WEBエンジニア」「モバイルエンジニア」「営業」「WEBデザイナー」「WEBディレクター」を積極採用中です！
インターンや新卒採用も行っております。
以下よりご応募をお待ちしております！
https://rightcode.co.jp/recruit
ITエンタメ10月 13, 2023Netflixの成功はレコメンドエンジン？- ライトコードの日常8月 30, 2023退職者の最終出社日に密着してみた！
- ITエンタメ8月 3, 2023世界初の量産型ポータブルコンピュータを開発したのに倒産!?アダム・オズボーン
- ITエンタメ7月 14, 2023【クリス・ワンストラス】GitHubが出来るまでとソフトウェアの未来
関連記事
採用情報
\ あの有名サービスに参画!? /
バックエンドエンジニア
\ クリエイティブの最前線 /
フロントエンドエンジニア
\ 世界を変える…！ /
Androidエンジニア
\ みんなが使うアプリを創る /
iOSエンジニア
