前端Vue项目——初始化及导航栏

时间:2024-01-24 21:22:46

一、项目初始化

  创建webpack模板项目如下所示:

MacBook-Pro:PycharmProjects hqs$ vue init webpack luffy_project

? Project name luffy_project
? Project description A Vue.js project
? Author hqs
? Vue build standalone
? Install vue-router? Yes
? Use ESLint to lint your code? No
? Set up unit tests No
? Setup e2e tests with Nightwatch? No
? Should we run `npm install` for you after the project has been created? (recommended) npm

   vue-cli · Generated "luffy_project".

  根据提示启动项目:

$ cd luffy_project/
$ npm run dev

  由于在初始化时选择了vue-router,因此会自动创建/src/router/index.js文件。

  删除Helloworld组件相关信息后,index.js文件内容如下所示:

import Vue from \'vue\'
import Router from \'vue-router\'
// @绝对路径 检索到 ...src/

// 如果Router当做局部模块使用一定要Vue.use(Router)
// 以后在组件中,可以通过this.$router 获取Router实例化对象
// 路由信息对象 this.$routes 获取路由配置信息
Vue.use(Router)

// 配置路由规则
export default new Router({
  routes: [
    {
\'path\': \'/\'
} ] })

二、基于ElementUI框架实现导航栏

1、elementUI——适合Vue的UI框架

  elementUI是一个UI库,它不依赖于vue,但确是当前和vue配合做项目开发的一个比较好的UI框架。

(1)npm安装

  推荐使用 npm 的方式安装,能更好地和 webpack 打包工具配合使用。

$ npm i element-ui -S

(2)CDN

  目前可以通过 unpkg.com/element-ui 获取到最新版本的资源,在页面上引入 js 和 css 文件即可开始使用。

<!-- 引入样式 -->
<link rel="stylesheet" href="https://unpkg.com/element-ui/lib/theme-chalk/index.css">
<!-- 引入组件库 -->
<script src="https://unpkg.com/element-ui/lib/index.js"></script>

  使用CND引入 Element 需要在链接地址上锁定版本,以免将来 Element 升级时受到非兼容性更新的影响。锁定版本的方法请查看 unpkg.com

2、引入 Element

  在项目中可以引入整个Element,或者是根据需要仅引入部分组件。

(1)完整引入

  在 main.js 中写入如下内容:

import Vue from \'vue\'
import App from \'./App\'
import router from \'./router\'
// elementUI导入
import ElementUI from \'element-ui\'
import \'element-ui/lib/theme-chalk/index.css\'  // 注意样式文件需要单独引入
// 调用插件
Vue.use(ElementUI);

Vue.config.productionTip = false;

/* eslint-disable no-new */
new Vue({
  el: \'#app\',
  router,
  components: { App },
  template: \'<App/>\'
});

  以上代码便完成了 Element 的完整引入。

  尝试在App.vue使用elementui的Button按钮:

<template>
  <div id="app">
    <!-- 导航区域 -->
    <el-button type="info">信息按钮</el-button>

    <router-view/>
  </div>
</template>

<script>
export default {
  name: \'App\'
}
</script>

  显示效果:

   

(2)按需引入

  借助 babel-plugin-component,可以只引入需要的组件,以达到减小项目体积的目的。

  首先安装babel-plugin-component:

$ npm install babel-plugin-component -D

  然后将.babelrc文件修改如下:

{
  "presets": [["es2015", { "modules": false }]],
  "plugins": [
    [
      "component",
      {
        "libraryName": "element-ui",
        "styleLibraryName": "theme-chalk"
      }
    ]
  ]
}

  如果只希望引入部分组件,如Buttion何Select,那么需要在 main.js 中写如下内容:

import Vue from \'vue\';
import { Button, Select } from \'element-ui\';
import App from \'./App.vue\';

Vue.component(Button.name, Button);
Vue.component(Select.name, Select);
/* 或写为
 * Vue.use(Button)
 * Vue.use(Select)
 */

new Vue({
  el: \'#app\',
  render: h => h(App)
});

3、导航栏实现

  首先创建/src/components/Common/LuffyHeader.vue文件:

<template>
  <!-- element-ui -->
  <el-container>
    <el-header height = \'80px\' >
      <div class="header">
        <div class="nav-left">
          <img src="https://www.luffycity.com/static/img/head-logo.a7cedf3.svg" alt="">
        </div>
        <div class="nav-center">
          <ul>
            <li>
              <a href="#">
                导航链接
              </a>
            </li>
          </ul>
        </div>
        <div class="nav-right">
          <span>登录</span>
          &nbsp;| &nbsp;
          <span>注册</span>
        </div>
      </div>
    </el-header>
  </el-container>
