当前位置: 首页 > news >正文

JQuery 日程管理组件 FullCalendar 文档

2019独角兽企业重金招聘Python工程师标准>>> hot3.png

1.HTML代码

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>FullCalendar Demo</title>

<link href='fullcalendar-3.2.0/fullcalendar.css' rel='stylesheet' />
<link href='fullcalendar-3.2.0/fullcalendar.print.css' rel='stylesheet' media='print' />
<script src='fullcalendar-3.2.0/lib/moment.min.js'></script>
<script src='fullcalendar-3.2.0/lib/jquery.min.js'></script>
<script src='fullcalendar-3.2.0/fullcalendar.js'></script>
<script src='fullcalendar-3.2.0/locale/zh-cn.js'></script>
<script src='fullcalendar-js-0.0.1.js'></script>
<style>
body {
	margin: 40px 10px;
	padding: 0;
	font-family: "Lucida Grande", Helvetica, Arial, Verdana, sans-serif;
	font-size: 14px;
}

#calendar {
	max-width: 900px;
	margin: 0 auto;
}
</style>
</head>
<body>

	<div id='calendar'></div>
	
	
	<div id="title"></div>
</body>
</html>

 

2.JQuery代码

$(document).ready(function() {
	$('#calendar').fullCalendar({
		defaultDate : '2017-02-02', //默认选中时间
		editable : true, //是否可编辑,即进行可拖动和缩放操作。
		eventLimit : true, // allow "more" link when too many events
		weekends : true,	//是否显示周末,设为false则不显示周六和周日。
		dragRevertDuration : 200,	//如果拖拽不成功,多久回复原状,毫秒
		timeFormat : 'H:mm', //设置显示的日程事件的时间格式,如timeFormat: 'H:mm' 则显示24小时制的像10:30
		axisFormat : 'H:mm',	//设置日历agenda视图下左侧的时间显示格式,默认显示如:5:30pm

		header : {
			left : 'prev,next today',
			center : 'title',
			right : 'month,agendaWeek,agendaDay,listWeek'
		},

		eventDragStart : function(event, jsEvent, ui, view) {
			//日程事件被拖动之前触发。这里的拖动不一定是一个有效的拖动,
			//只要日程事件的控件被拖着动了,事件就触发。 可以从该对象中获取位移,位置等数据。
		},

		eventDragStop : function(event, jsEvent, ui, view) {
			//日程事件被拖动之后触发。这里的拖动不一定是一个有效的拖动,
			//只要日程事件的控件被拖着动了,事件就触发。 可以从该对象中获取位移,位置等数据。
		},

		eventDrop : function(event, dayDelta, minuteDelta, allDay, revertFunc, jsEvent, ui, view) {
			//当拖拽完成并且时间改变时触发
			var content = '';
			var endTime = 'Null';
			if (null != event.end) {
				endTime = event.end.format();
			}

			content = '开始时间:' + event.start.format() + '\t 结束时间:' + endTime + '\t事件:eventDrop';

			$("#title").html(content);

		},

		eventResizeStart : function(event, jsEvent, ui, view) {
			//在一个日程事件改变大小之前触发(不一定要改变成功)
		},

		eventResizeStop : function(event, jsEvent, ui, view) {
			//在一个日程事件改变大小之后触发(不一定要改变成功)
		},

		eventResize : function(event, dayDelta, minuteDelta, revertFunc, jsEvent, ui, view) {
			//在日程事件改变大小并成功后调用, 参数和eventDrop参数用法一致
			var content = '';
			var endTime = 'Null';
			if (null != event.end) {
				endTime = event.end.format();
			}

			content = '开始时间:' + event.start.format() + '\t 结束时间:' + endTime + '\t事件:eventResizeStop';

			$("#title").html(content);
		},

		windowResize : function(view) {
			alert('The calendar has adjusted to a window resize');
		},

		viewRender : function(view, element) {
			$.each($('.fc-bg .fc-day'), function(index, obj) {
				var date = $(obj).attr('data-date');
				$(obj).attr({
					'id' : 'key' + date,
					'name' : date,
					'ck' : 0
				});
			});
		},

		dayClick : function(event, date, allDay, jsEvent, view) {
			var viewModel = $('#calendar').fullCalendar('getView');
			console.info(viewModel.type == 'month');
			if(viewModel.type == 'month'){
				var dom = $('<div>').css({
					width : '30px',
					height : '30px',
					float : 'right',
					marginTop : '70px',
					fontSize : '20px',
					fontColor : 'blue'
				}).text('忙');

				var ckCnt = $(this).attr('ck');
				if (ckCnt == 0) {
					$(this).attr('ck', '1');
					$(this).html(dom);
				} else {
					$(this).attr('ck', '0');
					$(this).html('');
				}
			}
			
		},

		eventClick : function(event, jsEvent, view) {
		},

		events : [ {
			title : 'All Day Event',
			start : '2017-02-01T10:20:00',
			end : '2017-02-01T11:20:00'
		}, {
			title : 'Long Event',
			start : '2017-02-04T10:30:00',
			end : '2017-02-05T11:30:00'
		}, {
			id : 999,
			title : 'Repeating Event',
			start : '2017-02-09T16:00:00'
		}, {
			id : 999,
			title : 'Repeating Event',
			start : '2017-02-16T16:00:00'
		}, {
			title : 'Conference',
			start : '2017-02-11',
			end : '2017-02-13'
		}, {
			title : 'Meeting',
			start : '2017-02-12T10:30:00',
			end : '2017-02-12T12:30:00'
		}, {
			title : 'Lunch',
			start : '2017-02-12T12:00:00'
		}, {
			title : 'Meeting',
			start : '2017-02-12T14:30:00'
		}, {
			title : 'Happy Hour',
			start : '2017-02-12T17:30:00'
		}, {
			title : 'Dinner',
			start : '2017-02-12T20:00:00'
		}, {
			title : 'Birthday Party',
			start : '2017-02-13T07:00:00'
		}, {
			title : 'Click for Baidu',
			url : 'http://baidu.com',
			start : '2017-02-28'
		} ]
	});

});

 

