晨曦的博客

技术博客

0%

七、Vue组件库：Element、Swiper（轮播专用组件）

发表于 更新于 分类于 ，

详情请点阅读全文

一、vue的Element组件库

官网：https://element.eleme.cn/#/zh-CN

1.1安装

推荐安装方法：
首先要进入项目目录

1
2
3
cnpm i element-ui -S
	或
npm i element-ui -S

1.1.2 CDN安装

直接引入无需安装：

1
2
3
4
<!-- 引入样式 -->
<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>

1.2引入所有

官方：https://element.eleme.cn/2.13/#/zh-CN/component/quickstart
在src/main.js里引入

1
2
3
4
5
6
7
8
9
10
11
import Vue from 'vue';
import ElementUI from 'element-ui';
import 'element-ui/lib/theme-chalk/index.css';
import App from './App.vue';

Vue.use(ElementUI);

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

二、按需引入

第1步，安装 babel-plugin-component：

1
cnpm install babel-plugin-component -D

第2步，配置src/.babelrc文件

【1】配置部分

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "presets": [
    ["env", {
      "modules": false,
      "targets": {
        "browsers": ["> 1%", "last 2 versions", "not ie <= 8"]
      }
    }],
    "stage-2"
  ],
  "plugins": [
    "transform-vue-jsx", "transform-runtime",
    [//【1】配置部分
          "component",
          {
            "libraryName": "element-ui",
            "styleLibraryName": "theme-chalk"
          }
    ]//配置结尾
  ]
}

第3步，引入部分组件，比如 Button 和 Select

那么需要在 main.js 中写入以下内容（全局引入）：
【1】引入所需组件
【2】使用对应组件（以下2个）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import Vue from 'vue';
import { Button, Select } from 'element-ui'; //【1】引入所需组件
import App from './App.vue';

Vue.use(Button) //【2】使用对应组件（以下2个）
Vue.use(Select) 

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

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

完整组件列表和引入方式详见：

（完整组件列表以 components.json 为准）
https://element.eleme.cn/2.13/#/zh-CN/component/quickstart

第4步，全局配置（可选步骤）

在引入 Element 时，可以传入一个全局配置对象。该对象目前支持 size 与 zIndex 字段。size 用于改变组件的默认尺寸，zIndex 设置弹框的初始 z-index（默认值：2000）。按照引入 Element 的方式，具体操作如下：

完整引入 Element：

1
2
3
import Vue from 'vue';
import Element from 'element-ui';
Vue.use(Element, { size: 'small', zIndex: 3000 });

按需引入 Element：

1
2
3
4
5
import Vue from 'vue';
import { Button } from 'element-ui';

Vue.prototype.$ELEMENT = { size: 'small', zIndex: 3000 };
Vue.use(Button);

按照以上设置，项目中所有拥有 size 属性的组件的默认尺寸均为 ‘small’，弹框的初始 z-index 为 3000。

第5步，开始使用

至此，一个基于 Vue 和 Element 的开发环境已经搭建完毕，现在就可以编写代码了。
官方使用文档： https://element.eleme.cn/2.13/#/zh-CN/component/button
在文档中找到button组件使用方法，把想要的样式复制到想要的地方即可
在这里插入图片描述

src/parent.vue

【1】使用Element的组件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
<template>
  <div class="parent">
    <h1>路由实例parent</h1>
    <!-- 【1】使用Element的组件 -->
    <el-button>默认按钮</el-button>
    <el-button type="primary">主要按钮</el-button>
    <el-button type="success">成功按钮</el-button>
    <el-button type="info">信息按钮</el-button>
    <el-button type="warning">警告按钮</el-button>
    <el-button type="danger">危险按钮</el-button>
    <hr/>
    <el-button plain>朴素按钮</el-button>
    <el-button type="primary" plain>主要按钮</el-button>
    <el-button type="success" plain>成功按钮</el-button>
    <el-button type="info" plain>信息按钮</el-button>
    <el-button type="warning" plain>警告按钮</el-button>
    <el-button type="danger" plain>危险按钮</el-button>
  </div>
