├── node_modules
├── public
│   ├── favicon.ico：页签图标
│   └── index.html：主页面
├── src
│   ├── assets：存放静态资源
│   │   └── logo.png
│   ├── component：存放组件
│   │   └── HelloWorld.vue
│   ├── App.vue：汇总所有组件
│   └── main.js：入口文件
├── .gitignore：git版本管制忽略的配置
├── babel.config.js：babel的配置文件
├── package.json：应用包配置文件
├── REMDME.md：应用描述文件
└── package-lock.json：包版本控制文件

• vue.js 与 vue.runtime.xxx.js 的区别：
  (1).vue.js 是完整版的 Vue，包含：核心功能+模板解析器。
  (2).vue.runtime.xxx.js 是运行版的 Vue，只包含：核心功能；没有模板解析器
• 因为 vue.runtime.xxx.js 没有模板解析器，所以不能使用 template 配置项，需要使用 render 函数接收到的 createElement 函数去指定具体内容。

new Vue({
  el: "#app",
  render: (h) => h("App"),
  /* render(createElement) {
    return createElement("h1", "你好");
  }, */

  // template: `<h1>你好</h1>`
});

使用 vue inspect > out.js 可以查看到 Vue 脚手架的默认配置。
使用 vue.config.js 可以对脚手架进行个性化定制，详情见：https://cli.vuejs.org/zh

1.被用来给元素或子组件注册引用信息（id的替代者）
2.应用在html标签上获取的是真实DOM元素，应用在组件标签上是组件实例对象（vc）
3.使用方式：
    打标识：<h1 ref="xxx">......</h1> 或 <School ref="xxx"></School>
    获取：this.$refs.xxx

功能：让组件接收外部传过来的数据
    (1).传递数据
        <Demo name="xxx"/>
    (2).接收数据：
        第一种方式（只接收）
            props:['name']

        第二种方式（限制类型）：
            props:{
                name:Number
            }

        第三种方式（限制类型、限制必要性、指定默认值）：
            props:{
                name:{
                    type:String, //类型
                    required:true, //必要性
                    default:'老王' //默认值
                }
            }
备注：props是只读的，Vue底层会检测你对props的修改，如果进行了修改，就会发出警告，若业务需求确实需要修改，那么请赋值props的内容到data中一份，然后去修改data中的数据。

功能：可以把多个组件公用的配置提取成一个混入对象
使用方式：
    第一步定义混合，例如：
        {
            data(){......},
            methods:{......}
            ......
        }
    第二部使用混入 ，例如：
        (1).全局混入：Vue.mixin(xxx)
        (2).局部混入：mixins:['xxx']

功能：用于增强Vue
本质：包含install方法的一个对象，install的第一个参数是Vue，第二个以后的参数是插件使用者传递的数据。
定义插件：
    对象.install = function(Vue, options) {
        //添加全局过滤器
        Vue.filter(......)

        //2.添加全局指令
        Vue.directive(......)

        //3.配置全局混入
        Vue.mixin(......)

        //4.添加实例方法
        Vue.prototype.$myMethod = function() {......}
        Vue.prototype.$myProperty = xxx
    }
    使用插件：Vue.use()

作用：让样式在局部生效，防止冲突。
写法：<style scoped>

1. 组件化编码流程：

(1).拆分静态组件：组件要按照功能点拆分，命名不要与 html 冲突。 (2).实现动态组件：考虑好数据的存放位置，数据是一个组件在用，还是一些组件在用：

	1).一个组件在用：放在组件自身即可。
	2).一些组件在用：放在他们共同的父组件上(<font style="color:red">状态提升</font>)。

(3).实现交互：从绑定事件开始。

2. props 适用于：

(1).父组件 ==> 子组件 通信 (2).子组件 ==> 父组件 通信 (要求父先给子一个函数)

3. 使用 v-model 时要切记：v-model绑定的值不能是props传过来的值，因为props是不可以被修改的！

4. props传过来的若是对象类型的值，修改对象中的属性时 Vue 不会报错，但不推荐这样做。

1. 一种组件间通信的方式，适用于：子组件 ===> 父组件

2. 使用场景：A 是父组件，B 是子组件，B 想给 A 传数据，那么就要在 A 中给 B 绑定自定义事件（事件的回调在 A 中）。