3.开发文档

3.1 普通显示设置

属性描述默认值
header设置日历头部信息。
如果设置为false,则不显示头部信息。包括left,center,right左中右三个位置,每个位置都可以对应以下不同的配置:
title: 显示当前月份/周/日信息
prev: 用于切换到上一月/周/日视图的按钮
next: 用于切换到下一月/周/日视图的按钮
prevYear:用于切换到上一年视图的按钮
nextYear:用于切换到下一年视图的按钮
{
left: 'title',
center: '',
right: 'today prev,next'
}
theme是否允许使用jquery的ui主题,如果设置为true,则需要加载jquery ui相关css和js文件。 查看演示false
buttonIcons设置header中使用的prev, next等变量对应按钮的样式,只有当theme为true时才有效,如果你调用了jQuery ui样式但又不想使用它的图标样式,可以将此属性设置为false{ prev: 'circle-triangle-w', next: 'circle-triangle-e' }
firstDay设置一周中显示的第一天是哪天,周日是0,周一是1,类推。0
isRTL设置为ture时则日历从右往左显示,貌似是针对阿拉伯人设计的。false
weekends是否显示周末,设为false则不显示周六和周日。true
hiddenDays隐藏一周中的某一天或某几天,数组形式,如隐藏周二和周五:[2,5],默认不隐藏,除非weekends设置为false。[]
weekMode在月视图里显示周的模式,因为每月周数可能不同,所以月视图高度不一定。
fixed:固定显示6周高,日历高度保持不变
liquid:不固定周数,高度随周数变化
variable:不固定周数,但高度固定
'fixed'
weekNumbers是否在日历中显示周次(一年中的第几周),如果设置为true,则会在月视图的左侧、周视图和日视图的左上角显示周数。false
weekNumberCalculation周次的显示格式。"iso"
height设置日历的高度,包括header日历头部,默认未设置,高度根据aspectRatio值自适应。 
contentHeight设置日历主体内容的高度,不包括header部分,默认未设置,高度根据aspectRatio值自适应。 
aspectRatio设置日历单元格宽度与高度的比例。1.35
handleWindowResize是否随浏览器窗口大小变化而自动变化。true
windowResizecallback,当浏览器窗口变化时触发function,使用:
$('#calendar').fullCalendar({
windowResize: function(view) {
alert('The calendar has adjusted to a window resize');
}
});
 
