FullCalendar中文帮助文档
1.与google日历连接，别忘记加入<script type='text/javascript' src='js/gcal.js'/>
events: $.fullCalendar.gcalFeed
("http://www.google.com/calendar/feeds/xuqi86@gmail.com/private-660ae86cc26345cff3430480e8eea4bb/basic",
{
className:'gcal-event',
editable:true,
currentTimezone:'Asia/Shanghai'
}
)
2.表头信息
agenda带有具体的时间格子
month,basicWeek,basicDay,agendaWeek,agendaDay 是5种不同的视图
空格和,的区别
header:{
left: 'month,basicWeek,basicDay,agendaWeek,agendaDay',
center: 'title',
right: 'prevYear,prev,today,next,nextYear'
}
3.是否使用 jquery的主题(我用的是start主题)
<link type="text/css" href="css/start/jquery-ui-1.7.2.custom.css" rel="stylesheet" />
<script type="text/javascript" src="js/jquery-ui-1.7.2.custom.min.js"></script>
<script type='text/javascript' src='js/jquery.js'>
theme:true
4.
buttonText:{
prev: '昨天',
next: '明天',
prevYear: '去年',
nextYear: '明年',
today: '今天',
month: '月',
week: '周',
day: '日'
}
5.每周的第一天是哪天
Sunday=0, Monday=1, Tuesday=2, etc.
firstDay:1
6.日期从右向左显示...不知道什么时候会这么用
isRTL:false
7.是否显示周末
weekends:true
8.在月视图里显示周的模式，因为可能每月周数不同，所以月视图高度不一定，注意引号
fixed 固定显示6周高，高度永远保持不变
liquid 不固定周数，周高度可变化
variable 不固定周数，但高度固定
weekMode:'fixed'
9.日历高度,包括表头
height: 850
内容高度，不包括表头
contentHeight: 600
10.单元格宽与高度的比值
注意：此属性不能与日历高度同时存在
aspectRatio: 1.35
11.切换视图的时候要执行的操作
view是一个对象，后面将说道具体的属性
viewDisplay:function(view){}
12.窗口大小变化时执行的操作
windowResize: function(view){}
13.把日历绑定到一个id的东西上
$('#id').fullCalendar('render');
14.销毁id日历
把日历回复到初始化前，删除了所有元素，时间，和初始化数据
$('#id').fullCalendar('destroy');
15.默认显示的视图，注意引号
defaultView:'month'
16.view对象的属性
name: 包括month,basicWeek,basicDay,agendaWeek,agendaDay
title: 标题内容(例如"September 2009" or "Sep 7 - 13 2009")
start:Date类型, 该view下的第一天.
end:Date类型, 该view下的最后一天. 由于是一个闭合的值, 所以, 比如在month view下, 10月这个月份, 那么end对应的应该是11月的第一天.
visStart:Date类型. 在该view下第一个可以访问的day. month view下, 该值是当月的第一天, week view下, 则通常和start一致.
visEnd: Date类型, 最后一个可访问的day
17.集中设定初始化值
可以设置的属性有 dragOpacity, titleFormat, columnFormat, and timeFormat
被应用的视图有
{
month: // month view
week: // basicWeek & agendaWeek views
day: // basicDay & agendaDay views
agenda: // agendaDay & agendaWeek views
agendaDay: // agendaDay view
agendaWeek: // agendaWeek view
basic: // basicWeek & basicDay views
basicWeek: // basicWeek view
basicDay: // basicDay view
'': // (an empty string) when no other properties match
}
18.取得视图对象
.fullCalendar('getView')->View Object
var view = $('#calendar').fullCalendar('getView');
alert("The view's title is " + view.title);
19.改变当前视图
.fullCalendar('changeView',viewName)
20.20里以下属性都是在agenda视图里起作用的
在agenda开头的视图里，是否显示最上面all-day那一栏
allDaySlot:true
默认的文字:
allDayText:'今天的任务'
左边那一列时间的格式:
axisFormat:'h(:mm)tt'
()表示整点就不显示里面的内容
支持的格式化占位符
1. s: 秒
2. ss: 秒, 两位
3. m: 分钟
4. mm: 分钟, 两位
5. h: 小时, 12小时制
6. hh: 小时, 12小时制, 两位
7. H: 小时, 24小时制
8. HH: 小时, 24小时制, 两位
9. d: 日期数字
10. dd: 日期数字, 两位
11. ddd: 日期名称, 缩写
12. dddd: 日期名称, 全名
13. M: 月份数字
14. MM: 月份数字, 两位
15. MMM: 月份名称, 缩写
16. MMMM: 月份名称, 全名
17. yy: 两位的年份
18. yyyy: 4位的年份
19. t: 上下午加 a或者p
20. tt: 上下午加am或pm
21. T: 上下午加A 或者P
22. TT: 上下午加AM或PM
23. u: ISO8601格式
24. S: 给日期加上st, nd, rd, th等后缀, 表明是第几天
每行的时间间隔
slotMinutes:10
滚动条滚动到得起始时间
firstHour: 7
每天从几点起开始显示
minTime:7
minTime:'7:30'
如果加上了分钟需要设置时间间隔
每天显示到几点结束
maxTime:24
maxTime:'23:10'
事件默认的时间执行长度
defaultEventMinutes:120
此时，如果事件对象没有指定执行多长时间，则默认执行两个小时，后面将说到事件对象
21.当前日期
year: 必须是4位数字，如果不指定，则是当前年
month: 当前月，从0开始，如果当前年和月都未指定，则月显示为1月
date:日期的一个月，这个属性只和周视图和日视图有关，如果没指定，并且年月也没有指定，则显示一个月的第一天
以下8个关于操作日期的方法
.fullCalendar('prev') 返回到上一个年月日，与视图的种类有关
.fullCalendar('next')
.fullCalendar('prevYear')
.fullCalendar('nextYear')
.fullCalendar('today')
.fullCalendar( 'gotoDate', year [, month, [ date ]] ) 注意月从0开始
.fullCalendar( 'incrementDate', years [, months, [ days ]] )
.fullCalendar( 'getDate' ) -> Date 取得一个日期对象
$('#my-button').click(function() {
var d = $('#calendar').fullCalendar('getDate');
alert("The current date of the calendar is " + d);
});
22.指定默认的时间格式
timeFormat:h(:mm)tt
23.指定默认的列格式
columnFormat:{
month: 'ddd', // Mon
week: 'ddd M/d', // Mon 9/7
day: 'dddd M/d' // Monday 9/7
}
24.标题格式化
titleFormat:{
month: 'MMMM yyyy', // September 2009
week: "MMM d[ yyyy]{ '—'[ MMM] d yyyy}", // Sep 7 - 13 2009
day: 'dddd, MMM d, yyyy' // Tuesday, Sep 8, 2009
}
25.月显示的名字
monthNames:['January', 'February', 'March', 'April', 'May', 'June', 'July',
'August', 'September', 'October', 'November', 'December']
monthNames:['一月','二月', '三月', '四月', '五月', '六月', '七月',
'八月', '九月', '十月', '十一月', '十二月']
月名字的简写
monthNamesShort:['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun'
'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
26.星期显示的名字
dayNames:['Sunday', 'Monday', 'Tuesday', 'Wednesday',
'Thursday', 'Friday', 'Saturday']
dayNames:['星期日', '星期一', '星期二', '星期三',
'星期四', '星期五', '星期六']
星期名字的缩写
dayNamesShort:['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
27.4个关于鼠标的回调方法
当点击某一天时触发此操作
dayClick:function( date, allDay, jsEvent, view ) { }
dayClick: function(date, allDay, jsEvent, view) {
if (allDay) {
alert('Clicked on the entire day: ' + date);
}else{
alert('Clicked on the slot: ' + date);
}
alert('Coordinates: ' + jsEvent.pageX + ',' + jsEvent.pageY);
alert('Current view: ' + view.name);
// change the day's background color just for fun
$(this).css('background-color', 'red');
}
当点击某一个事件时触发此操作
eventClick:function( event, jsEvent, view ) { }
eventClick: function(calEvent, jsEvent, view) {
alert('Event: ' + calEvent.title);
alert('Coordinates: ' + jsEvent.pageX + ',' + jsEvent.pageY);
alert('View: ' + view.name);
// change the border color just for fun
$(this).css('border-color', 'red');
}
当鼠标悬停在一个事件上触发此操作
eventMouseover:function( event, jsEvent, view ) { }
当鼠标从一个事件上移开触发此操作
eventMouseout:function( event, jsEvent, view ) { }
28.事件对象
fullcalendar用来存储一个日历事件信息的标准对象
一下属性中，只有title和start是必须的
id:String/Integer (optional)
title:String
allDay:true or false (optional) 指定是否是全天事件
start:Date 事件开始时间，格式如下
IETF format (ex: "Wed, 18 Oct 2009 13:00:00 EST")
ISO8601 format (ex: "2009-11-05T13:15:30Z")
end: Date (optional) 事件结束时间
如果事件是一个全天事件，则结束时间包括在内
如果事件不是全天事件，结束时间是0:00，则结束时间的第二天不包括在内
url:String (optional) 当用户点击时，将会访问的网址
className: String/Array (optional) 这个事件使用的css 类名
editable:true or false (optional) 事件是否可编辑
source: Array/String/Function (automatically populated) 事件源，自动指定
除了以上属性外，你可以自己指定属性和值
29.事件数组 events (as an array)
events: [
{
title : 'event1',
start : '2010-01-01'
},
{
title : 'event2',
start : '2010-01-05',
end : '2010-01-07'
},
{
title : 'event3',
start : '2010-01-09 12:30:00',
allDay : false // will make the time show
}
]
事件Json源 events (as a json feed)
events: "/myfeed.php" 该URL返回一个json或数组的日程事件组, GET参数视startParam和endParam选项而定
当用户改变视图时触发此事件，FullCalendar 将通过GET方法传递参数来确定需要哪些日程数据
/myfeed.php?start=1262332800&end=1265011200&_=1263178646
startParam:'start' 开始参数的名字
endParam:'end' 结束参数的名字
cacheParam:'_' 缓存参数的名字
lazyFetching:true 只有当需要的时候才取得数据，先从缓存里读取数据
_参数是自动加上去的，防止读缓存内容
日程事件 events (as a function)
events:function( start, end, callback ) { }
events: function(start, end, callback) {
$.ajax({
url: 'myxmlfeed.php',
dataType: 'xml',
data: {
// our hypothetical feed requires UNIX timestamps
start: Math.round(start.getTime() / 1000),
end: Math.round(end.getTime() / 1000)
},
success: function(doc) {
var events = [];
$(doc).find('event').each(function() {
event.push({
title: $(this).attr('title'),
start: $(this).attr('start') // will be parsed
});
});
callback(events);
}
});
}
30.事件源
eventSources 存储数组对象，可以是Arrays/Functions/URLs
eventSources: [
$.fullCalendar.gcalFeed("http://www.google.com/feed1"),
$.fullCalendar.gcalFeed("http://www.google.com/feed2")
]
31.日程默认为全天日程
allDayDefault:true
32.当读取ajax数据时
loading:function( isLoading, view )
当开始读取的时候是true,当读取完成是false
33.改变日程事件
updateEvent:
eventClick: function(event, element) {
event.title = "CLICKED!";
$('#calendar').fullCalendar('updateEvent', event);
}
日程对象可以通过回调函数被获得，比如 eventClick 或者 clientEvents的方法
34.取得客户端内存中保存的日程对象
clientEvents
.fullCalendar( 'clientEvents' [, idOrFilter ] ) -> Array 返回一个日程对象的数组
如果idOrFilter不写，则输出全部保存在客户端的日程对象数组
如果为ID ，则返回所有为此ID的对象
还可以为一个过滤function 接受一个日程对象，如果返回true，则此值包含在客户端对象组中国
35.从日历中删除日程
removeEvents 参数同上
36.重新取得日程
.fullCalendar('refetchEvents') 从所有源并且重新渲染到屏幕上
37.增加一个日程源
.fullCalendar('addEventSource',source)
源可以是Array/URL/Function ，获取的数据可以立刻显示在日历上
38.删除一个事件源
.fullCalendar('removeEventSource',source)
39.日程绑定
eventRender.function( event, element, view ) { }
event 是企图被渲染的日程对象
element 是一个新建的jQuery<div>被用来渲染的，他已经在恰当的时间被创建
eventRender 返回函数可以修改element，返回一个新的dom元素，用来替换被渲染的元素，或者返回false，禁止被渲染
40.日程渲染后事件
eventAfterRender:function( event, element, view ) { }
41.渲染事件
.fullCalendar('renderEvent',event[,stick])
通常，一旦日历重新取得日程源，则原有日程将消失，当指定stick为true时，日程将永久的保存到日历上
42.重新渲染所有事件
rerenderEvents
.fullCalendar('rerenderEvents')
43.是否可以拖拽和改变大小
editable:true
44.禁止拖拽和改变大小
disableDragging:false
disableResizing:false
45.如果拖拽不成功，多久回复原状
dragRevertDuration:500 单位是毫秒
46.拖拽不透明度
dragOpacity:{
agenda:.5 //对于agenda试图
'':1.0 //其他视图
}
47.需要的js包
<script type='text/javascript' src='js/ui.core.js'/>
<script type='text/javascript' src='js/ui.draggable.js'/>
<script type='text/javascript' src='js/ui.resizable.js'/>
注意顺序，要把jquery.js放到这3个包前面
48.拖拽事件引发的操作
eventDragStart:function(event,jsEvent,ui,view) { }
eventDragStop:function( event, jsEvent, ui, view ) { }
49.当拖拽完成并且时间改变
eventDrop:function( event, dayDelta, minuteDelta, allDay, revertFunc, jsEvent, ui, view ) { }
dayDelta 保存日程向前或者向后移动了多少天
minuteDelta 这个值只有在agenda视图有效，移动的时间
allDay 如果是月视图，或者是agenda视图的全天日程，此值为true,否则为false
eventDrop: function(event,dayDelta,minuteDelta,allDay,revertFunc) {
alert(
event.title + " was moved " +
dayDelta + " days and " +
minuteDelta + " minutes."
);
if (allDay) {
alert("Event is now all-day");
}else{
alert("Event has a time-of-day");
}
if (!confirm("Are you sure about this change?")) {
revertFunc();
}
}
50.改变大小的事件触发的操作
eventResizeStart:function( event, jsEvent, ui, view ) { }
eventResizeStop:function( event, jsEvent, ui, view ) { }
eventResize:function( event, dayDelta, minuteDelta, revertFunc, jsEvent, ui, view ) { }
浙公网安备 33010602011771号