以下、バージョンの混在に注意。

目次

Vue.js の読み込み

CDNを利用する場合

CDNを利用する場合はインストールは不要。
※ただし後述する 単一ファイルコンポーネント等は使用できない。

<!-- 開発用 -->
<script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.js"></script>

<!-- 開発用(バージョン指定)
<script src="https://cdn.jsdelivr.net/npm/vue@2.5.22/dist/vue.js"></script>

<!-- 本番用 -->
<script src="https://cdn.jsdelivr.net/npm/vue"></script>

<!-- 本番用(バージョン指定) -->
<script src="https://cdn.jsdelivr.net/npm/vue@2.5.22/dist/vue.min.js"></script>

vue-cli を使用する場合

npm i -g npm to update
npm install -g @vue/cli

ソースコード

Vue DevToolのインストール

vue-cli の基本

vue-cli を使用してプロジェクトの作成やローカル起動、ビルド等を行う事ができる。

vue-cli のインストール

npm i -g npm to update
npm install -g @vue/cli

プロジェクトの作成

vue create sample-project

ローカル起動

cd sample-project
npm run serve

http://localhost:8080/ で確認

ビルド

npm run build

※ dist 以下に出力される
※ 参考: https://jp.vuejs.org/v2/guide/deployment.html

基本的な使い方

Vueインスタンスを生成する事により、画面にデータを描画する事ができる。
また、Vueインスタンスを介して描画内容を変更する事も可能。

Vueインスタンスの生成

以下の通りVueインスタンスを生成して画面描画等を行う。

var vm = Vue({
    .
    .
})

指定できるオプション

オプション内容
dataUIの状態/データ
elVueインスタンスをマウントする要素
filtersデータの整形に使用する
methodsイベント発生時等の処理を関数として定義する
computedデータから派生して算出される値を関数として定義する

elプロパティを使用してマウントする場合

<div id="app">
  {{ message }}
</div>

<script>
var app = new Vue({
  el: '#app',
  data: {
    message: 'Hello Vue!'
  }
})

// 2秒後にメッセージを書き換える
setTimeout(function(){
    app.message = 'Change message!'
}, 2000);
</script>

$mountメソッドによるマウント

後から動的に読み込んだコンテンツをマウントする場合等は、$mount メソッドを利用する。

<div id="app"></div>

<script>
var vm = new Vue({
    template: '<p>{{message}}</p>',
    data: {
        message : 'Message!'
    }
})
vm.$mount('#app')
</script>

filters プロパティによるデータの装飾

filters プロパティを使用する事でローカルなフィルタを定義する事ができる
https://jp.vuejs.org/v2/guide/filters.html

<div id="app">
{{ message | toUpper }}
</div>

<script>
var vue = new Vue({
    el: '#app',
    data: {
        message: 'Hello World!'
    },
    filters: {
        toUpper : function(text){
            return text.toUpperCase()
        }
    }
})
</script>

グローバルなフィルタを定義したい場合は、Vue.filter() を使用する

<div id="app">
{{ message | toUpper }}
</div>

<script>
Vue.filter('toUpper', function(text) {
  return text.toUpperCase()
})
var vue = new Vue({
    el: '#app',
    data: {
        message: 'Hello World!'
    }
})

computed プロパティによるデータの装飾

computed プロパティ使用すると加工済みデータの描画等を行う事が出来る。
filters プロパティと違い、対象データはVueインスタンスから得る。
https://jp.vuejs.org/v2/guide/computed.html

<div id="app">
    <p>Message       : {{ message }}</p>
    <p>Upper message : {{ upperMessage }}</p>
</div>

<script>
var vue = new Vue({
    el: '#app',
    data: {
        message: 'Hello World!'
    },
    computed: {
        upperMessage: function(value){
            return this.message.toUpperCase();
        }
    }
})
</script>

$watchメソッドによる状態の監視

Vue.js のリアクティブシステムによる検知/要素の更新の他に、$watchメソッドによる状態の監視を行う事もできる。

<div id="app">
    <input type="text" v-model="message" />
</div>

<script>
var app = new Vue({
  el: '#app',
  data: {
    message: 'Hello Vue!',
    watch_message: ''
  }
})

// メッセージが変わったらコンソールにログ出力
app.$watch(function(){
    return this.message;
}, function(){
    console.log('changed!');
});

// 2秒後にメッセージを変更
setTimeout(function(){
    app.message = 'Change message!'
}, 2000);

</script>

コンポーネント

コンポーネントの基本

コンポーネントを利用する事で画面を部分的に部品化して再利用する事ができる。
参考: https://jp.vuejs.org/v2/guide/components.html

例) クリックカウンターボタンをコンポーネント化して再利用する

<!doctype html>
<html lang="ja">
<head>
<meta charset="utf-8">
<script src="https://cdn.jsdelivr.net/npm/vue@2.5.22/dist/vue.js"></script>
</head>
<body>

<div id="components-demo">
  <button-counter></button-counter>
  <button-counter></button-counter>
</div>

<script>
Vue.component('button-counter', {
  data: function () {
    return {
      count: 0
    }
  },
  template: '<button v-on:click='count++'>click count is {{ count }}.</button>'
})
new Vue({ el: '#components-demo' })
</script>

</body>
</html>

コンポーネントの定義

TODO:

コンポーネントの状態をキャッシュする

TODO: keep-alive

コンポーネント間の通信

TODO:

コンポーネントへのデータの受渡し

TODO: props

単一ファイルコンポーネント

画面や部品単位でvueファイル化する事によってコンポーネント化する事ができる。
※以下、ドキュメントまま。

関連: Vue.jsでコンポーネント化された画面を切り替える

<template>
  <p>{{ greeting }} World!</p>
