本文作者 Jinkey（微信公眾號(hào) jinkey-love，官網(wǎng) https://jinkey.ai）
原文鏈接 https://jinkey.ai/post/tech/vue2.0-xin-shou-wan-quan-tian-keng-gong-lue-cong-huan-jing-da-jian-dao-fa-bu
文章允許非篡改署名轉(zhuǎn)載，刪除或修改本段版權(quán)信息轉(zhuǎn)載的，視為侵犯知識(shí)產(chǎn)權(quán)，我們保留追求您法律責(zé)任的權(quán)利，特此聲明！
感謝 showonne、yubang 技術(shù)指導(dǎo)
Demo 地址:
http://demo.jinkey.io/vue2
源碼:
https://github.com/Jinkeycode/vue2-example
什么是 Vue
Vue 是一個(gè)前端框架，特點(diǎn)是
數(shù)據(jù)綁定
比如你改變一個(gè)輸入框 Input 標(biāo)簽的值，會(huì)自動(dòng)同步更新到頁(yè)面上其他綁定該輸入框的組件的值
數(shù)據(jù)綁定
組件化
頁(yè)面上小到一個(gè)按鈕都可以是一個(gè)單獨(dú)的文件.vue，這些小組件直接可以像樂(lè)高積木一樣通過(guò)互相引用而組裝起來(lái)
Vue2.0 推薦開發(fā)環(huán)境
Homebrew 1.0.6(Mac)、Node.js 6.7.0、npm 3.10.3、webpack 1.13.2、vue-cli 2.4.0、Atom 1.10.2
安裝環(huán)境
打開終端運(yùn)行以下命令
安裝brew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
安裝 nodejs
brew install nodejs
用 npm install npm@3.10.3 更新 npm 版本報(bào)錯(cuò):
(node:42) fs: re-evaluating native module sources is not supported.
解決辦法:
在官網(wǎng)下載6.70的安裝包再安裝一次(剛剛相當(dāng)于幫你配置好環(huán)境變量，現(xiàn)在再安裝一次升級(jí)到最新的 npm)
- 好像以前官網(wǎng)的安裝包不會(huì)自動(dòng)配置環(huán)境變量的，由于我電腦上之前安裝過(guò) nodejs 所以環(huán)境變量已經(jīng)配置好了，不知道現(xiàn)在的安裝包會(huì)不會(huì)自動(dòng)配置環(huán)境變量。
Windows 下直接下載安裝包即可
獲取nodejs模塊安裝目錄訪問(wèn)權(quán)限
sudo chmod -R 777 /usr/local/lib/node_modules/
安裝淘寶鏡像
npm install -g cnpm --registry=https://registry.npm.taobao.org
安裝webpack
cnpm install webpack -g
安裝vue腳手架
npm install vue-cli -g
在硬盤上找一個(gè)文件夾放工程用的，在終端中進(jìn)入該目錄
Mac
cd 目錄路徑
根據(jù)模板創(chuàng)建項(xiàng)目
vue init webpack-simple 工程名字<工程名字不能用中文>
或者創(chuàng)建 vue1.0 的項(xiàng)目
vue init webpack-simple#1.0 工程名字<工程名字不能用中文>
會(huì)有一些初始化的設(shè)置，如下輸入:
Target directory exists. Continue? (Y/n)直接回車默認(rèn)(然后會(huì)下載 vue2.0模板，這里可能需要連代理)
Project name (vue-test)直接回車默認(rèn)
Project description (A Vue.js project) 直接回車默認(rèn)
Author 寫你自己的名字
cd 命令進(jìn)入創(chuàng)建的工程目錄
工程目錄如圖所示:
安裝項(xiàng)目依賴
一定要從官方倉(cāng)庫(kù)安裝，npm 服務(wù)器在國(guó)外所以這一步安裝速度會(huì)很慢。
npm install
不要從國(guó)內(nèi)鏡像cnpm安裝(會(huì)導(dǎo)致后面缺了很多依賴庫(kù))
cnpm install
安裝 vue 路由模塊vue-router和網(wǎng)絡(luò)請(qǐng)求模塊vue-resource
cnpm install vue-router vue-resource --save
啟動(dòng)項(xiàng)目
npm run dev
填坑(以下坑可能由于 vue2.0 導(dǎo)致其他相關(guān)編譯打包工具沒更新導(dǎo)致的)
【重點(diǎn)】后來(lái)發(fā)現(xiàn)這些坑是由于 npm 不是最新的版本3.10.2， 用 npm 3.9.5就會(huì)出現(xiàn)以下坑
解決辦法: 請(qǐng)運(yùn)行以下命令
npm update -g
報(bào)錯(cuò)
Error: Cannot find module 'opn'
Error: Cannot find module 'webpack-dev-middleware'
Error: Cannot find module 'express'
Error: Cannot find module 'compression'
Error: Cannot find module 'sockjs'
Error: Cannot find module 'spdy'
Error: Cannot find module 'http-proxy-middleware'
Error: Cannot find module 'serve-index'
如果你用的是老版本的 vue-cli 還可能報(bào)其他錯(cuò)誤，需要更新一下 vue-cli
npm update vue-cli
然后可以查看一下當(dāng)前全局 vue-cli 的版本
npm view vue-cli
安裝一下這個(gè)依賴到工程開發(fā)環(huán)境
cnpm install opn --save-dev
cnpm install webpack-dev-middleware --save-dev
cnpm install express --save-dev
cnpm install compression --save-dev
cnpm install sockjs --save-dev
cnpm install spdy --save-dev
cnpm install http-proxy-middleware --save-dev
cnpm install serve-index --save-dev
cnpm install connect-history-api-fallback --save-dev
再啟動(dòng)項(xiàng)目，報(bào)錯(cuò)
ERROR in ./src/main.js
Module build failed: Error: Cannot find module 'babel-runtime/helpers/typeof'
at Function.Module._resolveFilename (module.js:440:15)
at Function.Module._load (module.js:388:25)
at Module.require (module.js:468:17)
at require (internal/module.js:20:19)
at Object.<anonymous> (/Volumes/MacStorage/Coding/Web/vue-test/node_modules/.6.17.0@babel-core/lib/transformation/file/index.js:6:16)
at Module._compile (module.js:541:32)
at Object.Module._extensions..js (module.js:550:10)
at Module.load (module.js:458:32)
at tryModuleLoad (module.js:417:12)
at Function.Module._load (module.js:409:3)
@ multi main
ERROR in ./~/.2.1.0-beta.8@webpack-dev-server/client/socket.js
Module not found: Error: Can't resolve 'sockjs-client' in '/Volumes/MacStorage/Coding/Web/vue-test/node_modules/.2.1.0-beta.8@webpack-dev-server/client'
@ ./~/.2.1.0-beta.8@webpack-dev-server/client/socket.js 1:13-37
@ ./~/.2.1.0-beta.8@webpack-dev-server/client?http://localhost:8080
@ multi main
安裝一下 babel-runtime
cnpm install babel-helpers --save-dev
啟動(dòng)項(xiàng)目，再次報(bào)錯(cuò)
Module build failed: Error: Cannot find module 'babel-helpers'
Module build failed: Error: Cannot find module 'babel-traverse'
Module build failed: Error: Cannot find module 'json5'
Module build failed: Error: Cannot find module 'babel-generator'
Module build failed: Error: Cannot find module 'detect-indent'
Module build failed: Error: Cannot find module 'jsesc'
找不到依賴那就再安裝一下
cnpm install babel-helpers --save-dev
cnpm install babel-traverse --save-dev
cnpm install json5 --save-dev
...不寫了，請(qǐng)把全部把舊的環(huán)境全部清除，更新到最新版本
解決辦法概述
遇到
Module build failed: Error: Cannot find module '模塊名'
那就安裝
cnpm install 模塊名 --save-dev(關(guān)于環(huán)境的，表現(xiàn)為npm run dev 啟動(dòng)不了)
cnpm install 模塊名 --save(關(guān)于項(xiàng)目的，比如main.js，表現(xiàn)為npm run dev 成功之后控制臺(tái)報(bào)錯(cuò))
比如escape-string-regexp、strip-ansi、has-ansi、is-finite、emojis-list
終于可以啟動(dòng)項(xiàng)目了
輸入完命令會(huì)自動(dòng)啟動(dòng)瀏覽器，如果默認(rèn)打開 IE 不行
npm run dev
自動(dòng)啟動(dòng)瀏覽器就會(huì)看到這 帥帥的界面了。
開始 Vue 之旅
打開 IDE
推薦 Atom 打開項(xiàng)目，需要安裝 Vue 語(yǔ)法高亮的插件
使用官網(wǎng)文檔學(xué)習(xí)基礎(chǔ)
我們來(lái)看官網(wǎng)的一個(gè)例子，(中文文檔請(qǐng)自行上網(wǎng)搜索)
打開 工程目錄下的 App.vue
template 寫 html，script寫 js，style寫樣式
為了方便敘述，我們把官網(wǎng)例子寫在同一個(gè)組件內(nèi)
這里有兩個(gè)坑:
第一。一個(gè)組件下只能有一個(gè)并列的 div，可以這么寫，所以復(fù)制官網(wǎng)示例的時(shí)候只要復(fù)制 div 里面的內(nèi)容就好。
但是不能這樣寫:
第二。數(shù)據(jù)要寫在 return 里面而不是像文檔那樣子寫
錯(cuò)誤的寫法:
這樣子可以自己啃完官網(wǎng)文檔組件之前的部分了。
來(lái)玩玩組件
前面講得基本上都是各種常用組件的數(shù)據(jù)綁定，下面還得說(shuō)說(shuō)的是 Vue 的組件的使用。
在工程目錄/src下創(chuàng)建component文件夾，并在component文件夾下創(chuàng)建一個(gè) firstcomponent.vue并寫仿照 App.vue 的格式和前面學(xué)到的知識(shí)寫一個(gè)組件。
<template>
<div id="firstcomponent">
<h1>I am a title.</h1>
<a> written by {{ author }} </a>
</div>
</template>
<script type="text/javascript">
export default {
data () {
return {
author: "微信公眾號(hào) jinkey-love"
}
}
}
</script>
<style>
</style>
duang... 不能按官網(wǎng)文檔那樣子叫我做就做，我得先試試再告訴你，我做完效果是這樣子的，希望觀眾做完也是這樣子。(迷之微笑 )
然后在 App.vue 使用組件 ( 因?yàn)樵?index.html 里面定義了<div id="app"></div>所以就以這個(gè)組件作為主入口，方便 )
第一步，引入。在<script></script>標(biāo)簽內(nèi)的第一行寫
import firstcomponent from './component/firstcomponent.vue'
第二步，注冊(cè)。在<script></script>標(biāo)簽內(nèi)的 data 代碼塊后面加上 components: { firstcomponent }。記得中間加英文逗號(hào)!!!
export default {
data () {
return {
msg: 'Hello Vue!'
}
},
components: { firstcomponent }
}
第三步，使用。
在<template></template>內(nèi)加上<firstcomponent></firstcomponent>
<template>
<div id="app">
<h1>{{ msg }}</h1>
<firstcomponent></firstcomponent>
</div>
</template>
完成后的代碼：
這時(shí)候看看瀏覽器上的 http://localhost:8080/ 頁(yè)面(之前打開過(guò)就會(huì)自動(dòng)刷新)，如果你沒看到效果是因?yàn)槟銢]有對(duì) App.vue 和 firstcomponent.vue 進(jìn)行保存操作，保存后頁(yè)面會(huì)自動(dòng)刷新。
使用路由搭建單頁(yè)應(yīng)用
之前已經(jīng)通過(guò)命令安裝了vue-router
cnpm install vue-router --save
在webpack.config.js加入別名
resolve: {
alias: {vue: 'vue/dist/vue.js'}
}
為什么要加 alias 配置項(xiàng)？其作用可以在文檔中有相應(yīng)的描述:
修改完之后的webpack.config.js是這樣子的:
var path = require('path')
var webpack = require('webpack')
module.exports = {
entry: './src/main.js',
output: {
path: path.resolve(__dirname, './dist'),
publicPath: '/dist/',
filename: 'build.js'
},
resolveLoader: {
root: path.join(__dirname, 'node_modules'),
},
module: {
loaders: [
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.vue$/,
loader: 'vue'
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.js$/,
loader: 'babel',
exclude: /node_modules/
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.(png|jpg|gif|svg)$/,
loader: 'file',
query: {
name: '[name].[ext]?[hash]'
}
}
]
},
resolve: {
alias: {vue: 'vue/dist/vue.js'}
},
devServer: {
historyApiFallback: true,
noInfo: true
},
devtool: '#eval-source-map'
}
if (process.env.NODE_ENV === 'production') {
module.exports.devtool = '#source-map'
// http://vue-loader.vuejs.org/en/workflow/production.html
module.exports.plugins = (module.exports.plugins || []).concat([
new webpack.DefinePlugin({
'process.env': {
NODE_ENV: '"production"'
}
}),
new webpack.optimize.UglifyJsPlugin({
compress: {
warnings: false
}
})
])
}
再按之前的方法寫一個(gè)組件 secondcomponent.vue
<template>
<div id="secondcomponent">
<h1>I am another page</h1>
<a> written by {{ author }} </a>
<p> 感謝 <a >showonne</a>大神的技術(shù)指導(dǎo)</p>
</div>
</template>
<script>
export default {
data() {
return {
author: "微信公眾號(hào) jinkey-love",
articles: [],
}
}
}
}
</script>
<style>
</style>
這時(shí)候修改 main.js，引入并注冊(cè) vue-router
import VueRouter from "vue-router";
Vue.use(VueRouter);
并且配置路由規(guī)則和 app 啟動(dòng)配置項(xiàng)加上 router，舊版的 router.map 方法在 vue-router 2.0 已經(jīng)不能用了。修改后的main.js如下:
import Vue from 'vue'
import App from './App.vue'
import VueRouter from "vue-router";
import VueResource from 'vue-resource'
//開啟debug模式
Vue.config.debug = true;
Vue.use(VueRouter);
Vue.use(VueResource);
// 定義組件, 也可以像教程之前教的方法從別的文件引入
const First = { template: '<div><h2>我是第 1 個(gè)子頁(yè)面</h2></div>' }
import secondcomponent from './component/secondcomponent.vue'
// 創(chuàng)建一個(gè)路由器實(shí)例
// 并且配置路由規(guī)則
const router = new VueRouter({
mode: 'history',
base: __dirname,
routes: [
{
path: '/first',
component: First
},
{
path: '/second',
component: secondcomponent
}
]
})
// 現(xiàn)在我們可以啟動(dòng)應(yīng)用了！
// 路由器會(huì)創(chuàng)建一個(gè) App 實(shí)例，并且掛載到選擇符 #app 匹配的元素上。
const app = new Vue({
router: router,
render: h => h(App)
}).$mount('#app')
這樣子改完再打開瀏覽器看看。
點(diǎn)擊那兩個(gè)鏈接試試，會(huì)發(fā)現(xiàn)<router-view class="view"></router-view>的內(nèi)容已經(jīng)展示出來(lái)，同時(shí)注意瀏覽器地址已經(jīng)變更。
另外，也可以把 App.vue 的內(nèi)容寫在 main.js 也是可以的不過(guò)不建議這么做
如果你使用 vue1.0和0.7版本的 vue-router，請(qǐng)參照下面這個(gè)教程, 他整個(gè)系列都不錯(cuò)的，當(dāng)然僅限于 vue1.0 :
給頁(yè)面加點(diǎn)動(dòng)態(tài)數(shù)據(jù)
這時(shí)候的頁(yè)面都是靜態(tài)的(數(shù)據(jù)在寫程序的時(shí)候已經(jīng)固定了不能修改)，而每個(gè)應(yīng)用基本上都會(huì)請(qǐng)求外部數(shù)據(jù)以動(dòng)態(tài)改變頁(yè)面內(nèi)容。對(duì)應(yīng)有一個(gè)庫(kù)叫 vue-resource 幫我們解決這個(gè)問(wèn)題。
使用命令行安裝
cnpm install vue-resource --save
在 main.js 引入并注冊(cè) vue-resource:
import VueResource from 'vue-resource'
Vue.use(VueResource);
我們?cè)?secondcomponent.vue 上來(lái)動(dòng)態(tài)加載數(shù)據(jù)
添加一個(gè)列表:
<ul>
<li v-for="article in articles">
{{article.title}}
</li>
</ul>
在 data 里面加入數(shù)組 articles 并賦值為[]
然后在 data 后面加入加入鉤子函數(shù) mounted(詳細(xì)請(qǐng)參照官方文檔關(guān)于 vue 生命周期的解析)，data 和 mount 中間記得記得加逗號(hào)
mounted: function() {
this.$http.jsonp('https://api.douban.com/v2/movie/top250?count=10', {}, {
headers: {
},
emulateJSON: true
}).then(function(response) {
// 這里是處理正確的回調(diào)
this.articles = response.data.subjects
// this.articles = response.data["subjects"] 也可以
}, function(response) {
// 這里是處理錯(cuò)誤的回調(diào)
console.log(response)
});
}
這里使用的是豆瓣的公開 GET 接口，如果接口是跨域的 POST 請(qǐng)求，則需要在服務(wù)器端配置:
Access-Control-Allow-Origin: *
這時(shí)候運(yùn)行看看。等一會(huì)接口返回?cái)?shù)據(jù)，咦，數(shù)據(jù)加載出來(lái)了，棒棒噠 !
更多 vue-router 的使用方法可以看
vue-router 0.7
http://m.doc00.com/doc/1001004eg
vue-router 2.0
http://router.vuejs.org/zh-cn/index.html
來(lái)拯救如此難看的界面
組件、雙向綁定、路由、數(shù)據(jù)請(qǐng)求等基本特性都能用了，寫到這里一個(gè)單頁(yè)應(yīng)用基本上成型了。但是，這幾面也太 TM 難看了吧。自己寫 UI 框架太費(fèi)勁？那就上網(wǎng)找一個(gè)吧。
本來(lái)想給大家介紹 Vux 的，因?yàn)樗玫氖俏⑿诺?WeUI 設(shè)計(jì)規(guī)范，對(duì)于開發(fā)微信小程序或者微信內(nèi)的網(wǎng)頁(yè)非常和諧，但由于寫這篇文章的時(shí)候 Vux 還不支持 vue2.0，只能用別的框架了。
命令行安裝 ElementUI (此處某公司的人應(yīng)該發(fā)紅包了...)
cnpm install element-ui@next -S
然后在 main.js 引入并注冊(cè)
import Element from 'element-ui'
import 'element-ui/lib/theme-default/index.css'
Vue.use(Element)
保存，這時(shí)候程序報(bào)錯(cuò)
Uncaught Error: Module parse failed: /Users/**/Desktop/vue2/node_modules/.1.0.0-rc.5@element-ui/lib/theme-default/index.css Unexpected character '@' (1:0)
You may need an appropriate loader to handle this file type.
官網(wǎng)文檔又有坑了，安裝教程也不跟我們說(shuō)這一步，當(dāng)我們都是高手了...
報(bào)錯(cuò)是由于我們引入了index.css這個(gè) CSS 文件，但是 webpack 打包的時(shí)候無(wú)法識(shí)別并轉(zhuǎn)換成 js，所以就需要配置才能讀取 css 和字體文件，運(yùn)行命令安裝下面三個(gè)東西(如果之前安裝過(guò)就不需要了)
cnpm install style-loader --save-dev
cnpm install css-loader --save-dev
cnpm install file-loader --save-dev
在 webpack.config.js 中的 loaders 數(shù)組加入以下配置，記得該加逗號(hào)的地方加逗號(hào)!
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.css$/,
loader: "style!css"
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.(eot|woff|woff2|ttf)([\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\?]?.*)$/,
loader: "file"
}
修改完的 webpack.config.js 如下
var path = require('path')
var webpack = require('webpack')
module.exports = {
entry: './src/main.js',
output: {
path: path.resolve(__dirname, './dist'),
publicPath: '/dist/',
filename: 'build.js'
},
resolveLoader: {
root: path.join(__dirname, 'node_modules'),
},
module: {
loaders: [
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.vue$/,
loader: 'vue'
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.js$/,
loader: 'babel',
exclude: /node_modules/
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.css$/,
loader: "style!css"
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.(eot|woff|woff2|ttf)([\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\?]?.*)$/,
loader: "file"
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.(png|jpg|gif|svg)$/,
loader: 'file',
query: {
name: '[name].[ext]?[hash]'
}
}
]
},
resolve: {
alias: {vue: 'vue/dist/vue.js'}
},
devServer: {
historyApiFallback: true,
noInfo: true
},
devtool: '#eval-source-map'
}
if (process.env.NODE_ENV === 'production') {
module.exports.devtool = '#source-map'
// http://vue-loader.vuejs.org/en/workflow/production.html
module.exports.plugins = (module.exports.plugins || []).concat([
new webpack.DefinePlugin({
'process.env': {
NODE_ENV: '"production"'
}
}),
new webpack.optimize.UglifyJsPlugin({
compress: {
warnings: false
}
})
])
}
給豆瓣的電影列表套個(gè)衣服(樣式) :
<el-card class="box-card">
<div slot="header" class="clearfix">
<h1 style="line-height: 36px; color: #20A0FF">豆瓣電影排行榜</h2>
</div>
<div v-for="article in articles" class="text item">
{{article.title}}
</div>
</el-card>
打開瀏覽器,輸入網(wǎng)址:
列表比之前漂亮多了，你還可以參照 ElementUI 的文檔使用更多組件樣式
編譯
npm run build
又報(bào)錯(cuò)了...orz
ERROR in build.js from UglifyJs
SyntaxError: Unexpected token punc ?(?, expected punc ?:? [build.js:32001,6]
解決辦法(21061019 showonne 提交 PR 已合并到主分支)
cnpm install babel-preset-es2015 --save-dev
cnpm install babel-preset-stage-0 --save-dev
然后在項(xiàng)目目錄下創(chuàng)建一個(gè).babelrc文件，內(nèi)容如下:
{
presets: ['es2015', 'stage-0']
}
或者在webpack.config.js中這里
{
test: /\\\\.js$/,
loader: 'babel',
exclude: /node_modules/
}
加入 presets 配置，修改成下面醬紫:
{
test: /\\\\.js$/,
loader: 'babel',
exclude: /node_modules/,
query: {presets: ['es2015', 'stage-0']
}
再次執(zhí)行 npm run build 就可以了，后來(lái)發(fā)現(xiàn)直接運(yùn)行 webpack 命令也是可以打包的
webpack --color --progress
接著把 index.html 和整個(gè) dist 目錄丟到服務(wù)器就可以了。
如果你覺得這篇文章寫得好，不需要打賞，你可以下載我朋友做的一個(gè)閱讀工具，可以訂閱公眾號(hào)和簡(jiǎn)書、也可以看大神分享的優(yōu)秀文章。
Jinkey原創(chuàng)
感謝 showonne、yubang 技術(shù)指導(dǎo)
Demo 地址:
http://demo.jinkey.io/vue2
源碼:
https://github.com/Jinkeycode/vue2-example
什么是 Vue
Vue 是一個(gè)前端框架，特點(diǎn)是
數(shù)據(jù)綁定
比如你改變一個(gè)輸入框 Input 標(biāo)簽的值，會(huì)自動(dòng)同步更新到頁(yè)面上其他綁定該輸入框的組件的值
數(shù)據(jù)綁定
組件化
頁(yè)面上小到一個(gè)按鈕都可以是一個(gè)單獨(dú)的文件.vue，這些小組件直接可以像樂(lè)高積木一樣通過(guò)互相引用而組裝起來(lái)
Vue2.0 推薦開發(fā)環(huán)境
Homebrew 1.0.6(Mac)、Node.js 6.7.0、npm 3.10.3、webpack 1.13.2、vue-cli 2.4.0、Atom 1.10.2
安裝環(huán)境
打開終端運(yùn)行以下命令
安裝brew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
安裝 nodejs
brew install nodejs
用 npm install npm@3.10.3 更新 npm 版本報(bào)錯(cuò):
(node:42) fs: re-evaluating native module sources is not supported.
解決辦法:
在官網(wǎng)下載6.70的安裝包再安裝一次(剛剛相當(dāng)于幫你配置好環(huán)境變量，現(xiàn)在再安裝一次升級(jí)到最新的 npm)
- 好像以前官網(wǎng)的安裝包不會(huì)自動(dòng)配置環(huán)境變量的，由于我電腦上之前安裝過(guò) nodejs 所以環(huán)境變量已經(jīng)配置好了，不知道現(xiàn)在的安裝包會(huì)不會(huì)自動(dòng)配置環(huán)境變量。
Windows 下直接下載安裝包即可
獲取nodejs模塊安裝目錄訪問(wèn)權(quán)限
sudo chmod -R 777 /usr/local/lib/node_modules/
安裝淘寶鏡像
npm install -g cnpm --registry=https://registry.npm.taobao.org
安裝webpack
cnpm install webpack -g
安裝vue腳手架
npm install vue-cli -g
在硬盤上找一個(gè)文件夾放工程用的，在終端中進(jìn)入該目錄
Mac
cd 目錄路徑
根據(jù)模板創(chuàng)建項(xiàng)目
vue init webpack-simple 工程名字<工程名字不能用中文>
或者創(chuàng)建 vue1.0 的項(xiàng)目
vue init webpack-simple#1.0 工程名字<工程名字不能用中文>
會(huì)有一些初始化的設(shè)置，如下輸入:
Target directory exists. Continue? (Y/n)直接回車默認(rèn)(然后會(huì)下載 vue2.0模板，這里可能需要連代理)
Project name (vue-test)直接回車默認(rèn)
Project description (A Vue.js project) 直接回車默認(rèn)
Author 寫你自己的名字
cd 命令進(jìn)入創(chuàng)建的工程目錄
工程目錄如圖所示:
安裝項(xiàng)目依賴
一定要從官方倉(cāng)庫(kù)安裝，npm 服務(wù)器在國(guó)外所以這一步安裝速度會(huì)很慢。
npm install
不要從國(guó)內(nèi)鏡像cnpm安裝(會(huì)導(dǎo)致后面缺了很多依賴庫(kù))
cnpm install
安裝 vue 路由模塊vue-router和網(wǎng)絡(luò)請(qǐng)求模塊vue-resource
cnpm install vue-router vue-resource --save
啟動(dòng)項(xiàng)目
npm run dev
填坑(以下坑可能由于 vue2.0 導(dǎo)致其他相關(guān)編譯打包工具沒更新導(dǎo)致的)
【重點(diǎn)】后來(lái)發(fā)現(xiàn)這些坑是由于 npm 不是最新的版本3.10.2， 用 npm 3.9.5就會(huì)出現(xiàn)以下坑
解決辦法: 請(qǐng)運(yùn)行以下命令
npm update -g
報(bào)錯(cuò)
Error: Cannot find module 'opn'
Error: Cannot find module 'webpack-dev-middleware'
Error: Cannot find module 'express'
Error: Cannot find module 'compression'
Error: Cannot find module 'sockjs'
Error: Cannot find module 'spdy'
Error: Cannot find module 'http-proxy-middleware'
Error: Cannot find module 'serve-index'
如果你用的是老版本的 vue-cli 還可能報(bào)其他錯(cuò)誤，需要更新一下 vue-cli
npm update vue-cli
然后可以查看一下當(dāng)前全局 vue-cli 的版本
npm view vue-cli
安裝一下這個(gè)依賴到工程開發(fā)環(huán)境
cnpm install opn --save-dev
cnpm install webpack-dev-middleware --save-dev
cnpm install express --save-dev
cnpm install compression --save-dev
cnpm install sockjs --save-dev
cnpm install spdy --save-dev
cnpm install http-proxy-middleware --save-dev
cnpm install serve-index --save-dev
cnpm install connect-history-api-fallback --save-dev
再啟動(dòng)項(xiàng)目，報(bào)錯(cuò)
ERROR in ./src/main.js
Module build failed: Error: Cannot find module 'babel-runtime/helpers/typeof'
at Function.Module._resolveFilename (module.js:440:15)
at Function.Module._load (module.js:388:25)
at Module.require (module.js:468:17)
at require (internal/module.js:20:19)
at Object.<anonymous> (/Volumes/MacStorage/Coding/Web/vue-test/node_modules/.6.17.0@babel-core/lib/transformation/file/index.js:6:16)
at Module._compile (module.js:541:32)
at Object.Module._extensions..js (module.js:550:10)
at Module.load (module.js:458:32)
at tryModuleLoad (module.js:417:12)
at Function.Module._load (module.js:409:3)
@ multi main
ERROR in ./~/.2.1.0-beta.8@webpack-dev-server/client/socket.js
Module not found: Error: Can't resolve 'sockjs-client' in '/Volumes/MacStorage/Coding/Web/vue-test/node_modules/.2.1.0-beta.8@webpack-dev-server/client'
@ ./~/.2.1.0-beta.8@webpack-dev-server/client/socket.js 1:13-37
@ ./~/.2.1.0-beta.8@webpack-dev-server/client?http://localhost:8080
@ multi main
安裝一下 babel-runtime
cnpm install babel-helpers --save-dev
啟動(dòng)項(xiàng)目，再次報(bào)錯(cuò)
Module build failed: Error: Cannot find module 'babel-helpers'
Module build failed: Error: Cannot find module 'babel-traverse'
Module build failed: Error: Cannot find module 'json5'
Module build failed: Error: Cannot find module 'babel-generator'
Module build failed: Error: Cannot find module 'detect-indent'
Module build failed: Error: Cannot find module 'jsesc'
找不到依賴那就再安裝一下
cnpm install babel-helpers --save-dev
cnpm install babel-traverse --save-dev
cnpm install json5 --save-dev
...不寫了，請(qǐng)把全部把舊的環(huán)境全部清除，更新到最新版本
解決辦法概述
遇到
Module build failed: Error: Cannot find module '模塊名'
那就安裝
cnpm install 模塊名 --save-dev(關(guān)于環(huán)境的，表現(xiàn)為npm run dev 啟動(dòng)不了)
cnpm install 模塊名 --save(關(guān)于項(xiàng)目的，比如main.js，表現(xiàn)為npm run dev 成功之后控制臺(tái)報(bào)錯(cuò))
比如escape-string-regexp、strip-ansi、has-ansi、is-finite、emojis-list
終于可以啟動(dòng)項(xiàng)目了
輸入完命令會(huì)自動(dòng)啟動(dòng)瀏覽器，如果默認(rèn)打開 IE 不行
npm run dev
自動(dòng)啟動(dòng)瀏覽器就會(huì)看到這 帥帥的界面了。
開始 Vue 之旅
打開 IDE
推薦 Atom 打開項(xiàng)目，需要安裝 Vue 語(yǔ)法高亮的插件
使用官網(wǎng)文檔學(xué)習(xí)基礎(chǔ)
我們來(lái)看官網(wǎng)的一個(gè)例子，(中文文檔請(qǐng)自行上網(wǎng)搜索)
打開 工程目錄下的 App.vue
template 寫 html，script寫 js，style寫樣式
為了方便敘述，我們把官網(wǎng)例子寫在同一個(gè)組件內(nèi)
這里有兩個(gè)坑:
第一。一個(gè)組件下只能有一個(gè)并列的 div，可以這么寫，所以復(fù)制官網(wǎng)示例的時(shí)候只要復(fù)制 div 里面的內(nèi)容就好。
但是不能這樣寫:
第二。數(shù)據(jù)要寫在 return 里面而不是像文檔那樣子寫
錯(cuò)誤的寫法:
這樣子可以自己啃完官網(wǎng)文檔組件之前的部分了。
來(lái)玩玩組件
前面講得基本上都是各種常用組件的數(shù)據(jù)綁定，下面還得說(shuō)說(shuō)的是 Vue 的組件的使用。
在工程目錄/src下創(chuàng)建component文件夾，并在component文件夾下創(chuàng)建一個(gè) firstcomponent.vue并寫仿照 App.vue 的格式和前面學(xué)到的知識(shí)寫一個(gè)組件。
<template>
<div id="firstcomponent">
<h1>I am a title.</h1>
<a> written by {{ author }} </a>
</div>
</template>
<script type="text/javascript">
export default {
data () {
return {
author: "微信公眾號(hào) jinkey-love"
}
}
}
</script>
<style>
</style>
duang... 不能按官網(wǎng)文檔那樣子叫我做就做，我得先試試再告訴你，我做完效果是這樣子的，希望觀眾做完也是這樣子。(迷之微笑 )
然后在 App.vue 使用組件 ( 因?yàn)樵?index.html 里面定義了<div id="app"></div>所以就以這個(gè)組件作為主入口，方便 )
第一步，引入。在<script></script>標(biāo)簽內(nèi)的第一行寫
import firstcomponent from './component/firstcomponent.vue'
第二步，注冊(cè)。在<script></script>標(biāo)簽內(nèi)的 data 代碼塊后面加上 components: { firstcomponent }。記得中間加英文逗號(hào)!!!
export default {
data () {
return {
msg: 'Hello Vue!'
}
},
components: { firstcomponent }
}
第三步，使用。
在<template></template>內(nèi)加上<firstcomponent></firstcomponent>
<template>
<div id="app">
<h1>{{ msg }}</h1>
<firstcomponent></firstcomponent>
</div>
</template>
完成后的代碼：
這時(shí)候看看瀏覽器上的 http://localhost:8080/ 頁(yè)面(之前打開過(guò)就會(huì)自動(dòng)刷新)，如果你沒看到效果是因?yàn)槟銢]有對(duì) App.vue 和 firstcomponent.vue 進(jìn)行保存操作，保存后頁(yè)面會(huì)自動(dòng)刷新。
使用路由搭建單頁(yè)應(yīng)用
之前已經(jīng)通過(guò)命令安裝了vue-router
cnpm install vue-router --save
在webpack.config.js加入別名
resolve: {
alias: {vue: 'vue/dist/vue.js'}
}
為什么要加 alias 配置項(xiàng)？其作用可以在文檔中有相應(yīng)的描述:
修改完之后的webpack.config.js是這樣子的:
var path = require('path')
var webpack = require('webpack')
module.exports = {
entry: './src/main.js',
output: {
path: path.resolve(__dirname, './dist'),
publicPath: '/dist/',
filename: 'build.js'
},
resolveLoader: {
root: path.join(__dirname, 'node_modules'),
},
module: {
loaders: [
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.vue$/,
loader: 'vue'
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.js$/,
loader: 'babel',
exclude: /node_modules/
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.(png|jpg|gif|svg)$/,
loader: 'file',
query: {
name: '[name].[ext]?[hash]'
}
}
]
},
resolve: {
alias: {vue: 'vue/dist/vue.js'}
},
devServer: {
historyApiFallback: true,
noInfo: true
},
devtool: '#eval-source-map'
}
if (process.env.NODE_ENV === 'production') {
module.exports.devtool = '#source-map'
// http://vue-loader.vuejs.org/en/workflow/production.html
module.exports.plugins = (module.exports.plugins || []).concat([
new webpack.DefinePlugin({
'process.env': {
NODE_ENV: '"production"'
}
}),
new webpack.optimize.UglifyJsPlugin({
compress: {
warnings: false
}
})
])
}
再按之前的方法寫一個(gè)組件 secondcomponent.vue
<template>
<div id="secondcomponent">
<h1>I am another page</h1>
<a> written by {{ author }} </a>
<p> 感謝 <a >showonne</a>大神的技術(shù)指導(dǎo)</p>
</div>
</template>
<script>
export default {
data() {
return {
author: "微信公眾號(hào) jinkey-love",
articles: [],
}
}
}
}
</script>
<style>
</style>
這時(shí)候修改 main.js，引入并注冊(cè) vue-router
import VueRouter from "vue-router";
Vue.use(VueRouter);
并且配置路由規(guī)則和 app 啟動(dòng)配置項(xiàng)加上 router，舊版的 router.map 方法在 vue-router 2.0 已經(jīng)不能用了。修改后的main.js如下:
import Vue from 'vue'
import App from './App.vue'
import VueRouter from "vue-router";
import VueResource from 'vue-resource'
//開啟debug模式
Vue.config.debug = true;
Vue.use(VueRouter);
Vue.use(VueResource);
// 定義組件, 也可以像教程之前教的方法從別的文件引入
const First = { template: '<div><h2>我是第 1 個(gè)子頁(yè)面</h2></div>' }
import secondcomponent from './component/secondcomponent.vue'
// 創(chuàng)建一個(gè)路由器實(shí)例
// 并且配置路由規(guī)則
const router = new VueRouter({
mode: 'history',
base: __dirname,
routes: [
{
path: '/first',
component: First
},
{
path: '/second',
component: secondcomponent
}
]
})
// 現(xiàn)在我們可以啟動(dòng)應(yīng)用了！
// 路由器會(huì)創(chuàng)建一個(gè) App 實(shí)例，并且掛載到選擇符 #app 匹配的元素上。
const app = new Vue({
router: router,
render: h => h(App)
}).$mount('#app')
這樣子改完再打開瀏覽器看看。
點(diǎn)擊那兩個(gè)鏈接試試，會(huì)發(fā)現(xiàn)<router-view class="view"></router-view>的內(nèi)容已經(jīng)展示出來(lái)，同時(shí)注意瀏覽器地址已經(jīng)變更。
另外，也可以把 App.vue 的內(nèi)容寫在 main.js 也是可以的不過(guò)不建議這么做
如果你使用 vue1.0和0.7版本的 vue-router，請(qǐng)參照下面這個(gè)教程, 他整個(gè)系列都不錯(cuò)的，當(dāng)然僅限于 vue1.0 :
給頁(yè)面加點(diǎn)動(dòng)態(tài)數(shù)據(jù)
這時(shí)候的頁(yè)面都是靜態(tài)的(數(shù)據(jù)在寫程序的時(shí)候已經(jīng)固定了不能修改)，而每個(gè)應(yīng)用基本上都會(huì)請(qǐng)求外部數(shù)據(jù)以動(dòng)態(tài)改變頁(yè)面內(nèi)容。對(duì)應(yīng)有一個(gè)庫(kù)叫 vue-resource 幫我們解決這個(gè)問(wèn)題。
使用命令行安裝
cnpm install vue-resource --save
在 main.js 引入并注冊(cè) vue-resource:
import VueResource from 'vue-resource'
Vue.use(VueResource);
我們?cè)?secondcomponent.vue 上來(lái)動(dòng)態(tài)加載數(shù)據(jù)
添加一個(gè)列表:
<ul>
<li v-for="article in articles">
{{article.title}}
</li>
</ul>
在 data 里面加入數(shù)組 articles 并賦值為[]
然后在 data 后面加入加入鉤子函數(shù) mounted(詳細(xì)請(qǐng)參照官方文檔關(guān)于 vue 生命周期的解析)，data 和 mount 中間記得記得加逗號(hào)
mounted: function() {
this.$http.jsonp('https://api.douban.com/v2/movie/top250?count=10', {}, {
headers: {
},
emulateJSON: true
}).then(function(response) {
// 這里是處理正確的回調(diào)
this.articles = response.data.subjects
// this.articles = response.data["subjects"] 也可以
}, function(response) {
// 這里是處理錯(cuò)誤的回調(diào)
console.log(response)
});
}
這里使用的是豆瓣的公開 GET 接口，如果接口是跨域的 POST 請(qǐng)求，則需要在服務(wù)器端配置:
Access-Control-Allow-Origin: *
這時(shí)候運(yùn)行看看。等一會(huì)接口返回?cái)?shù)據(jù)，咦，數(shù)據(jù)加載出來(lái)了，棒棒噠 !
更多 vue-router 的使用方法可以看
vue-router 0.7
http://m.doc00.com/doc/1001004eg
vue-router 2.0
http://router.vuejs.org/zh-cn/index.html
來(lái)拯救如此難看的界面
組件、雙向綁定、路由、數(shù)據(jù)請(qǐng)求等基本特性都能用了，寫到這里一個(gè)單頁(yè)應(yīng)用基本上成型了。但是，這幾面也太 TM 難看了吧。自己寫 UI 框架太費(fèi)勁？那就上網(wǎng)找一個(gè)吧。
本來(lái)想給大家介紹 Vux 的，因?yàn)樗玫氖俏⑿诺?WeUI 設(shè)計(jì)規(guī)范，對(duì)于開發(fā)微信小程序或者微信內(nèi)的網(wǎng)頁(yè)非常和諧，但由于寫這篇文章的時(shí)候 Vux 還不支持 vue2.0，只能用別的框架了。
命令行安裝 ElementUI (此處某公司的人應(yīng)該發(fā)紅包了...)
cnpm install element-ui@next -S
然后在 main.js 引入并注冊(cè)
import Element from 'element-ui'
import 'element-ui/lib/theme-default/index.css'
Vue.use(Element)
保存，這時(shí)候程序報(bào)錯(cuò)
Uncaught Error: Module parse failed: /Users/**/Desktop/vue2/node_modules/.1.0.0-rc.5@element-ui/lib/theme-default/index.css Unexpected character '@' (1:0)
You may need an appropriate loader to handle this file type.
官網(wǎng)文檔又有坑了，安裝教程也不跟我們說(shuō)這一步，當(dāng)我們都是高手了...
報(bào)錯(cuò)是由于我們引入了index.css這個(gè) CSS 文件，但是 webpack 打包的時(shí)候無(wú)法識(shí)別并轉(zhuǎn)換成 js，所以就需要配置才能讀取 css 和字體文件，運(yùn)行命令安裝下面三個(gè)東西(如果之前安裝過(guò)就不需要了)
cnpm install style-loader --save-dev
cnpm install css-loader --save-dev
cnpm install file-loader --save-dev
在 webpack.config.js 中的 loaders 數(shù)組加入以下配置，記得該加逗號(hào)的地方加逗號(hào)!
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.css$/,
loader: "style!css"
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.(eot|woff|woff2|ttf)([\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\?]?.*)$/,
loader: "file"
}
修改完的 webpack.config.js 如下
var path = require('path')
var webpack = require('webpack')
module.exports = {
entry: './src/main.js',
output: {
path: path.resolve(__dirname, './dist'),
publicPath: '/dist/',
filename: 'build.js'
},
resolveLoader: {
root: path.join(__dirname, 'node_modules'),
},
module: {
loaders: [
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.vue$/,
loader: 'vue'
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.js$/,
loader: 'babel',
exclude: /node_modules/
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.css$/,
loader: "style!css"
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.(eot|woff|woff2|ttf)([\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\?]?.*)$/,
loader: "file"
},
{
test: /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.(png|jpg|gif|svg)$/,
loader: 'file',
query: {
name: '[name].[ext]?[hash]'
}
}
]
},
resolve: {
alias: {vue: 'vue/dist/vue.js'}
},
devServer: {
historyApiFallback: true,
noInfo: true
},
devtool: '#eval-source-map'
}
if (process.env.NODE_ENV === 'production') {
module.exports.devtool = '#source-map'
// http://vue-loader.vuejs.org/en/workflow/production.html
module.exports.plugins = (module.exports.plugins || []).concat([
new webpack.DefinePlugin({
'process.env': {
NODE_ENV: '"production"'
}
}),
new webpack.optimize.UglifyJsPlugin({
compress: {
warnings: false
}
})
])
}
給豆瓣的電影列表套個(gè)衣服(樣式) :
<el-card class="box-card">
<div slot="header" class="clearfix">
<h1 style="line-height: 36px; color: #20A0FF">豆瓣電影排行榜</h2>
</div>
<div v-for="article in articles" class="text item">
{{article.title}}
</div>
</el-card>
打開瀏覽器,輸入網(wǎng)址:
列表比之前漂亮多了，你還可以參照 ElementUI 的文檔使用更多組件樣式
編譯
npm run build
又報(bào)錯(cuò)了...orz
ERROR in build.js from UglifyJs
SyntaxError: Unexpected token punc ?(?, expected punc ?:? [build.js:32001,6]
解決辦法(21061019 showonne 提交 PR 已合并到主分支)
cnpm install babel-preset-es2015 --save-dev
cnpm install babel-preset-stage-0 --save-dev
然后在項(xiàng)目目錄下創(chuàng)建一個(gè).babelrc文件，內(nèi)容如下:
{
presets: ['es2015', 'stage-0']
}
或者在webpack.config.js中這里
{
test: /\\\\.js$/,
loader: 'babel',
exclude: /node_modules/
}
加入 presets 配置，修改成下面醬紫:
{
test: /\\\\.js$/,
loader: 'babel',
exclude: /node_modules/,
query: {presets: ['es2015', 'stage-0']
}
再次執(zhí)行 npm run build 就可以了，后來(lái)發(fā)現(xiàn)直接運(yùn)行 webpack 命令也是可以打包的
webpack --color --progress
接著把 index.html 和整個(gè) dist 目錄丟到服務(wù)器就可以了。
如果你覺得這篇文章寫得好，不需要打賞，你可以下載我朋友做的一個(gè)閱讀工具，可以訂閱公眾號(hào)和簡(jiǎn)書、也可以看大神分享的優(yōu)秀文章。
下載地址：https://itunes.apple.com/us/app/you-duuread-zhi-gei-xiang/id1175225244