</template>

<script>

  export default{
    name:'parent',
    components:{},
    data(){
      return{
        list:[] 
      }
    },
    filters:{},
    directives:{},
  }
</script>

<style scoped>
</style>

效果：
在这里插入图片描述

2.2 走马灯（轮播）图片展示组件使用示例

src/main.js

【1】以下2个为引入走马灯必须组件
【2】以下2个为使用走马灯组件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
import Vue from 'vue'
import App from './App'
import router from '@/router.js'//先引入自定义路由
import {
  Button,
  Select,
  Carousel,//【1】以下2个为引入走马灯必须组件
  CarouselItem,
   } from 'element-ui';

Vue.use(Button)
Vue.use(Select)
Vue.use(Carousel)//【2】以下2个为使用走马灯必须组件
Vue.use(CarouselItem)

Vue.config.productionTip = false

new Vue({
  el: '#app',
  template: '<App/>',
  router,//把路由投到vue实例
  components: {
    App
  }
})

src/components/parent.vue

【0】定义一些图片
【1】使用Element的走马灯组件
【2】控制走马灯图片样式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
<template>
  <div class="parent">
    <h1>路由实例parent</h1>
    <hr/>
    <!-- 【1】使用Element的走马灯组件 -->
    <el-carousel height="550px">
        <el-carousel-item v-for="(img,index) in imgs" :key="index">
          <img :src="img" /> <!-- 循环图片 -->
        </el-carousel-item>
      </el-carousel>
  </div>
</template>

<script>

  export default{
    name:'parent',
    components:{},
    data(){
      return{
        imgs:[//【0】定义一些图片
          "http://www.wallcoo.com/nature/2010_Landscape_1920_Desktop_11/wallpapers/1600x1200/Moose%20Pond%20and%20Mount%20Pleasant%20in%20Autumn%2C%20Maine.jpg",
          "https://cli.clewm.net/file/2015/01/20/81b71bc509d09368d4602a4b5b05d093.jpg",
          "https://hbimg.huabanimg.com/a84ec58661bc95efb974e2eebea2b3fd880a8fb12870a-ksYmbV_fw658",
        ]
      }
    },
    filters:{},
    directives:{},
  }
</script>

<style scoped>
  /* 【2】控制走马灯图片样式 */
    .el-carousel__item h3 {
      color: #475669;
      font-size: 14px;
      opacity: 0.75;
      line-height: 150px;
      margin: 0;
    }

    .el-carousel__item:nth-child(2n) {
       background-color: #99a9bf;
    }

    .el-carousel__item:nth-child(2n+1) {
       background-color: #d3dce6;
    }
    img {
      width:100%;
    }
</style>

效果：
在这里插入图片描述

三、Swiper（轮播专用组件）

官网：https://www.swiper.com.cn
Vue中使用：https://github.com/surmon-china/vue-awesome-swiper
官方API文档：https://www.swiper.com.cn/api/index.html

1.1 概述

  1. Swiper常用于移动端网站的内容触摸滑动
  2. Swiper是纯javascript打造的滑动特效插件，面向手机、平板电脑等移动终端。
  3. Swiper能实现触屏焦点图、触屏Tab切换、触屏多图切换等常用效果。
  4. Swiper开源、免费、稳定、使用简单、功能强大，是架构移动终端网站的重要选择！

1.2 安装Swiper

CDN

1
2
3
4
5
6
7
<link rel="stylesheet" href="path/to/swiper/dist/css/swiper.css"/>
<script type="text/javascript" src="path/to/swiper.js"></script>
<script type="text/javascript" src="path/to/vue.min.js"></script>
<script type="text/javascript" src="path/to/dist/vue-awesome-swiper.js"></script>
<script type="text/javascript">
  Vue.use(window.VueAwesomeSwiper)
</script>

NPM

首先要进入项目目录。

1
2
3
cnpm install vue-awesome-swiper --save
或
npm install vue-awesome-swiper --save

