Skip to content

Latest commit

 

History

History
188 lines (157 loc) · 7.29 KB

README.md

File metadata and controls

188 lines (157 loc) · 7.29 KB
Raw

样例地址 (样例不是最新代码哦)

2021/11/10 V2.0.0beta(已发布)

  • 移动端支持,支持的类型有：year / month / date / datetime / datetimerange / daterange / monthrange / yearrange / weeknum

    • 新增属性 isMobile:true
    • 新增属性：scrolllist: ['year', 'month', 'date', 'hour', 'minute', 'second'],此属性用于设置显示哪些滚动条，不设置使用默认

  • 修改theme样式的写法，新增theme.css文件，也可以自定义theme属性的值，并添加css变量

  • 修改placeholder的属性名 placeholder:{startTime:'起始',endTime:'结束'}

2021/07/19 V1.2.7(已发布)

  • 增加placeholder的object类型支持 placeholder:{start:'起始',end:'结束'}

2021/06/18 V1.2.6(已发布)

  • 修改bug，起始日期和结束日期一样不能点击确定

2021/03/11 V1.2.5(已发布)

  • 增加主题色，目前一共三种 default，blue，orange

2021/03/11 V1.2.3(已发布)

  • 隐藏日历时，由隐藏元素改为移除元素

2021/02/04 V1.2.2(已发布)

  • 修复部分bug

2021/02/02 V1.2.1(已发布)

  • 修复部分bug，extend方法、multiple日历的shortcut设置

2021/02/01 V1.2.0(已发布)

  • 周次选择器
  • iconfont从cdn改为本地
  • 修复部分bug

2021/01/28 V1.1.0(已发布)

更新功能点

  • 移除moment.js，改为dayjs
  • 处理初始化日期为空的状态
  • 增加不可选日期配置方法 disableDate
  • 改为webpack打包
  • 剔除jquery

概要

此选择器比较了市面上各种不同的日期时间选择器，争取最大化的支持各种需要的功能，目前支持的选择器类型有：

  • 单日期选择
  • 单日期时间选择
  • 日期/日期时间区间选择
  • 单月选择
  • 月份区间选择
  • 单年度选择
  • 年度区间选择
  • 按周选择
  • 多日期选择

后续还将增加其他的类型和配置，敬请期待哦！

如果选择器不能满足您的使用需求，请提交issue，我将尽快对选择器进行更新。

选择器样式示例：

avatar avatar avatar avatar avatar avatar avatar

使用步骤

下载代码

引用js

<script type="text/javascript" src="./dist/xndatepicker.min.js"></script>

初始化选择器

var xndatepicker=new XNDatepicker(
$("#date"),//日历容器，可以是input，或其他标签
{
        isMobile:true,//是否是移动端
        // pc端支持的类型
        type:'daterange',日历类型 date,datetime,daterange,datetimerange,month,monthrange,year,yearrange,week,multiple,weeknum,weeknumrange
        // 移动端支持的类型
        type:'daterange',日历类型 date,datetime,daterange,datetimerange,month,monthrange,year,yearrange,weeknum,weeknumrange
        
        
        //pc端特有属性
        showWeek: true,//是否显示周几
        linkPanels:false,//双日历面板联动
        firstDayOfWeek:7,//周起始日 1-7
        disableDate:function(date,dayjs,calcType){//还未对初始时间做处理
                        if(dayjs(date).format('YYYY')=='2019')//当前是2019年时不可选
                            return true;
                        if(calcType=='month' && dayjs(date).format('MM')=='09')//当当前显示的是月选择器，而且月份为09的时候不可选
                            return true;
                        return false;
                    }
                    
        //移动端特有属性 
        scrolllist:['hour','minute','second'],//滚动条的显示设置，不写则使用默认配置
        
        shortList: [],//快捷选项，不写使用默认快捷选项
        
        placeholder:{startTime:'请选择',endTime:'请选择结束时间'},
        
        locale:{//本地化参数配置
            month:[
                '1月',
                '2月',
                '3月',
                '4月',
                '5月',
                '6月',
                '7月',
                '8月',
                '9月',
                '10月',
                '11月',
                '12月',
            ],
            
            //** pc端特有
            monthHead:[ 
                '1月',
                '2月',
                '3月',
                '4月',
                '5月',
                '6月',
                '7月',
                '8月',
                '9月',
                '10月',
                '11月',
                '12月',
            ],
            week:['日','一','二','三','四','五','六'],
            clear:'清空',
            //**//
            
            cancel:'取消',
            confirm:'确定',
            yearHeadSuffix: function(year){//日历头部年份显示
                return year+'年'
            },
            weekNum:function(weeknum){//周次选择器显示
                return '第'+weeknum+'周'
            }
            
            //移动端特有
            dateSuffix:'日',
            hourSuffix:'时',
            minuteSuffix:'分',
            secondSuffix:'秒',
        },//显示信息
        confirmFirst:true,//初始化的时候就触发confirm
        separator:' 到 ',//双日历模式下的链接符
        showClear:true,//是否显示清除按钮
        autoConfirm:true,//单日历模式，和周日历模式，是否自动确定
        showShortKeys:true,//是否显示快捷选项
        showType:'modal',//显示样式
        autoFillDate:true,//自动变更element里面的值，如果自动变更，则按照插件样式显示
        
        theme:'default',//主题
        //自带主题有 green pink blue orange
        //可以自定义主题，例如 设置theme为red，则需要引用自定义css，css内容请参考 theme.css文件
        
        
        multipleDates:[],//当为多选日期类型时的初始值
        startTime:'',//初始开始时间
        endTime:'',//初始结束时间
        minDate:'',//最小时间
        maxDate:'',//最大时间
        
    },
    function(data){ 
    //选择日期后的回调函数
    //data.startTime,data.endTime,data.dayjs
        console.log(data)
    },)

方法

  • 日期格式化 xndatepicker.format(date,formatString)
  • 销毁实例 xndatepicker.destroy()
  • 更新日期 xndatepicker.resetDate(startTime,endTime)

示例代码请参考 index.html

后续功能点

  • 移动端的支持 - 已支持
  • 多主题的支持 - 已支持