首頁 > 軟體

vue-cli 3如何使用vue-bootstrap-datetimepicker日期外掛

2021-02-20 12:00:43

需求背景簡介

最近打算使用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>

其中<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日期外掛的資料請關注it145.com其它相關文章!


IT145.com E-mail:sddin#qq.com