インストール
ディレクトリ
- ##NPM
- コマンド ライン ツール
- さまざまなビルドの説明
- #用語
- ##ランタイムコンパイラとランタイムのみ
- Bower AMD モジュール ローダー
Vue は
IE8 をサポートしていません。以下は、Vue が IE8 ではエミュレートできない ECMAScript 5 機能を使用しているためです。ただし、すべての ECMAScript 5 互換ブラウザ
すべてを参照バージョン更新ログについては
GitHub
Vue Devtools
Vue を使用する場合は、Vue Devtools をインストールすることをお勧めします
それについて。よりユーザーフレンドリーなインターフェイスで Vue アプリケーションをレビューおよびデバッグできるようになります。
##<script># を導入します##直接ダウンロードして、
<script>
タグでインポートすると、
がグローバル変数として登録されます。
開発環境では圧縮バージョンを使用しないでください。そうしないと、一般的なエラーに関するすべての警告が失われます!
開発バージョン
完全な警告モードとデバッグ モードが含まれています
製品バージョン警告を削除、最小 gzip 33.30KB
#CDN
プロトタイピングまたは学習の場合は、次のように最新バージョンを使用できます: <script src="https://cdn.jsdelivr.net/npm/vue"></script>
運用環境の場合は、新しいバージョンが発生することを避けるために、明示的なバージョン番号とビルド ファイルにリンクすることをお勧めします。 : <script src="https://cdn.jsdelivr.net/npm/vue@2.6.10/dist/vue.js"></script>
ネイティブ ES モジュールを使用する場合は、ES モジュールと互換性のあるビルド ファイルもあります: <script type="module">
import Vue from 'https://cdn.jsdelivr.net/npm/vue@2.6.10/dist/vue.esm.browser.js'
</script>
これは cdn.jsdelivr.net/npm/vue でダウンロードできます。 NPM パッケージのソース コードを参照します。
Vue は unpkg や cdnjs でも入手できます (cdnjs のバージョン更新は若干遅れている可能性があります)。
さまざまなビルド バージョン を理解し、公開するサイトでは 実稼働環境バージョン を使用してください。vue.js を # に置き換えてください。 # #vue.min.js。これは、開発環境よりもはるかに高速なエクスペリエンスを可能にする小規模なビルドです。
#NPM
##Vue を使用して大規模なアプリケーションを構築する場合は、NPM インストールを使用することをお勧めします[1]
。 NPM は、webpack や Browserify などのモジュール バンドラーとうまく連携します。同時に、Vue は 単一ファイル コンポーネント を開発するためのサポート ツールも提供します。
# 最新稳定版
$ npm install vue
コマンド ライン ツール (CLI)
Vue は 公式 CLI では、シングル ページ アプリケーション (SPA) の複雑なスキャフォールディングを迅速に構築します。最新のフロントエンド ワークフロー向けに、バッテリーを含むビルド設定を提供します。起動して実行するには数分しかかかりません。また、ホット リロード、保存時の lint チェック、運用準備が整ったビルドが付属しています。詳細については、
Vue CLI
のドキュメントを参照してください。 CLI ツールは、ユーザーが Node.js および関連するビルド ツールについて一定レベルの理解を持っていることを前提としています。 Vue を初めて使用する場合は、まずビルド ツールを使用せずに ガイド を読み、次に CLI を使用する前に Vue 自体に慣れることを強くお勧めします。
##さまざまなビルド バージョンの説明
NPM では、次のことを行います。パッケージの dist/ ディレクトリでさまざまな Vue.js ビルドを見つけてください。それらの違いは次のとおりです。
CommonJSES モジュール (ベース)ビルド ツール)ES モジュール (ブラウザで直接使用)フル バージョンvue.common.jsvue.esm.jsvue.esm.browser.jsランタイム バージョンのみが含まれますvue.runtime.common.jsvue.runtime.esm.js-#フルバージョン (本番環境)ランタイム バージョン (運用環境) のみが含まれます##UMD
vue.js vue.runtime.js vue.min.js- - vue.esm.browser.min.js vue.runtime.min.js- - -
#用語
- ##フルバージョン
: コンパイラとランタイムバージョン。
- コンパイラ
: テンプレート文字列を JavaScript レンダリング関数にコンパイルするために使用されるコード。
- ランタイム
: Vue インスタンスの作成、仮想 DOM のレンダリングと処理などに使用されるコード。基本的にはコンパイラ以外のすべてです。
UMD: UMD バージョンは、<script> タグを使用してブラウザで直接使用できます。 jsDelivr CDN の https://cdn.jsdelivr.net/npm/vue
のデフォルト ファイルは、UMD バージョンのランタイム コンパイラー (vue.js) です。
CommonJS: CommonJS バージョンは、Browserify や webpack 1# などの古いパッケージ化ツールで使用されます。 ##。これらのパッケージ化ツールのデフォルト ファイル (pkg.main) は、ランタイム (vue.runtime.common.js) のみを含む CommonJS バージョンです。
- ES モジュール
#: 2.6 以降、Vue は 2 つの ES モジュール (ESM) ビルド ファイルを提供します:
バンドル ツール用の ESM: webpack 2- や
Rollup などの最新のバンドル ツール用に提供されます。 ESM 形式は静的に分析されるように設計されているため、パッケージ化ツールはこれを利用して「ツリーシェイキング」を実行し、最終パッケージから未使用のコードを除外できます。これらのパッケージ化ツールで提供されるデフォルトのファイル (pkg.module) は、ランタイム専用の ES モジュール ビルド (vue.runtime.esm.js) です。
ブラウザ用 ESM (2.6): <script type="module">-
経由で最新のブラウザに直接インポート
ランタイム コンパイラーとランタイムのみ #テンプレートをコンパイルする必要がある場合クライアント側 (文字列を template
オプションに渡す、または要素にマウントして DOM 内の HTML をテンプレートとして使用するなど) では、コンパイラに On を追加する必要があります。 、フルバージョン: // 需要编译器
new Vue({
template: '<div>{{ hi }}</div>'
})
// 不需要编译器
new Vue({
render (h) {
return h('div', this.hi)
}
})
vue-loader または vueify を使用すると、
*.vue ファイル内のテンプレートがプリコンパイルされます。ビルド時の JavaScript。実際には最終パッケージにはコンパイラは必要ないので、ランタイム バージョンを使用してください。
ランタイム バージョンは完全バージョンよりも約 30% 小さいため、可能な限りこのバージョンを使用する必要があります。それでも完全バージョンを使用したい場合は、パッケージ化ツールでエイリアスを設定する必要があります:
webpack
module.exports = { // ...
resolve: { alias: { 'vue$': 'vue/dist/vue.esm.js' // 用 webpack 1 时需用 'vue/dist/vue.common.js'
}
}
}
Rollup
const alias = require('rollup-plugin-alias')
rollup({ // ...
plugins: [
alias({ 'vue': require.resolve('vue/dist/vue.esm.js')
})
]
})
Browserify
プロジェクトの package.json
に追加します:
{ // ...
"browser": { "vue": "vue/dist/vue.common.js"
}
}
Parcel
プロジェクトの package.json
を追加します:
{ // ...
"alias": { "vue" : "./node_modules/vue/dist/vue.common.js"
}
}
##開発環境モードと運用環境モード #UMD バージョンの場合、開発環境/本番環境モードはハードコーディングされています。開発環境では非圧縮コードを使用し、本番環境では圧縮コードを使用します。
CommonJS および ES モジュールのバージョンはパッケージ化ツール用であるため、縮小バージョンは提供していません。最終パッケージは自分で圧縮する必要があります。 CommonJS および ES モジュールのバージョンでは、どのモードで実行するかを決定するための元の process.env.NODE_ENV
インストルメンテーションも保持されます。 Vue が実行されるモードを制御するには、これらの環境変数を適切なパッケージ化ツール設定に置き換える必要があります。 process.env.NODE_ENV を文字列リテラルに置き換えると、UglifyJS などの圧縮ツールが開発環境のみのコード ブロックを完全に破棄して、最終的なファイル サイズを削減することもできます。
webpack
webpack 4 では、mode
オプションを使用できます: module.exports = {
mode: 'production'
}
ただし、webpack 3 以降では、それより前のバージョンでは、
DefinePlugin:var webpack = require('webpack')
module.exports = {
// ...
plugins: [
// ...
new webpack.DefinePlugin({
'process.env': {
NODE_ENV: JSON.stringify('production')
}
})
]
}
RollupUse rollup-plugin-replace
:## を使用する必要があります。 #const replace = require('rollup-plugin-replace')
rollup({
// ...
plugins: [
replace({
'process.env.NODE_ENV': JSON.stringify('production')
})
]
}).then(...)
グローバル envify 変換をパッケージに適用します。
NODE_ENV=production browserify -g envify -e main.js | uglifyjs -c -m > build.js
実稼働環境のデプロイメントに移動することもできます。
CSP 環境
Google Chrome アプリなどの一部の環境では、コンテンツの適用が強制されます。セキュリティ ポリシー (CSP)、new Function() を使用して式を評価できません。この場合、CSP 互換バージョンを使用できます。フルバージョンはこの機能に依存してテンプレートをコンパイルするため、これらの環境では使用できません。
一方、ランタイム バージョンは CSP と完全に互換性があります。 webpack vue-loader
または
Browserify vueify を介してビルドすると、テンプレートは CSP 環境で完全に実行できる render 関数にプリコンパイルされます。
開発バージョン
重要: GitHub リポジトリの /dist
フォルダーは、新しいバージョンで利用可能です。バージョンがリリースされたときに提出されます。 GitHub にある Vue の最新のソース コードを使用したい場合は、自分でビルドする必要があります。
git clone https://github.com/vuejs/vue.git node_modules/vue
cd node_modules/vue
npm install
npm run build
Bower
Bower は UMD バージョンでのみ利用可能です。
# 最新稳定版本
$ bower install vue
AMD モジュール ローダー
すべての UMD バージョンを直接使用できますAMDモジュールとして。
翻訳者注記
[1] 中国本土のユーザーの場合、NPM ソースを に設定することをお勧めします。国産ミラー を使用すると、取り付け速度が大幅に向上します。