需求背景簡介
最近打算使用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
npm install bootstrap@4.0.0 --save-dev
- 安裝jquery
npm install jquery@3.3.1 --save-dev
- 安裝moment
npm install moment@2.22.2 --save-dev
- 安裝pc-bootstrap4-datetimepicker
npm install pc-bootstrap4-datetimepicker@4.17.50 --save-dev
或者直接設置package.json,然後通過npm install安裝。 package.json配置如下:
...
"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插件,安裝方法如下:
npm install @fortawesome/fontawesome-free@5.5.0 --save-dev
然後在使用datetimepicker這個插件的Vue文件中使用一下代碼配置:
<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代碼如下:
<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>
<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>
其中中的內容就不用多數了,瞭解Vue的都基本清楚,如果不太瞭解Vue的朋友可以查看Vue的官網。
data中的options內容是datetimepicker這個插件的相關配置,整體的配置請參考這個鏈接,目前使用的配置描述如下:
- format:日期格式,這一塊需要注意的是,如果將HH:mm:ss中的HH換成hh,則這個插件描述日期的方式會分成AM和PM
- locale: 表示使用哪種語言,zh-cn表示中文簡體
- tooltips: 表示提示內容,這一塊這個插件有個Bug,在選擇日期和選擇時間的提示都是“Select Time”,因此這裏把這個提示設置爲空