怎么实现一个datePicker(日期选择)组件(纯原生,无依赖)

时间:2024-02-24 15:58:59

本文首次发表于浴火小青春博客,欢迎访问~

百度前端技术学院上有一个任务,要实现一个日期选择组件,本文由此而来~

  1. 看看需求
  • 组件默认一直呈显示状态
  • 通过某种方式选择年、月,选择了年月后,日期列表做相应切换
  • 通过单击某个具体的日期进行日期选择
  • 组件初始化时,可配置可选日期的上下限。可选日期和不可选日期需要有样式上的区别
  • 提供设定日期的接口,指定具体日期,日历面板相应日期选中
  • 日期选择面板默认隐藏,会显示一个日期显示框和一个按钮,点击这两个部分,会浮出日历面板。再点击则隐藏。
  • 点击选择具体日期后,面板隐藏,日期显示框中显示选取的日期
  • 增加一个接口,用于当用户选择日期后的回调处理
  • 增加一个参数及相应接口方法,来决定这个日历组件是选择具体某天日期,还是选择一个时间段
  • 当设置为选择时间段时,需要在日历面板上点击两个日期来完成一次选择,两个日期中,较早的为起始时间,较晚的为结束时间,选择的时间段用特殊样式标示
  • 增加参数及响应接口方法,允许设置时间段选择的最小或最大跨度,并提供当不满足跨度设置时的默认处理及回调函数接口
  • 在弹出的日期段选择面板中增加确认和取消按钮

先完成一个组件的基本结构

    (function(window,document){
       function Calendar(options){
          //传入配置的中的参数
          this.init();
       } 
       Calendar.prototype={
            init:function(){
               this.createDom();
               this.loadCss();
               this.cacheDom();
               this.bindEvents();
               this.render();
            },
            loadCss:function(){
               // 把组件所需的样式表动态加载进来
            },
            createDom:function(){
               // 创建dom对象或者创建html片段或者创建template
            },
            cacheDom:function(){
               // 存储dom 对象
            },
            bindEvents:function(){
               //事件绑定
            },
            render:function(){
              //渲染函数,更新数据或样式
            }
       }
       window.Calendar=Calendar;//把组件对象绑定到全局
    }(window,document));

通常我写组件时的基本结构如上,你可以根据组件的需要或者自己习惯进行编写。然后就可以在html里面添加以下的代码就可以调用我们的组件了,

<script src=\'calendar.js></script>
<script type=\'text/javascript\'>
   var a=new Calendar({
      // 各种配置
      /* 类似于 id:\'myCalendar\'
         onSelected:function(){
                    alert(\'hello\');
        }
     */
   });
</script>

下面再看一下我们的需求,我们来一 一分析

需求也不是很多嘛,手动斜眼~
先上图,根据图再慢慢分析

概要图
其实我们看了需求之后,每个人都会有一个大概的思路,下面说一下我的思路
首先,要实现一个日期选择器,最重要的就是要有一个日历,根据不同的年份和月份,日期面板上回显示每一天和对应的周几~
其实实现这一点的话就两点

  • 第一,要根据年份和月份算出每月有多少天
  • 第二,要计算出每月的第一天(1号)是周几
    伪代码如下:
 /**
     * @param  {string} year  年份
     * @param  {string} month 月份
     * @param  {string} day   号
     * @return {object}  message
     * message{
     * year   年份
     * month  月份
     * monthLen  那个月的天数
     * whichDay  1号是周几
     * day       号
     * }    
     */
     function calculate(year,month,day){
     	        var date=year+\'/\'+month+\'/\'+\'1\';
     	        var whichDay=new Date(date).getDay();
              var message={
                    year:year,
                    month:month,
                    monthLen:new Date(year,month,0).getDate(),
                    whichDay:whichDay,
                    day:day
              };
              return message;
     },

我想看完代码之后大家应该比较疑惑的是获取每个月天数的那句代码,这个比较优雅的做法是从这里看到的,
注意:在Date对象里month为0代表的是1月份,month为5代表6月份,所以我new Date(year,5,0)代表的六月份的第0天,即5月份的最后一天,所以还可以用getDate()获取5月份的长度,getDate方法是返回指定日期对象的月份中的第几天(1-31)。
所以当我们点击了月份加减/年份加减的按钮时,向calculate函数传入变化后的year,month参数,然后进行渲染,日历面板改变

其次,”选择时间段并且另处于开始时间和结束时间之间的日期添加特殊的样式“这一点也是花了不少时间来写,
伪代码如下:

// 初始化
var firstDate,secondDate=[0,0,0];
//点击日历面板上的日期的点击事件的执行函数的片段,每当点击事件被触发,就会执行该片段

if(self.isSelectRange){
             var date=[self.year.innerHTML,self.month.innerHTML,ele.innerHTML];            
             if(self.firstDate[0]===0){// 
                if(self.secondDate[0]===0){//两个日期都没有被设置
                     self.firstDate=date;
                }else{//firstDate没有被设置,secondDate已经被设置,
                     
                }
             }else{
                if(self.secondDate[0]===0){//firstDate已经设置,
                    self.secondDate=date;
                    if(compareDate(self.firstDate.join(\'/\'),self.secondDate.join(\'/\'))){//如果第一个选择的日期大于第二次选择的日期,进行交换
                        self.firstDate=[self.secondDate,self.secondDate=self.firstDate][0];
                    } 
                }else{//两个日期都已经被设置,已经选择了两个元素,再次选择则都
                   self.secondDate=[0,0,0];
                   self.firstDate=date;
                   self.clearDayInRangeStyle();
                }
             }
             self.day.innerHTML=ele.innerHTML;
             self.render();

firstDate,secondDate分别代表开始时间和结束时间。每次触发日期的点击事件时,就会执行以上的代码片段,对firstDate和secondDate进行更改,这样的话,无论是我对日历面板进行更新或者对开始时间和结束时间之间的日期显示不同的样式,都可以通过firstDate和secondDate来实现。

显示不同的样式就判断日期是否在开始时间和结束时间之间,每次重新render的时候就给选择过的firstDate和secondDate添加样式。

包括计算开始时间和结束时间之间的跨度是否在设定的跨度内,我们点击按钮后进行判断。
最后,看看render函数怎么实现
关于render函数,有以下几点需要注意:

  • 清除日历面板上的所有内容和样式,样式通过清除每个单元格上的类实现
  • 根据每月1号是周几和每月的长度生成每月的日历
  • 根据记录的fisrtDate和secondDate来显示已经选择过的选择的样式

以上大概是我的思路,我也实现了一个组件,有兴趣的朋友可以点这里,欢迎找bug~