3. 绑定自定义组件：

   1. 第一种方式，在父组件中：<Demo @atguigu="test" />或<Demo v-on:atguigu="test" />

   2. 第二种方式，在父组件中：

      <Demo ref="demo" />
      ......
      mounted(){
      	this.$refs.demo.$on('atguigu',this.test)
      }

   3. 若要让自定义事件只能触发一次，可以使用once修饰符，或$once方法。

4. 触发自定义事件：this.$emit('atguigu',数据)

5. 解绑自定义事件：this.$off('atguigu')或this.$off(['atguigu','demo'])

6. 组件上也可以绑定原生 DOM 事件，需要使用 native 修饰符。

7. 注意：通过this.$refs.xxx.$on('atguigu',回调)绑定自定义事件时，回调要么配置在 methods 中，要么用箭头函数，否则 this 指向会出问题！

1. 一种组件间通信的方式，适用于任意组件间通讯。
2. 安装全局事件总线：

    new Vue({
        ......
        beforeCreate() {
            Vue.prototype.$bus = this //安装全局事件总线，$bus就是当前应用的vm
        },
        ......
    })

3. 使用事件总线：

1. 接收数据：A 组件想接收数据，则在 A 组件中给$bus 绑定自定义事件，事件的回调留在 A 组件自身

methods(){
 demo(data){......}
}
......
mounted(){
 this.$bus.$on('xxxx',this.demo)
}

2. 提供数据：this.$bus.$emit('xxxx',数据)

4. 最好在 beforeDestroy 钩子中，用$off去解绑当前组件所用到的事件。

1. 一种组件间通信的方式，适用于在任意组件间通信。

2. 使用步骤：

1. 安装 pubsub:npm i pubsub-js

2. 引入：import pubsub from 'pubsub-js'

3. 接收数据：A 组件想接收数据，则在 A 组件中订阅消息，订阅的回调留在 A 组件自身。

   methods(){
     demo(data){......}
   }
   ......
   mounted(){
     this.pid = pubsub.subscribe('xxx',this.demo) //订阅消息
   }

4. 提供数据：pubsub.publish('xxx',数据)

5. 最好在 beforeDestroy 钩子中，用pubsub.unsubscribe(pid)去取消订阅。

1. 语法：this.$nextTick(回调函数)

2. 作用：在下一次 DOM 更新循环结束后执行其指定的回调。

3. 什么时候用：当改变数据后，要基于更新后的新 DOM 进行某些操作时，要在nextTick所指定的回调函数中执行。

1. 作用：在插入、更新或移除 DOM 元素时，在适合的时候给元素添加样式类名。

2. 图示：

3. 写法：

   1. 准备好样式：
   • 元素进入的样式：
   1. v-enter：进入的起点
   1. v-enter-active：进入的过程中
   1. v-enter-to：进入的终点
   
   • 元素离开的样式：
   1. v-leave：离开的起点
   1. v-leave-active：离开的过程中
   1. v-leave-to：离开的终点
   
   1. 使用<transition>包裹要过度的元素，并配置 name 属性：

    <transition name="hello">
        <h1 v-show="isShow">你好啊！</h1>
    </tranision>

   3. 备注：若有多个元素需要过度，则需要使用：<transition-group>，且每个元素都要指定key值。

在 vue.config.js 中添加如下配置：

devServer: {
  proxy: "http://localhost:5000";
}

说明：

1. 优点：配置简单，请求资源时直接发给前端（8080）即可。

2. 缺点：不能配置多个代理，不能灵活的控制请求是否走代理。

3. 工作方式：若按照上述配置代理，当请求了前端不存在的资源时，name 该请求会转发给服务器（优先匹配前端资源）

编写 vue.config.js 配置具体代理规则：

module.exports = {
  devServer: {
    proxy: {
      "/api": {
        //匹配所有以'/api'开头的请求路径
        target: "http://localhost:5000", //代理目标的基础路径
        changeOrigin: true,
        pathRewrite: { "^/api": "" },
      },
      "/api2": {
        //匹配所有以'/api2'开头的请求路径
        target: "http://localhost:5001", //代理目标的基础路径
        changeOrigin: true,
        pathRewrite: { "^/api2": "" },
      },
    },
  },
};
/*
    changeOrigin设置为true时，服务器收到的请求头中的host为：localhost:5000
    changeOrigin设置为false时：服务器中收到的请求头中的host为：localhost:8080
    changeOrigin默认值为true
*/

