JS日程管理插件FullCalendar提供了丰富的属性设置和方法调用,开发者可以根据FullCalendar提供的API快速完成一个日历日程的开发,本文将FullCalendar的常用属性和方法、回调函数等整理成中文文档,以供参阅
属性不显示头部信息。包括left,center,right左中右三个位置,每个位置都可以对应以下不同的配置:
title: 显示当前月份/周/日信息
prev: 用于切换到上一月/周/日视图的按钮
next: 用于切换到下一月/周/日视图的按钮
prevYear:用于切换到上一年视图的按钮
nextYear:用于切换到下一年视图的按钮主题,如果设置为true,则需要加载相关css和js文件。
视图
FullCalendar提供五种可用视图,包括month(月视图),basicWeek(基本周视图,左侧不显示具体时间),basicDay(基本日视图,左侧不显示具体时间),agendaWeek(周视图),agendaDay(日视图)。
View视图对象的属性:
View其他属性和方法
日程选项
以下选项设置适用于agendaWeek和agendaDay视图里。
当前日期设置
文本与时间定制
你可以根据项目需求设置日历显示的文本信息,如中文的月份等。
鼠标单击和滑过
以下列出的是当鼠标单击或者滑过日历中的某个元素时,回调的函数callback。
选择操作
日程事件数据
FullCalendar最重要的部分,设置用于日程事件相关信息。
Event Object,事件对象,用来存储一个日历事件信息的标准对象,只有title和start是必须的
事件源对象
事件源即日历中的数据来源,FullCalendar提供了数组、函数调用、以及JSON数据的形式,当然也可以通过Google Calendar feed获取数据接口。jb51.cc后面会有文章专门介绍事件数据的操作,包括数据的查询、写入、更新和删除操作。
以下是Event事件相关的参数属性说明。
事件渲染
日程事件拖动和缩放
拖动和缩放功能依赖于jQuery ui的draggable和resizable,所以在使用时要提前加载相关插件。
属性回复原状,毫秒获取位移,位置等数据。用法: function( event,ui,view ) { }用法:
function( event,dayDelta,minuteDelta,revertFunc,view ) { }
ayDelta 保存日程向前或者向后移动了多少天
minuteDelta 这个值只有在agenda视图有效,移动的时间
allDay 如果是月视图,或者是agenda视图的全天日程,此值为true,否则为false用法:
function( event,view ) { }调用,参数和eventDrop参数用法一致。用法:
function( event,view ) { }
日期工具
函数支持的属性值. 比如{ monthNames : ['一月','二月',……],dayNames: ['周日','周一',…..]},用法:
$.fullCalendar.formatDate( date,formatString [,options ] )用法:
$.fullCalendar.formatDates( date1,date2,formatString [,options ] )用法:
$.fullCalendar.parseDate( string )用法:
$.fullCalendar.parseISO8601( string [,ignoreTimezone ] )
以上是FullCalendar
插件的基本
属性与
方法,您可以查看
文章进行实际操作
参考文献:
官方文档:
FullCalendar 官方文档翻译:中文API官方文档