rendermethod,绑定日历到id上。
$('#id').fullCalendar('render');
destroymethod,销毁id日历,把日历回复到初始化前状态。
$('#id').fullCalendar('destroy');

3.2 视图

FullCalendar提供五种可用视图,包括month(月视图),basicWeek(基本周视图,左侧不显示具体时间),basicDay(基本日视图,左侧不显示具体时间),agendaWeek(周视图),agendaDay(日视图)。

View视图对象的属性:

属性描述
name包括month,basicWeek,basicDay,agendaWeek,agendaDay
title标题内容(例如"2013年9月" or "Sep 7 - 13 2013")
startDate类型, 该view下的第一天
endDate类型, 该view下的最后一天. 由于是一个闭合的值, 所以, 比如在month view下, 10月这个月份, 那么end对应的应该是11月的第一天
visStartDate类型. 在该view下第一个可以访问的day. month view下, 该值是当月的第一天, week view下, 则通常和start一致
visEndDate类型, 最后一个可访问的day

View其他属性和方法

属性描述默认值
defaultView日历初始化时默认视图'month'
getViewmethod,取得视图对象信息,如获取当前视图的标题内容:
var view = $('#calendar').fullCalendar('getView'); alert("The view's title is " + view.title);
changeViewmethod,切换视图
.fullCalendar('changeView',viewName)
viewName为5种视图中的一种

3.3 日程选项

以下选项设置适用于agendaWeek和agendaDay视图里。

属性描述默认值
allDaySlot在agenda视图模式下,是否在日历上方显示all-day(全天)true
allDayText定义日历上方显示全天信息的文本'all-day'
axisFormat设置日历agenda视图下左侧的时间显示格式,默认显示如:5:30pm'h(:mm)tt'
slotMinutes在agenda的视图中, 两个时间之间的间隔(分钟)30
defaultEventMinutes事件默认的时间执行长度,如果事件对象没有指定执行多长时间,则默认执行两个小时120
firstHour当切换到agenda时,初始滚动条滚动到的时间位置,默认在6点钟的位置6
minTime设置显示的时间从几点开始0
maxTime设置显示的时间从几天结束24
slotEventOverlap设置视图中的事件显示是否可以重叠覆盖true

3.4 当前日期设置

属性描述默认值
year设置日历年份,必须为4位如:2013,如果不设置则默认为当前年份 
month设置初始化日历的月份,从0开始,如果年份和月份都未指定,则从一月开始。 
date设置日历初始化时的日期,只有在周视图和日视图中有效 
prevmethod,进入到上一月(周、天)视图
$('#calendar').fullCalendar('prev');
nextmethod,进入到下一月(周、天)视图
$('#calendar').fullCalendar('next');
prevYearmethod,进入上一年视图
nextYearmethod,进入下一年视图
todaymethod,进入当天
gotoDatemethod,指定进入日历中的某一天
$('#calendar').fullCalendar( 'gotoDate', year [, month, [ date ]] )
incrementDatemethod, 以当前时间为轴, 将日历向前, 或向后移动指定长度的时间, 比如: $('#calendar').fullCalendar(‘incrementDate’, -3, 2, -5)就表示将日历年份向前移动3年, 月份向后移动2月, day(天数)向前移动5天。
getDatemethod,返回当前日历中的日期

3.5 文本与时间定制

你可以根据项目需求设置日历显示的文本信息,如中文的月份等。