说明：

1. 优点：可以配置多个代理，且可以灵活的控制请求是否走代理。

2. 配置略微繁琐，请求资源必须加前缀。

1. 作用：让父组件可以向子组件指定位置插入 html 结构，也是一种组件间通信的方式，适用于父组件 ===> 子组件。

2. 分类：默认插槽、具名插槽、作用域插槽

3. 使用方式：

   1. 默认插槽：

   父组件中：
   <Category>
               <div>html结构1</div>
           </Category>
   
   子组件中：
   <template>
     <div>
       <!-- 定义插槽 -->
       <slot>插槽默认内容...</slot>
     </div>
   </template>

   2. 具名插槽：

   父组件中：
   <Category>
               <template slot="center">
                   <div>html结构1</div>
               </template>
     
               <template slot="footer">
                   <div>html结构2</div>
               </template>
           </Category>
   
   子组件中：
   <template>
     <div>
       <!-- 定义插槽 -->
       <slot name="center">插槽默认内容...</slot>
       <slot name="footer">插槽默认内容...</slot>
     </div>
   </template>

   3. 作用域插槽

      1. 理解数据在组件的自身，但根据数据生成的结构需要组件的使用者来决定。（games 数据在 Category 组件中，但使用数据所遍历出来的结构由 App 组件决定）

      2. 具体编码：

   父组件中：
   <Category>
               <template scope="scopeData">
                   <!-- 生成的是ul列表 ->
                   <ul>
                       <li v-for="g in scopeData.game" :key="g>{{g}}</li>
                   </ul>
   			</template>
           </Category>
   
   <Category>
               <template scope="scopeData">
                   <!-- 生成的是h4标题 ->
                   <h4 v-for="g in scopeData.game" :key="g>{{g}}</h4>
   			</template>
           </Category>
   
   子组件中：
   <template>
     <div>
       <slot :games="games"></slot>
     </div>
   </template>
   
   <script>
   export default {
     name: "Category",
     props: ["title"],
     //数据在子组件自身
     data() {
       return {
         games: ["红色警戒", "穿越火线", "劲舞团", "超级玛丽"],
       };
     },
   };
   </script>

在Vue中实现集中式状态（数据）管理的一个Vue插件，对vue应用中多个组件的共享状态进行集中式的管理（读/写），也是一种组件间通信的方式，且适用于任意组件间通信。

多个组件需要共享数据时

1. 创建文件：src/store/index.js

   //引入Vue核心库
   import Vue from "vue";
   //引入Vuex
   import Vuex from "vuex";
   //应用Vuex插件
   Vue.use(Vuex);
   
   //准备actions对象——响应组件中用户的动作
   const actions = {};
   //准备mutations对象——修改state中的数据
   const mutations = {};
   //准备state对象——保存具体的数据
   const state = {};
   
   //创建并暴露store
   export default new Vuex.Store({
     actions,
     mutations,
     state,
   });

2. 在main.js中创建 vm 时传入store配置项

    ......
    //引入store
    import store from './store'
    ......
   
    //创建vm
    new Vue({
        el: '#app',
        render: h => h(App),
        store
    })

1. 初始化数据，配置actions、配置mutations，操作文件store.js

   //引入Vue核心库
   import Vue from "vue";
   //引入Vuex
   import Vuex from "vuex";
   //使用Vuex
   Vue.use(Vuex);
   
   const actions = {
     //响应组件中加的动作
     jia(context, value) {
       //console.log('actions中的jia被调用了',context,value)
       context.commit("JIA", value);
     },
   };
   
   const mutations = {
     //执行加
     JIA(state, value) {
       //console.log('mutations中的JIA被调用了'state,value)
       state.sum += value;
     },
   };
   
   //初始化数据
   const state = {
     num: 0,
   };
   
   //创建并暴露store
   export default new Vuex.Store({
     actions,
     mutations,
     state,
   });

