关于自定义日历
工作需要,现有框架封装的日历无法满足需求,又找不到更好的插件的情况下,咋办??自己写个呗!
效果图和功能说明
先看看效果图
在这里插入图片描述
其实基本界面就这样了,和其他没啥区别。
但是既然要单独封装一个,那肯定有其他可扩展的地方,不然就没意义了
功能说明
1、基本日历功能
2、可以自定义标题头部
3、可自定义顶部时间以及月份切换部分
4、日历单元格样式可以自定义
5、星期一栏可以自定义
6、可以在日历里面插入数据:这一点是最重要的,也是必须要自己封装的重要因素
使用
封装为日历组件,直接引用即可。需要扩展其他功能,可以看组件里面的props哦,这是可以接收的参数。当然,如果用props不能满足的,那就看看里面的slot插槽部分咯。
这是props定义接收的参数,每个参数均有注释,这里不多做介绍。
props: { initDate:{ type:[String,Date,Number], default:()=>new Date() },//初始化日期 width:{ type:[String,Number], default:'100%' },//日历宽度 height:{ type:[String,Number], default:'100%' },//日历高度 calendarClass:String,//日历自定义样式类 titleClass:String,//年月标题自定义样式类 titleH:{ type:[String,Number], default:'35px' },//年月标题高度 titleBk:{ type:String, default:'#ffffff' },//年月标题颜色 bodyBk:{ type:String, default:'#ffffff' },//日历体背景 bodyClass:String,//日历体自定义样式 dateDefaultClass:String,//日期自定义默认类名 dateActivDateClass:String,//日期自定义选中类名 dateDisabledDateClass:String,//日期自定义不可见类名 titleDateConnector:String,//标题日期连接符 insertData:{ type:Array, default:()=>[] },//自定义拼接数据 weeks:{ type:Array, default:()=>['日','一','二','三','四','五','六'] },//周数据 dateProp:{ type:String, default:'date' },//自定义表示时间的字段 calenCellClass:String,//日历单元格自定义样式 firstRowCellClass:String,//日历第一行单元格自定义样式 firstColumCellClass:String,//日历第一列单元格自定义样式 cellBorder:Boolean,//是否有边框 cellTitleHeight:{ type:[Number,String], default:'40px' },//日历标题高度 cellTitleColor:{ type:String, default:'#333333' },//日历标题颜色 range:{ type:Array, default:()=>[] },//日期范围 },
更多个性化功能请看slot部分
在这里插入图片描述
插槽使用示例:
不熟悉插槽的伙伴可以去vue官网补补:https://cn.vuejs.org/v2/guide/components-slots.html
日历标题 {{currentYear}}年{{currentMonth}}月 返回今天
其他不多说了,最后上代码。由于组件代码放在一个页面写重了点,因此分成了几个文件
所有data里面的变量,props,还有函数均有说明。
先看canlendar.vue
{{currentYear}}{{titleDateConnector || '年'}}{{currentMonth+1}}{{titleDateConnector ? '' : '月'}} < > {{week}} {{day.day}}
工具文件util.js
//获取开始日期结束日期最终信息 export function getStartTimeEndTimeInfoFun(startDate,endDate){ let start=checkStartTimeEndTimeFun(startDate) let end=checkStartTimeEndTimeFun(endDate) let calenStartDateResult=start ? getNewDateFun(start) : false let calenStartYear=calenStartDateResult ? calenStartDateResult.calendarAddYear : '' let calenStartMonth=calenStartDateResult ? calenStartDateResult.calendarAddMonth : '' let calenStartDate=calenStartDateResult ? calenStartDateResult.calendarAddDate : '' let calenEndDateResult=end ? getNewDateFun(end) : false let calenEndYear=calenEndDateResult ? calenEndDateResult.calendarAddYear : '' let calenEndMonth=calenEndDateResult ? calenEndDateResult.calendarAddMonth : '' let calenEndDate=calenEndDateResult ? calenEndDateResult.calendarAddDate : '' if(calenStartYear!==calenEndYear || calenStartMonth!==calenEndMonth || !calenEndDate || !calenStartDate || (calenStartDate>calenEndDate)){ (start || end) && console.error(`日期范围仅支持本月范围选择或日期格式错误${startDate} ${endDate}`) return {dateRangeCode:0} } return{ calenStartYear, calenStartMonth:calenStartMonth-1, calenStartDate, calenEndYear, calenEndMonth:calenEndMonth-1, calenEndDate, dateRangeCode:1 } } //检查开始日期和结束日期 export function checkStartTimeEndTimeFun(date){ if(typeof date!=='string' && (typeof date==='string' && !date) && typeof date!=='number' && !(date instanceof Date)){ //非时间可能的数据格式,或者明确时间没有值,跳过 return '' } if(typeof date==='number' && date.length<10){ console.error(`日期${date}格式错误,请使用正确的时间戳格式,例如:1593669468000`) return '' } if(typeof date==='string' && date){ //传递过来的时间格式时字符串,此处不可以用parseInt,因为parseInt会将类似2020-02-02解析为2020 if(!/-/.test(date) && !/\//.test(date && !Number(date))){ console.error(`日期${date}格式错误,请使用正确的字符串日期格式,例如:2020-06-06,或2020/06/06`) return '' } if(!/-/.test(date) && !/\//.test(date) && Number(date)){ date=Number(date) } } return date } //将传入的时间生成新的值并返回 export function getNewDateFun(date){ let calendarAddYear=null let calendarAddMonth=null let calendarAddDate=null if(typeof date==='string'){ //字符串,可能时2020-03-04或2020/02/03或03-02或03/02 let dateArr=/-/.test(date) ? date.split('-') : date.split('/') if(dateArr.length===3){ //年月日 calendarAddYear=parseInt(dateArr[0]) calendarAddMonth=parseInt(dateArr[1]) calendarAddDate=parseInt(dateArr[2]) }else if(dateArr.length===2){ //月日,年默认为今年 calendarAddYear=new Date().getFullYear() calendarAddMonth=parseInt(dateArr[0]) calendarAddDate=parseInt(dateArr[1]) }else{ //其他未知情况,报错 console.error(`日期${date}格式错误,请使用正确的字符串日期格式,例如:2020-06-06,或2020/06/06`) return false } }else{ //时间戳和时间对象 if(typeof date==='number'){ //时间戳转为时间对象 date=new Date(date) } calendarAddYear=date.getFullYear() calendarAddMonth=date.getMonth()+1 calendarAddDate=date.getDate() } return{ calendarAddYear, calendarAddMonth, calendarAddDate } } //将数据插入日历 export function insertDataToCalendar(value,calendarList,dateProp){ if(!value.length || !(value instanceof Array)){ return } for(let i=0;iitem.calendarAddYear===calendarList[i].year)//先筛选出当前年的 filterCalendarList=filterCalendarList.filter(item=>item.calendarAddMonth===calendarList[i].month)//再筛选出当前月的 filterCalendarList=filterCalendarList.filter(item=>item.calendarAddDate===calendarList[i].day)//最后筛选出当前天的 // console.log(filterCalendarList) if(!filterCalendarList.length){ // 没有值,跳过 continue } // 将传过来的数据插入原日历数据 calendarList.splice(i,1,{...calendarList[i],...filterCalendarList[0],hasData:true}) } }
日期验证文件validate.js
/** * 判断日期格式是否正确,正确返回日期 */ export function isValidDate(dateTime) { let yourDate=dateTime try { ;(typeof dateTime === 'string') && (dateTime=dateTime.replace(/-/g,'/')) dateTime=new Date(dateTime) if(dateTime instanceof Date && !isNaN(dateTime.getTime())){ return { dateTime, isValid:true, } }else{ console.error(`日期 ${yourDate} 格式错误`) return { isValid:false, } } }catch (err){ console.error(err) } } /** * 判断是否为数字,整数或者小数 */ export function isNumber(val) { let regPos = /^\d+(\.\d+)?$/ //非负浮点数 let regNeg = /^(-(([0-9]+\.[0-9]*[1-9][0-9]*)|([0-9]*[1-9][0-9]*\.[0-9]+)|([0-9]*[1-9][0-9]*)))$/ //负浮点数 return regPos.test(val) || regNeg.test(val) }
最后是样式文件style.less和flex.less
style.less
html,body,ul,li,p,span,div{ margin:0; padding:0; -webkit-box-sizing: border-box; -moz-box-sizing: border-box; box-sizing: border-box; } .dateDefaultCss{ color: black; cursor: pointer } .dateActiveCss{ color: white; cursor: pointer; background:#317ef2; } .disableDateCss{ color: #bfbfbf; cursor: default } .custom-calendar { .calendar-title { padding:0 30px 0 10px; .left { font-size: 105%; } .right { width:70px; border:solid 1px #dddddd; padding:0 10px; span{ font-size: 20px; } span:hover { cursor: pointer; color: #3a82fa; } } margin-bottom: 5px; color: #000; } .calendar-body { padding-bottom:10px; .bodyTitleBox{ .body-title { width:14%; } } .calen-content{ flex-wrap:wrap; } .calen-cell { color: #000; display: table-cell; text-align: center; vertical-align: middle; width:14%; margin-bottom: 5px; .dateSpan{ padding: 3px; -webkit-border-radius: 50%; -moz-border-radius: 50%; border-radius: 50%; width:20px; height:20px; margin:0 auto; } div{ width: 3px; height: 3px; border-radius: 50%; background: #3a82fa; margin: 0 auto; } } } }
flex.less
/* flex布局样式 */ /* flex布局 */ .rowStart { display: flex; flex-direction: row; justify-content: flex-start; align-items: center; } .rowAround { display: flex; flex-direction: row; justify-content: space-around; align-items: center; } .rowBtween { display: flex; flex-direction: row; justify-content: space-between; align-items: center; } .rowCenter { display: flex; flex-direction: row; justify-content: center; align-items: center; } .rowEnd { display: flex; flex-direction: row; justify-content: flex-end; align-items: center; } .columnStart { display: flex; flex-direction: column; justify-content: flex-start; align-items: center; } .columnAround { display: flex; flex-direction: column; justify-content: space-around; align-items: center; } .columnBtween { display: flex; flex-direction: column; justify-content: space-between; align-items: center; } .columnCenter { display: flex; flex-direction: column; justify-content: center; align-items: center; } .columnEnd { display: flex; flex-direction: column; justify-content: flex-end; align-items: center; }
还没有评论,来说两句吧...