vue-cli 3如何使用vue-bootstrap-datetimepicker日期插件

时间:2022-04-30 16:16:02

需求背景简介

最近打算使用vue并结合前端工程化体系重构之前的一个Demo,其中有一个功能是使用bootstrap的datepicker插件选择查询日期。在网上找到了一个基于vue扩展的datepicker插件:vue-bootstrap-datepicker。这篇博客主要介绍在使用vue-cli 3创建的项目中如何使用该插件。项目地址:https://gitlab.com/JiaoXN/vuecli3usedatetimepicker.git

安装插件及其依赖项

这个插件有两个版本:一个是基于bootstrap 3.x开发的,一个是基于bootstrap 4.x开发的。本篇博客将会介绍后一种插件的安装及使用方法。

首先呢,需要安装插件的依赖项,包括bootstrap 4.x、jquery >= 1.8.3、moment.js 2.22以及pc-bootstrap4-datetimepicker。

  • 安装bootstrap
?
1
npm install bootstrap@4.0.0 --save-dev
  • 安装jquery
?
1
npm install jquery@3.3.1 --save-dev
  • 安装moment
?
1
npm install moment@2.22.2 --save-dev
  • 安装pc-bootstrap4-datetimepicker
?
1
npm install pc-bootstrap4-datetimepicker@4.17.50 --save-dev

或者直接设置package.json,然后通过npm install安装。 package.json配置如下:

?
1
2
3
4
5
6
7
...
"devDependencies": {
    "pc-bootstrap4-datetimepicker": "^4.17.50",
    "moment": "^2.22.2",
    "jquery": "^3.3.1",
    "bootstrap": "4.0.0"
}

然后安装vue-bootstrap-datetimepicker,安装方法与上述依赖项安装一致。

插件配置

由于vue-bootstrap-datetimepicker这个插件的原始版本是基于Bootstrap 3.x版本开发的,后来为了适应Bootstrap 4.x,有人对其进行了拓展(此时pc-bootstrap4-datetimepicker可以看做Bootstrap 4.x的补丁),但是如果直接使用这个插件默认的图标(类似于时间图标或者日期图标)均显示不出来,因此还需要一下配置。

出现上述问题的原因在于Bootstrap 4.x删除了glyphicon图标,所以呢,首先需要安装fortawesome插件,安装方法如下:

?
1
npm install @fortawesome/fontawesome-free@5.5.0 --save-dev

然后在使用datetimepicker这个插件的Vue文件中使用一下代码配置:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<script>
 
import '@fortawesome/fontawesome-free/css/all.css'
 
import $ from 'jquery'
 
export default {
    ...
    created: function() {
        icons: {
            time: 'far fa-clock',
        date: 'far fa-calendar',
        up: 'fas fa-arrow-up',
        down: 'fas fa-arrow-down',
        previous: 'fas fa-chevron-left',
        next: 'fas fa-chevron-right',
        today: 'fas fa-calendar-check',
        clear: 'far fa-trash-alt',
        close: 'far fa-times-circle'
        }
    }
}
 
</script

上述代码中的created函数属于Vue生命周期中的一个钩子函数

插件使用

安装相关依赖插件和配置插件图片,接下来可以使用这个插件了,整个Vue代码如下:

?
1
2
3
4
5
6
7
8
9
10
11
12
<template>
    <div class="container">
        <div class="row>
            <div class="col-md-12">
                <date-picker
                    v-model="date"
                    :config="options"
                    @dp-hide="showDatePickResult"/>
            </div>
        </div>
    </div>
</template>
?
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
<script>
import 'bootstrap/dist/css/bootstrap.css'
 
import datePicker from 'vue-bootstrap-datetimepicker'
 
import 'pc-bootstrap4-datetimepicker/build/css/bootstrap-datetimepicker.css'
 
import '@fortawesome/fontawesome-free/css/all.css'
 
import $ from 'jquery'
 
export default {
    name: 'HelloWorld',
    data () {
        return {
            date: new Date(),
            options: {
                format: 'YYYY-MM-DD HH:mm:ss',
                useCurrent: false,
                locale: 'zh-cn',
                tooltips: {
                 selectTime: ''
                }
            }
        }
    },
    methods: {
        showDatePickResult: function () {
            console.log(this.date)
        }
    },
    components: {
        datePicker
    },
    created: function () {
        $.extend(true, $.fn.datetimepicker.defaults, {
            icons: {
            time: 'far fa-clock',
            date: 'far fa-calendar',
            up: 'fas fa-arrow-up',
            down: 'fas fa-arrow-down',
            previous: 'fas fa-chevron-left',
            next: 'fas fa-chevron-right',
            today: 'fas fa-calendar-check',
            clear: 'far fa-trash-alt',
            close: 'far fa-times-circle'
            }
        })
    }
}
</script>

其中<template></template>中的内容就不用多赘述了,了解Vue的都基本清楚,如果不太了解Vue的朋友可以查看Vue的官网

data中的options内容是datetimepicker这个插件的相关配置,整体的配置请参考这个链接,目前使用的配置描述如下:

  • format:日期格式,这一块需要注意的是,如果将HH:mm:ss中的HH换成hh,则这个插件描述日期的方式会分成AM和PM
  • locale: 表示使用哪种语言,zh-cn表示中文简体
  • tooltips: 表示提示内容,这一块这个插件有个Bug,在选择日期和选择时间的提示都是“Select Time”,因此这里把这个提示设置为空

以上就是vue-cli 3如何使用vue-bootstrap-datetimepicker日期插件的详细内容,更多关于使用vue-bootstrap-datetimepicker日期插件的资料请关注服务器之家其它相关文章!

原文链接:https://juejin.cn/post/6930243603713228813