</template>

<script>
module.exports = {
  data: function () {
    return {
      greeting: 'Hello'
    }
  }
}
</script>

<style scoped>
p {
  font-size: 2em;
  text-align: center;
}
</style>

ディレクティブ

v-on ディレクティブによるイベントハンドリング

https://jp.vuejs.org/v2/guide/events.html

  • メソッドイベントハンドラ
    TODO:
  • イベント修飾子
    TODO:
    .stop
    .prevent
    .capture
    .self
    .once
    .passive

v-if ディレクティブによる条件付きレンダリング

v-if ディレクティブを使用して条件付きレンダリングを行う事ができる。

https://jp.vuejs.org/v2/guide/conditional.html

<div id="app">
  <span v-if="display">Message1!</span>
  <span v-else>Message2!</span>
</div>

<script>
var app = new Vue({
  el: '#app',
  data: {
    display: true
  }
})

// 2秒後に表示を切り替える
setTimeout(function(){
    app.display = false
}, 2000);
</script>

他に v-else-if や v-else も使用可能。
https://jp.vuejs.org/v2/guide/conditional.html#v-else
https://jp.vuejs.org/v2/guide/conditional.html#v-else-if

v-bind ディレクティブによるプロパティのバインド

TODO:

v-once で1回だけ描画する

TODO:

v-text ディレクティブによるテキストの描画

TODO:

v-html ディレクティブによるHTMLの描画

TODO:

v-model ディレクティブによる双方向データバインディング

TODO:

データ通信

axios を使ってデータ通信を行う簡単なサンプル。

npm インストール

npm install --save-dev axios

利用例

import Vue from 'vue';
import axios from 'axios';
export default {
  name: 'Page1',
  mounted: function(){
    axios
      .get('/path_to/sample.json')
      .then(response => {
        console.log(response)
      })
  },
}

ミックスイン

https://jp.vuejs.org/v2/guide/mixins.html

以下、ミックスインを使用して共通関数を定義する例を記載する。

src/components/MyMixin.js

import axios from 'axios';

export default {
  name: 'MyMixin',
  data: function(){
    return {
      CONTEXT_ROOT: "/"
    }
  },
  methods: {
    getData: function(url, option, callback){
      console.log("get request: "+ this.CONTEXT_ROOT + url);
      axios
        .get(this.CONTEXT_ROOT + url, option)
        .then(response => {
          console.log(response);
          callback(response)
      })
    }
  }
}

src/components/Page1.vue

<template>
  <div class="main">
    <h1>Page1 content</h1>
    <div>{{ results }}</div>
  </div>
</template>

<script>
import myMixin from '../components/MyMixin.js';

export default {
  mixins: [myMixin],
  name: 'Page1',
  data: function(){
    return {
      results: "データを読み込んでいます.."
    }
  },
  mounted: function(){
    this.getData(
      'sample.json',
      null,
      response => {
        this.results = response.data
      }
    );
  }
}
</script>

トランジション

TODO:

Vue Router を利用したSPA

Vue CLI を使用してプロジェクトの作成を行う場合は、マニュアルモードで作成する。(以下 Vue CLI v3.11.0 にて作成する例)

プロジェクトの作成

vue create sample-vue-router

# 今回は手動インストールで以下の通り選択した。
? Please pick a preset: Manually select features
? Check the features needed for your project: Babel, Router, Linter
? Use history mode for router? (Requires proper server setup for index fallback in production) No     ※1
? Pick a linter / formatter config: Basic
? Pick additional lint features: (Press  to select,  to toggle all,  to invert selection)Lint on save
? Where do you prefer placing config for Babel, PostCSS, ESLint, etc.? In dedicated config files
? Save this as a preset for future projects? (y/N) n

※1 ... historyモードの場合は、URLはロケーションハッシュで表現しない。
   (Hisory API を使用してページのリロードなしに完全なURLとして表現される)

画面等の作成/変更

src/main.js

import Vue from 'vue'
import App from './App.vue'
import router from './router'

Vue.config.productionTip = false

new Vue({
  router,
  render: h => h(App)
}).$mount('#app')

src/App.vue

<template>
  <div id="app">
    <div id="nav">
      <router-link to="/">Home</router-link> |
      <router-link to="/page1">Page1</router-link> |
      <router-link to="/page2">Page2</router-link> |
    </div>
    <div id="main">
      <router-view/>
    </div>
  </div>
</template>

<style>
#app {
  font-family: 'Avenir', Helvetica, Arial, sans-serif;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  text-align: center;
  color: #2c3e50;
}
#nav {
  padding: 30px;
}

#nav a {
  font-weight: bold;
  color: #2c3e50;
}

#nav a.router-link-exact-active {
  color: #42b983;
}
</style>

src/router.js

import Vue from 'vue'
import Router from 'vue-router'

Vue.use(Router)

export default new Router({
  routes: [
    { path: '/'     , name: 'home' , component: () => import('./views/Home.vue')  },
    { path: '/page1', name: 'page1', component: () => import('./views/Page1.vue') },
    { path: '/page2', name: 'page2', component: () => import('./views/Page2.vue') },
  ]
})

src/views/Home.vue

<template>
  <h1>Home View</h1>
</template>

<script>
export default {
  name: 'home',
  components: {}
}
</script>

src/views/Page1.vue

<template>
  <h1>Page1</h1>
</template>

<script>
export default {
  name: 'page1',
  components: {}
}
</script>

src/views/Page2.vue

<template>
  <h1>Page1</h1>
</template>

<script>
export default {
  name: 'page2',
  components: {}
}
</script>

トップ   差分 バックアップ リロード   一覧 単語検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2019-02-04 (月) 14:43:08 (1902d)