2. 组件中读取 vuex 中的数据：$store.state.sum

3. 组件中修改 vuex 中的数据：$store.dispatch('action中的方法名',数据)或$store.commit('mutations中的方法名',数据)

备注：若没有网络请求或其他业务逻辑，组件中也可以越过 actions，即不写dispatch，直接编写commit

1. 概念：当 state 中的数据需要经过加工后再使用时，可以使用 getters 加工。

2. 在store.js中追加getters配置

   const getters = {
       bigSum(state) {
           return state.sum * 10
       }
   }
   
   //创建并暴露store
   export default new Vuex.Store({
       ......
       getters
   })

3. 组件中读取数据：$store.getters.bigSum

1. mapState 方法：用于帮助我们映射state中的数据为计算属性

    computed:{
        //借助mapState生成计算属性：sum、school、subject（对象写法）
        ...mapState({sum:'sum',school:'school',subject:'subject'}),
   
        //借助mapState生成计算属性：sum、school、subject（数组写法）
        ...mapState(['sum','school','subject']),
    }

2. mapGetters 方法：用于帮助我们映射getters中的数据为计算属性

    computed:{
        //借助mapGetters生成计算属性：bigSum（对象写法）
        ...mapGetters({bigSum:'bigSum'}),
   
        //借助mapGetters生成计算属性：bigSum（数组写法）
        ...mapGetters(['bigSum'])
    }

3. mapActions 方法：用于帮助我们生成与actions对话的方法，即：包含$store.dispatch(xxx)的函数

   methods:{
       //靠mapActions生成：incrementOdd、incrementWait（对象方式）
       ...mapActions({incrementOdd:'jiaOdd',incrementWait:'jiaWait'})
   
       //靠mapActions成成：incrementOdd、incrementWait（数组方式）
       ...mapActions(['jiaAdd','jiaWait'])
   }

4. mapMutations 方法：用于帮助我们生成与mutations对话的方法，即：包含$store.commit(xxx)的函数

   //靠mapMutations生成：increment、decrement（对象方式）
   ...mapMutations({increment:'JIA',decrement:'JIAN'}),
   
   //靠mapMutations生成：increment、decrement（数组方式）
   ...mapMutations(['JIA','JIAN']),

备注：mapActions 与 mapMutations 使用时，若需要传递参数 需要：在模板中绑定事件时传递好参数，否则参数是事件对象。

1. 目的：让代码更好维护，让多种数据分类更加明确。

2. 修改store.js

   const countAbout = {
       namespaced: true,//开启命名空间
       state: {x:1},
       mutations: { ... },
       actions: { ... },
       getters: {
           bigSum(state) {
               return state.sum * 10
           }
       }
   }
   
   const personAbout = {
       namespaced: true,//开启命名空间
       state: { ... },
       mutations: { ... },
       actions: { ... }
   }
   
   const store = new Vuex.Store({
       modules: {
           countAblut,
           personAbout
       }
   })

3. 开启命名空间后，组件中读取 state 数据：

    //方式一：自己直接读取
    this.$store.state.personAbout.list
    //方式二：借助mapState读取
    ...mapState('countAbout',['sum','school','subject']),

4. 开启命名空间后，组件中读取 getters 数据

    //方式一：自己直接读取
    this.$store.getters['personAbout/firstPersonName']
    //方式二：借助mapGetters读取
    ...mapGetters('countAbout',['bigSum']),

5. 开启命名空间后，组件中调用 dispatch

    //方式一：自己直接dispatch
    this.$store.dispatch('personAbout/addPersonWang',person)
    //方式二：借助mapActions
    ...mapActions('countAbout',{incrementOdd:'jiaOdd', incrementWait:'jiaWait'})

6. 开启命名空间后，组件中调用 commit

   //方式一：自己直接commit
   this.$store.commit('personAbout/ADD_PERSON',person)
   //方式二：借助mapMutations:
   ...mapMutations('personAbout',{increment:'JIA', decrerment:'JIAN'})

1. 理解：一个路由（route）就是一组映射关系（key-value），多个路由需要路由器（router）进行管理。

2. 前端路由：key 是路径，value 是组件。

1. 安装 vue-router，命令：npm i vue-router

2. 应用插件：Vue.use(VueRouter)