属性描述默认值
timeFormat设置显示的日程事件的时间格式,如timeFormat: 'H:mm' 则显示24小时制的像10:30{agenda: ‘h:mm{ - h:mm}}
columnFormat设置显示日历每列表头信息的格式文本,默认:
{
month: 'ddd', // Mon
week: 'ddd M/d', // Mon 9/7
day: 'dddd M/d' // Monday 9/7 }
见描述
titleFormat设置用于显示日历头部的文本信息,默认:
{
month: 'MMMM yyyy', // September 2013
week: "MMM d[ yyyy]{ '—'[ MMM] d yyyy}", // Sep 7 - 13 2013
day: 'dddd, MMM d, yyyy' // Tuesday, Sep 8, 2013
}
见描述
buttonText设置日历头部各按钮的显示文本信息,默认:
{
prev: '‹', // ‹
next: '›', // ›
prevYear: '«', // «
nextYear: '»', // »
today: 'today',
month: 'month',
week: 'week',
day: 'day'
}
见描述
monthNames月份全称,默认:
['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']
见描述
monthNamesShort月份名称简写,默认:['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun' 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']见描述
dayNames星期全称,默认:['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday']见描述
dayNamesShort星期名称简写,默认:['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']见描述
weekNumberTitle周次,即一年中的第几周"W"

3.6 鼠标单击和滑过

以下列出的是当鼠标单击或者滑过日历中的某个元素时,回调的函数callback。

属性描述
dayClick当单击日历中的某一天时,触发callback,用法:
$('#calendar').fullCalendar({
dayClick: function(date, allDay, jsEvent, view) {
do something...
}
});
date是点击的day的时间(如果在agenda view, 还包含时间),在月view下点击一天时,allDay是true,在agenda模式下,点击all-day的窄条时,allDay是true,点击其他的agenda view下的day则为false,jsEvent就是一个普通的javascript事件,包含的是click事件的基础信息。
eventClick当点击日历中的某一日程(事件)时,触发此操作,用法:
$('#calendar').fullCalendar({
dayClick: function(event, jsEvent, view) {
do something...
}
});
event是日程(事件)对象,jsEvent是个javascript事件,view是当前视图对象。
eventMouseover
eventMouseout
鼠标划过和离开的事件,用法和参数同上

3.7 选择操作

属性描述默认值
selectable是否允许用户通过单击或拖动选择日历中的对象,包括天和时间。false
selectHelper当点击或拖动选择时间时,显示默认加载的提示信息,该属性只在周/天视图里可用。false
unselectAuto当点击页面日历以外的位置时,是否自动取消当前的选中状态。true
unselectCancel指定哪些元素不会清空当前的选中,以JQUERY选择器的方式指定 '#someId'。''
selectcallback,被选中的函数回调,使用方法:
function( startDate, endDate, allDay, jsEvent, view )
startDate:被选中区域的开始时间
endDate:被选中区域的结束时间
allDay:是否为全天事件
startDate:jascript对象
startDate:当前视图对象
 
unselectcallback,选中被取消时的回调,使用方法:
function( view, jsEvent )
selectmethod,选中某个时间,使用方法:
$('#calendar').fullCalendar( 'select', startDate, endDate, allDay )
unselectmethod,取消选中,使用方法:
$('#calendar').fullCalendar( 'unselect' )

3.8 日程事件数据

FullCalendar最重要的部分,设置用于日程事件相关信息。

Event Object,事件对象,用来存储一个日历事件信息的标准对象,只有title和start是必须的

属性描述
id可选,事件唯一标识,重复的事件具有相同的id
title必须,事件在日历上显示的title
allDay可选,true or false,是否是全天事件。
start必须,事件的开始时间。
end可选,结束时间。
url可选,当指定后,事件被点击将打开对应url。
className指定事件的样式。
editable事件是否可编辑,可编辑是指可以移动, 改变大小等。
source指向次event的eventsource对象。
color背景和边框颜色。
backgroundColor背景颜色。
borderColor边框颜色。
textColor文本颜色。

3.9 事件源对象

事件源即日历中的数据来源,FullCalendar提供了数组、函数调用、以及JSON数据的形式,当然也可以通过Google Calendar feed获取数据接口。helloweba.com后面会有文章专门介绍事件数据的操作,包括数据的查询、写入、更新和删除操作。

以下是Event事件相关的参数属性说明。

属性描述默认值
eventSources事件源,存储数组对象,可以是Arrays/Functions/URLs。 
allDayDefault是否为全天日程事件,显示这一天中所做的事情。true
ignoreTimezone是否忽略时区。true
startParam在使用URL方式获取events数据源的时候, 自动插入到URL中的参数, 表示当前需要抓取的日程事件的起始时间。'start'
endParam和startParam参数意义相同, 表示要抓取的日程事件的终止时间。'end'
lazyFetching是否从缓存信息获取event。比如从月视图切换到周视图。true
eventDataTransformcallback,将外部数据源转换成Fullcalendar可以处理的数据
loadingcallback,日历开始加载的时候,isLoading参数为true触发一次,日历加载完毕,isLoading参数为false触发一次,用法:
function(isLoading, view)
updateEventmethod,更新日历空间中的一个日程事件,如果是重复的日程事件,则都更新。用法:
$('#calendar').fullCalendar( 'updateEvent', event )
clientEventsmethod,返回FullCalendar已经存储到客户端的CalEvents对象数组, 第二个参数和removeEvents方法的第二个参数意义相同, 只不过在过滤器中, 如果返回true, 则该CalEvent对象将被加入到返回的数组中。
removeEventsmethod,从日历中删除一个日程事件. 第二个参数可以不填, 可以填id, 可以是一个过滤器(一个函数, 接受CalEvent对象作为参数)。用法:
$('#calendar').fullCalendar( 'removeEvents' [, idOrFilter ] )
refetchEventsmethod,重新抓取所有的日程事件源上的日程事件并渲染它们。
addEventSourcemethod,添加一个日程事件源,添加之后, FullCalendar会马上从该源获取日程事件, 并加载到日历中。第二个参数和定义Calendar时候使用的url参数一致。
removeEventSourcemethod,移除一个日程事件源,该源上获取得到的日程时间也将被马上从日历中移除。

3.10 事件渲染

属性描述
eventColor
eventBackgroundColor
eventBorderColor
eventTextColor
设置日程事件的背景色和边框色,以及文本颜色。可以使用任意支持css的颜色方式,如 #f00, #ff0000, rgb(255,0,0), or red。
eventRendercallback,当日程事件渲染时触发,用法:
function(calEvent, element, view)
eventAfterRendercallback,当日程事件被渲染后触发,用法:
function( event, element, view ) { }
eventDestroycallback,当日程事件移出时触发,用法:
function( event, element, view ) { }
renderEventmethod,一旦日历重新取得日程源,则原有日程将消失,当指定stick为true时,日程将永久的保存到日历上。
rerenderEventsmethod,重新渲染所有事件。

3.11 日程事件拖动和缩放

拖动和缩放功能依赖于jQuery ui的draggable和resizable,所以在使用时要提前加载jQuery ui相关插件。

属性描述默认值
editable是否可编辑,即进行可拖动和缩放操作。false
eventStartEditable是否让事件在开始时就可以拖动。true
dragRevertDuration如果拖拽不成功,多久回复原状,毫秒500
dragOpacity拖动时候的不透明度。
{
agenda:.5 //对于agenda试图
'':1.0 //其他视图
}
见描述
eventDragStart,
eventDragStop
callback,日程事件被拖动之前和之后触发。这里的拖动不一定是一个有效的拖动,只要日程事件的控件被拖着动了,事件就触发。 可以从该对象中获取位移,位置等数据。用法: function( event, jsEvent, ui, view ) { }
eventDropcallback,当拖拽完成并且时间改变时触发,用法:
function( event, dayDelta, minuteDelta, allDay, revertFunc, jsEvent, ui, view ) { }
ayDelta 保存日程向前或者向后移动了多少天
minuteDelta 这个值只有在agenda视图有效,移动的时间
allDay 如果是月视图,或者是agenda视图的全天日程,此值为true,否则为false
eventResizeStart, 
eventResizeStop
callback,在一个日程事件改变大小之前之后发生(不一定要改变成功),用法:
function( event, jsEvent, ui, view ) { }
eventResizecallback,在日程事件改变大小并成功后调用, 参数和eventDrop参数用法一致。用法:
function( event, dayDelta, minuteDelta, revertFunc, jsEvent, ui, view ) { }

3.12 日期工具

函数描述
formatDate格式化日期,通过指定的格式格式化一个日期,返回一个字符串。options选项是一个对象,其中设置本地化变量支持的属性值. 比如{ monthNames : ['一月','二月',……],dayNames: ['周日','周一',…..]},用法:
$.fullCalendar.formatDate( date,formatString [,options ] )
formatDates一次格式化两个日期,和上一个格式化日期类似,只不过,这里在formatString中使用大括号{…}来描述第二个日期的格式化方式。用法:
$.fullCalendar.formatDates( date1,date2,formatString [,options ] )
parseDate解析日期,将一个字符串格式成一个javascript的Date对象,这个string可以是ISO8601,IETF,UNIX时间戳三种格式。用法:
$.fullCalendar.parseDate( string )
parseISO8601将一个ISO8601字符串转换成一个javascript 的Date对象。用法:
$.fullCalendar.parseISO8601( string [,ignoreTimezone ] )

转载于:https://my.oschina.net/u/2433960/blog/913499

相关文章:

  • 索引
  • 黄东旭:When TiDB Meets Kubernetes
  • c# FileSystemWatcher控件的使用方法
  • Android 自己定义View学习(2)
  • redis订阅/发布 分享
  • 红与黑
  • 读取Web.Config中的设置参数之二
  • 自学有感7
  • Http之Get/Post请求区别
  • 清河好程序猿训练营是什么?
  • 分享:Ajax工具文件
  • 洛谷P1287 盒子与球 数学
  • 识别地图上的地名-- 笔记一
  • 如何破解来自私有云的安全挑战
  • SQL优化34条[转载]
  • 【剑指offer】让抽象问题具体化
  • 【跃迁之路】【735天】程序员高效学习方法论探索系列(实验阶段492-2019.2.25)...
  • co.js - 让异步代码同步化
  • docker-consul
  • javascript 哈希表
  • LeetCode18.四数之和 JavaScript
  • 服务器之间,相同帐号,实现免密钥登录
  • 技术胖1-4季视频复习— (看视频笔记)
  • 经典排序算法及其 Java 实现
  • 快速体验 Sentinel 集群限流功能,只需简单几步
  • 时间复杂度与空间复杂度分析
  • 世界上最简单的无等待算法(getAndIncrement)
  • 双管齐下,VMware的容器新战略
  • 通过来模仿稀土掘金个人页面的布局来学习使用CoordinatorLayout
  •  一套莫尔斯电报听写、翻译系统
  • Oracle Portal 11g Diagnostics using Remote Diagnostic Agent (RDA) [ID 1059805.
  • AI算硅基生命吗,为什么?
  • 长三角G60科创走廊智能驾驶产业联盟揭牌成立,近80家企业助力智能驾驶行业发展 ...
  • #define用法
  • #基础#使用Jupyter进行Notebook的转换 .ipynb文件导出为.md文件
  • $(document).ready(function(){}), $().ready(function(){})和$(function(){})三者区别
  • (11)工业界推荐系统-小红书推荐场景及内部实践【粗排三塔模型】
  • (2021|NIPS,扩散,无条件分数估计,条件分数估计)无分类器引导扩散
  • (Matalb回归预测)PSO-BP粒子群算法优化BP神经网络的多维回归预测
  • (Spark3.2.0)Spark SQL 初探: 使用大数据分析2000万KF数据
  • (附源码)springboot课程在线考试系统 毕业设计 655127
  • (附源码)ssm失物招领系统 毕业设计 182317
  • (转)Oracle 9i 数据库设计指引全集(1)
  • *_zh_CN.properties 国际化资源文件 struts 防乱码等
  • .net 4.0发布后不能正常显示图片问题
  • .net core 源码_ASP.NET Core之Identity源码学习
  • .NET轻量级ORM组件Dapper葵花宝典
  • .pyc文件是什么?
  • /proc/vmstat 详解
  • /var/lib/dpkg/lock 锁定问题
  • ;号自动换行
  • @RequestBody与@ModelAttribute
  • @RequestParam @RequestBody @PathVariable 等参数绑定注解详解
  • @transaction 提交事务_【读源码】剖析TCCTransaction事务提交实现细节
  • [2019.2.28]BZOJ4033 [HAOI2015]树上染色