基础知识：vue-cli项目搭建及配置

发布于：2023-03-12 ⋅ 阅读:(84) ⋅ 点赞:(0)

vue-cli脚手架下载启动

脚手架搭建

// 安装node、npm
    // 查看node版本
    node -v 
    
    // 查看npm版本
    npm -v
    
    // 如未安装请安装node， node会一起安装npm
    
// 全局安装 vue-cli
    npm install vue-cli -g
     
// 下载脚手架项目 
    vue init webpack my-project
    
// 进入项目根目录 
    cd my-project
     
// 启动服务 
    npm start 或 npm run dev
    
// 访问url 
    localhost:8080 或 127.0.0.1:8080

补充：
点这里 → node下载地址

主体结构说明

├─build                       // webpack配置文件（如：路径配置、css预编译等）
├─config                      // vue配置文件（如：端口、打包输出等）
├─dist                        // npm run dev打包后的文件夹
├─node_modules                // node安装依赖包
├─src                         // 资源文件夹
    ├─assets                  // 静态文件资源
    ├─components              // 组件文件夹（如：common公用组件、pages页面组件）
    ├─router                  // 路由文件夹
    ├─App.vue                 // vue入口文件
    ├─main.js                 // 页面程序入口文件
├─static                      // 静态资源（如：图片、json数据等） 
├─.babelrc                    // es6解析的配置
├─.editorconfig               // 编辑器统一代码风格的配置
├─.gitignore                  // git忽略提交的配置
├─.postcssrc.js               // css转换的配置
├─index.html                  // 页面入口
├─package-lock.json           // node_modules 或 package.json 发生变化时自动生成的文件
├─package.json                // 项目基本信息
└─README.md                   // 项目说明

// config
├─config 
    ├─dev.env.js              // 开发环境配置
    ├─index.js                // 主配置
    ├─prod.env.js             // 生产环境配置

// build
├─build 
    ├─build.js                // npm run build构建生产版本
    ├─check-versions.js       // 检测node和npm的版本，实现版本依赖
    ├─utils.js                // css预编译处理工具
    ├─vue-loader.conf.js      // vue处理工具（template、script、style）
    ├─webpack.base.conf.js    // 开发和生产共同使用的配置文件，主要实现配制入口，配置输出环境，配置模块resolve和插件等
    ├─webpack.dev.conf.js     // 开发环境webpack配置
    ├─webpack.prod.conf.js    // 生产环境webpack配置

config/index.js

端口

// 更改端口
port: 3000,

打开浏览器

// 是否在编译完成后，自动打开浏览器访问http://localhost:3000
autoOpenBrowser: false,

代理

proxyTable: {
  // 接口跨域
  // 解决跨域的问题
  '/lots-web/**': {
    target: 'http://localhost:8080' // 接口的域名
  },
  // 开发环境本地数据挂载 
  // json数据文件路径：static/mock/index.json
  '/api': {
    target: 'http://localhost:7000',
    pathRewrite: {
    '^/api': '/static/mock'
    }
  }
}

build/webpack.base.conf.js

路径配置

alias: {
  'vue$': 'vue/dist/vue.esm.js',
  '@': resolve('src'),
  // import 'css/common.css'
  'css': resolve('src/assets/css')
}

build/utils.js

variables.scss预编译

// 安装模块：
// npm install --save-dev sass-loader
// npm install --save-dev node-sass
// npm install --save-dev sass-resources-loader
scss: generateLoaders('sass').concat(
  {
    loader: 'sass-resources-loader',
    options: {
      resources: path.resolve(__dirname, '../src/assets/css/variables.scss')
    }
  }
)

// 使用方式：xxx.vue
@import 'css/xxx.scss'
<style lang='scss' scoped><style>

variables.styl预编译

// 安装模块：
// npm install --save-dev stylus
// npm install --save-dev stylus-loader
const stylusOptions = {
  import: [
    path.join(__dirname, "../src/assets/css/variables.styl")
  ]
}
return {
  stylus: generateLoaders('stylus', stylusOptions),
  styl: generateLoaders('stylus', stylusOptions)
}

// 使用方式：xxx.vue
@import 'css/xxx.styl'
<style lang='stylus' scoped><style>

src/main.js

初始 主文件

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

Vue.config.productionTip = false 

new Vue({
  el: '#app',
  router,
  components: {App},
  template: ''
})

详细 主文件

// 入口 
import router from './router'                     // 路由
import store from './store'                       // 状态
import api from './utility/api'                   // 接口
 
// 模块 
import axios from 'axios'                         // 接口调用
import 'babel-polyfill'                           // ie9和一些低版本的浏览器对es6新语法的不支持问题
import fastClick from 'fastclick'                 // 延迟300毫秒
import VueAwesomeSwiper from 'vue-awesome-swiper' // 图片轮播
import BScroll from 'better-scroll'               // 拖动插件
 
// 公用样式 
import 'css/reset.css'                            // 重置
import 'css/common.css'                           // 公共
import 'css/border.css'                           // 1像素边
import 'css/iconfont.css'                         // 文字图标
import 'swiper/dist/css/swiper.css'               // 图片轮播