</template>

<script>
  export default {
    name: \'LuffyHeader\',
    data(){
      return {
      }
    },
  };
</script>

  再创建/static/global/global.css文件:

* {
  padding: 0;
  margin: 0;
}

body {
  font-size: 14px;
  color: #4a4a4a;
  font-family: PingFangSC-Light; /*苹果设计的一款全新的中文系统字体,该字体支持苹果的动态字体调节技术*/
}

ul {
  list-style: none;
}

a {
  text-decoration: none;
}

  在main.js中引入全局样式文件:

import Vue from \'vue\'
import App from \'./App\'
import router from \'./router\'
import ElementUI from \'element-ui\'
import \'element-ui/lib/theme-chalk/index.css\'     // 样式需要单独引入
import \'../static/global/global.css\'
import \'../static/global/gt.js\'

// 调用插件
Vue.use(ElementUI);

Vue.config.productionTip = false

  最后在App.vue中引入和使用组件:

<template>
  <div id="app">
    <!-- 导航区域 -->
    <LuffyHeader/>
    <router-view/>
  </div>
</template>

<script>
  import LuffyHeader from \'@/components/Common/LuffyHeader\'
  export default {
    name: \'App\',
    components:{
      LuffyHeader
    }
  }
</script>

  显示效果如下所示:

  

三、导航栏路由跳转

1、组件创建和路由配置编写

  添加“首页”、“免费课程”、“轻课”、“学位课”四大组件,因此创建如下文件:

src/components/Home/Home.vue
src/components/Course/Course.vue
src/components/LightCourse/LightCourse.vue
src/components/Micro/Micro.vue

  在src/router/index.js中引入组件,配置路由规则:

import Vue from \'vue\'
import Router from \'vue-router\'
// @绝对路径 检索到 ...src/

// 如果Router当做局部模块使用一定要Vue.use(Router)
// 以后在组件中,可以通过this.$router 获取Router实例化对象
// 路由信息对象 this.$routes 获取路由配置信息
import Home from \'@/components/Home/Home\'
import Course from \'@/components/Course/Course\'
import LightCourse from \'@/components/LightCourse/LightCourse\'
import Micro from \'@/components/Micro/Micro\'

Vue.use(Router)

// 配置路由规则
export default new Router({
  routes: [
    {
      path: \'/\',
      redirect: \'/home\'   // 访问/,直接跳转到/home路径
    },
    {
      path: \'/home\',
      name: \'Home\',
      component: Home
    },
    {
      path: \'/course\',
      name: \'Course\',
      component: Course
    },
    {
      path: \'/home/light-course\',
      name: \'LightCourse\',
      component: LightCourse
    },
    {
      path: \'/micro\',
      name: \'Micro\',
      component: Micro
    }
  ]
})

2、导航链接编写

  修改 LuffyHeader.vue页面,编写导航链接:

<template>
  <!-- element-ui -->
  <el-container>
    <el-header height = \'80px\' >
      <div class="header">
        <div class="nav-left">
          <img src="https://www.luffycity.com/static/img/head-logo.a7cedf3.svg" alt="">
        </div>
        <div class="nav-center">
          <ul>
            <li v-for="(list, index) in headerList" :key="list.id">
              <a href="#">
                {{ list.title }}
              </a>
            </li>
          </ul>
        </div>
        <div class="nav-right">
          <span>登录</span>
          &nbsp;| &nbsp;
          <span>注册</span>
        </div>
      </div>
    </el-header>
  </el-container>
</template>

