基於Vue元件化的日期聯動選擇器

Vue · 發表 2018-11-30 14:38:28

摘要：我們的社群前端工程用的是element元件庫，後臺管理系統用的是iview，元件庫都很棒，但是日期、時間選擇器沒有那種“ 年份 - 月份 -天數 ” 聯動選擇的元件。雖然兩個元件庫給出的相關元件也很棒，但是有時候確實不是太好用，不太明白為什麼很多元件庫都拋棄了日期聯動選擇。因此考慮自己動手做一...

我們的社群前端工程用的是element元件庫，後臺管理系統用的是iview，元件庫都很棒，但是日期、時間選擇器沒有那種“ 年份 - 月份 -天數 ” 聯動選擇的元件。雖然兩個元件庫給出的相關元件也很棒，但是有時候確實不是太好用，不太明白為什麼很多元件庫都拋棄了日期聯動選擇。因此考慮自己動手做一個。

將時間戳轉換成日期格式

// timestamp 為時間戳
new Date(timestamp)
//獲取到時間標磚物件，如：Sun Sep 02 2018 00:00:00 GMT+0800 (中國標準時間)

/*
獲取年： new Date(timestamp).getFullYear()
獲取月： new Date(timestamp).getMonth() + 1
獲取日： new Date(timestamp).getDate() 
獲取星期幾： new Date(timestamp).getDay() 
*/
複製程式碼

將日期格式(yyyy-mm-dd)轉換成時間戳

//三種形式
 new Date('2018-9-2').getTime()
 new Date('2018-9-2').valueOf()
 Date.parse(new Date('2018-9-2'))
複製程式碼

IE下的相容問題

注意：上述程式碼在IE10下(至少包括IE10)是沒法或得到標準時間value的，因為 2018-9-2 並不是標準的日期格式(標準的是 2018-09-02)，而至少 chrome 核心為我們做了容錯處理(估計火狐也相容)。因此，必須得做嚴格的日期字串整合操作，萬不可偷懶

基於Vue元件化的日期聯機選擇器

該日期選擇元件要達到的目的如下：

(1) 當前填入的日期不論完整或預設，都要向父元件傳值（預設傳''），因為父元件要根據獲取的日期值做相關處理（如限制提交等操作等）；

(2) 具體天數要做自適應，即大月31天、小月30天、2月平年28天、閏年29天；

(3) 如先選擇天數為31號(或30號)，再選擇月數，如當前選擇月數不含已選天數，則清空天數；

(4) 如父元件有時間戳傳入，則要將時間顯示出來供元件修改。

實現程式碼(使用的是基於Vue + element元件庫)

<template>
<div class="date-pickers">
<el-select 
class="year select"
v-model="currentDate.year"
@change='judgeDay'
placeholder="年">
<el-option
v-for="item in years"
:key="item"
:label="item"
:value="item">
</el-option>
</el-select>
<el-select 
class="month select"
v-model="currentDate.month" 
@change='judgeDay'
placeholder="月">
<el-option
v-for="item in months"
:key="item"
:label="String(item).length==1?String('0'+item):String(item)"
:value="item">
</el-option>
</el-select>
<el-select 
class="day select"
:class="{'error':hasError}"
v-model="currentDate.day" 
placeholder="日">
<el-option
v-for="item in days"
:key="item"
:label="String(item).length==1?String('0'+item):String(item)"
:value="item">
</el-option>
</el-select>
</div>
</template>
<script>
export default {
props: {
sourceDate: {
type: [String, Number]
}
},
name: "date-pickers",
data() {
return {
currentDate: {
year: "",
month: "",
day: ""
},
maxYear: new Date().getFullYear(),
minYear: 1910,
years: [],
months: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12],
normalMaxDays: 31,
days: [],
hasError: false
};
},
watch: {
sourceDate() {
if (this.sourceDate) {
this.currentDate = this.timestampToTime(this.sourceDate);
}
},
normalMaxDays() {
this.getFullDays();
if (this.currentDate.year && this.currentDate.day > this.normalMaxDays) {
this.currentDate.day = "";
}
},
currentDate: {
handler(newValue, oldValue) {
this.judgeDay();
if (newValue.year && newValue.month && newValue.day) {
this.hasError = false;
} else {
this.hasError = true;
}
this.emitDate();
},
deep: true
}
},
created() {
this.getFullYears();
this.getFullDays();
},
methods: {
emitDate() {
let timestamp; //暫預設傳給父元件時間戳形式
if ( this.currentDate.year && this.currentDate.month && this.currentDate.day) {
let month = this.currentDate.month < 10 ? ('0'+ this.currentDate.month):this.currentDate.month;
let day = this.currentDate.day < 10 ? ('0'+ this.currentDate.day):this.currentDate.day;
let dateStr = this.currentDate.year + "-" + month + "-" + day;
timestamp = new Date(dateStr).getTime();
} 
else {
timestamp = "";
}
this.$emit("dateSelected", timestamp);
},
timestampToTime(timestamp) {
let dateObject = {};
if (typeof timestamp == "number") {
dateObject.year = new Date(timestamp).getFullYear();
dateObject.month = new Date(timestamp).getMonth() + 1;
dateObject.day = new Date(timestamp).getDate();
return dateObject;
}
},
getFullYears() {
for (let i = this.minYear; i <= this.maxYear; i++) {
this.years.push(i);
}
},
getFullDays() {
this.days = [];
for (let i = 1; i <= this.normalMaxDays; i++) {
this.days.push(i);
}
},
judgeDay() {
if ([4, 6, 9, 11].indexOf(this.currentDate.month) !== -1) {
this.normalMaxDays = 30; //小月30天
if (this.currentDate.day && this.currentDate.day == 31) {
this.currentDate.day = "";
}
} else if (this.currentDate.month == 2) {
if (this.currentDate.year) {
if (
(this.currentDate.year % 4 == 0 &&
this.currentDate.year % 100 != 0) ||
this.currentDate.year % 400 == 0
) {
this.normalMaxDays = 29; //閏年2月29天
} else {
this.normalMaxDays = 28; //閏年平年28天
}
} 
else {
this.normalMaxDays = 28;//閏年平年28天
}
} 
else {
this.normalMaxDays = 31;//大月31天
}
}
}
};
</script>
<style lang="less">
.date-pickers {
.select {
margin-right: 10px;
width: 80px;
text-align: center;
}
.year {
width: 100px;
}
.error {
.el-input__inner {
border: 1px solid #f1403c;
border-radius: 4px;
}
}
}
</style>
複製程式碼

