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

Posted on by

需求背景簡介

最近打算使用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 [email protected] --save-dev
  • 安裝jquery
npm install [email protected] --save-dev
  • 安裝moment
npm install [email protected] --save-dev
  • 安裝pc-bootstrap4-datetimepicker
npm install [email protected] --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/[email protected] --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>

其中<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日期插件的資料請關註WalkonNet其它相關文章！

推薦閱讀：