JS日程管理插件FullCalendar中文说明文档

JS日程管理插件FullCalendar提供了丰富的属性设置和方法调用，开发者可以根据FullCalendar提供的API快速完成一个日历日程的开发，本文将FullCalendar的常用属性和方法、回调函数等整理成中文文档，以供参阅

普通显示设置

属性 描述 默认值
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
windowResize callback，当浏览器窗口变化时触发function，使用：
$('#calendar').fullCalendar({
windowResize: function(view) {
alert('The calendar has adjusted to a window resize');
}
});
render method，绑定日历到id上。
$('#id').fullCalendar('render');
destroy method，销毁id日历，把日历回复到初始化前状态。
$('#id').fullCalendar('destroy');

视图

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

View视图对象的属性：

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

View其他属性和方法

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

日程选项

以下选项设置适用于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

当前日期设置

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

文本与时间定制

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

属性 描述 默认值
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"

鼠标单击和滑过

以下列出的是当鼠标单击或者滑过日历中的某个元素时，回调的函数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		 鼠标划过和离开的事件，用法和参数同上

选择操作

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

日程事件数据

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 文本颜色。

事件源对象

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

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

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

事件渲染

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

日程事件拖动和缩放

拖动和缩放功能依赖于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 ) { }
eventDrop callback，当拖拽完成并且时间改变时触发，用法：
function( event, dayDelta, minuteDelta, allDay, revertFunc, jsEvent, ui, view ) { }
ayDelta 保存日程向前或者向后移动了多少天
minuteDelta 这个值只有在agenda视图有效，移动的时间
allDay 如果是月视图，或者是agenda视图的全天日程，此值为true,否则为false
eventResizeStart,
eventResizeStop		 callback，在一个日程事件改变大小之前之后发生(不一定要改变成功)，用法：
function( event, jsEvent, ui, view ) { }
eventResize callback，在日程事件改变大小并成功后调用, 参数和eventDrop参数用法一致。用法：
function( event, dayDelta, minuteDelta, revertFunc, jsEvent, ui, view ) { }

日期工具

函数 描述
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 ] )

以上是FullCalendar插件的基本属性与方法，您可以查看文章JS日程管理插件FullCalendar简单实例进行实际操作

参考文献：

官方文档：https://fullcalendar.io/docs/

FullCalendar 官方文档翻译：fullCalendar中文API官方文档

赞 (0)