3. 编写 router 配置项：

   import Vue from 'vue'
   //引用VueRouter
   import VueRouter from "vue-router";
   
   Vue.use(VueRouter);
   
   //引入Luyou组件
   import About from "../components/About";
   import Home from "../components/Home";
   
   //创建router实例对象，去管理一组一组的路由规则
   const router = new VueRouter({
     routes: [
       {
         path: "/about",
         component: About,
       },
       {
         path: "/home",
         component: Home,
       },
       {
   	  path: '/search',
         component: () => '../components/Search'
         // 路由元信息
         meta: {
           title: '查询'
         }
       }
     ],
   });
   
   //暴露router
   export default router;

4. 实现切换（active-class 可配置高亮样式）

   <router-link sctive-class="sctive" to="/about">
     About
   </router-link>

5. 指定展示的位置

   <router-view></router-view>

1. 路由组件通常存放在pages文件夹，一般组件存放在components文件夹。

2. 通过切换，“隐藏”了的路由组件，默认是被销毁掉的，需要的时候再去挂载。

3. 每个组件都有自己的$route属性，里面存储着自己的路由信息。

4. 整个应用只有一个 router，可以通过组件的$router属性获取到。

1. 配置路由规则，使用 children 配置项：

   routes: [
     {
       path: "/about",
       component: About,
     },
     {
       path: "/home",
       component: Home,
       children: [
         //通过children配置子集路由
         {
           path: "news", //此处一定不要写：/news
           component: News,
         },
         {
           path: "message", //此处一定不要写：/message
           commponent: Message,
         },
       ],
     },
   ];

2. 跳转（要写完整路径）：

   <router-link to="/home/news">News</router-link>

1. 传递参数

   <!-- 跳转并携带query参数，to的字符串写法 -->
   <router-link :to="/home/message/detail?id=666&title=你好">跳转</router-link>
   
   <!-- 跳转并携带query参数，to的对象写法 -->
   <router-link
     :to="{
           path:'/home/message/detail',
           query:{
               id:666,
               title:'你好'
           }
       }"
     >跳转</router-link
   >
   
   this.$router.push(`/search?keyWords=${this.keyWords}`)

2. 接收参数：

   $route.query.id;
   $route.query.title;

1. 作用：可以简化路由的跳转。

2. 如何使用

   1. 给路由命名：

   {
      path:'demo',
      component:Demo,
      children:[
          {
              path:'test',
              component:Test,
              children:[
                  {
                      name:'hello',
                      path:'welcome',
                      component:Hello
                  }
              ]
          }
      ]
   }

   2. 简化跳转

   <!-- 简化前，需要写完整的路径 -->
   <router-link to="/demo/test/welcome">跳转</route-link>
   
   <!-- 简化后，直接通过名字跳转 -->
   <router-link :to="{name:'hello'}">跳转</router-link>
   
   <!-- 简化写法配合传递参数 -->
   <router-link
       :to="{
           name:'hello',
           query:{
               id:666,
               title:'你好'
           }
       }"
   >跳转</router-link>

1. 配置路由，声明接收 params 参数

   {
       path:'/home',
       component:Home,
       children:[
           {
               path:'news',
               component:News
           },
           {
               path:'message/:id?', // ?：这个参数可传可不传
               component:Message,
               children:[
                   {
                       name:'xiangqing',
                       path:'detail/:id/:title', //使用占位符声明接收params参数
                       component:Detail
                   }
               ]
           }
       ]
   }

2. 传递参数

   <!-- 跳转并携带params参数，to的字符串写法 -->
   <router-link :to="/home/message/detail/666/你好">跳转</router-link>
   
   <!-- 跳转并携带params参数，to的对象写法 -->
   <router-link
     :to="{
           name:'xiangqing',
           params:{
               id:666,
               title:'你好'
           }   
       }"
     >跳转</router-link
   >

特别注意：路由携带 params 参数时，若使用 to 的对象写法，则不能使用 path 配置项，必须使用name配置！

3. 接收参数:

   $route.params.id;
   $route.params.title;

作用：让路由组件更方便的收到参数

