Jinkey原创
感谢 showonne、yubang 技术指导
Demo 地址:
http://demo.jinkey.io/vue2
源码:
https://github.com/Jinkeycode/vue2-example
Vue 是一个前端框架,特点是
数据绑定
比如你改变一个输入框 Input 标签的值,会自动同步更新到页面上其他绑定该输入框的组件的值

页面上小到一个按钮都可以是一个单独的文件.vue,这些小组件直接可以像乐高积木一样通过互相引用而组装起来
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
打开终端运行以下命令:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"复制
brew install nodejs复制
用 npm install [email protected] 更新 npm 版本报错:
(node:42) fs: re-evaluating native module sources is not supported.
解决办法:
在官网下载6.70的安装包再安装一次(刚刚相当于帮你配置好环境变量,现在再安装一次升级到最新的 npm)
- 好像以前官网的安装包不会自动配置环境变量的,由于我电脑上之前安装过 nodejs 所以环境变量已经配置好了,不知道现在的安装包会不会自动配置环境变量。
Windows 下直接下载安装包即可
linux 下可以使用 apt-get(ubuntu) 或 yum(centos) 命令安装。
具体可参考:http://www.shouce.ren/api/view/a/3461
sudo chmod -R 777 /usr/local/lib/node_modules/复制
安装淘宝镜像
大家都知道国内直接使用 npm 的官方镜像是非常慢的,这里推荐使用淘宝 NPM 镜像。
npm install -g cnpm --registry=https://registry.npm.taobao.org复制
这样就可以使用 cnpm 命令来安装模块了:
cnpm install [name]复制
cnpm install webpack -g复制
npm install vue-cli -g复制
cd 目录路径复制
vue init webpack-simple 工程名字<工程名字不能用中文>
或者创建 vue1.0 的项目
vue init webpack-simple#1.0 工程名字<工程名字不能用中文>
会有一些初始化的设置,如下输入:
Target directory exists. Continue? (Y/n)
直接回车默认(然后会下载 vue2.0模板,这里可能需要连代理)
Project name (vue-test)
直接回车默认
Project description (A Vue.js project)
直接回车默认
Author
写你自己的名字
工程目录如图所示:
一定要从官方仓库安装,npm 服务器在国外所以这一步安装速度会很慢。
npm install复制
不要从国内镜像cnpm安装(会导致后面缺了很多依赖库)
cnpm install复制
vue-router
和网络请求模块vue-resource
cnpm install vue-router vue-resource --save复制
npm run dev复制
【重点】后来发现这些坑是由于 npm 不是最新的版本3.10.2, 用 npm 3.9.5就会出现以下坑
解决办法: 请运行以下命令
npm update -g
报错
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 还可能报其他错误,需要更新一下 vue-cli
npm update vue-cli复制
然后可以查看一下当前全局 vue-cli 的版本
npm view vue-cli复制
安装一下这个依赖到工程开发环境
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复制
再启动项目,报错
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.(/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 复制
安装一下 babel-runtime
cnpm install babel-helpers --save-dev复制
启动项目,再次报错
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 ...不写了,请把全部把旧的环境全部清除,更新到最新版本复制
遇到
Module build failed: Error: Cannot find module '模块名'复制
那就安装
cnpm install 模块名 --save-dev(关于环境的,表现为npm run dev 启动不了) cnpm install 模块名 --save(关于项目的,比如main.js,表现为npm run dev 成功之后控制台报错) 比如escape-string-regexp、strip-ansi、has-ansi、is-finite、emojis-list复制
输入完命令会自动启动浏览器,如果默认打开 IE 不行
npm run dev复制
自动启动浏览器就会看到这个界面了。
推荐 Atom 打开项目,需要安装 Vue 语法高亮的插件
我们来看官网的一个例子,(中文文档请自行上网搜索)
打开 工程目录下的 App.vue
template 写 html,script写 js,style写样式
为了方便叙述,我们把官网例子写在同一个组件内
这里有两个坑:
第一。一个组件下只能有一个并列的 div,可以这么写,所以复制官网示例的时候只要复制 div 里面的内容就好。
但是不能这样写:
第二。数据要写在 return 里面而不是像文档那样子写
错误的写法:
这样子可以自己啃完官网文档组件之前的部分了。
前面讲得基本上都是各种常用组件的数据绑定,下面还得说说的是 Vue 的组件的使用。
在工程目录/src
下创建component
文件夹,并在component
文件夹下创建一个 firstcomponent.vue
并写仿照 App.vue 的格式和前面学到的知识写一个组件。
复制
duang... 不能按官网文档那样子叫我做就做,我得先试试再告诉你,我做完效果是这样子的,希望观众做完也是这样子。(迷之微笑 )
然后在 App.vue 使用组件 ( 因为在 index.html
里面定义了
标签内的第一行写
import firstcomponent from './component/firstcomponent.vue'复制
第二步,注册。在标签内的 data 代码块后面加上 components: { firstcomponent }。记得中间加英文逗号!!!
export default { data () { return { msg: 'Hello Vue!' } }, components: { firstcomponent } }复制
第三步,使用。
在内加上
id="app">- src="./assets/logo.png">
- {{ msg }}
复制
完成后的代码:
这时候看看浏览器上的 http://localhost:8080/
页面(之前打开过就会自动刷新),如果你没看到效果是因为你没有对 App.vue
和firstcomponent.vue
进行保存操作,保存后页面会自动刷新。
之前已经通过命令安装了vue-router
cnpm install vue-router --save复制
在webpack.config.js加入别名
resolve: { alias: {vue: 'vue/dist/vue.js'} }复制
为什么要加 alias 配置项?其作用可以在文档中有相应的描述:
修改完之后的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
- }
- })
- ])
- }
复制
再按之前的方法写一个组件 secondcomponent.vue
id="secondcomponent">- I am another page
- written by {{ author }}
- 感谢 href="https://github.com/showonne">showonne大神的技术指导
- export default {
- data() {
- return {
- author: "微信公众号 jinkey-love",
- articles: [],
- }
- }
- }
- }
复制
这时候修改 main.js,引入并注册 vue-router
import VueRouter from "vue-router"; Vue.use(VueRouter);复制
并且配置路由规则和 app 启动配置项加上 router,旧版的 router.map 方法在 vue-router 2.0
已经不能用了。修改后的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: '
' }我是第 1 个子页面
- import secondcomponent from './component/secondcomponent.vue'
- // 创建一个路由器实例
- // 并且配置路由规则
- const router = new VueRouter({
- mode: 'history',
- base: __dirname,
- routes: [
- {
- path: '/first',
- component: First
- },
- {
- path: '/second',
- component: secondcomponent
- }
- ]
- })
- // 现在我们可以启动应用了!
- // 路由器会创建一个 App 实例,并且挂载到选择符 #app 匹配的元素上。
- const app = new Vue({
- router: router,
- render: h => h(App)
- }).$mount('#app')
复制
这样子改完再打开浏览器看看。
点击那两个链接试试,会发现
的内容已经展示出来,同时注意浏览器地址已经变更。
另外,也可以把 App.vue 的内容写在 main.js 也是可以的不过不建议这么做
如果你使用 vue1.0和0.7版本的 vue-router,请参照下面这个教程, 他整个系列都不错的,当然仅限于 vue1.0 :
http://guowenfh.github.io/2016/03/28/vue-webpack-06-router/复制
这时候的页面都是静态的(数据在写程序的时候已经固定了不能修改),而每个应用基本上都会请求外部数据以动态改变页面内容。对应有一个库叫 vue-resource
帮我们解决这个问题。
使用命令行安装
cnpm install vue-resource --save复制
在 main.js 引入并注册 vue-resource
:
import VueResource from 'vue-resource' Vue.use(VueResource);复制
我们在 secondcomponent.vue 上来动态加载数据
添加一个列表:
在 data 里面加入数组 articles 并赋值为[]
然后在 data 后面加入加入钩子函数 mounted
(详细请参照官方文档关于 vue 生命周期的解析),data 和 mount 中间记得记得加逗号
- mounted: function() {
- this.$http.jsonp('https://api.douban.com/v2/movie/top250?count=10', {}, {
- headers: {
- },
- emulateJSON: true
- }).then(function(response) {
- // 这里是处理正确的回调
- this.articles = response.data.subjects
- // this.articles = response.data["subjects"] 也可以
- }, function(response) {
- // 这里是处理错误的回调
- console.log(response)
- });
- }
复制
这里使用的是豆瓣的公开 GET 接口,如果接口是跨域的 POST 请求,则需要在服务器端配置:
Access-Control-Allow-Origin: *复制
这时候运行看看。等一会接口返回数据,咦,数据加载出来了,棒棒哒 !
更多 vue-router 的使用方法可以看
vue-router 0.7
http://m.doc00.com/doc/1001004eg
vue-router 2.0
http://router.vuejs.org/zh-cn/index.html
组件、双向绑定、路由、数据请求等基本特性都能用了,写到这里一个单页应用基本上成型了。但是,这几面也太 TM 难看了吧。自己写 UI 框架太费劲?那就上网找一个吧。
本来想给大家介绍 Vux 的,因为他用的是微信的 WeUI 设计规范,对于开发微信小程序或者微信内的网页非常和谐,但由于写这篇文章的时候 Vux 还不支持 vue2.0,只能用别的框架了。
命令行安装 ElementUI (此处某公司的人应该发红包了...)
cnpm install element-ui@next -S复制
然后在 main.js 引入并注册
import Element from 'element-ui' import 'element-ui/lib/theme-default/index.css' Vue.use(Element)复制
保存,这时候程序报错
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.复制
官网文档又有坑了,安装教程也不跟我们说这一步,当我们都是高手了...
报错是由于我们引入了index.css
这个 CSS 文件,但是 webpack 打包的时候无法识别并转换成 js,所以就需要配置才能读取 css 和字体文件,运行命令安装下面三个东西(如果之前安装过就不需要了)
cnpm install style-loader --save-dev cnpm install css-loader --save-dev cnpm install file-loader --save-dev复制
在 webpack.config.js 中的 loaders 数组加入以下配置,记得该加逗号的地方加逗号!
- {
- 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
- }
- })
- ])
- }
复制
给豆瓣的电影列表套个衣服(样式) :
class="box-card"> slot="header" class="clearfix">style="line-height: 36px; color: #20A0FF">豆瓣电影排行榜
v-for="article in articles" class="text item">- {{article.title}}
复制
打开浏览器,输入网址:http://localhost:8080/second
列表比之前漂亮多了,你还可以参照 ElementUI 的文档使用更多组件样式
http://element.eleme.io/#/component/layout
h3>编译
npm run build复制
又报错了...orz
ERROR in build.js from UglifyJs SyntaxError: Unexpected token punc «(», expected punc «:» [build.js:32001,6] 把node_modules/.bin/cross-env里的 require('../dist')(process.argv.slice(2));复制
后来发现直接运行 webpack 命令就可以打包了
webpack --color --progress复制
接着把 index.html 和整个 dist 目录丢到服务器就可以了。