<script>
  export default {
    name: \'LuffyHeader\',
    data() {
      return {
        headerList: [
          {id: \'1\', name: \'Home\', title: \'首页\'},
          {id: \'2\', name: \'Course\', title: \'免费课程\'},
          {id: \'3\', name: \'LightCourse\', title: \'轻课\'},
          {id: \'4\', name: \'Micro\', title: \'学位课程\'}
        ],
        isShow: false
      }
    }
  }
</script>

  编写headerList列表及列表中的导航对象,在 导航栏中遍历对象获取对应信息,显示在页面效果如下所示:

  

3、router-link路由跳转

  经过上面的编写,虽然导航栏已经可以正常显示,但是a标签是不会做自动跳转的。 需要使用 router-link 进一步改写LuffyHeader.vue,使得路由跳转得以渲染对应组件:

<template>
  <!-- element-ui -->
  <el-container>
    <el-header height = \'80px\' >
      <div class="header">
        <div class="nav-left">
          <img src="https://www.luffycity.com/static/img/head-logo.a7cedf3.svg" alt="">
        </div>
        <div class="nav-center">
          <ul>
            <li v-for="(list, index) in headerList" :key="list.id">
              <router-link :to="{name:list.name}">
                {{ list.title }}
              </router-link>
            </li>
          </ul>
        </div>
        <div class="nav-right">
          <span>登录</span>
          &nbsp;| &nbsp;
          <span>注册</span>
        </div>
      </div>
    </el-header>
  </el-container>
</template>

<script>
  export default {
    name: \'LuffyHeader\',
    data() {
      return {
        headerList: [
          {id: \'1\', name: \'Home\', title: \'首页\'},
          {id: \'2\', name: \'Course\', title: \'免费课程\'},
          {id: \'3\', name: \'LightCourse\', title: \'轻课\'},
          {id: \'4\', name: \'Micro\', title: \'学位课程\'}
        ],
        isShow: false
      }
    }
  }
</script>

  使用to=\'{name:list.name}\'设置命令路由,这样点击a标签就可以跳转了。显示效果如下所示:

  

  可以看到虽然点击了轻课,但是和其他导航项样式没有任何分别,需要设置路由active样式完成优化。

4、linkActiveClass设置路由的active样式

  linkActiveClass 全局配置 <router-link> 的默认“激活 class 类名”。

  active-class 设置 链接激活时使用的 CSS 类名。默认值可以通过路由的构造选项 linkActiveClass 来全局配置。

(1)在路由配置linkActiveClass

  在 src/router/index.js 中做如下配置:

import Vue from \'vue\'
import Router from \'vue-router\'
// @绝对路径 检索到 ...src/

// 如果Router当做局部模块使用一定要Vue.use(Router)
// 以后在组件中,可以通过this.$router 获取Router实例化对象
// 路由信息对象 this.$routes 获取路由配置信息
import Home from \'@/components/Home/Home\'
import Course from \'@/components/Course/Course\'
import LightCourse from \'@/components/LightCourse/LightCourse\'
import Micro from \'@/components/Micro/Micro\'

Vue.use(Router)

// 配置路由规则
export default new Router({
  linkActiveClass: \'is-active\',
  routes: [
    {
      path: \'/\',
      redirect: \'/home\'   // 访问/,直接跳转到/home路径
    },
    ......
    {
      path: \'/micro\',
      name: \'Micro\',
      component: Micro
    }
  ]
})

(2)在LuffyHeader.vue中配置路由active样式

<template>
  ......省略
</template>

<script>
  ......省略
</script>

<style lang="css" scoped>
  .nav-center ul li a.is-active{
    color: #4a4a4a;
    border-bottom: 4px solid #ffc210;
  }
</style>

(3)显示效果

  

5、hash模式切换为 history 模式

  vue-router 默认 hash 模式——使用URL的hash来模拟一个完整的URL,于是当URL改变时,页面不会重新加载。比如http://www.abc.com/#/indexhash值为#/indexhash模式的特点在于hash出现在url中,但是不会被包括在HTTP请求中,对后端没有影响,不会重新加载页面。

  如果不想要这种显示比较丑的hash,可以用路由的 history模式,这种模式充分利用 history.pushState API来完成URL跳转而无需重新加载页面。

(1)路由修改为history模式

  修改 src/router/index.js 文件如下所示:

import Vue from \'vue\'
import Router from \'vue-router\'
// @绝对路径 检索到 ...src/

// 如果Router当做局部模块使用一定要Vue.use(Router)
// 以后在组件中,可以通过this.$router 获取Router实例化对象
// 路由信息对象 this.$routes 获取路由配置信息
import Home from \'@/components/Home/Home\'
import Course from \'@/components/Course/Course\'
import LightCourse from \'@/components/LightCourse/LightCourse\'
import Micro from \'@/components/Micro/Micro\'

Vue.use(Router)

// 配置路由规则
export default new Router({
  linkActiveClass: \'is-active\',
  mode: \'history\',   // 改为history模式
  routes: [
    {
      path: \'/\',
      redirect: \'/home\'   // 访问/,直接跳转到/home路径
    },
    .....
  ]
})

  使用history模式时,url就像正常url,例如http://yoursite.com/user/id,这样比较美观。

  显示效果如下所示:

  

(2)后端配置

   但是要用好这种模式,需要后台配置支持。vue的应用是单页客户端应用,如果后台没有正确的配置,用户在浏览器访问http://yoursite.com/user/id 就会返回404,这样就不好了。

  因此要在服务端增加一个覆盖所有情况的候选资源:如果 URL 匹配不到任何静态资源,则应该返回同一个 index.html 页面,这个页面就是app依赖的页面。

  后端配置示例:https://router.vuejs.org/zh/guide/essentials/history-mode.html#%E5%90%8E%E7%AB%AF%E9%85%8D%E7%BD%AE%E4%BE%8B%E5%AD%90