{
    name:'xiangqing',
    path:'detail/:id',
    component:Detail,

    // 第一种写法：props值为对象，该对象中所有的key-value的组合最终都会通过props传给Detail组件
    // props:{a:900}

    // 第二种写法：props值为布尔值，布尔值为true，则把路由收到的所有params参数通过props传给Detail组件
    // props:true

    // 第三种写法：props值为函数，该函数返回的对象中每一组key-value都会通过props传给Detail组件
    props($route){
        return {
            id:$route.query.id,
            title:$route.query.title
        }
    }
}

1. 作用：控制路由跳转时操作浏览器历史记录的模式

2. 浏览器的历史记录有两种写入方式：分别为push和replace，push是追加历史记录，replac是替换当前记录。路由跳转时候默认为push

3. 如何开启replace模式：<router-link replace ......>News</router-link>

1. 作用：不借助<router-link>实现路由导航，让路由导航更加灵活

2. 具体编码：

   this.$router.push({
     name: "Search",
     query: {
       keyWords: this.keyWords,
     },
   });
   
   //$router的两个API
   this.$router.push({
     name: "xiangqing",
     params: {
       id: xxx,
       title: xxx,
     },
   });
   
   this.$router.replace({
     name: "xiangqing",
     params: {
       id: xxx,
       title: xxx,
     },
   });
   
   this.$router.back(); //后退
   
   this.$router.forward(); //前进
   
   this.$router.go(); //可前进也可后退

3. 传递参数：

   // 第一种：字符串形式
   // this.$router.push('/search/' + this.keyWords + '?keyWords=' + this.keyWords)
   // 第二种：模板字符串
   // this.$router.push(`/search/${this.keyWords}?keyWords=${this.keyWords}`)
   // 第三种：对象写法
   this.$router.push({
     name: "Search",
     params: {
       keyWords: this.keyWords,
     },
     query: {
       keyWords: this.keyWords,
     },
   });

1. 作用：让不展示的路由组件保持挂载，不被销毁

2. 具体编码：

<keep-alive include="News">
  <router-view></router-view>
</keep-alive>

1. 作用：路由组件所独有的两个钩子，用于捕获路由组件的激活状态。

2. 具体名字：

   1. activated路由组件被激活时触发。

   2. deactivated路由组件失活时触发。

1. 作用：对路由进行权限控制

2. 分类：全局守卫、独享守卫、组件内守卫

3. 全局守卫

   //全局前置守卫：初始化时执行、每次路由切换前执行
   router.beforeEach((to, from, next) => {
     console.log("beforeEach", to, from);
     if (to.meta.isAuth) {
       //判断当前路由是否需要进行权限控制
       if (localStorage.getItem("school") === "atguigu") {
         //权限控制的具体规则
         next(); //放行
       } else {
         alert("暂无权限查看");
         // next({name: 'guanyu'})
       }
       next(); //放行
     } else {
       next(); //放行
     }
   });
   
   //全局后置路由守卫：初始化时执行、每次切换后执行
   router.afterEach((to, from) => {
     console.log("acterEach", to, from);
     if (to.meta.title) {
       focument.title = to.meta.title;
     } else {
       document.title = "vue_test";
     }
   });

4. 独享守卫

   beforeEnter(to,from,next){
       console.log('beforeEnter',to,from)
       if(to.meta.isAuth){
           next()
       } else {
           alert('暂无权查看')
           next({name:'guanyu'})
       }
   }
   

5. 组件内路由

   //进入守卫：通过路由规则，进入该组件时被调用
   beforeRouteEnter(to,from,next){
   },
   //离开守卫：通过路由规则，离开该组件时被调用
   beforeRouteLEave(to,from,next){
   }
   

1. 对于一个 url 来说，什么是 hash 值？————#及其后面的内容就是 hash 值。

2. hash 值不会包含在 HTTP 请求中，即：hash 值不会带给服务器。

3. hash 模式：

   1. 地址中永远带着#号，不美观。

   2. 若以后将地址通过第三方手机 app 分享，若 app 校验严格，则地址会被标记为不合法。

   3. 兼容性较好。

4. history 模式：

   1. 地址干净，美观。

   2. 兼容性和 hash 模式相比略差。

   3. 应用部署上线时需要后端人员支持，解决刷新页面服务器端 404 的问题。