mpvue-calendar 基于vue-calendar的适配mpvue平台的的微信小程序日历组件

网友投稿 1859 2022-10-13

mpvue-calendar 基于vue-calendar的适配mpvue平台的的微信小程序日历组件

mpvue-calendar 基于vue-calendar的适配mpvue平台的的微信小程序日历组件

mpvue-calendar

基于vue-calendar的适配mpvue平台的的微信小程序日历组件,现在已可以使用在浏览器

预览

安装

npm i mpvue-calendar -S

使用

import Calendar from 'mpvue-calendar' 引入组件import 'mpvue-calendar/src/style.css' 引入样式文件(mpvue 小程序端)components中注册组件Calendar template中使用组件

⚠️ 在浏览器端使用要引入下面browser-style.css替换上面的style.css

import 'mpvue-calendar/src/browser-style.css' 引入样式文件(浏览器端)

参数及方法

参数or方法类型说明默认值
monthsArray自定义月份显示['一月', '二月', ... , '十二月']
weeksArray自定义星期显示['日', '一', '二', '三', '四', '五', '六']
valueArray选中日期,具体用法见下-                                                    
beginArray设置可用日期开始时间,在此之前的日期会被禁用,不传则不限制。例如想禁用2018-6-21日之前的所有日期,设为[2018, 6, 21]-
endArray设置可用日期结束时间,在此之后的日期会被禁用,不传则不限制。例如想禁用2022-10-8日之后的所有日期,设为[2022, 10, 8]-
disabledArray禁用指定日期,如禁用2018-6-21日为['2018-6-21']-
eventsObject自定义事件备注-
lunarBoolean是否显示农历false
monFirstBoolean是否日期以星期一作为开始false (默认为星期日开头)
completionBoolean是否补全日期,设为true时会以每月6行展示,不足6行的会用下月日期补全false
cleanBoolean是否为简洁模式,简洁模式下自定义备注会显示为圆点false
nowBoolean or String是否显示今日,传入字符串时可以自定义日历上今日的文字true
almanacsObject自定义节日,如{'11-14': '学生日', '11-22': '感恩日'}, 自定义节日会覆盖组件的默认节日信息-
tileContentArray为每个具体日期自定义class和插入文本内容,具体用法见下-
rangeBoolean是否为范围模式false
multiBoolean是否为多选模式false
weekSwitchBoolean是否为按周切换日期模式false
arrowLeftString自定义左箭头图片,填写图片路径,不填则使用默认字体图标-
arrowRightString自定义右箭头图片,填写图片路径,不填则使用默认字体图标-
responsiveBoolean是否启用样式自适应(只支持浏览器端),会自动调整日历内部元素到合适大小false
monthRangeArray会根据传入的开始年月到结束年月,显示多个在范围内的月份,如['2019-2', '2020-3']会显示从2019年2月-2020年3月的13个月份日期
rangeMonthFormatString在monthRange传入情况下,用来格式化年月份标题,如'yyyy-MM'则会显示2019-12、'yy年MM月'则会显示19年12月
select(val, val2)function日期选中事件的回调方法,在range模式下val为开始日期、val2为结束日期,非range模式下val为选中日期,val2为日期信息
setToday()function组件实例中的方法,可以返回今日
renderer(year, month, payload)function组件实例中的方法,可以重新渲染指定日期(参数中传入渲染的年份(year)和月份(month),需要为数字类型) 。在weekSwitch模式下,payload传数字(0-5)时,根据周的索引渲染该周。如果传入字符串'1'-'31',则会查找出该年月日所在的周进行渲染
dateInfo(y, m, d)function组件实例中的方法,传入年、月、日三个参数会返回当天的信息(农历、节气、星座、星期、天干地支等)
selectYear(year)function选择年份事件的回调方法,year为选中的年份
selectMonth(month, year)function选择月份事件的回调方法,month为选中的月份,year为选中的年份
prev(year, month, weekIndex)function选择上一月事件的回调方法,参数year为年、month为月份,在weekSwitch模式下,weekIndex为周的索引
next(year, month, weekIndex)function选择下一月事件的回调方法,参数同prev方法一致

参数说明

value 在普通模式下value为一维数组如2018年6月21为[2018,6,21]。在range和multi模式下value为二维数组,如multi模式选中2018年6月21和6月28为[[2018,6,21], [2018,6,28]]。 在range模式下如果定义value参数必须定义开始日期和结束日期,如[[2018,6,21], [2018,6,28]]( ⚠️ 从开始日期到结束日期)。若需要清空选中value时,将value参数设置为[](空数组)即可。events events为自定义备注,例如备注2018年6月21日为{'2018-6-21': '今日备注', '2018-6-22':'明日备注'},在clean模式下备注为圆点,lunar农历模式下备注会替代农历优先展示。now now参数可以选择是否将今天日期展示为今字,传入false则不展示,传入字符串则展示你定义等字符串内容,默认为true,展示今字样。tileContent tileContent参数可以为具体某日定义一个class名,还可以插入一段文本内容。如[{date: '2018-9-20', className: 'holiday', content: '休'}]可以设置2018-9-20这天的class名为holiday,并且生成一个文本内容为 休 的dom节点。

示例

版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。

上一篇:C++核心准则ES.87:不要在条件语句中增加多余的==或!=
下一篇:C++核心准则CP.20:使用RAII,永远不要直接使用lock/unlock
相关文章

 发表评论

暂时没有评论,来抢沙发吧~