相关推荐

  • fullCalendar中文API官方文档

    fullCalendar中文API官方文档

    1. 使用方式: 引入相关js, css后, $('#div_name').fullCalendar({//options}); 接受的是一个option对象 2. 普通属性 2.1. year, month, date: 整数, 初始化加载时的日期. 2.2. defaultView: 字符串类型, 默认是'month; 2.2.1. 允许的views: 2.2.1.1. month 一页显示一月, 日历样式 2.2.1.2. basicWeek 一页显示一周, 无特殊样式 2.2.1.3.

  • FullCalendar日历插件应用之数据展现(一)

    FullCalendar日历插件应用之数据展现(一)

    开发者可以使用FullCalendar创建强大的日历日程应用,FullCalendar提供了丰富的选项设置和方法调用,使得开发者可以轻松的创建各种功能的日历程序. 由于项目需求,需要通过日历的方式展现某些数据,在网上搜索了很多日历的插件,觉得比较好用的还是fullCalendar,下面是我写的一个简单Demo,如有不足,请多多指正!!! 一.引入必要的文件: <link href="Scripts/Plugins/fullcalendar.css" rel="style

  • JS日程管理插件FullCalendar简单实例

    JS日程管理插件FullCalendar简单实例

    在线演示              源码下载 HTML 首先第一步就是在需要调用FullCalendar日程插件的页面中载入必要的javascript和css文件,包括jQuery库文件,FullCalendar插件以及FullCalendar样式表.如果您还想要拖动日程的功能,那么还需要加入jQuery ui插件. <link rel="stylesheet" type="text/css" href="css/fullcalendar.css&q

  • jQuery日程管理插件fullcalendar使用详解

    FullCalendar用来做日程管理功能非常强大,但是唯一不足的地方是没有将中国农历历法加进去,今天我将结合实例和大家分享如何将中国农历中的节气和节日整合到FullCalendar中,从而增强其实用性. HTML 首先是要载入jQuery库和fullcalendar插件. <script src='js/jquery-1.9.1.min.js'></script> <script src='js/fullcalendar.min.js'></script>

  • JS日程管理插件FullCalendar中文说明文档

    JS日程管理插件FullCalendar提供了丰富的属性设置和方法调用,开发者可以根据FullCalendar提供的API快速完成一个日历日程的开发,本文将FullCalendar的常用属性和方法.回调函数等整理成中文文档,以供参阅 普通显示设置 属性 描述 默认值 header 设置日历头部信息. 如果设置为false,则不显示头部信息.包括left,center,right左中右三个位置,每个位置都可以对应以下不同的配置: title: 显示当前月份/周/日信息 prev: 用于切换到上一月

  • fullcalendar日程管理插件月份切换回调处理方案

    fullcalendar日程管理插件月份切换回调处理方案

    目录 解决方案 示例 fullcalendar设置及渲染 点击事件定义 展示效果 注意: fullcalendar 版本:v5.9.0 解决方案 fullcalendar next ,prev等切换月份的按钮是没有回调函数,要想由回调函数必须用customButtons(自定义按钮,官方文档),它能提供回调函数,然后再回调函数里通过调用 this.$refs.calendar.$options.calendar.next();或calendar.next(); 去切换月份. 示例 核心代码 fu

  • CKEditor4配置与开发详细中文说明文档

    一.CKEditor4安装 安装CKEditor 是很容易的.选择合适的过程(新安装或升级),按下面描述的步骤安装. 1.新安装 第一次安装CKEditor,按如下方式进行: 1) 从CKEditor 网站:http://ckeditor.com/download下载最新版本的CKEditor .  2) 将下载的文档解压到你的website根目录下的ckeditor 目录中.你可以将文档放在你的website的任意路径中.ckeditor 目录是缺省目录. 2.升级 要升级现有的CKEdito

  • JS导出PDF插件的方法(支持中文、图片使用路径)

    在WEB上想做一个导出PDF的功能,发现jsPDF比较多人推荐,遗憾的是不支持中文,最后找到pdfmake,很好地解决了此问题.它的效果可以先到http://pdfmake.org/playground.html查看.在使用过程中,还发现图片的插入是相对繁琐的一件事. 针对这些问题,本文的主要内容可分为三部分: •pdfmake的基本使用方法: •如何解决中文问题; •如何通过指定图片地址插入图片. pdfmake的基本使用方法 1.包含以下两个文件 <script src="build/

  • jQuery日程管理控件glDatePicker用法详解

    jQuery日程管理控件glDatePicker用法详解

    本文实例讲述了jQuery日程管理控件glDatePicker用法.分享给大家供大家参考,具体如下: 之前接触过一款日程管理控件,叫 FullCalendar,功能很强大,会列出每天的事项,可选择编辑并且可以定制自己的日历,然而,有时候,我们的网页上只需要一个简单的日历,迷你但实用,有日程安排的日期高亮显示,可跳转日期,可选择日期等等基本功能都应该具备,而这时 FullCalendar 就显得太过庞大了,所以,就有了我对 glDatePicker 控件的学习. 先看效果:    橘红色表示当前选

  • Pinia.js状态管理器上手使用指南

    Pinia.js状态管理器上手使用指南

    目录 前言 安装 创建 Store State 定义State 获取 state 修改 state Getters Actions 异步 action action 间相互调用 数据持久化 安装 使用 自定义 key 持久化部分 state 最后 前言 Pinia.js 是新一代的状态管理器,由 Vue.js团队中成员所开发的,因此也被认为是下一代的 Vuex,即 Vuex5.x,在 Vue3.0 的项目中使用也是备受推崇. Pinia.js 有如下特点: 完整的 typescript 的支持:

  • Vue.js 状态管理及 SSR解析

    Vue.js 状态管理及 SSR解析

    目录 前端状态管理出现的意义及解决的问题 Vuex 源码解读 Vuex 公共方法 Vuex 介绍及深入使用 Vuex 使用(官网) 1.基本框架 2.基本使用 3.State 3.1 mapState 辅助函数 4.Getter 4.1 通过属性访问 4.2 通过方法访问 4.3 mapGetters 辅助函数 5.Mutation 5.1 提交载荷(Payload) 5.2 使用常量替代 Mutation 事件类型 5.3 Mutation 必须是同步函数 5.4 在组件中提交 Mutatio

随机推荐