1.3 引入

1.3.1全局引入 （mount with global）

src/main.js

1
2
3
4
5
6
7
import Vue from 'vue'
import VueAwesomeSwiper from 'vue-awesome-swiper'

// require styles
import 'swiper/dist/css/swiper.css'

Vue.use(VueAwesomeSwiper, /* { default global options } */)

1.3.2组件内安装（局部引入）（mount with component）

src/components/parent.vue

1
2
3
4
5
6
7
8
9
10
11
// require styles
import 'swiper/dist/css/swiper.css'

import { swiper, swiperSlide } from 'vue-awesome-swiper'

export default {
  components: {
    swiper,
    swiperSlide
  }
}

1.3.3 ssr安装（mount with ssr）

1
2
3
4
5
// If used in nuxt.js/ssr, you should keep it only in browser build environment
if (process.browser) {
  const VueAwesomeSwiper = require('vue-awesome-swiper/dist/ssr')
  Vue.use(VueAwesomeSwiper)
}

1.4 定义插件相关参数（custom swiper plugin）

src/main.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
import Swiper from 'swiper'
Swiper.use({
  name: 'pluginName',
  params: {
    pluginSwitch: false,
  },
  on: {
    init() {
      if (!this.params.pluginSwitch) return
      console.log('init')
    },
    // swiper callback...
  }
})

1.5 使用swiper

参数配置相关详见官方API文档：https://www.swiper.com.cn/api/index.html

src/main.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
import Vue from 'vue'
import App from './App'
import router from '@/router.js'//先引入自定义路由
//[1]引入swiper
import VueAwesomeSwiper from 'vue-awesome-swiper'
import 'swiper/dist/css/swiper.css'

Vue.use(VueAwesomeSwiper)//[2]使用swiper

Vue.use(Carousel)//以下2个为使用走马灯必须组件
Vue.use(CarouselItem)

Vue.config.productionTip = false

new Vue({
  el: '#app',
  template: '<App/>',
  router,//把路由投到vue实例
  components: {
    App
  }
})

parent.vue

【0】-【3】

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
<template>
  <div class="parent">
    <h1>路由实例parent</h1>
    <hr/>
    <!-- 【1】使用swiper的轮播组件 -->
    <swiper :options="swiperOption" ref="mySwiper" @someSwiperEvent="callback">
        <!-- slides -->
        <swiper-slide v-for="(img,i) in imgs" :key="i">
          <img :src="img"/>
        </swiper-slide>

        <!-- Optional controls -->
        <div class="swiper-pagination"  slot="pagination"></div><!--分页器。如果放置在swiper-container外面，需要自定义样式。-->

        <!-- <div class="swiper-button-prev" slot="button-prev"></div>
        <div class="swiper-button-next" slot="button-next"></div>
        <div class="swiper-scrollbar"   slot="scrollbar"></div> -->
      </swiper>

  </div>
</template>

<script>

  export default{
    name:'parent',
    components:{},
    data(){
      return{
        //【2】配置轮播相关参数都写在此对象内部
        swiperOption: {
                  pagination: {
                      el: '.swiper-pagination',
                    },
                },
        imgs:[//【0】定义一些图片
          "https://hbimg.huabanimg.com/a84ec58661bc95efb974e2eebea2b3fd880a8fb12870a-ksYmbV_fw658",
          "https://cli.clewm.net/file/2015/01/20/81b71bc509d09368d4602a4b5b05d093.jpg",
          "https://hbimg.huabanimg.com/a84ec58661bc95efb974e2eebea2b3fd880a8fb12870a-ksYmbV_fw658",
        ]
      }
    },
    filters:{},
    directives:{},
  }
</script>

<style scoped>
  /* 【3】控制轮播图样式 */
.swiper-container{
    --swiper-theme-color: #ff6600;
    --swiper-pagination-color: #00ff33;/* 两种都可以 */
  }
img {
width:800px;
}
</style>

效果：
在这里插入图片描述