程式碼解析

預設天數(normalMaxDays)為31天，最小年份1910，最大年份為當前年（因為我的業務場景是填寫生日，大家這些都可以自己調）並在created 鉤子中先初始化年份和天數。

監聽當前日期(currentDate)

核心是監聽每一次日期的改變，並修正normalMaxDays，這裡對currentDate進行深監聽，同時傳送到父元件,監聽過程:

watch: {
currentDate: {
handler(newValue, oldValue) {
this.judgeDay(); //更新當前天數
this.emitDate(); //傳送結果至父元件或其他地方
},
deep: true
}
}
複製程式碼

judgeDay方法：

judgeDay() {
if ([4, 6, 9, 11].indexOf(this.currentDate.month) !== -1) {
this.normalMaxDays = 30; //小月30天
if (this.currentDate.day && this.currentDate.day == 31) {
this.currentDate.day = ""; 
}
} else if (this.currentDate.month == 2) {
if (this.currentDate.year) {
if (
(this.currentDate.year % 4 == 0 &&
this.currentDate.year % 100 != 0) ||
this.currentDate.year % 400 == 0
) {
this.normalMaxDays = 29; //閏年2月29天
} else {
this.normalMaxDays = 28; //平年2月28天
}
} else {
this.normalMaxDays = 28; //平年2月28天
}
} else {
this.normalMaxDays = 31; //大月31天
}
}
複製程式碼

最開始的時候我用的 includes判斷當前月是否是小月：

if([4, 6, 9, 11].includes(this.currentDate.month))
複製程式碼

也是缺乏經驗，最後測出來includes 在IE10不支援，因此改用普通的indexOf()。

emitDate：

emitDate() {
let timestamp; //暫預設傳給父元件時間戳形式
if ( this.currentDate.year && this.currentDate.month && this.currentDate.day) {
let month = this.currentDate.month < 10 ? ('0'+ this.currentDate.month):this.currentDate.month;
let day = this.currentDate.day < 10 ? ('0'+ this.currentDate.day):this.currentDate.day;
let dateStr = this.currentDate.year + "-" + month + "-" + day;
timestamp = new Date(dateStr).getTime();
} 
else {
timestamp = "";
}
this.$emit("dateSelected", timestamp);//傳送給父元件相關結果
},
複製程式碼

這裡需要注意的，最開始並沒有做上述標準日期格式處理，因為chrome做了適當容錯，但是在IE10就不行了，所以最好要做這種處理。

normalMaxDays改變後必須重新獲取天數，並依情況清空當前選擇天數：

watch: {
normalMaxDays() {
this.getFullDays();
if (this.currentDate.year && this.currentDate.day > this.normalMaxDays) {
this.currentDate.day = "";
}
}
}
複製程式碼