最近在做一个类似课程表的需求,需要自制一个日历来支持功能及展现,就顺便研究一下应该怎么开发日历组件。
更新
- 2.23修复了2026年2月份会渲染多一行的bug,谢谢@深蓝一人童鞋提出的bug,解决方案是给二月份的日历做特殊处理,new Date(year, month 1, 0).getDay() === 6时不会再渲染后面的日期。
- 下班更新一哈,更科学的逻辑
// if (total_calendar_list.length > 35) { // nextNum = 42 - total_calendar_list.length; // } else { // nextNum = 35 - total_calendar_list.length; // }// if (month === 1 && new Date(year, month, 0).getDay() === 6) { // nextNum = 0 // }nextNum = 6 - new Date(year, month 1, 0).getDay()
本文主要涉及以下内容:
- 怎么开发一套日历皮肤?
- 怎么计算年月日?
- 怎么开发日历相关的功能?
- 总结&DEMO源码
怎么开发一套日历皮肤?
层层分离,块块独立
在梳理日历逻辑之前我想先记录一下日历样式相关的问题:
下面是借鉴px2rem模式,写的基于vw为主单位的自适应转化。简单来说,就是在我们的设计稿是iPhone8一倍图的情况下,计算出某元素宽度与375(iPhone8最大宽度)的比例再与100vw相乘就得到了,该元素的vw值。因为vw是相对于屏幕的百分比单位,所以就能达到我们想要的自适应效果啦,不同的屏幕里,同一元素的展现比例是一致的。
// 借鉴了Rem布局
@function pxWithVw($n) {@return 100vw * $n / 375;
}
// 规定极限宽度,避免PC上观感太差
@function pxWithVwMax($n) {@return 480px * $n / 375;
}
有了上面这段SCSS的函数,我们就基本可以不用考虑屏幕适配的问题了,可以尽情的敲样式啦。关于日历的样式,其实说复杂也还好,我们只需要在做之前好好的分一下层级就好了。
如同上图,每一个框表示一层元素,最后会有这样的布局--
<!--最外层的div限定整个日历的宽度以及一些圆角阴影等样式-->
<div class="calendar"><!--header则为上图中绿色框的内容,包含上下月切换以及日历title--><div class="calendar__header"></div><!--顾名思义main则是整个日历的核心内容,也就是日期的展示区域--><div class="calendar__main"><!--星期一~星期日的展示头,列表渲染固定的7个block--><div class="main__block-head"></div><!--相应月份的日期展示区域,列表渲染--><div class="main__block"></div></div>
</div>
也许大家看完之后比较奇怪calendar__main里面的布局,为什么没有把固定的展示头分离开来,当你实际写到这里的时候会发现其实没有这个必要。
因为我们用了pxWithVw去规定calendar__main的宽度以及每个block的宽度,也就确保了每7块元素必定会占满我们一行,再利用justify-content: space-around确保我们每块元素的间隙一致即可。
好了,层层分离说完了,什么是块块独立呢?
主要指的是日期的展示块,我们是每块独立的,这样在我们渲染的时候可以很方便的决定应该以什么样式去展示他,或是应该给他绑定怎么样的事件,给我们精密控制每个日期的展示提供了便利。
怎么计算年月日?
本小节的内容总结起来其实就一句话--
我们只需要知道,某个月的1号是星期几,就能把整个日历渲染出来
关于年月日的计算,我这边有两种模式,一种是只计算当月日期,另一种则是将整年的日期都计算出来。在本篇文章里我想着重记录第一种写法,大家想了解第二种的话可以到我的github里看看这个日历的demo。
我们先来个看图说话,这个二月份有28天,1号是星期四。那是不是说,我们只要从周四开始,按顺序渲染出28个'main__block'就好了呢?其实就是这样,关键是怎么把我们的1号定位到周四,只要这个能够准确定位到,我们的日历自然就出来了。
// 定义每个月的天数,如果是闰年第二月改为29天
// year=2018;month=1(js--month=0~11)
let daysInMonth = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
if ((year % 4 === 0 && year % 100 !== 0) || year % 400 === 0) {daysInMonth[1] = 29;
}
// 获得指定年月的1号是星期几
let targetDay = new Date(year, month, 1).getDay();
// 将要在calendar__main中渲染的列表
let total_calendar_list = [];
let preNum = targetDay;
// 首先先说一下,我们的日期是(日--六)这个顺序也就是(0--6)
// 有了上述的前提我们可以认为targetDay为多少,我们就只需要在total_calendar_list的数组中push几个content为''的obj作为占位
if (targetDay > 0) {for (let i = 0; i < preNum; i ) {let obj = {type: "pre",content: ""};total_calendar_list.push(obj);}
}
这样一来,1号的位置自然而然就到了我们需要的星期四了,接下来就只需要按顺序渲染就ok啦。下面是剩下日期数组填充,填充完毕之后return出来供我们view层使用。
for (let i = 0; i < daysInMonth[month]; i ) {let obj = {type: "normal",content: i 1};total_calendar_list.push(obj);
}
nextNum = 6 - new Date(year, month 1, 0).getDay()
// 与上面的type=pre同理
for (let i = 0; i < nextNum; i ) {let obj = {type: "next",content: ""};total_calendar_list.push(obj);
}
return total_calendar_list;
怎么开发日历相关的功能?
如何选择上一个月或下一个月?
data() {return {// ...selectedYear: new Date().getFullYear(),selectedMonth: new Date().getMonth(),selectedDate: new Date().getDate()};
}handlePreMonth() {if (this.selectedMonth === 0) {this.selectedYear = this.selectedYear - 1this.selectedMonth = 11this.selectedDate = 1} else {this.selectedMonth = this.selectedMonth - 1this.selectedDate = 1}
}handleNextMonth() {if (this.selectedMonth === 11) {this.selectedYear = this.selectedYear 1this.selectedMonth = 0this.selectedDate = 1} else {this.selectedMonth = this.selectedMonth 1this.selectedDate = 1}
}
就是这么简单,需要注意的点是跨年的时间转换,我们需要在变更月份的同时把年份也改变,这样才能渲染出正确的日期。
也许大家会有疑问,怎么变更了月份或年份之后不需要重新计算一次日期呢?其实是有计算的,不知大家是否还记得,vue可是数据驱动变更的,我们只需要关注数据的变更即可,其他东西vue都会帮我们解决。
如果选中某一天?
handleDayClick(item) {if (item.type === 'normal') {// do anything...this.selectedDate = Number(item.content)}
}
在渲染列表的时候我就给每一个block绑定了click事件,这样做的好处就是调用十分方便,点击每一个block的时候,可以获取该block的内容然后do anything you like
当然我们也可以给外层的父级元素绑定事件监听,通过事件流来解决每个block的点击事件,这里看个人习惯~毕竟元素数量不是特别多
总结
一个移动端日历貌似也有惊无险的完成啦,总体来说日历这活还是偏样式方面的,对逻辑的要求不是特别高,对样式的要求倒是挺高的需要对flexbox布局有一定理解,才能迅速的吧日历的骨架搭起来,虽然也不一定说必须用flex,不过个人认为用flex的效率会稍高一些。
基于Vue写的日历DEMO--Github
啰嗦一下,为什么想起来写日历?当然是业务需求啦,所以说这个日历组件一开始是react写的,后面想在vue里也尝试一下就改成了vue。其实在react里面写也是大同小异啦,只不过我会把日期的block抽离成无状态组件,也不为啥就感觉比较好看:)