// 公用组件 
import Fade from '@/pages/common/fade'            // 显隐过渡
import Gallery from '@/pages/common/gallery'      // 画廊
Vue.component('c-fade', Fade)
Vue.component('c-gallery', Gallery)
 
// 全局调用 
Vue.use(VueAwesomeSwiper)                         
Vue.prototype.$scroll = BScroll
Vue.prototype.$http = axios
Vue.prototype.$api = api

fastClick.attach(document.body)                   // 为消除移动端浏览器，从物理触摸到触发点击事件之间的300ms延时的问题

Vue.config.productionTip = false                  // 设置为 false 以阻止 vue 在启动时生成生产提示 

// 创建Vue 
new Vue({
  el: '#app',
  router,
  store,
  components: {App},
  template: '<App/>'
})

src/App.vue

vue入口文件
keep-alive数据缓存

<keep-alive :exclude="exclude">
  <router-view/>
</keep-alive>
data(){
  return {
    exclude: [
      'Detail'
    ]
  }
}

用法

// 1、如不填，则缓存全部组件
// 2、keep-alive include="City"，缓存name='City'的组件
// 3、keep-alive exclude="Detail"，不缓存name='Detail'的组件

生命周期

// 当时用keep-alive的时候，会触发activated和deactivated生命周期
// activated 当组件被激活的时候调用
// deactivated 当组件被移除的时候调用

src/router/index.js

路由文件人口
初始 文件

import Vue from 'vue'
import Router from 'vue-router'
import Home from '@/pages/home/home'

export default new Router({
  routes: [
    {
      path: '/home',
      component: Home
    }
  ]
)}

详细 文件

import Vue from 'vue'
import Router from 'vue-router'
import Home from '@/pages/home/home'

const path = {
  home: '/'
}

const router = new Router({

  // 路由和组件渲染 
  routes: [
    {
      path: path.home,
      component: Home
    }
  ],
  
  // 路由"#"号去除 
  mode: 'history',
  
  // 当前路由添加.active
  linkActiveClass: 'active',
  linkExactActiveClass: 'active',
  
  // 切换路由时界面始终显示顶部 
  scrollBehavior(to, from, savePosition){
    return {
      x: 0,
      y: 0
    }
  } 
  
)}

export default router

src/store/index.js

状态管理文件入口：index.js

// 状态管理 
import Vue from 'vue'
import Vuex from 'vuex'
import state from './state'
import mutations from './mutations'
import actions from './actions'

Vue.use(Vuex)
export default new Vuex.Store({
  state,
  mutations,
  actions
})

第一步 引入state.js

// state.js 
let defaultCity = {
  id: 1,
  spell: 'beijing',
  name: '北京'
}
if(localStorage.city){
  defaultCity = JSON.parse(localStorage.city) // 字符串转对象
}
const state = {
  city: defaultCity
}
export default state

第二步 引入mutations.js

// mutations.js 
const mutations = {
  changeCity(state, payload){
    state.city = payload
    localStorage.city = JSON.stringify(payload) // 当为对象是，要转字符串
  }
}
export default mutations

第三步 引入actions.js

// actions.js 
const actions = {
  changeCity(context, payload){
    context.commit('changeCity', payload)
  }
}
export default actions

第四步 vue文件使用vuex

// xxx.vue 
// template部分：
<div @click="handleClick(item)">{{city}}</div>

// script部分：
import { mapState, mapActions} from 'vuex'
export default {
  computed: {
    ...mapState(['city'])
  },
  methods: {
    ...mapActions(['changeCity'])
    handleClick(city){}
      this.changeCity(city)
    }
  }
}

axios

$http调用接口
全局调用

 
// 修改main.js文件
Vue.prototype.$http = axios
// xxx.vue文件：
this.$http
    .get('/api/index.json', {
      params: {...}
    })
    .then(
      fn(data)
    ).catch(
      fn(data
    ));

局部调用

// xxx.vue文件：
import axios from 'axios'
axios.get('/api/index.json')
     .then(
       fn(data)
     )
     .catch(
       fn(data)
     );

示例

getHomeData() {
  this.$http
    .get(this.$api.home, {
      params: {
        name: this.city.name
      }
    })
    .then(res => {
      let resData = res.data;
      if (resData.ret && resData.data) {
        let data = resData.data
        this.bannerList = data.bannerList
        this.iconList = data.iconList
        this.likeList = data.recommendList
        this.weekendList = data.weekendList
      }
    })
    .catch((err) => {
      console.log(err)
    })
}

移动端

缩放比例

// 修改文件：index.html
<meta minimum-scale=1.0, maximum-scale=1.0, user-scalable=no>
<meta width="device-width,
            height=device-height,
            initial-scale=1.0,
            minimum-scale=1.0,
            maximum-scale=1.0,
            user-scalable=no">

移动端初始配置

// 移动端访问 
// 修改package.json文件：--host 0.0.0.0
// mac查看ip： ifconfig
// windows查看ip： ipconfig
// 手机访问地址： ip地址:7000

初始化

// 初始化样式 reset.css 
// 1px像素设备不一致 borer.css 
import 'css/common.css'                           // 公共
import 'css/border.css'                           // 1像素边

延迟300ms

// 模块 fastclick 解决移动端事件延迟300ms 
// main.js文件加入：
import fastClick from 'fastclick'                 // 延迟300毫秒
fastClick.attach(document.body)

iconfont

文字图标

// 网址 http://www.iconfont.cn  
// 步骤 
// 选择图标加入购物车 →
// 添加到项目 →
// 下载到本地 →
// 字体和css复制到项目 →
// 更改iconfont目录和删除代码 →

// 引入iconfont.css →
<span class="iconfont user-icon">&#x e624;><span>

better-scroll

拖动使界面滚动
全局

// 修改main.js文件：
import BScroll from 'better-scroll'
Vue.prototype.$scroll= BScroll
xxx.vue文件：
mounted() {
  this.scroll = new this.$scroll(elevent); // element为dom或$refs
},

局部

// xxx.vue文件：
import BScroll from 'better-scroll'
this.scrolll = new BScroll(this.$refs.wrapper)
// 定位到某个元素 this.scroll.scrollToElement(element)

vue-awesome-swiper

图片轮播

// 网址 https://www.swiper.com.cn/ 
// 步骤 
// 安装模块 vue-awesome-swiper 轮播插件(2.6.7)

// 修改main.js：
import "swiper/dist/css/swiper.css"
Vue.use(VueAwesomeSwiper)
xxx.vue文件：

<swiper :options="swiperOption" v-if="hasBanner">
  <swiper-slide v-for="item in list">
    <img :src="item.imgUrl">
  </swiper-slide>
  <div class="swiper-pagination" slot="pagination"></div>
</swiper>

swiperOption: {
  pagination: '.swiper-pagination',
  autoplay: 3000,
  paginationType: 'fraction',
  loop: true
}

router-link

路由链接

// router-link组件的active设置 
// 全局设置：
export default new VueRouter({
  linkActiveClass: 'active',
  linkExactActiveClass: 'active',
  routes : [
    ... 省略
  ]
});

// 局部设置：
<router-link :to="'home'" tag="li" active-class="active" exact-active-class="active" exact><标题router-link>
// 加上exact 则遵循路由完全一致模式，该路由下的路径不匹配 
// 标准 <router-link :to="'/detail?name=' + item.name" tag="div"></router-link> 
// 路由跳转 this.$router.push('/')、this.$router.replace('/')

fade

过渡动画

// template 
<transition>
  <slot></slot>
</transition>
 
// style 
<style lang="stylus" scoped>
.v-enter, .v-leave-to
  opacity 0
.v-enter-active, .v-leave-active
  transition opacity .5s
</style>

// name 
name="fade"
.fade-enter

touch

拖动事件

// touchstart/touchmove 
<div
  class="letter"
  @click="handleClickLetter"
  @touchstart.prevent="handleTouchStart"
  @touchmove="handleTouchMove"
  ref="letter">
  <div class="letter-cont" ref="letterCont">
    <span
      class="letter-item"
      v-for="item in list"
      :key="item">{{item}}</span>
  </div>
</div>
methods: {
  handleClickLetter(e) {
    const letter = e.target.innerHTML
    this.$emit('change', letter)
  },
  handleTouchStart() {
    this.letterHeight = this.$refs.letterCont.clientHeight / this.letterLen
    this.letterOffsetTop = this.$refs.letter.offsetTop + this.$refs.letterCont.offsetTop
  },
  handleTouchMove(e) {
    let touchY = e.touches[0].clientY
    let letterScope = (touchY - this.letterOffsetTop) / this.letterHeight
    if (letterScope > 0 && letterScope < this.letterLen) {
      if (this.timer) clearTimeout(this.timer)
        this.timer = setTimeout(() => {
        this.letterIndex = Math.floor(letterScope)
      }, 16)
    }
  }
}

其他

组件里name的作用

// 1、递归组件会用到
// 2、取消缓存的时候会用到
// 3、浏览器vue插件显示组件的时候用到

子父组件传值

// 子组件：
handleClick(){
  this.$emit('change', value)
}

// 父组件：
<component @change="handleClick"></component>
handleClick(){}

$refs

// this.$refs.msg 普通元素,引用指向dom：
<div ref='msg'>Hello, world<div>

// this.$refs.child 组件，引用指向组件实例：
<c-child ref='child'>Hello, world<c-child>

$route获取url数据

// 1. /detail/:id
// /detail/1389435894
this.$route.params.id

// 2. /detail
// /detail?id=1389435894
this.route.query.id

利用setTimeout节流

if(this.timer) clearTimeout(timer);
this.timer = setTimeout(()=>{
  console.log(''xxx')
}, 16);

滚动监听

// 1.
window.onscroll = this.handleScroll
// 2.
window.addEventListener('scroll', this.handleScroll)

浏览器cookie

localStorage.city = city
localStorage.clear()
本文含有隐藏内容，请 开通VIP 后查看

网站公告

今日签到

点亮在社区的每一天
去签到

热门文章

最新发布