+
+// Returns a boolean about whether the given duration has any time parts (hours/minutes/seconds/ms)
+function durationHasTime(dur) {
+ return Boolean(dur.hours() || dur.minutes() || dur.seconds() || dur.milliseconds());
+}
+
+
+function isNativeDate(input) {
+ return Object.prototype.toString.call(input) === '[object Date]' || input instanceof Date;
+}
+
+
+// Returns a boolean about whether the given input is a time string, like "06:40:00" or "06:00"
+function isTimeString(str) {
+ return /^\d+\:\d+(?:\:\d+\.?(?:\d{3})?)?$/.test(str);
+}
+
+
+/* Logging and Debug
+----------------------------------------------------------------------------------------------------------------------*/
+
+FC.log = function() {
+ var console = window.console;
+
+ if (console && console.log) {
+ return console.log.apply(console, arguments);
+ }
+};
+
+FC.warn = function() {
+ var console = window.console;
+
+ if (console && console.warn) {
+ return console.warn.apply(console, arguments);
+ }
+ else {
+ return FC.log.apply(FC, arguments);
+ }
+};
+
+
+/* General Utilities
+----------------------------------------------------------------------------------------------------------------------*/
+
+var hasOwnPropMethod = {}.hasOwnProperty;
+
+
+// Merges an array of objects into a single object.
+// The second argument allows for an array of property names who's object values will be merged together.
+function mergeProps(propObjs, complexProps) {
+ var dest = {};
+ var i, name;
+ var complexObjs;
+ var j, val;
+ var props;
+
+ if (complexProps) {
+ for (i = 0; i < complexProps.length; i++) {
+ name = complexProps[i];
+ complexObjs = [];
+
+ // collect the trailing object values, stopping when a non-object is discovered
+ for (j = propObjs.length - 1; j >= 0; j--) {
+ val = propObjs[j][name];
+
+ if (typeof val === 'object') {
+ complexObjs.unshift(val);
+ }
+ else if (val !== undefined) {
+ dest[name] = val; // if there were no objects, this value will be used
+ break;
+ }
+ }
+
+ // if the trailing values were objects, use the merged value
+ if (complexObjs.length) {
+ dest[name] = mergeProps(complexObjs);
+ }
+ }
+ }
+
+ // copy values into the destination, going from last to first
+ for (i = propObjs.length - 1; i >= 0; i--) {
+ props = propObjs[i];
+
+ for (name in props) {
+ if (!(name in dest)) { // if already assigned by previous props or complex props, don't reassign
+ dest[name] = props[name];
+ }
+ }
+ }
+
+ return dest;
+}
+
+
+// Create an object that has the given prototype. Just like Object.create
+function createObject(proto) {
+ var f = function() {};
+ f.prototype = proto;
+ return new f();
+}
+
+
+function copyOwnProps(src, dest) {
+ for (var name in src) {
+ if (hasOwnProp(src, name)) {
+ dest[name] = src[name];
+ }
+ }
+}
+
+
+function hasOwnProp(obj, name) {
+ return hasOwnPropMethod.call(obj, name);
+}
+
+
+// Is the given value a non-object non-function value?
+function isAtomic(val) {
+ return /undefined|null|boolean|number|string/.test($.type(val));
+}
+
+
+function applyAll(functions, thisObj, args) {
+ if ($.isFunction(functions)) {
+ functions = [ functions ];
+ }
+ if (functions) {
+ var i;
+ var ret;
+ for (i=0; i<functions.length; i++) {
+ ret = functions[i].apply(thisObj, args) || ret;
+ }
+ return ret;
+ }
+}
+
+
+function firstDefined() {
+ for (var i=0; i<arguments.length; i++) {
+ if (arguments[i] !== undefined) {
+ return arguments[i];
+ }
+ }
+}
+
+
+function htmlEscape(s) {
+ return (s + '').replace(/&/g, '&')
+ .replace(/</g, '<')
+ .replace(/>/g, '>')
+ .replace(/'/g, ''')
+ .replace(/"/g, '"')
+ .replace(/\n/g, '<br />');
+}
+
+
+function stripHtmlEntities(text) {
+ return text.replace(/&.*?;/g, '');
+}
+
+
+// Given a hash of CSS properties, returns a string of CSS.
+// Uses property names as-is (no camel-case conversion). Will not make statements for null/undefined values.
+function cssToStr(cssProps) {
+ var statements = [];
+
+ $.each(cssProps, function(name, val) {
+ if (val != null) {
+ statements.push(name + ':' + val);
+ }
+ });
+
+ return statements.join(';');
+}
+
+
+// Given an object hash of HTML attribute names to values,
+// generates a string that can be injected between < > in HTML
+function attrsToStr(attrs) {
+ var parts = [];
+
+ $.each(attrs, function(name, val) {
+ if (val != null) {
+ parts.push(name + '="' + htmlEscape(val) + '"');
+ }
+ });
+
+ return parts.join(' ');
+}
+
+
+function capitaliseFirstLetter(str) {
+ return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+
+function compareNumbers(a, b) { // for .sort()
+ return a - b;
+}
+
+
+function isInt(n) {
+ return n % 1 === 0;
+}
+
+
+// Returns a method bound to the given object context.
+// Just like one of the jQuery.proxy signatures, but without the undesired behavior of treating the same method with
+// different contexts as identical when binding/unbinding events.
+function proxy(obj, methodName) {
+ var method = obj[methodName];
+
+ return function() {
+ return method.apply(obj, arguments);
+ };
+}
+
+
+// Returns a function, that, as long as it continues to be invoked, will not
+// be triggered. The function will be called after it stops being called for
+// N milliseconds. If `immediate` is passed, trigger the function on the
+// leading edge, instead of the trailing.
+// https://github.com/jashkenas/underscore/blob/1.6.0/underscore.js#L714
+function debounce(func, wait, immediate) {
+ var timeout, args, context, timestamp, result;
+
+ var later = function() {
+ var last = +new Date() - timestamp;
+ if (last < wait) {
+ timeout = setTimeout(later, wait - last);
+ }
+ else {
+ timeout = null;
+ if (!immediate) {
+ result = func.apply(context, args);
+ context = args = null;
+ }
+ }
+ };
+
+ return function() {
+ context = this;
+ args = arguments;
+ timestamp = +new Date();
+ var callNow = immediate && !timeout;
+ if (!timeout) {
+ timeout = setTimeout(later, wait);
+ }
+ if (callNow) {
+ result = func.apply(context, args);
+ context = args = null;
+ }
+ return result;
+ };
+}
+
+
+// HACK around jQuery's now A+ promises: execute callback synchronously if already resolved.
+// thenFunc shouldn't accept args.
+// similar to whenResources in Scheduler plugin.
+function syncThen(promise, thenFunc) {
+ // not a promise, or an already-resolved promise?
+ if (!promise || !promise.then || promise.state() === 'resolved') {
+ return $.when(thenFunc()); // resolve immediately
+ }
+ else if (thenFunc) {
+ return promise.then(thenFunc);
+ }
+}
+
+;;
+
+/*
+GENERAL NOTE on moments throughout the *entire rest* of the codebase:
+All moments are assumed to be ambiguously-zoned unless otherwise noted,
+with the NOTABLE EXCEOPTION of start/end dates that live on *Event Objects*.
+Ambiguously-TIMED moments are assumed to be ambiguously-zoned by nature.
+*/
+
+var ambigDateOfMonthRegex = /^\s*\d{4}-\d\d$/;
+var ambigTimeOrZoneRegex =
+ /^\s*\d{4}-(?:(\d\d-\d\d)|(W\d\d$)|(W\d\d-\d)|(\d\d\d))((T| )(\d\d(:\d\d(:\d\d(\.\d+)?)?)?)?)?$/;
+var newMomentProto = moment.fn; // where we will attach our new methods
+var oldMomentProto = $.extend({}, newMomentProto); // copy of original moment methods
+
+// tell momentjs to transfer these properties upon clone
+var momentProperties = moment.momentProperties;
+momentProperties.push('_fullCalendar');
+momentProperties.push('_ambigTime');
+momentProperties.push('_ambigZone');
+
+
+// Creating
+// -------------------------------------------------------------------------------------------------
+
+// Creates a new moment, similar to the vanilla moment(...) constructor, but with
+// extra features (ambiguous time, enhanced formatting). When given an existing moment,
+// it will function as a clone (and retain the zone of the moment). Anything else will
+// result in a moment in the local zone.
+FC.moment = function() {
+ return makeMoment(arguments);
+};
+
+// Sames as FC.moment, but forces the resulting moment to be in the UTC timezone.
+FC.moment.utc = function() {
+ var mom = makeMoment(arguments, true);
+
+ // Force it into UTC because makeMoment doesn't guarantee it
+ // (if given a pre-existing moment for example)
+ if (mom.hasTime()) { // don't give ambiguously-timed moments a UTC zone
+ mom.utc();
+ }
+
+ return mom;
+};
+
+// Same as FC.moment, but when given an ISO8601 string, the timezone offset is preserved.
+// ISO8601 strings with no timezone offset will become ambiguously zoned.
+FC.moment.parseZone = function() {
+ return makeMoment(arguments, true, true);
+};
+
+// Builds an enhanced moment from args. When given an existing moment, it clones. When given a
+// native Date, or called with no arguments (the current time), the resulting moment will be local.
+// Anything else needs to be "parsed" (a string or an array), and will be affected by:
+// parseAsUTC - if there is no zone information, should we parse the input in UTC?
+// parseZone - if there is zone information, should we force the zone of the moment?
+function makeMoment(args, parseAsUTC, parseZone) {
+ var input = args[0];
+ var isSingleString = args.length == 1 && typeof input === 'string';
+ var isAmbigTime;
+ var isAmbigZone;
+ var ambigMatch;
+ var mom;
+
+ if (moment.isMoment(input) || isNativeDate(input) || input === undefined) {
+ mom = moment.apply(null, args);
+ }
+ else { // "parsing" is required
+ isAmbigTime = false;
+ isAmbigZone = false;
+
+ if (isSingleString) {
+ if (ambigDateOfMonthRegex.test(input)) {
+ // accept strings like '2014-05', but convert to the first of the month
+ input += '-01';
+ args = [ input ]; // for when we pass it on to moment's constructor
+ isAmbigTime = true;
+ isAmbigZone = true;
+ }
+ else if ((ambigMatch = ambigTimeOrZoneRegex.exec(input))) {
+ isAmbigTime = !ambigMatch[5]; // no time part?
+ isAmbigZone = true;
+ }
+ }
+ else if ($.isArray(input)) {
+ // arrays have no timezone information, so assume ambiguous zone
+ isAmbigZone = true;
+ }
+ // otherwise, probably a string with a format
+
+ if (parseAsUTC || isAmbigTime) {
+ mom = moment.utc.apply(moment, args);
+ }
+ else {
+ mom = moment.apply(null, args);
+ }
+
+ if (isAmbigTime) {
+ mom._ambigTime = true;
+ mom._ambigZone = true; // ambiguous time always means ambiguous zone
+ }
+ else if (parseZone) { // let's record the inputted zone somehow
+ if (isAmbigZone) {
+ mom._ambigZone = true;
+ }
+ else if (isSingleString) {
+ mom.utcOffset(input); // if not a valid zone, will assign UTC
+ }
+ }
+ }
+
+ mom._fullCalendar = true; // flag for extended functionality
+
+ return mom;
+}
+
+
+// Week Number
+// -------------------------------------------------------------------------------------------------
+
+
+// Returns the week number, considering the locale's custom week number calcuation
+// `weeks` is an alias for `week`
+newMomentProto.week = newMomentProto.weeks = function(input) {
+ var weekCalc = this._locale._fullCalendar_weekCalc;
+
+ if (input == null && typeof weekCalc === 'function') { // custom function only works for getter
+ return weekCalc(this);
+ }
+ else if (weekCalc === 'ISO') {
+ return oldMomentProto.isoWeek.apply(this, arguments); // ISO getter/setter
+ }
+
+ return oldMomentProto.week.apply(this, arguments); // local getter/setter
+};
+
+
+// Time-of-day
+// -------------------------------------------------------------------------------------------------
+
+// GETTER
+// Returns a Duration with the hours/minutes/seconds/ms values of the moment.
+// If the moment has an ambiguous time, a duration of 00:00 will be returned.
+//
+// SETTER
+// You can supply a Duration, a Moment, or a Duration-like argument.
+// When setting the time, and the moment has an ambiguous time, it then becomes unambiguous.
+newMomentProto.time = function(time) {
+
+ // Fallback to the original method (if there is one) if this moment wasn't created via FullCalendar.
+ // `time` is a generic enough method name where this precaution is necessary to avoid collisions w/ other plugins.
+ if (!this._fullCalendar) {
+ return oldMomentProto.time.apply(this, arguments);
+ }
+
+ if (time == null) { // getter
+ return moment.duration({
+ hours: this.hours(),
+ minutes: this.minutes(),
+ seconds: this.seconds(),
+ milliseconds: this.milliseconds()
+ });
+ }
+ else { // setter
+
+ this._ambigTime = false; // mark that the moment now has a time
+
+ if (!moment.isDuration(time) && !moment.isMoment(time)) {
+ time = moment.duration(time);
+ }
+
+ // The day value should cause overflow (so 24 hours becomes 00:00:00 of next day).
+ // Only for Duration times, not Moment times.
+ var dayHours = 0;
+ if (moment.isDuration(time)) {
+ dayHours = Math.floor(time.asDays()) * 24;
+ }
+
+ // We need to set the individual fields.
+ // Can't use startOf('day') then add duration. In case of DST at start of day.
+ return this.hours(dayHours + time.hours())
+ .minutes(time.minutes())
+ .seconds(time.seconds())
+ .milliseconds(time.milliseconds());
+ }
+};
+
+// Converts the moment to UTC, stripping out its time-of-day and timezone offset,
+// but preserving its YMD. A moment with a stripped time will display no time
+// nor timezone offset when .format() is called.
+newMomentProto.stripTime = function() {
+
+ if (!this._ambigTime) {
+
+ this.utc(true); // keepLocalTime=true (for keeping *date* value)
+
+ // set time to zero
+ this.set({
+ hours: 0,
+ minutes: 0,
+ seconds: 0,
+ ms: 0
+ });
+
+ // Mark the time as ambiguous. This needs to happen after the .utc() call, which might call .utcOffset(),
+ // which clears all ambig flags.
+ this._ambigTime = true;
+ this._ambigZone = true; // if ambiguous time, also ambiguous timezone offset
+ }
+
+ return this; // for chaining
+};
+
+// Returns if the moment has a non-ambiguous time (boolean)
+newMomentProto.hasTime = function() {
+ return !this._ambigTime;
+};
+
+
+// Timezone
+// -------------------------------------------------------------------------------------------------
+
+// Converts the moment to UTC, stripping out its timezone offset, but preserving its
+// YMD and time-of-day. A moment with a stripped timezone offset will display no
+// timezone offset when .format() is called.
+newMomentProto.stripZone = function() {
+ var wasAmbigTime;
+
+ if (!this._ambigZone) {
+
+ wasAmbigTime = this._ambigTime;
+
+ this.utc(true); // keepLocalTime=true (for keeping date and time values)
+
+ // the above call to .utc()/.utcOffset() unfortunately might clear the ambig flags, so restore
+ this._ambigTime = wasAmbigTime || false;
+
+ // Mark the zone as ambiguous. This needs to happen after the .utc() call, which might call .utcOffset(),
+ // which clears the ambig flags.
+ this._ambigZone = true;
+ }
+
+ return this; // for chaining
+};
+
+// Returns of the moment has a non-ambiguous timezone offset (boolean)
+newMomentProto.hasZone = function() {
+ return !this._ambigZone;
+};
+
+
+// implicitly marks a zone
+newMomentProto.local = function(keepLocalTime) {
+
+ // for when converting from ambiguously-zoned to local,
+ // keep the time values when converting from UTC -> local
+ oldMomentProto.local.call(this, this._ambigZone || keepLocalTime);
+
+ // ensure non-ambiguous
+ // this probably already happened via local() -> utcOffset(), but don't rely on Moment's internals
+ this._ambigTime = false;
+ this._ambigZone = false;
+
+ return this; // for chaining
+};
+
+
+// implicitly marks a zone
+newMomentProto.utc = function(keepLocalTime) {
+
+ oldMomentProto.utc.call(this, keepLocalTime);
+
+ // ensure non-ambiguous
+ // this probably already happened via utc() -> utcOffset(), but don't rely on Moment's internals
+ this._ambigTime = false;
+ this._ambigZone = false;
+
+ return this;
+};
+
+
+// implicitly marks a zone (will probably get called upon .utc() and .local())
+newMomentProto.utcOffset = function(tzo) {
+
+ if (tzo != null) { // setter
+ // these assignments needs to happen before the original zone method is called.
+ // I forget why, something to do with a browser crash.
+ this._ambigTime = false;
+ this._ambigZone = false;
+ }
+
+ return oldMomentProto.utcOffset.apply(this, arguments);
+};
+
+
+// Formatting
+// -------------------------------------------------------------------------------------------------
+
+newMomentProto.format = function() {
+ if (this._fullCalendar && arguments[0]) { // an enhanced moment? and a format string provided?
+ return formatDate(this, arguments[0]); // our extended formatting
+ }
+ if (this._ambigTime) {
+ return oldMomentFormat(this, 'YYYY-MM-DD');
+ }
+ if (this._ambigZone) {
+ return oldMomentFormat(this, 'YYYY-MM-DD[T]HH:mm:ss');
+ }
+ return oldMomentProto.format.apply(this, arguments);
+};
+
+newMomentProto.toISOString = function() {
+ if (this._ambigTime) {
+ return oldMomentFormat(this, 'YYYY-MM-DD');
+ }
+ if (this._ambigZone) {
+ return oldMomentFormat(this, 'YYYY-MM-DD[T]HH:mm:ss');
+ }
+ return oldMomentProto.toISOString.apply(this, arguments);
+};
+
+;;
+
+// Single Date Formatting
+// -------------------------------------------------------------------------------------------------
+
+
+// call this if you want Moment's original format method to be used
+function oldMomentFormat(mom, formatStr) {
+ return oldMomentProto.format.call(mom, formatStr); // oldMomentProto defined in moment-ext.js
+}
+
+
+// Formats `date` with a Moment formatting string, but allow our non-zero areas and
+// additional token.
+function formatDate(date, formatStr) {
+ return formatDateWithChunks(date, getFormatStringChunks(formatStr));
+}
+
+
+function formatDateWithChunks(date, chunks) {
+ var s = '';
+ var i;
+
+ for (i=0; i<chunks.length; i++) {
+ s += formatDateWithChunk(date, chunks[i]);
+ }
+
+ return s;
+}
+
+
+// addition formatting tokens we want recognized
+var tokenOverrides = {
+ t: function(date) { // "a" or "p"
+ return oldMomentFormat(date, 'a').charAt(0);
+ },
+ T: function(date) { // "A" or "P"
+ return oldMomentFormat(date, 'A').charAt(0);
+ }
+};
+
+
+function formatDateWithChunk(date, chunk) {
+ var token;
+ var maybeStr;
+
+ if (typeof chunk === 'string') { // a literal string
+ return chunk;
+ }
+ else if ((token = chunk.token)) { // a token, like "YYYY"
+ if (tokenOverrides[token]) {
+ return tokenOverrides[token](date); // use our custom token
+ }
+ return oldMomentFormat(date, token);
+ }
+ else if (chunk.maybe) { // a grouping of other chunks that must be non-zero
+ maybeStr = formatDateWithChunks(date, chunk.maybe);
+ if (maybeStr.match(/[1-9]/)) {
+ return maybeStr;
+ }
+ }
+
+ return '';
+}
+
+
+// Date Range Formatting
+// -------------------------------------------------------------------------------------------------
+// TODO: make it work with timezone offset
+
+// Using a formatting string meant for a single date, generate a range string, like
+// "Sep 2 - 9 2013", that intelligently inserts a separator where the dates differ.
+// If the dates are the same as far as the format string is concerned, just return a single
+// rendering of one date, without any separator.
+function formatRange(date1, date2, formatStr, separator, isRTL) {
+ var localeData;
+
+ date1 = FC.moment.parseZone(date1);
+ date2 = FC.moment.parseZone(date2);
+
+ localeData = date1.localeData();
+
+ // Expand localized format strings, like "LL" -> "MMMM D YYYY"
+ formatStr = localeData.longDateFormat(formatStr) || formatStr;
+ // BTW, this is not important for `formatDate` because it is impossible to put custom tokens
+ // or non-zero areas in Moment's localized format strings.
+
+ separator = separator || ' - ';
+
+ return formatRangeWithChunks(
+ date1,
+ date2,
+ getFormatStringChunks(formatStr),
+ separator,
+ isRTL
+ );
+}
+FC.formatRange = formatRange; // expose
+
+
+function formatRangeWithChunks(date1, date2, chunks, separator, isRTL) {
+ var unzonedDate1 = date1.clone().stripZone(); // for formatSimilarChunk
+ var unzonedDate2 = date2.clone().stripZone(); // "
+ var chunkStr; // the rendering of the chunk
+ var leftI;
+ var leftStr = '';
+ var rightI;
+ var rightStr = '';
+ var middleI;
+ var middleStr1 = '';
+ var middleStr2 = '';
+ var middleStr = '';
+
+ // Start at the leftmost side of the formatting string and continue until you hit a token
+ // that is not the same between dates.
+ for (leftI=0; leftI<chunks.length; leftI++) {
+ chunkStr = formatSimilarChunk(date1, date2, unzonedDate1, unzonedDate2, chunks[leftI]);
+ if (chunkStr === false) {
+ break;
+ }
+ leftStr += chunkStr;
+ }
+
+ // Similarly, start at the rightmost side of the formatting string and move left
+ for (rightI=chunks.length-1; rightI>leftI; rightI--) {
+ chunkStr = formatSimilarChunk(date1, date2, unzonedDate1, unzonedDate2, chunks[rightI]);
+ if (chunkStr === false) {
+ break;
+ }
+ rightStr = chunkStr + rightStr;
+ }
+
+ // The area in the middle is different for both of the dates.
+ // Collect them distinctly so we can jam them together later.
+ for (middleI=leftI; middleI<=rightI; middleI++) {
+ middleStr1 += formatDateWithChunk(date1, chunks[middleI]);
+ middleStr2 += formatDateWithChunk(date2, chunks[middleI]);
+ }
+
+ if (middleStr1 || middleStr2) {
+ if (isRTL) {
+ middleStr = middleStr2 + separator + middleStr1;
+ }
+ else {
+ middleStr = middleStr1 + separator + middleStr2;
+ }
+ }
+
+ return leftStr + middleStr + rightStr;
+}
+
+
+var similarUnitMap = {
+ Y: 'year',
+ M: 'month',
+ D: 'day', // day of month
+ d: 'day', // day of week
+ // prevents a separator between anything time-related...
+ A: 'second', // AM/PM
+ a: 'second', // am/pm
+ T: 'second', // A/P
+ t: 'second', // a/p
+ H: 'second', // hour (24)
+ h: 'second', // hour (12)
+ m: 'second', // minute
+ s: 'second' // second
+};
+// TODO: week maybe?
+
+
+// Given a formatting chunk, and given that both dates are similar in the regard the
+// formatting chunk is concerned, format date1 against `chunk`. Otherwise, return `false`.
+function formatSimilarChunk(date1, date2, unzonedDate1, unzonedDate2, chunk) {
+ var token;
+ var unit;
+
+ if (typeof chunk === 'string') { // a literal string
+ return chunk;
+ }
+ else if ((token = chunk.token)) {
+ unit = similarUnitMap[token.charAt(0)];
+
+ // are the dates the same for this unit of measurement?
+ // use the unzoned dates for this calculation because unreliable when near DST (bug #2396)
+ if (unit && unzonedDate1.isSame(unzonedDate2, unit)) {
+ return oldMomentFormat(date1, token); // would be the same if we used `date2`
+ // BTW, don't support custom tokens
+ }
+ }
+
+ return false; // the chunk is NOT the same for the two dates
+ // BTW, don't support splitting on non-zero areas
+}
+
+
+// Chunking Utils
+// -------------------------------------------------------------------------------------------------
+
+
+var formatStringChunkCache = {};
+
+
+function getFormatStringChunks(formatStr) {
+ if (formatStr in formatStringChunkCache) {
+ return formatStringChunkCache[formatStr];
+ }
+ return (formatStringChunkCache[formatStr] = chunkFormatString(formatStr));
+}
+
+
+// Break the formatting string into an array of chunks
+function chunkFormatString(formatStr) {
+ var chunks = [];
+ var chunker = /\[([^\]]*)\]|\(([^\)]*)\)|(LTS|LT|(\w)\4*o?)|([^\w\[\(]+)/g; // TODO: more descrimination
+ var match;
+
+ while ((match = chunker.exec(formatStr))) {
+ if (match[1]) { // a literal string inside [ ... ]
+ chunks.push(match[1]);
+ }
+ else if (match[2]) { // non-zero formatting inside ( ... )
+ chunks.push({ maybe: chunkFormatString(match[2]) });
+ }
+ else if (match[3]) { // a formatting token
+ chunks.push({ token: match[3] });
+ }
+ else if (match[5]) { // an unenclosed literal string
+ chunks.push(match[5]);
+ }
+ }
+
+ return chunks;
+}
+
+
+// Misc Utils
+// -------------------------------------------------------------------------------------------------
+
+
+// granularity only goes up until day
+// TODO: unify with similarUnitMap
+var tokenGranularities = {
+ Y: { value: 1, unit: 'year' },
+ M: { value: 2, unit: 'month' },
+ W: { value: 3, unit: 'week' },
+ w: { value: 3, unit: 'week' },
+ D: { value: 4, unit: 'day' }, // day of month
+ d: { value: 4, unit: 'day' } // day of week
+};
+
+// returns a unit string, either 'year', 'month', 'day', or null
+// for the most granular formatting token in the string.
+FC.queryMostGranularFormatUnit = function(formatStr) {
+ var chunks = getFormatStringChunks(formatStr);
+ var i, chunk;
+ var candidate;
+ var best;
+
+ for (i = 0; i < chunks.length; i++) {
+ chunk = chunks[i];
+ if (chunk.token) {
+ candidate = tokenGranularities[chunk.token.charAt(0)];
+ if (candidate) {
+ if (!best || candidate.value > best.value) {
+ best = candidate;
+ }
+ }
+ }
+ }
+
+ if (best) {
+ return best.unit;
+ }
+
+ return null;
+};
+
+;;
+
+FC.Class = Class; // export
+
+// Class that all other classes will inherit from
+function Class() { }
+
+
+// Called on a class to create a subclass.
+// Last argument contains instance methods. Any argument before the last are considered mixins.
+Class.extend = function() {
+ var len = arguments.length;
+ var i;
+ var members;
+
+ for (i = 0; i < len; i++) {
+ members = arguments[i];
+ if (i < len - 1) { // not the last argument?
+ mixIntoClass(this, members);
+ }
+ }
+
+ return extendClass(this, members || {}); // members will be undefined if no arguments
+};
+
+
+// Adds new member variables/methods to the class's prototype.
+// Can be called with another class, or a plain object hash containing new members.
+Class.mixin = function(members) {
+ mixIntoClass(this, members);
+};
+
+
+function extendClass(superClass, members) {
+ var subClass;
+
+ // ensure a constructor for the subclass, forwarding all arguments to the super-constructor if it doesn't exist
+ if (hasOwnProp(members, 'constructor')) {
+ subClass = members.constructor;
+ }
+ if (typeof subClass !== 'function') {
+ subClass = members.constructor = function() {
+ superClass.apply(this, arguments);
+ };
+ }
+
+ // build the base prototype for the subclass, which is an new object chained to the superclass's prototype
+ subClass.prototype = createObject(superClass.prototype);
+
+ // copy each member variable/method onto the the subclass's prototype
+ copyOwnProps(members, subClass.prototype);
+
+ // copy over all class variables/methods to the subclass, such as `extend` and `mixin`
+ copyOwnProps(superClass, subClass);
+
+ return subClass;
+}
+
+
+function mixIntoClass(theClass, members) {
+ copyOwnProps(members, theClass.prototype);
+}
+;;
+
+var EmitterMixin = FC.EmitterMixin = {
+
+ // jQuery-ification via $(this) allows a non-DOM object to have
+ // the same event handling capabilities (including namespaces).
+
+
+ on: function(types, handler) {
+
+ // handlers are always called with an "event" object as their first param.
+ // sneak the `this` context and arguments into the extra parameter object
+ // and forward them on to the original handler.
+ var intercept = function(ev, extra) {
+ return handler.apply(
+ extra.context || this,
+ extra.args || []
+ );
+ };
+
+ // mimick jQuery's internal "proxy" system (risky, I know)
+ // causing all functions with the same .guid to appear to be the same.
+ // https://github.com/jquery/jquery/blob/2.2.4/src/core.js#L448
+ // this is needed for calling .off with the original non-intercept handler.
+ if (!handler.guid) {
+ handler.guid = $.guid++;
+ }
+ intercept.guid = handler.guid;
+
+ $(this).on(types, intercept);
+
+ return this; // for chaining
+ },
+
+
+ off: function(types, handler) {
+ $(this).off(types, handler);
+
+ return this; // for chaining
+ },
+
+
+ trigger: function(types) {
+ var args = Array.prototype.slice.call(arguments, 1); // arguments after the first
+
+ // pass in "extra" info to the intercept
+ $(this).triggerHandler(types, { args: args });
+
+ return this; // for chaining
+ },
+
+
+ triggerWith: function(types, context, args) {
+
+ // `triggerHandler` is less reliant on the DOM compared to `trigger`.
+ // pass in "extra" info to the intercept.
+ $(this).triggerHandler(types, { context: context, args: args });
+
+ return this; // for chaining
+ }
+
+};
+
+;;
+
+/*
+Utility methods for easily listening to events on another object,
+and more importantly, easily unlistening from them.
+*/
+var ListenerMixin = FC.ListenerMixin = (function() {
+ var guid = 0;
+ var ListenerMixin = {
+
+ listenerId: null,
+
+ /*
+ Given an `other` object that has on/off methods, bind the given `callback` to an event by the given name.
+ The `callback` will be called with the `this` context of the object that .listenTo is being called on.
+ Can be called:
+ .listenTo(other, eventName, callback)
+ OR
+ .listenTo(other, {
+ eventName1: callback1,
+ eventName2: callback2
+ })
+ */
+ listenTo: function(other, arg, callback) {
+ if (typeof arg === 'object') { // given dictionary of callbacks
+ for (var eventName in arg) {
+ if (arg.hasOwnProperty(eventName)) {
+ this.listenTo(other, eventName, arg[eventName]);
+ }
+ }
+ }
+ else if (typeof arg === 'string') {
+ other.on(
+ arg + '.' + this.getListenerNamespace(), // use event namespacing to identify this object
+ $.proxy(callback, this) // always use `this` context
+ // the usually-undesired jQuery guid behavior doesn't matter,
+ // because we always unbind via namespace
+ );
+ }
+ },
+
+ /*
+ Causes the current object to stop listening to events on the `other` object.
+ `eventName` is optional. If omitted, will stop listening to ALL events on `other`.
+ */
+ stopListeningTo: function(other, eventName) {
+ other.off((eventName || '') + '.' + this.getListenerNamespace());
+ },
+
+ /*
+ Returns a string, unique to this object, to be used for event namespacing
+ */
+ getListenerNamespace: function() {
+ if (this.listenerId == null) {
+ this.listenerId = guid++;
+ }
+ return '_listener' + this.listenerId;
+ }
+
+ };
+ return ListenerMixin;
+})();
+;;
+
+// simple class for toggle a `isIgnoringMouse` flag on delay
+// initMouseIgnoring must first be called, with a millisecond delay setting.
+var MouseIgnorerMixin = {
+
+ isIgnoringMouse: false, // bool
+ delayUnignoreMouse: null, // method
+
+
+ initMouseIgnoring: function(delay) {
+ this.delayUnignoreMouse = debounce(proxy(this, 'unignoreMouse'), delay || 1000);
+ },
+
+
+ // temporarily ignore mouse actions on segments
+ tempIgnoreMouse: function() {
+ this.isIgnoringMouse = true;
+ this.delayUnignoreMouse();
+ },
+
+
+ // delayUnignoreMouse eventually calls this
+ unignoreMouse: function() {
+ this.isIgnoringMouse = false;
+ }
+
+};
+
+;;
+
+/* A rectangular panel that is absolutely positioned over other content
+------------------------------------------------------------------------------------------------------------------------
+Options:
+ - className (string)
+ - content (HTML string or jQuery element set)
+ - parentEl
+ - top
+ - left
+ - right (the x coord of where the right edge should be. not a "CSS" right)
+ - autoHide (boolean)
+ - show (callback)
+ - hide (callback)
+*/
+
+var Popover = Class.extend(ListenerMixin, {
+
+ isHidden: true,
+ options: null,
+ el: null, // the container element for the popover. generated by this object
+ margin: 10, // the space required between the popover and the edges of the scroll container
+
+
+ constructor: function(options) {
+ this.options = options || {};
+ },
+
+
+ // Shows the popover on the specified position. Renders it if not already
+ show: function() {
+ if (this.isHidden) {
+ if (!this.el) {
+ this.render();
+ }
+ this.el.show();
+ this.position();
+ this.isHidden = false;
+ this.trigger('show');
+ }
+ },
+
+
+ // Hides the popover, through CSS, but does not remove it from the DOM
+ hide: function() {
+ if (!this.isHidden) {
+ this.el.hide();
+ this.isHidden = true;
+ this.trigger('hide');
+ }
+ },
+
+
+ // Creates `this.el` and renders content inside of it
+ render: function() {
+ var _this = this;
+ var options = this.options;
+
+ this.el = $('<div class="fc-popover"/>')
+ .addClass(options.className || '')
+ .css({
+ // position initially to the top left to avoid creating scrollbars
+ top: 0,
+ left: 0
+ })
+ .append(options.content)
+ .appendTo(options.parentEl);
+
+ // when a click happens on anything inside with a 'fc-close' className, hide the popover
+ this.el.on('click', '.fc-close', function() {
+ _this.hide();
+ });
+
+ if (options.autoHide) {
+ this.listenTo($(document), 'mousedown', this.documentMousedown);
+ }
+ },
+
+
+ // Triggered when the user clicks *anywhere* in the document, for the autoHide feature
+ documentMousedown: function(ev) {
+ // only hide the popover if the click happened outside the popover
+ if (this.el && !$(ev.target).closest(this.el).length) {
+ this.hide();
+ }
+ },
+
+
+ // Hides and unregisters any handlers
+ removeElement: function() {
+ this.hide();
+
+ if (this.el) {
+ this.el.remove();
+ this.el = null;
+ }
+
+ this.stopListeningTo($(document), 'mousedown');
+ },
+
+
+ // Positions the popover optimally, using the top/left/right options
+ position: function() {
+ var options = this.options;
+ var origin = this.el.offsetParent().offset();
+ var width = this.el.outerWidth();
+ var height = this.el.outerHeight();
+ var windowEl = $(window);
+ var viewportEl = getScrollParent(this.el);
+ var viewportTop;
+ var viewportLeft;
+ var viewportOffset;
+ var top; // the "position" (not "offset") values for the popover
+ var left; //
+
+ // compute top and left
+ top = options.top || 0;
+ if (options.left !== undefined) {
+ left = options.left;
+ }
+ else if (options.right !== undefined) {
+ left = options.right - width; // derive the left value from the right value
+ }
+ else {
+ left = 0;
+ }
+
+ if (viewportEl.is(window) || viewportEl.is(document)) { // normalize getScrollParent's result
+ viewportEl = windowEl;
+ viewportTop = 0; // the window is always at the top left
+ viewportLeft = 0; // (and .offset() won't work if called here)
+ }
+ else {
+ viewportOffset = viewportEl.offset();
+ viewportTop = viewportOffset.top;
+ viewportLeft = viewportOffset.left;
+ }
+
+ // if the window is scrolled, it causes the visible area to be further down
+ viewportTop += windowEl.scrollTop();
+ viewportLeft += windowEl.scrollLeft();
+
+ // constrain to the view port. if constrained by two edges, give precedence to top/left
+ if (options.viewportConstrain !== false) {
+ top = Math.min(top, viewportTop + viewportEl.outerHeight() - height - this.margin);
+ top = Math.max(top, viewportTop + this.margin);
+ left = Math.min(left, viewportLeft + viewportEl.outerWidth() - width - this.margin);
+ left = Math.max(left, viewportLeft + this.margin);
+ }
+
+ this.el.css({
+ top: top - origin.top,
+ left: left - origin.left
+ });
+ },
+
+
+ // Triggers a callback. Calls a function in the option hash of the same name.
+ // Arguments beyond the first `name` are forwarded on.
+ // TODO: better code reuse for this. Repeat code
+ trigger: function(name) {
+ if (this.options[name]) {
+ this.options[name].apply(this, Array.prototype.slice.call(arguments, 1));
+ }
+ }
+
+});
+
+;;
+
+/*
+A cache for the left/right/top/bottom/width/height values for one or more elements.
+Works with both offset (from topleft document) and position (from offsetParent).
+
+options:
+- els
+- isHorizontal
+- isVertical
+*/
+var CoordCache = FC.CoordCache = Class.extend({
+
+ els: null, // jQuery set (assumed to be siblings)
+ forcedOffsetParentEl: null, // options can override the natural offsetParent
+ origin: null, // {left,top} position of offsetParent of els
+ boundingRect: null, // constrain cordinates to this rectangle. {left,right,top,bottom} or null
+ isHorizontal: false, // whether to query for left/right/width
+ isVertical: false, // whether to query for top/bottom/height
+
+ // arrays of coordinates (offsets from topleft of document)
+ lefts: null,
+ rights: null,
+ tops: null,
+ bottoms: null,
+
+
+ constructor: function(options) {
+ this.els = $(options.els);
+ this.isHorizontal = options.isHorizontal;
+ this.isVertical = options.isVertical;
+ this.forcedOffsetParentEl = options.offsetParent ? $(options.offsetParent) : null;
+ },
+
+
+ // Queries the els for coordinates and stores them.
+ // Call this method before using and of the get* methods below.
+ build: function() {
+ var offsetParentEl = this.forcedOffsetParentEl || this.els.eq(0).offsetParent();
+
+ this.origin = offsetParentEl.offset();
+ this.boundingRect = this.queryBoundingRect();
+
+ if (this.isHorizontal) {
+ this.buildElHorizontals();
+ }
+ if (this.isVertical) {
+ this.buildElVerticals();
+ }
+ },
+
+
+ // Destroys all internal data about coordinates, freeing memory
+ clear: function() {
+ this.origin = null;
+ this.boundingRect = null;
+ this.lefts = null;
+ this.rights = null;
+ this.tops = null;
+ this.bottoms = null;
+ },
+
+
+ // When called, if coord caches aren't built, builds them
+ ensureBuilt: function() {
+ if (!this.origin) {
+ this.build();
+ }
+ },
+
+
+ // Populates the left/right internal coordinate arrays
+ buildElHorizontals: function() {
+ var lefts = [];
+ var rights = [];
+
+ this.els.each(function(i, node) {
+ var el = $(node);
+ var left = el.offset().left;
+ var width = el.outerWidth();
+
+ lefts.push(left);
+ rights.push(left + width);
+ });
+
+ this.lefts = lefts;
+ this.rights = rights;
+ },
+
+
+ // Populates the top/bottom internal coordinate arrays
+ buildElVerticals: function() {
+ var tops = [];
+ var bottoms = [];
+
+ this.els.each(function(i, node) {
+ var el = $(node);
+ var top = el.offset().top;
+ var height = el.outerHeight();
+
+ tops.push(top);
+ bottoms.push(top + height);
+ });
+
+ this.tops = tops;
+ this.bottoms = bottoms;
+ },
+
+
+ // Given a left offset (from document left), returns the index of the el that it horizontally intersects.
+ // If no intersection is made, returns undefined.
+ getHorizontalIndex: function(leftOffset) {
+ this.ensureBuilt();
+
+ var lefts = this.lefts;
+ var rights = this.rights;
+ var len = lefts.length;
+ var i;
+
+ for (i = 0; i < len; i++) {
+ if (leftOffset >= lefts[i] && leftOffset < rights[i]) {
+ return i;
+ }
+ }
+ },
+
+
+ // Given a top offset (from document top), returns the index of the el that it vertically intersects.
+ // If no intersection is made, returns undefined.
+ getVerticalIndex: function(topOffset) {
+ this.ensureBuilt();
+
+ var tops = this.tops;
+ var bottoms = this.bottoms;
+ var len = tops.length;
+ var i;
+
+ for (i = 0; i < len; i++) {
+ if (topOffset >= tops[i] && topOffset < bottoms[i]) {
+ return i;
+ }
+ }
+ },
+
+
+ // Gets the left offset (from document left) of the element at the given index
+ getLeftOffset: function(leftIndex) {
+ this.ensureBuilt();
+ return this.lefts[leftIndex];
+ },
+
+
+ // Gets the left position (from offsetParent left) of the element at the given index
+ getLeftPosition: function(leftIndex) {
+ this.ensureBuilt();
+ return this.lefts[leftIndex] - this.origin.left;
+ },
+
+
+ // Gets the right offset (from document left) of the element at the given index.
+ // This value is NOT relative to the document's right edge, like the CSS concept of "right" would be.
+ getRightOffset: function(leftIndex) {
+ this.ensureBuilt();
+ return this.rights[leftIndex];
+ },
+
+
+ // Gets the right position (from offsetParent left) of the element at the given index.
+ // This value is NOT relative to the offsetParent's right edge, like the CSS concept of "right" would be.
+ getRightPosition: function(leftIndex) {
+ this.ensureBuilt();
+ return this.rights[leftIndex] - this.origin.left;
+ },
+
+
+ // Gets the width of the element at the given index
+ getWidth: function(leftIndex) {
+ this.ensureBuilt();
+ return this.rights[leftIndex] - this.lefts[leftIndex];
+ },
+
+
+ // Gets the top offset (from document top) of the element at the given index
+ getTopOffset: function(topIndex) {
+ this.ensureBuilt();
+ return this.tops[topIndex];
+ },
+
+
+ // Gets the top position (from offsetParent top) of the element at the given position
+ getTopPosition: function(topIndex) {
+ this.ensureBuilt();
+ return this.tops[topIndex] - this.origin.top;
+ },
+
+ // Gets the bottom offset (from the document top) of the element at the given index.
+ // This value is NOT relative to the offsetParent's bottom edge, like the CSS concept of "bottom" would be.
+ getBottomOffset: function(topIndex) {
+ this.ensureBuilt();
+ return this.bottoms[topIndex];
+ },
+
+
+ // Gets the bottom position (from the offsetParent top) of the element at the given index.
+ // This value is NOT relative to the offsetParent's bottom edge, like the CSS concept of "bottom" would be.
+ getBottomPosition: function(topIndex) {
+ this.ensureBuilt();
+ return this.bottoms[topIndex] - this.origin.top;
+ },
+
+
+ // Gets the height of the element at the given index
+ getHeight: function(topIndex) {
+ this.ensureBuilt();
+ return this.bottoms[topIndex] - this.tops[topIndex];
+ },
+
+
+ // Bounding Rect
+ // TODO: decouple this from CoordCache
+
+ // Compute and return what the elements' bounding rectangle is, from the user's perspective.
+ // Right now, only returns a rectangle if constrained by an overflow:scroll element.
+ queryBoundingRect: function() {
+ var scrollParentEl = getScrollParent(this.els.eq(0));
+
+ if (!scrollParentEl.is(document)) {
+ return getClientRect(scrollParentEl);
+ }
+ },
+
+ isPointInBounds: function(leftOffset, topOffset) {
+ return this.isLeftInBounds(leftOffset) && this.isTopInBounds(topOffset);
+ },
+
+ isLeftInBounds: function(leftOffset) {
+ return !this.boundingRect || (leftOffset >= this.boundingRect.left && leftOffset < this.boundingRect.right);
+ },
+
+ isTopInBounds: function(topOffset) {
+ return !this.boundingRect || (topOffset >= this.boundingRect.top && topOffset < this.boundingRect.bottom);
+ }
+
+});
+
+;;
+
+/* Tracks a drag's mouse movement, firing various handlers
+----------------------------------------------------------------------------------------------------------------------*/
+// TODO: use Emitter
+
+var DragListener = FC.DragListener = Class.extend(ListenerMixin, MouseIgnorerMixin, {
+
+ options: null,
+ subjectEl: null,
+
+ // coordinates of the initial mousedown
+ originX: null,
+ originY: null,
+
+ // the wrapping element that scrolls, or MIGHT scroll if there's overflow.
+ // TODO: do this for wrappers that have overflow:hidden as well.
+ scrollEl: null,
+
+ isInteracting: false,
+ isDistanceSurpassed: false,
+ isDelayEnded: false,
+ isDragging: false,
+ isTouch: false,
+
+ delay: null,
+ delayTimeoutId: null,
+ minDistance: null,
+
+ handleTouchScrollProxy: null, // calls handleTouchScroll, always bound to `this`
+
+
+ constructor: function(options) {
+ this.options = options || {};
+ this.handleTouchScrollProxy = proxy(this, 'handleTouchScroll');
+ this.initMouseIgnoring(500);
+ },
+
+
+ // Interaction (high-level)
+ // -----------------------------------------------------------------------------------------------------------------
+
+
+ startInteraction: function(ev, extraOptions) {
+ var isTouch = getEvIsTouch(ev);
+
+ if (ev.type === 'mousedown') {
+ if (this.isIgnoringMouse) {
+ return;
+ }
+ else if (!isPrimaryMouseButton(ev)) {
+ return;
+ }
+ else {
+ ev.preventDefault(); // prevents native selection in most browsers
+ }
+ }
+
+ if (!this.isInteracting) {
+
+ // process options
+ extraOptions = extraOptions || {};
+ this.delay = firstDefined(extraOptions.delay, this.options.delay, 0);
+ this.minDistance = firstDefined(extraOptions.distance, this.options.distance, 0);
+ this.subjectEl = this.options.subjectEl;
+
+ this.isInteracting = true;
+ this.isTouch = isTouch;
+ this.isDelayEnded = false;
+ this.isDistanceSurpassed = false;
+
+ this.originX = getEvX(ev);
+ this.originY = getEvY(ev);
+ this.scrollEl = getScrollParent($(ev.target));
+
+ this.bindHandlers();
+ this.initAutoScroll();
+ this.handleInteractionStart(ev);
+ this.startDelay(ev);
+
+ if (!this.minDistance) {
+ this.handleDistanceSurpassed(ev);
+ }
+ }
+ },
+
+
+ handleInteractionStart: function(ev) {
+ this.trigger('interactionStart', ev);
+ },
+
+
+ endInteraction: function(ev, isCancelled) {
+ if (this.isInteracting) {
+ this.endDrag(ev);
+
+ if (this.delayTimeoutId) {
+ clearTimeout(this.delayTimeoutId);
+ this.delayTimeoutId = null;
+ }
+
+ this.destroyAutoScroll();
+ this.unbindHandlers();
+
+ this.isInteracting = false;
+ this.handleInteractionEnd(ev, isCancelled);
+
+ // a touchstart+touchend on the same element will result in the following addition simulated events:
+ // mouseover + mouseout + click
+ // let's ignore these bogus events
+ if (this.isTouch) {
+ this.tempIgnoreMouse();
+ }
+ }
+ },
+
+
+ handleInteractionEnd: function(ev, isCancelled) {
+ this.trigger('interactionEnd', ev, isCancelled || false);
+ },
+
+
+ // Binding To DOM
+ // -----------------------------------------------------------------------------------------------------------------
+
+
+ bindHandlers: function() {
+ var _this = this;
+ var touchStartIgnores = 1;
+
+ if (this.isTouch) {
+ this.listenTo($(document), {
+ touchmove: this.handleTouchMove,
+ touchend: this.endInteraction,
+ touchcancel: this.endInteraction,
+
+ // Sometimes touchend doesn't fire
+ // (can't figure out why. touchcancel doesn't fire either. has to do with scrolling?)
+ // If another touchstart happens, we know it's bogus, so cancel the drag.
+ // touchend will continue to be broken until user does a shorttap/scroll, but this is best we can do.
+ touchstart: function(ev) {
+ if (touchStartIgnores) { // bindHandlers is called from within a touchstart,
+ touchStartIgnores--; // and we don't want this to fire immediately, so ignore.
+ }
+ else {
+ _this.endInteraction(ev, true); // isCancelled=true
+ }
+ }
+ });
+
+ // listen to ALL scroll actions on the page
+ if (
+ !bindAnyScroll(this.handleTouchScrollProxy) && // hopefully this works and short-circuits the rest
+ this.scrollEl // otherwise, attach a single handler to this
+ ) {
+ this.listenTo(this.scrollEl, 'scroll', this.handleTouchScroll);
+ }
+ }
+ else {
+ this.listenTo($(document), {
+ mousemove: this.handleMouseMove,
+ mouseup: this.endInteraction
+ });
+ }
+
+ this.listenTo($(document), {
+ selectstart: preventDefault, // don't allow selection while dragging
+ contextmenu: preventDefault // long taps would open menu on Chrome dev tools
+ });
+ },
+
+
+ unbindHandlers: function() {
+ this.stopListeningTo($(document));
+
+ // unbind scroll listening
+ unbindAnyScroll(this.handleTouchScrollProxy);
+ if (this.scrollEl) {
+ this.stopListeningTo(this.scrollEl, 'scroll');
+ }
+ },
+
+
+ // Drag (high-level)
+ // -----------------------------------------------------------------------------------------------------------------
+
+
+ // extraOptions ignored if drag already started
+ startDrag: function(ev, extraOptions) {
+ this.startInteraction(ev, extraOptions); // ensure interaction began
+
+ if (!this.isDragging) {
+ this.isDragging = true;
+ this.handleDragStart(ev);
+ }
+ },
+
+
+ handleDragStart: function(ev) {
+ this.trigger('dragStart', ev);
+ },
+
+
+ handleMove: function(ev) {
+ var dx = getEvX(ev) - this.originX;
+ var dy = getEvY(ev) - this.originY;
+ var minDistance = this.minDistance;
+ var distanceSq; // current distance from the origin, squared
+
+ if (!this.isDistanceSurpassed) {
+ distanceSq = dx * dx + dy * dy;
+ if (distanceSq >= minDistance * minDistance) { // use pythagorean theorem
+ this.handleDistanceSurpassed(ev);
+ }
+ }
+
+ if (this.isDragging) {
+ this.handleDrag(dx, dy, ev);
+ }
+ },
+
+
+ // Called while the mouse is being moved and when we know a legitimate drag is taking place
+ handleDrag: function(dx, dy, ev) {
+ this.trigger('drag', dx, dy, ev);
+ this.updateAutoScroll(ev); // will possibly cause scrolling
+ },
+
+
+ endDrag: function(ev) {
+ if (this.isDragging) {
+ this.isDragging = false;
+ this.handleDragEnd(ev);
+ }
+ },
+
+
+ handleDragEnd: function(ev) {
+ this.trigger('dragEnd', ev);
+ },
+
+
+ // Delay
+ // -----------------------------------------------------------------------------------------------------------------
+
+
+ startDelay: function(initialEv) {
+ var _this = this;
+
+ if (this.delay) {
+ this.delayTimeoutId = setTimeout(function() {
+ _this.handleDelayEnd(initialEv);
+ }, this.delay);
+ }
+ else {
+ this.handleDelayEnd(initialEv);
+ }
+ },
+
+
+ handleDelayEnd: function(initialEv) {
+ this.isDelayEnded = true;
+
+ if (this.isDistanceSurpassed) {
+ this.startDrag(initialEv);
+ }
+ },
+
+
+ // Distance
+ // -----------------------------------------------------------------------------------------------------------------
+
+
+ handleDistanceSurpassed: function(ev) {
+ this.isDistanceSurpassed = true;
+
+ if (this.isDelayEnded) {
+ this.startDrag(ev);
+ }
+ },
+
+
+ // Mouse / Touch
+ // -----------------------------------------------------------------------------------------------------------------
+
+
+ handleTouchMove: function(ev) {
+ // prevent inertia and touchmove-scrolling while dragging
+ if (this.isDragging) {
+ ev.preventDefault();
+ }
+
+ this.handleMove(ev);
+ },
+
+
+ handleMouseMove: function(ev) {
+ this.handleMove(ev);
+ },
+
+
+ // Scrolling (unrelated to auto-scroll)
+ // -----------------------------------------------------------------------------------------------------------------
+
+
+ handleTouchScroll: function(ev) {
+ // if the drag is being initiated by touch, but a scroll happens before
+ // the drag-initiating delay is over, cancel the drag
+ if (!this.isDragging) {
+ this.endInteraction(ev, true); // isCancelled=true
+ }
+ },
+
+
+ // Utils
+ // -----------------------------------------------------------------------------------------------------------------
+
+
+ // Triggers a callback. Calls a function in the option hash of the same name.
+ // Arguments beyond the first `name` are forwarded on.
+ trigger: function(name) {
+ if (this.options[name]) {
+ this.options[name].apply(this, Array.prototype.slice.call(arguments, 1));
+ }
+ // makes _methods callable by event name. TODO: kill this
+ if (this['_' + name]) {
+ this['_' + name].apply(this, Array.prototype.slice.call(arguments, 1));
+ }
+ }
+
+
+});
+
+;;
+/*
+this.scrollEl is set in DragListener
+*/
+DragListener.mixin({
+
+ isAutoScroll: false,
+
+ scrollBounds: null, // { top, bottom, left, right }
+ scrollTopVel: null, // pixels per second
+ scrollLeftVel: null, // pixels per second
+ scrollIntervalId: null, // ID of setTimeout for scrolling animation loop
+
+ // defaults
+ scrollSensitivity: 30, // pixels from edge for scrolling to start
+ scrollSpeed: 200, // pixels per second, at maximum speed
+ scrollIntervalMs: 50, // millisecond wait between scroll increment
+
+
+ initAutoScroll: function() {
+ var scrollEl = this.scrollEl;
+
+ this.isAutoScroll =
+ this.options.scroll &&
+ scrollEl &&
+ !scrollEl.is(window) &&
+ !scrollEl.is(document);
+
+ if (this.isAutoScroll) {
+ // debounce makes sure rapid calls don't happen
+ this.listenTo(scrollEl, 'scroll', debounce(this.handleDebouncedScroll, 100));
+ }
+ },
+
+
+ destroyAutoScroll: function() {
+ this.endAutoScroll(); // kill any animation loop
+
+ // remove the scroll handler if there is a scrollEl
+ if (this.isAutoScroll) {
+ this.stopListeningTo(this.scrollEl, 'scroll'); // will probably get removed by unbindHandlers too :(
+ }
+ },
+
+
+ // Computes and stores the bounding rectangle of scrollEl
+ computeScrollBounds: function() {
+ if (this.isAutoScroll) {
+ this.scrollBounds = getOuterRect(this.scrollEl);
+ // TODO: use getClientRect in future. but prevents auto scrolling when on top of scrollbars
+ }
+ },
+
+
+ // Called when the dragging is in progress and scrolling should be updated
+ updateAutoScroll: function(ev) {
+ var sensitivity = this.scrollSensitivity;
+ var bounds = this.scrollBounds;
+ var topCloseness, bottomCloseness;
+ var leftCloseness, rightCloseness;
+ var topVel = 0;
+ var leftVel = 0;
+
+ if (bounds) { // only scroll if scrollEl exists
+
+ // compute closeness to edges. valid range is from 0.0 - 1.0
+ topCloseness = (sensitivity - (getEvY(ev) - bounds.top)) / sensitivity;
+ bottomCloseness = (sensitivity - (bounds.bottom - getEvY(ev))) / sensitivity;
+ leftCloseness = (sensitivity - (getEvX(ev) - bounds.left)) / sensitivity;
+ rightCloseness = (sensitivity - (bounds.right - getEvX(ev))) / sensitivity;
+
+ // translate vertical closeness into velocity.
+ // mouse must be completely in bounds for velocity to happen.
+ if (topCloseness >= 0 && topCloseness <= 1) {
+ topVel = topCloseness * this.scrollSpeed * -1; // negative. for scrolling up
+ }
+ else if (bottomCloseness >= 0 && bottomCloseness <= 1) {
+ topVel = bottomCloseness * this.scrollSpeed;
+ }
+
+ // translate horizontal closeness into velocity
+ if (leftCloseness >= 0 && leftCloseness <= 1) {
+ leftVel = leftCloseness * this.scrollSpeed * -1; // negative. for scrolling left
+ }
+ else if (rightCloseness >= 0 && rightCloseness <= 1) {
+ leftVel = rightCloseness * this.scrollSpeed;
+ }
+ }
+
+ this.setScrollVel(topVel, leftVel);
+ },
+
+
+ // Sets the speed-of-scrolling for the scrollEl
+ setScrollVel: function(topVel, leftVel) {
+
+ this.scrollTopVel = topVel;
+ this.scrollLeftVel = leftVel;
+
+ this.constrainScrollVel(); // massages into realistic values
+
+ // if there is non-zero velocity, and an animation loop hasn't already started, then START
+ if ((this.scrollTopVel || this.scrollLeftVel) && !this.scrollIntervalId) {
+ this.scrollIntervalId = setInterval(
+ proxy(this, 'scrollIntervalFunc'), // scope to `this`
+ this.scrollIntervalMs
+ );
+ }
+ },
+
+
+ // Forces scrollTopVel and scrollLeftVel to be zero if scrolling has already gone all the way
+ constrainScrollVel: function() {
+ var el = this.scrollEl;
+
+ if (this.scrollTopVel < 0) { // scrolling up?
+ if (el.scrollTop() <= 0) { // already scrolled all the way up?
+ this.scrollTopVel = 0;
+ }
+ }
+ else if (this.scrollTopVel > 0) { // scrolling down?
+ if (el.scrollTop() + el[0].clientHeight >= el[0].scrollHeight) { // already scrolled all the way down?
+ this.scrollTopVel = 0;
+ }
+ }
+
+ if (this.scrollLeftVel < 0) { // scrolling left?
+ if (el.scrollLeft() <= 0) { // already scrolled all the left?
+ this.scrollLeftVel = 0;
+ }
+ }
+ else if (this.scrollLeftVel > 0) { // scrolling right?
+ if (el.scrollLeft() + el[0].clientWidth >= el[0].scrollWidth) { // already scrolled all the way right?
+ this.scrollLeftVel = 0;
+ }
+ }
+ },
+
+
+ // This function gets called during every iteration of the scrolling animation loop
+ scrollIntervalFunc: function() {
+ var el = this.scrollEl;
+ var frac = this.scrollIntervalMs / 1000; // considering animation frequency, what the vel should be mult'd by
+
+ // change the value of scrollEl's scroll
+ if (this.scrollTopVel) {
+ el.scrollTop(el.scrollTop() + this.scrollTopVel * frac);
+ }
+ if (this.scrollLeftVel) {
+ el.scrollLeft(el.scrollLeft() + this.scrollLeftVel * frac);
+ }
+
+ this.constrainScrollVel(); // since the scroll values changed, recompute the velocities
+
+ // if scrolled all the way, which causes the vels to be zero, stop the animation loop
+ if (!this.scrollTopVel && !this.scrollLeftVel) {
+ this.endAutoScroll();
+ }
+ },
+
+
+ // Kills any existing scrolling animation loop
+ endAutoScroll: function() {
+ if (this.scrollIntervalId) {
+ clearInterval(this.scrollIntervalId);
+ this.scrollIntervalId = null;
+
+ this.handleScrollEnd();
+ }
+ },
+
+
+ // Get called when the scrollEl is scrolled (NOTE: this is delayed via debounce)
+ handleDebouncedScroll: function() {
+ // recompute all coordinates, but *only* if this is *not* part of our scrolling animation
+ if (!this.scrollIntervalId) {
+ this.handleScrollEnd();
+ }
+ },
+
+
+ // Called when scrolling has stopped, whether through auto scroll, or the user scrolling
+ handleScrollEnd: function() {
+ }
+
+});
+;;
+
+/* Tracks mouse movements over a component and raises events about which hit the mouse is over.
+------------------------------------------------------------------------------------------------------------------------
+options:
+- subjectEl
+- subjectCenter
+*/
+
+var HitDragListener = DragListener.extend({
+
+ component: null, // converts coordinates to hits
+ // methods: prepareHits, releaseHits, queryHit
+
+ origHit: null, // the hit the mouse was over when listening started
+ hit: null, // the hit the mouse is over
+ coordAdjust: null, // delta that will be added to the mouse coordinates when computing collisions
+
+
+ constructor: function(component, options) {
+ DragListener.call(this, options); // call the super-constructor
+
+ this.component = component;
+ },
+
+
+ // Called when drag listening starts (but a real drag has not necessarily began).
+ // ev might be undefined if dragging was started manually.
+ handleInteractionStart: function(ev) {
+ var subjectEl = this.subjectEl;
+ var subjectRect;
+ var origPoint;
+ var point;
+
+ this.computeCoords();
+
+ if (ev) {
+ origPoint = { left: getEvX(ev), top: getEvY(ev) };
+ point = origPoint;
+
+ // constrain the point to bounds of the element being dragged
+ if (subjectEl) {
+ subjectRect = getOuterRect(subjectEl); // used for centering as well
+ point = constrainPoint(point, subjectRect);
+ }
+
+ this.origHit = this.queryHit(point.left, point.top);
+
+ // treat the center of the subject as the collision point?
+ if (subjectEl && this.options.subjectCenter) {
+
+ // only consider the area the subject overlaps the hit. best for large subjects.
+ // TODO: skip this if hit didn't supply left/right/top/bottom
+ if (this.origHit) {
+ subjectRect = intersectRects(this.origHit, subjectRect) ||
+ subjectRect; // in case there is no intersection
+ }
+
+ point = getRectCenter(subjectRect);
+ }
+
+ this.coordAdjust = diffPoints(point, origPoint); // point - origPoint
+ }
+ else {
+ this.origHit = null;
+ this.coordAdjust = null;
+ }
+
+ // call the super-method. do it after origHit has been computed
+ DragListener.prototype.handleInteractionStart.apply(this, arguments);
+ },
+
+
+ // Recomputes the drag-critical positions of elements
+ computeCoords: function() {
+ this.component.prepareHits();
+ this.computeScrollBounds(); // why is this here??????
+ },
+
+
+ // Called when the actual drag has started
+ handleDragStart: function(ev) {
+ var hit;
+
+ DragListener.prototype.handleDragStart.apply(this, arguments); // call the super-method
+
+ // might be different from this.origHit if the min-distance is large
+ hit = this.queryHit(getEvX(ev), getEvY(ev));
+
+ // report the initial hit the mouse is over
+ // especially important if no min-distance and drag starts immediately
+ if (hit) {
+ this.handleHitOver(hit);
+ }
+ },
+
+
+ // Called when the drag moves
+ handleDrag: function(dx, dy, ev) {
+ var hit;
+
+ DragListener.prototype.handleDrag.apply(this, arguments); // call the super-method
+
+ hit = this.queryHit(getEvX(ev), getEvY(ev));
+
+ if (!isHitsEqual(hit, this.hit)) { // a different hit than before?
+ if (this.hit) {
+ this.handleHitOut();
+ }
+ if (hit) {
+ this.handleHitOver(hit);
+ }
+ }
+ },
+
+
+ // Called when dragging has been stopped
+ handleDragEnd: function() {
+ this.handleHitDone();
+ DragListener.prototype.handleDragEnd.apply(this, arguments); // call the super-method
+ },
+
+
+ // Called when a the mouse has just moved over a new hit
+ handleHitOver: function(hit) {
+ var isOrig = isHitsEqual(hit, this.origHit);
+
+ this.hit = hit;
+
+ this.trigger('hitOver', this.hit, isOrig, this.origHit);
+ },
+
+
+ // Called when the mouse has just moved out of a hit
+ handleHitOut: function() {
+ if (this.hit) {
+ this.trigger('hitOut', this.hit);
+ this.handleHitDone();
+ this.hit = null;
+ }
+ },
+
+
+ // Called after a hitOut. Also called before a dragStop
+ handleHitDone: function() {
+ if (this.hit) {
+ this.trigger('hitDone', this.hit);
+ }
+ },
+
+
+ // Called when the interaction ends, whether there was a real drag or not
+ handleInteractionEnd: function() {
+ DragListener.prototype.handleInteractionEnd.apply(this, arguments); // call the super-method
+
+ this.origHit = null;
+ this.hit = null;
+
+ this.component.releaseHits();
+ },
+
+
+ // Called when scrolling has stopped, whether through auto scroll, or the user scrolling
+ handleScrollEnd: function() {
+ DragListener.prototype.handleScrollEnd.apply(this, arguments); // call the super-method
+
+ this.computeCoords(); // hits' absolute positions will be in new places. recompute
+ },
+
+
+ // Gets the hit underneath the coordinates for the given mouse event
+ queryHit: function(left, top) {
+
+ if (this.coordAdjust) {
+ left += this.coordAdjust.left;
+ top += this.coordAdjust.top;
+ }
+
+ return this.component.queryHit(left, top);
+ }
+
+});
+
+
+// Returns `true` if the hits are identically equal. `false` otherwise. Must be from the same component.
+// Two null values will be considered equal, as two "out of the component" states are the same.
+function isHitsEqual(hit0, hit1) {
+
+ if (!hit0 && !hit1) {
+ return true;
+ }
+
+ if (hit0 && hit1) {
+ return hit0.component === hit1.component &&
+ isHitPropsWithin(hit0, hit1) &&
+ isHitPropsWithin(hit1, hit0); // ensures all props are identical
+ }
+
+ return false;
+}
+
+
+// Returns true if all of subHit's non-standard properties are within superHit
+function isHitPropsWithin(subHit, superHit) {
+ for (var propName in subHit) {
+ if (!/^(component|left|right|top|bottom)$/.test(propName)) {
+ if (subHit[propName] !== superHit[propName]) {
+ return false;
+ }
+ }
+ }
+ return true;
+}
+
+;;
+
+/* Creates a clone of an element and lets it track the mouse as it moves
+----------------------------------------------------------------------------------------------------------------------*/
+
+var MouseFollower = Class.extend(ListenerMixin, {
+
+ options: null,
+
+ sourceEl: null, // the element that will be cloned and made to look like it is dragging
+ el: null, // the clone of `sourceEl` that will track the mouse
+ parentEl: null, // the element that `el` (the clone) will be attached to
+
+ // the initial position of el, relative to the offset parent. made to match the initial offset of sourceEl
+ top0: null,
+ left0: null,
+
+ // the absolute coordinates of the initiating touch/mouse action
+ y0: null,
+ x0: null,
+
+ // the number of pixels the mouse has moved from its initial position
+ topDelta: null,
+ leftDelta: null,
+
+ isFollowing: false,
+ isHidden: false,
+ isAnimating: false, // doing the revert animation?
+
+ constructor: function(sourceEl, options) {
+ this.options = options = options || {};
+ this.sourceEl = sourceEl;
+ this.parentEl = options.parentEl ? $(options.parentEl) : sourceEl.parent(); // default to sourceEl's parent
+ },
+
+
+ // Causes the element to start following the mouse
+ start: function(ev) {
+ if (!this.isFollowing) {
+ this.isFollowing = true;
+
+ this.y0 = getEvY(ev);
+ this.x0 = getEvX(ev);
+ this.topDelta = 0;
+ this.leftDelta = 0;
+
+ if (!this.isHidden) {
+ this.updatePosition();
+ }
+
+ if (getEvIsTouch(ev)) {
+ this.listenTo($(document), 'touchmove', this.handleMove);
+ }
+ else {
+ this.listenTo($(document), 'mousemove', this.handleMove);
+ }
+ }
+ },
+
+
+ // Causes the element to stop following the mouse. If shouldRevert is true, will animate back to original position.
+ // `callback` gets invoked when the animation is complete. If no animation, it is invoked immediately.
+ stop: function(shouldRevert, callback) {
+ var _this = this;
+ var revertDuration = this.options.revertDuration;
+
+ function complete() { // might be called by .animate(), which might change `this` context
+ _this.isAnimating = false;
+ _this.removeElement();
+
+ _this.top0 = _this.left0 = null; // reset state for future updatePosition calls
+
+ if (callback) {
+ callback();
+ }
+ }
+
+ if (this.isFollowing && !this.isAnimating) { // disallow more than one stop animation at a time
+ this.isFollowing = false;
+
+ this.stopListeningTo($(document));
+
+ if (shouldRevert && revertDuration && !this.isHidden) { // do a revert animation?
+ this.isAnimating = true;
+ this.el.animate({
+ top: this.top0,
+ left: this.left0
+ }, {
+ duration: revertDuration,
+ complete: complete
+ });
+ }
+ else {
+ complete();
+ }
+ }
+ },
+
+
+ // Gets the tracking element. Create it if necessary
+ getEl: function() {
+ var el = this.el;
+
+ if (!el) {
+ el = this.el = this.sourceEl.clone()
+ .addClass(this.options.additionalClass || '')
+ .css({
+ position: 'absolute',
+ visibility: '', // in case original element was hidden (commonly through hideEvents())
+ display: this.isHidden ? 'none' : '', // for when initially hidden
+ margin: 0,
+ right: 'auto', // erase and set width instead
+ bottom: 'auto', // erase and set height instead
+ width: this.sourceEl.width(), // explicit height in case there was a 'right' value
+ height: this.sourceEl.height(), // explicit width in case there was a 'bottom' value
+ opacity: this.options.opacity || '',
+ zIndex: this.options.zIndex
+ });
+
+ // we don't want long taps or any mouse interaction causing selection/menus.
+ // would use preventSelection(), but that prevents selectstart, causing problems.
+ el.addClass('fc-unselectable');
+
+ el.appendTo(this.parentEl);
+ }
+
+ return el;
+ },
+
+
+ // Removes the tracking element if it has already been created
+ removeElement: function() {
+ if (this.el) {
+ this.el.remove();
+ this.el = null;
+ }
+ },
+
+
+ // Update the CSS position of the tracking element
+ updatePosition: function() {
+ var sourceOffset;
+ var origin;
+
+ this.getEl(); // ensure this.el
+
+ // make sure origin info was computed
+ if (this.top0 === null) {
+ sourceOffset = this.sourceEl.offset();
+ origin = this.el.offsetParent().offset();
+ this.top0 = sourceOffset.top - origin.top;
+ this.left0 = sourceOffset.left - origin.left;
+ }
+
+ this.el.css({
+ top: this.top0 + this.topDelta,
+ left: this.left0 + this.leftDelta
+ });
+ },
+
+
+ // Gets called when the user moves the mouse
+ handleMove: function(ev) {
+ this.topDelta = getEvY(ev) - this.y0;
+ this.leftDelta = getEvX(ev) - this.x0;
+
+ if (!this.isHidden) {
+ this.updatePosition();
+ }
+ },
+
+
+ // Temporarily makes the tracking element invisible. Can be called before following starts
+ hide: function() {
+ if (!this.isHidden) {
+ this.isHidden = true;
+ if (this.el) {
+ this.el.hide();
+ }
+ }
+ },
+
+
+ // Show the tracking element after it has been temporarily hidden
+ show: function() {
+ if (this.isHidden) {
+ this.isHidden = false;
+ this.updatePosition();
+ this.getEl().show();
+ }
+ }
+
+});
+
+;;
+
+/* An abstract class comprised of a "grid" of areas that each represent a specific datetime
+----------------------------------------------------------------------------------------------------------------------*/
+
+var Grid = FC.Grid = Class.extend(ListenerMixin, MouseIgnorerMixin, {
+
+ // self-config, overridable by subclasses
+ hasDayInteractions: true, // can user click/select ranges of time?
+
+ view: null, // a View object
+ isRTL: null, // shortcut to the view's isRTL option
+
+ start: null,
+ end: null,
+
+ el: null, // the containing element
+ elsByFill: null, // a hash of jQuery element sets used for rendering each fill. Keyed by fill name.
+
+ // derived from options
+ eventTimeFormat: null,
+ displayEventTime: null,
+ displayEventEnd: null,
+
+ minResizeDuration: null, // TODO: hack. set by subclasses. minumum event resize duration
+
+ // if defined, holds the unit identified (ex: "year" or "month") that determines the level of granularity
+ // of the date areas. if not defined, assumes to be day and time granularity.
+ // TODO: port isTimeScale into same system?
+ largeUnit: null,
+
+ dayDragListener: null,
+ segDragListener: null,
+ segResizeListener: null,
+ externalDragListener: null,
+
+
+ constructor: function(view) {
+ this.view = view;
+ this.isRTL = view.opt('isRTL');
+ this.elsByFill = {};
+
+ this.dayDragListener = this.buildDayDragListener();
+ this.initMouseIgnoring();
+ },
+
+
+ /* Options
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Generates the format string used for event time text, if not explicitly defined by 'timeFormat'
+ computeEventTimeFormat: function() {
+ return this.view.opt('smallTimeFormat');
+ },
+
+
+ // Determines whether events should have their end times displayed, if not explicitly defined by 'displayEventTime'.
+ // Only applies to non-all-day events.
+ computeDisplayEventTime: function() {
+ return true;
+ },
+
+
+ // Determines whether events should have their end times displayed, if not explicitly defined by 'displayEventEnd'
+ computeDisplayEventEnd: function() {
+ return true;
+ },
+
+
+ /* Dates
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Tells the grid about what period of time to display.
+ // Any date-related internal data should be generated.
+ setRange: function(range) {
+ this.start = range.start.clone();
+ this.end = range.end.clone();
+
+ this.rangeUpdated();
+ this.processRangeOptions();
+ },
+
+
+ // Called when internal variables that rely on the range should be updated
+ rangeUpdated: function() {
+ },
+
+
+ // Updates values that rely on options and also relate to range
+ processRangeOptions: function() {
+ var view = this.view;
+ var displayEventTime;
+ var displayEventEnd;
+
+ this.eventTimeFormat =
+ view.opt('eventTimeFormat') ||
+ view.opt('timeFormat') || // deprecated
+ this.computeEventTimeFormat();
+
+ displayEventTime = view.opt('displayEventTime');
+ if (displayEventTime == null) {
+ displayEventTime = this.computeDisplayEventTime(); // might be based off of range
+ }
+
+ displayEventEnd = view.opt('displayEventEnd');
+ if (displayEventEnd == null) {
+ displayEventEnd = this.computeDisplayEventEnd(); // might be based off of range
+ }
+
+ this.displayEventTime = displayEventTime;
+ this.displayEventEnd = displayEventEnd;
+ },
+
+
+ // Converts a span (has unzoned start/end and any other grid-specific location information)
+ // into an array of segments (pieces of events whose format is decided by the grid).
+ spanToSegs: function(span) {
+ // subclasses must implement
+ },
+
+
+ // Diffs the two dates, returning a duration, based on granularity of the grid
+ // TODO: port isTimeScale into this system?
+ diffDates: function(a, b) {
+ if (this.largeUnit) {
+ return diffByUnit(a, b, this.largeUnit);
+ }
+ else {
+ return diffDayTime(a, b);
+ }
+ },
+
+
+ /* Hit Area
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Called before one or more queryHit calls might happen. Should prepare any cached coordinates for queryHit
+ prepareHits: function() {
+ },
+
+
+ // Called when queryHit calls have subsided. Good place to clear any coordinate caches.
+ releaseHits: function() {
+ },
+
+
+ // Given coordinates from the topleft of the document, return data about the date-related area underneath.
+ // Can return an object with arbitrary properties (although top/right/left/bottom are encouraged).
+ // Must have a `grid` property, a reference to this current grid. TODO: avoid this
+ // The returned object will be processed by getHitSpan and getHitEl.
+ queryHit: function(leftOffset, topOffset) {
+ },
+
+
+ // Given position-level information about a date-related area within the grid,
+ // should return an object with at least a start/end date. Can provide other information as well.
+ getHitSpan: function(hit) {
+ },
+
+
+ // Given position-level information about a date-related area within the grid,
+ // should return a jQuery element that best represents it. passed to dayClick callback.
+ getHitEl: function(hit) {
+ },
+
+
+ /* Rendering
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Sets the container element that the grid should render inside of.
+ // Does other DOM-related initializations.
+ setElement: function(el) {
+ this.el = el;
+
+ if (this.hasDayInteractions) {
+ preventSelection(el);
+
+ this.bindDayHandler('touchstart', this.dayTouchStart);
+ this.bindDayHandler('mousedown', this.dayMousedown);
+ }
+
+ // attach event-element-related handlers. in Grid.events
+ // same garbage collection note as above.
+ this.bindSegHandlers();
+
+ this.bindGlobalHandlers();
+ },
+
+
+ bindDayHandler: function(name, handler) {
+ var _this = this;
+
+ // attach a handler to the grid's root element.
+ // jQuery will take care of unregistering them when removeElement gets called.
+ this.el.on(name, function(ev) {
+ if (
+ !$(ev.target).is(
+ _this.segSelector + ',' + // directly on an event element
+ _this.segSelector + ' *,' + // within an event element
+ '.fc-more,' + // a "more.." link
+ 'a[data-goto]' // a clickable nav link
+ )
+ ) {
+ return handler.call(_this, ev);
+ }
+ });
+ },
+
+
+ // Removes the grid's container element from the DOM. Undoes any other DOM-related attachments.
+ // DOES NOT remove any content beforehand (doesn't clear events or call unrenderDates), unlike View
+ removeElement: function() {
+ this.unbindGlobalHandlers();
+ this.clearDragListeners();
+
+ this.el.remove();
+
+ // NOTE: we don't null-out this.el for the same reasons we don't do it within View::removeElement
+ },
+
+
+ // Renders the basic structure of grid view before any content is rendered
+ renderSkeleton: function() {
+ // subclasses should implement
+ },
+
+
+ // Renders the grid's date-related content (like areas that represent days/times).
+ // Assumes setRange has already been called and the skeleton has already been rendered.
+ renderDates: function() {
+ // subclasses should implement
+ },
+
+
+ // Unrenders the grid's date-related content
+ unrenderDates: function() {
+ // subclasses should implement
+ },
+
+
+ /* Handlers
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Binds DOM handlers to elements that reside outside the grid, such as the document
+ bindGlobalHandlers: function() {
+ this.listenTo($(document), {
+ dragstart: this.externalDragStart, // jqui
+ sortstart: this.externalDragStart // jqui
+ });
+ },
+
+
+ // Unbinds DOM handlers from elements that reside outside the grid
+ unbindGlobalHandlers: function() {
+ this.stopListeningTo($(document));
+ },
+
+
+ // Process a mousedown on an element that represents a day. For day clicking and selecting.
+ dayMousedown: function(ev) {
+ if (!this.isIgnoringMouse) {
+ this.dayDragListener.startInteraction(ev, {
+ //distance: 5, // needs more work if we want dayClick to fire correctly
+ });
+ }
+ },
+
+
+ dayTouchStart: function(ev) {
+ var view = this.view;
+
+ // HACK to prevent a user's clickaway for unselecting a range or an event
+ // from causing a dayClick.
+ if (view.isSelected || view.selectedEvent) {
+ this.tempIgnoreMouse();
+ }
+
+ this.dayDragListener.startInteraction(ev, {
+ delay: this.view.opt('longPressDelay')
+ });
+ },
+
+
+ // Creates a listener that tracks the user's drag across day elements.
+ // For day clicking and selecting.
+ buildDayDragListener: function() {
+ var _this = this;
+ var view = this.view;
+ var isSelectable = view.opt('selectable');
+ var dayClickHit; // null if invalid dayClick
+ var selectionSpan; // null if invalid selection
+
+ // this listener tracks a mousedown on a day element, and a subsequent drag.
+ // if the drag ends on the same day, it is a 'dayClick'.
+ // if 'selectable' is enabled, this listener also detects selections.
+ var dragListener = new HitDragListener(this, {
+ scroll: view.opt('dragScroll'),
+ interactionStart: function() {
+ dayClickHit = dragListener.origHit; // for dayClick, where no dragging happens
+ selectionSpan = null;
+ },
+ dragStart: function() {
+ view.unselect(); // since we could be rendering a new selection, we want to clear any old one
+ },
+ hitOver: function(hit, isOrig, origHit) {
+ if (origHit) { // click needs to have started on a hit
+
+ // if user dragged to another cell at any point, it can no longer be a dayClick
+ if (!isOrig) {
+ dayClickHit = null;
+ }
+
+ if (isSelectable) {
+ selectionSpan = _this.computeSelection(
+ _this.getHitSpan(origHit),
+ _this.getHitSpan(hit)
+ );
+ if (selectionSpan) {
+ _this.renderSelection(selectionSpan);
+ }
+ else if (selectionSpan === false) {
+ disableCursor();
+ }
+ }
+ }
+ },
+ hitOut: function() { // called before mouse moves to a different hit OR moved out of all hits
+ dayClickHit = null;
+ selectionSpan = null;
+ _this.unrenderSelection();
+ },
+ hitDone: function() { // called after a hitOut OR before a dragEnd
+ enableCursor();
+ },
+ interactionEnd: function(ev, isCancelled) {
+ if (!isCancelled) {
+ if (
+ dayClickHit &&
+ !_this.isIgnoringMouse // see hack in dayTouchStart
+ ) {
+ view.triggerDayClick(
+ _this.getHitSpan(dayClickHit),
+ _this.getHitEl(dayClickHit),
+ ev
+ );
+ }
+ if (selectionSpan) {
+ // the selection will already have been rendered. just report it
+ view.reportSelection(selectionSpan, ev);
+ }
+ }
+ }
+ });
+
+ return dragListener;
+ },
+
+
+ // Kills all in-progress dragging.
+ // Useful for when public API methods that result in re-rendering are invoked during a drag.
+ // Also useful for when touch devices misbehave and don't fire their touchend.
+ clearDragListeners: function() {
+ this.dayDragListener.endInteraction();
+
+ if (this.segDragListener) {
+ this.segDragListener.endInteraction(); // will clear this.segDragListener
+ }
+ if (this.segResizeListener) {
+ this.segResizeListener.endInteraction(); // will clear this.segResizeListener
+ }
+ if (this.externalDragListener) {
+ this.externalDragListener.endInteraction(); // will clear this.externalDragListener
+ }
+ },
+
+
+ /* Event Helper
+ ------------------------------------------------------------------------------------------------------------------*/
+ // TODO: should probably move this to Grid.events, like we did event dragging / resizing
+
+
+ // Renders a mock event at the given event location, which contains zoned start/end properties.
+ // Returns all mock event elements.
+ renderEventLocationHelper: function(eventLocation, sourceSeg) {
+ var fakeEvent = this.fabricateHelperEvent(eventLocation, sourceSeg);
+
+ return this.renderHelper(fakeEvent, sourceSeg); // do the actual rendering
+ },
+
+
+ // Builds a fake event given zoned event date properties and a segment is should be inspired from.
+ // The range's end can be null, in which case the mock event that is rendered will have a null end time.
+ // `sourceSeg` is the internal segment object involved in the drag. If null, something external is dragging.
+ fabricateHelperEvent: function(eventLocation, sourceSeg) {
+ var fakeEvent = sourceSeg ? createObject(sourceSeg.event) : {}; // mask the original event object if possible
+
+ fakeEvent.start = eventLocation.start.clone();
+ fakeEvent.end = eventLocation.end ? eventLocation.end.clone() : null;
+ fakeEvent.allDay = null; // force it to be freshly computed by normalizeEventDates
+ this.view.calendar.normalizeEventDates(fakeEvent);
+
+ // this extra className will be useful for differentiating real events from mock events in CSS
+ fakeEvent.className = (fakeEvent.className || []).concat('fc-helper');
+
+ // if something external is being dragged in, don't render a resizer
+ if (!sourceSeg) {
+ fakeEvent.editable = false;
+ }
+
+ return fakeEvent;
+ },
+
+
+ // Renders a mock event. Given zoned event date properties.
+ // Must return all mock event elements.
+ renderHelper: function(eventLocation, sourceSeg) {
+ // subclasses must implement
+ },
+
+
+ // Unrenders a mock event
+ unrenderHelper: function() {
+ // subclasses must implement
+ },
+
+
+ /* Selection
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Renders a visual indication of a selection. Will highlight by default but can be overridden by subclasses.
+ // Given a span (unzoned start/end and other misc data)
+ renderSelection: function(span) {
+ this.renderHighlight(span);
+ },
+
+
+ // Unrenders any visual indications of a selection. Will unrender a highlight by default.
+ unrenderSelection: function() {
+ this.unrenderHighlight();
+ },
+
+
+ // Given the first and last date-spans of a selection, returns another date-span object.
+ // Subclasses can override and provide additional data in the span object. Will be passed to renderSelection().
+ // Will return false if the selection is invalid and this should be indicated to the user.
+ // Will return null/undefined if a selection invalid but no error should be reported.
+ computeSelection: function(span0, span1) {
+ var span = this.computeSelectionSpan(span0, span1);
+
+ if (span && !this.view.calendar.isSelectionSpanAllowed(span)) {
+ return false;
+ }
+
+ return span;
+ },
+
+
+ // Given two spans, must return the combination of the two.
+ // TODO: do this separation of concerns (combining VS validation) for event dnd/resize too.
+ computeSelectionSpan: function(span0, span1) {
+ var dates = [ span0.start, span0.end, span1.start, span1.end ];
+
+ dates.sort(compareNumbers); // sorts chronologically. works with Moments
+
+ return { start: dates[0].clone(), end: dates[3].clone() };
+ },
+
+
+ /* Highlight
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Renders an emphasis on the given date range. Given a span (unzoned start/end and other misc data)
+ renderHighlight: function(span) {
+ this.renderFill('highlight', this.spanToSegs(span));
+ },
+
+
+ // Unrenders the emphasis on a date range
+ unrenderHighlight: function() {
+ this.unrenderFill('highlight');
+ },
+
+
+ // Generates an array of classNames for rendering the highlight. Used by the fill system.
+ highlightSegClasses: function() {
+ return [ 'fc-highlight' ];
+ },
+
+
+ /* Business Hours
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ renderBusinessHours: function() {
+ },
+
+
+ unrenderBusinessHours: function() {
+ },
+
+
+ /* Now Indicator
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ getNowIndicatorUnit: function() {
+ },
+
+
+ renderNowIndicator: function(date) {
+ },
+
+
+ unrenderNowIndicator: function() {
+ },
+
+
+ /* Fill System (highlight, background events, business hours)
+ --------------------------------------------------------------------------------------------------------------------
+ TODO: remove this system. like we did in TimeGrid
+ */
+
+
+ // Renders a set of rectangles over the given segments of time.
+ // MUST RETURN a subset of segs, the segs that were actually rendered.
+ // Responsible for populating this.elsByFill. TODO: better API for expressing this requirement
+ renderFill: function(type, segs) {
+ // subclasses must implement
+ },
+
+
+ // Unrenders a specific type of fill that is currently rendered on the grid
+ unrenderFill: function(type) {
+ var el = this.elsByFill[type];
+
+ if (el) {
+ el.remove();
+ delete this.elsByFill[type];
+ }
+ },
+
+
+ // Renders and assigns an `el` property for each fill segment. Generic enough to work with different types.
+ // Only returns segments that successfully rendered.
+ // To be harnessed by renderFill (implemented by subclasses).
+ // Analagous to renderFgSegEls.
+ renderFillSegEls: function(type, segs) {
+ var _this = this;
+ var segElMethod = this[type + 'SegEl'];
+ var html = '';
+ var renderedSegs = [];
+ var i;
+
+ if (segs.length) {
+
+ // build a large concatenation of segment HTML
+ for (i = 0; i < segs.length; i++) {
+ html += this.fillSegHtml(type, segs[i]);
+ }
+
+ // Grab individual elements from the combined HTML string. Use each as the default rendering.
+ // Then, compute the 'el' for each segment.
+ $(html).each(function(i, node) {
+ var seg = segs[i];
+ var el = $(node);
+
+ // allow custom filter methods per-type
+ if (segElMethod) {
+ el = segElMethod.call(_this, seg, el);
+ }
+
+ if (el) { // custom filters did not cancel the render
+ el = $(el); // allow custom filter to return raw DOM node
+
+ // correct element type? (would be bad if a non-TD were inserted into a table for example)
+ if (el.is(_this.fillSegTag)) {
+ seg.el = el;
+ renderedSegs.push(seg);
+ }
+ }
+ });
+ }
+
+ return renderedSegs;
+ },
+
+
+ fillSegTag: 'div', // subclasses can override
+
+
+ // Builds the HTML needed for one fill segment. Generic enough to work with different types.
+ fillSegHtml: function(type, seg) {
+
+ // custom hooks per-type
+ var classesMethod = this[type + 'SegClasses'];
+ var cssMethod = this[type + 'SegCss'];
+
+ var classes = classesMethod ? classesMethod.call(this, seg) : [];
+ var css = cssToStr(cssMethod ? cssMethod.call(this, seg) : {});
+
+ return '<' + this.fillSegTag +
+ (classes.length ? ' class="' + classes.join(' ') + '"' : '') +
+ (css ? ' style="' + css + '"' : '') +
+ ' />';
+ },
+
+
+
+ /* Generic rendering utilities for subclasses
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Computes HTML classNames for a single-day element
+ getDayClasses: function(date) {
+ var view = this.view;
+ var today = view.calendar.getNow();
+ var classes = [ 'fc-' + dayIDs[date.day()] ];
+
+ if (
+ view.intervalDuration.as('months') == 1 &&
+ date.month() != view.intervalStart.month()
+ ) {
+ classes.push('fc-other-month');
+ }
+
+ if (date.isSame(today, 'day')) {
+ classes.push(
+ 'fc-today',
+ view.highlightStateClass
+ );
+ }
+ else if (date < today) {
+ classes.push('fc-past');
+ }
+ else {
+ classes.push('fc-future');
+ }
+
+ return classes;
+ }
+
+});
+
+;;
+
+/* Event-rendering and event-interaction methods for the abstract Grid class
+----------------------------------------------------------------------------------------------------------------------*/
+
+Grid.mixin({
+
+ // self-config, overridable by subclasses
+ segSelector: '.fc-event-container > *', // what constitutes an event element?
+
+ mousedOverSeg: null, // the segment object the user's mouse is over. null if over nothing
+ isDraggingSeg: false, // is a segment being dragged? boolean
+ isResizingSeg: false, // is a segment being resized? boolean
+ isDraggingExternal: false, // jqui-dragging an external element? boolean
+ segs: null, // the *event* segments currently rendered in the grid. TODO: rename to `eventSegs`
+
+
+ // Renders the given events onto the grid
+ renderEvents: function(events) {
+ var bgEvents = [];
+ var fgEvents = [];
+ var i;
+
+ for (i = 0; i < events.length; i++) {
+ (isBgEvent(events[i]) ? bgEvents : fgEvents).push(events[i]);
+ }
+
+ this.segs = [].concat( // record all segs
+ this.renderBgEvents(bgEvents),
+ this.renderFgEvents(fgEvents)
+ );
+ },
+
+
+ renderBgEvents: function(events) {
+ var segs = this.eventsToSegs(events);
+
+ // renderBgSegs might return a subset of segs, segs that were actually rendered
+ return this.renderBgSegs(segs) || segs;
+ },
+
+
+ renderFgEvents: function(events) {
+ var segs = this.eventsToSegs(events);
+
+ // renderFgSegs might return a subset of segs, segs that were actually rendered
+ return this.renderFgSegs(segs) || segs;
+ },
+
+
+ // Unrenders all events currently rendered on the grid
+ unrenderEvents: function() {
+ this.handleSegMouseout(); // trigger an eventMouseout if user's mouse is over an event
+ this.clearDragListeners();
+
+ this.unrenderFgSegs();
+ this.unrenderBgSegs();
+
+ this.segs = null;
+ },
+
+
+ // Retrieves all rendered segment objects currently rendered on the grid
+ getEventSegs: function() {
+ return this.segs || [];
+ },
+
+
+ /* Foreground Segment Rendering
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Renders foreground event segments onto the grid. May return a subset of segs that were rendered.
+ renderFgSegs: function(segs) {
+ // subclasses must implement
+ },
+
+
+ // Unrenders all currently rendered foreground segments
+ unrenderFgSegs: function() {
+ // subclasses must implement
+ },
+
+
+ // Renders and assigns an `el` property for each foreground event segment.
+ // Only returns segments that successfully rendered.
+ // A utility that subclasses may use.
+ renderFgSegEls: function(segs, disableResizing) {
+ var view = this.view;
+ var html = '';
+ var renderedSegs = [];
+ var i;
+
+ if (segs.length) { // don't build an empty html string
+
+ // build a large concatenation of event segment HTML
+ for (i = 0; i < segs.length; i++) {
+ html += this.fgSegHtml(segs[i], disableResizing);
+ }
+
+ // Grab individual elements from the combined HTML string. Use each as the default rendering.
+ // Then, compute the 'el' for each segment. An el might be null if the eventRender callback returned false.
+ $(html).each(function(i, node) {
+ var seg = segs[i];
+ var el = view.resolveEventEl(seg.event, $(node));
+
+ if (el) {
+ el.data('fc-seg', seg); // used by handlers
+ seg.el = el;
+ renderedSegs.push(seg);
+ }
+ });
+ }
+
+ return renderedSegs;
+ },
+
+
+ // Generates the HTML for the default rendering of a foreground event segment. Used by renderFgSegEls()
+ fgSegHtml: function(seg, disableResizing) {
+ // subclasses should implement
+ },
+
+
+ /* Background Segment Rendering
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Renders the given background event segments onto the grid.
+ // Returns a subset of the segs that were actually rendered.
+ renderBgSegs: function(segs) {
+ return this.renderFill('bgEvent', segs);
+ },
+
+
+ // Unrenders all the currently rendered background event segments
+ unrenderBgSegs: function() {
+ this.unrenderFill('bgEvent');
+ },
+
+
+ // Renders a background event element, given the default rendering. Called by the fill system.
+ bgEventSegEl: function(seg, el) {
+ return this.view.resolveEventEl(seg.event, el); // will filter through eventRender
+ },
+
+
+ // Generates an array of classNames to be used for the default rendering of a background event.
+ // Called by fillSegHtml.
+ bgEventSegClasses: function(seg) {
+ var event = seg.event;
+ var source = event.source || {};
+
+ return [ 'fc-bgevent' ].concat(
+ event.className,
+ source.className || []
+ );
+ },
+
+
+ // Generates a semicolon-separated CSS string to be used for the default rendering of a background event.
+ // Called by fillSegHtml.
+ bgEventSegCss: function(seg) {
+ return {
+ 'background-color': this.getSegSkinCss(seg)['background-color']
+ };
+ },
+
+
+ // Generates an array of classNames to be used for the rendering business hours overlay. Called by the fill system.
+ // Called by fillSegHtml.
+ businessHoursSegClasses: function(seg) {
+ return [ 'fc-nonbusiness', 'fc-bgevent' ];
+ },
+
+
+ /* Business Hours
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Compute business hour segs for the grid's current date range.
+ // Caller must ask if whole-day business hours are needed.
+ buildBusinessHourSegs: function(wholeDay) {
+ var events = this.view.calendar.getCurrentBusinessHourEvents(wholeDay);
+
+ // HACK. Eventually refactor business hours "events" system.
+ // If no events are given, but businessHours is activated, this means the entire visible range should be
+ // marked as *not* business-hours, via inverse-background rendering.
+ if (
+ !events.length &&
+ this.view.calendar.options.businessHours // don't access view option. doesn't update with dynamic options
+ ) {
+ events = [
+ $.extend({}, BUSINESS_HOUR_EVENT_DEFAULTS, {
+ start: this.view.end, // guaranteed out-of-range
+ end: this.view.end, // "
+ dow: null
+ })
+ ];
+ }
+
+ return this.eventsToSegs(events);
+ },
+
+
+ /* Handlers
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Attaches event-element-related handlers for *all* rendered event segments of the view.
+ bindSegHandlers: function() {
+ this.bindSegHandlersToEl(this.el);
+ },
+
+
+ // Attaches event-element-related handlers to an arbitrary container element. leverages bubbling.
+ bindSegHandlersToEl: function(el) {
+ this.bindSegHandlerToEl(el, 'touchstart', this.handleSegTouchStart);
+ this.bindSegHandlerToEl(el, 'touchend', this.handleSegTouchEnd);
+ this.bindSegHandlerToEl(el, 'mouseenter', this.handleSegMouseover);
+ this.bindSegHandlerToEl(el, 'mouseleave', this.handleSegMouseout);
+ this.bindSegHandlerToEl(el, 'mousedown', this.handleSegMousedown);
+ this.bindSegHandlerToEl(el, 'click', this.handleSegClick);
+ },
+
+
+ // Executes a handler for any a user-interaction on a segment.
+ // Handler gets called with (seg, ev), and with the `this` context of the Grid
+ bindSegHandlerToEl: function(el, name, handler) {
+ var _this = this;
+
+ el.on(name, this.segSelector, function(ev) {
+ var seg = $(this).data('fc-seg'); // grab segment data. put there by View::renderEvents
+
+ // only call the handlers if there is not a drag/resize in progress
+ if (seg && !_this.isDraggingSeg && !_this.isResizingSeg) {
+ return handler.call(_this, seg, ev); // context will be the Grid
+ }
+ });
+ },
+
+
+ handleSegClick: function(seg, ev) {
+ var res = this.view.trigger('eventClick', seg.el[0], seg.event, ev); // can return `false` to cancel
+ if (res === false) {
+ ev.preventDefault();
+ }
+ },
+
+
+ // Updates internal state and triggers handlers for when an event element is moused over
+ handleSegMouseover: function(seg, ev) {
+ if (
+ !this.isIgnoringMouse &&
+ !this.mousedOverSeg
+ ) {
+ this.mousedOverSeg = seg;
+ if (this.view.isEventResizable(seg.event)) {
+ seg.el.addClass('fc-allow-mouse-resize');
+ }
+ this.view.trigger('eventMouseover', seg.el[0], seg.event, ev);
+ }
+ },
+
+
+ // Updates internal state and triggers handlers for when an event element is moused out.
+ // Can be given no arguments, in which case it will mouseout the segment that was previously moused over.
+ handleSegMouseout: function(seg, ev) {
+ ev = ev || {}; // if given no args, make a mock mouse event
+
+ if (this.mousedOverSeg) {
+ seg = seg || this.mousedOverSeg; // if given no args, use the currently moused-over segment
+ this.mousedOverSeg = null;
+ if (this.view.isEventResizable(seg.event)) {
+ seg.el.removeClass('fc-allow-mouse-resize');
+ }
+ this.view.trigger('eventMouseout', seg.el[0], seg.event, ev);
+ }
+ },
+
+
+ handleSegMousedown: function(seg, ev) {
+ var isResizing = this.startSegResize(seg, ev, { distance: 5 });
+
+ if (!isResizing && this.view.isEventDraggable(seg.event)) {
+ this.buildSegDragListener(seg)
+ .startInteraction(ev, {
+ distance: 5
+ });
+ }
+ },
+
+
+ handleSegTouchStart: function(seg, ev) {
+ var view = this.view;
+ var event = seg.event;
+ var isSelected = view.isEventSelected(event);
+ var isDraggable = view.isEventDraggable(event);
+ var isResizable = view.isEventResizable(event);
+ var isResizing = false;
+ var dragListener;
+
+ if (isSelected && isResizable) {
+ // only allow resizing of the event is selected
+ isResizing = this.startSegResize(seg, ev);
+ }
+
+ if (!isResizing && (isDraggable || isResizable)) { // allowed to be selected?
+
+ dragListener = isDraggable ?
+ this.buildSegDragListener(seg) :
+ this.buildSegSelectListener(seg); // seg isn't draggable, but still needs to be selected
+
+ dragListener.startInteraction(ev, { // won't start if already started
+ delay: isSelected ? 0 : this.view.opt('longPressDelay') // do delay if not already selected
+ });
+ }
+
+ // a long tap simulates a mouseover. ignore this bogus mouseover.
+ this.tempIgnoreMouse();
+ },
+
+
+ handleSegTouchEnd: function(seg, ev) {
+ // touchstart+touchend = click, which simulates a mouseover.
+ // ignore this bogus mouseover.
+ this.tempIgnoreMouse();
+ },
+
+
+ // returns boolean whether resizing actually started or not.
+ // assumes the seg allows resizing.
+ // `dragOptions` are optional.
+ startSegResize: function(seg, ev, dragOptions) {
+ if ($(ev.target).is('.fc-resizer')) {
+ this.buildSegResizeListener(seg, $(ev.target).is('.fc-start-resizer'))
+ .startInteraction(ev, dragOptions);
+ return true;
+ }
+ return false;
+ },
+
+
+
+ /* Event Dragging
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Builds a listener that will track user-dragging on an event segment.
+ // Generic enough to work with any type of Grid.
+ // Has side effect of setting/unsetting `segDragListener`
+ buildSegDragListener: function(seg) {
+ var _this = this;
+ var view = this.view;
+ var calendar = view.calendar;
+ var el = seg.el;
+ var event = seg.event;
+ var isDragging;
+ var mouseFollower; // A clone of the original element that will move with the mouse
+ var dropLocation; // zoned event date properties
+
+ if (this.segDragListener) {
+ return this.segDragListener;
+ }
+
+ // Tracks mouse movement over the *view's* coordinate map. Allows dragging and dropping between subcomponents
+ // of the view.
+ var dragListener = this.segDragListener = new HitDragListener(view, {
+ scroll: view.opt('dragScroll'),
+ subjectEl: el,
+ subjectCenter: true,
+ interactionStart: function(ev) {
+ seg.component = _this; // for renderDrag
+ isDragging = false;
+ mouseFollower = new MouseFollower(seg.el, {
+ additionalClass: 'fc-dragging',
+ parentEl: view.el,
+ opacity: dragListener.isTouch ? null : view.opt('dragOpacity'),
+ revertDuration: view.opt('dragRevertDuration'),
+ zIndex: 2 // one above the .fc-view
+ });
+ mouseFollower.hide(); // don't show until we know this is a real drag
+ mouseFollower.start(ev);
+ },
+ dragStart: function(ev) {
+ if (dragListener.isTouch && !view.isEventSelected(event)) {
+ // if not previously selected, will fire after a delay. then, select the event
+ view.selectEvent(event);
+ }
+ isDragging = true;
+ _this.handleSegMouseout(seg, ev); // ensure a mouseout on the manipulated event has been reported
+ _this.segDragStart(seg, ev);
+ view.hideEvent(event); // hide all event segments. our mouseFollower will take over
+ },
+ hitOver: function(hit, isOrig, origHit) {
+ var dragHelperEls;
+
+ // starting hit could be forced (DayGrid.limit)
+ if (seg.hit) {
+ origHit = seg.hit;
+ }
+
+ // since we are querying the parent view, might not belong to this grid
+ dropLocation = _this.computeEventDrop(
+ origHit.component.getHitSpan(origHit),
+ hit.component.getHitSpan(hit),
+ event
+ );
+
+ if (dropLocation && !calendar.isEventSpanAllowed(_this.eventToSpan(dropLocation), event)) {
+ disableCursor();
+ dropLocation = null;
+ }
+
+ // if a valid drop location, have the subclass render a visual indication
+ if (dropLocation && (dragHelperEls = view.renderDrag(dropLocation, seg))) {
+
+ dragHelperEls.addClass('fc-dragging');
+ if (!dragListener.isTouch) {
+ _this.applyDragOpacity(dragHelperEls);
+ }
+
+ mouseFollower.hide(); // if the subclass is already using a mock event "helper", hide our own
+ }
+ else {
+ mouseFollower.show(); // otherwise, have the helper follow the mouse (no snapping)
+ }
+
+ if (isOrig) {
+ dropLocation = null; // needs to have moved hits to be a valid drop
+ }
+ },
+ hitOut: function() { // called before mouse moves to a different hit OR moved out of all hits
+ view.unrenderDrag(); // unrender whatever was done in renderDrag
+ mouseFollower.show(); // show in case we are moving out of all hits
+ dropLocation = null;
+ },
+ hitDone: function() { // Called after a hitOut OR before a dragEnd
+ enableCursor();
+ },
+ interactionEnd: function(ev) {
+ delete seg.component; // prevent side effects
+
+ // do revert animation if hasn't changed. calls a callback when finished (whether animation or not)
+ mouseFollower.stop(!dropLocation, function() {
+ if (isDragging) {
+ view.unrenderDrag();
+ view.showEvent(event);
+ _this.segDragStop(seg, ev);
+ }
+ if (dropLocation) {
+ view.reportEventDrop(event, dropLocation, this.largeUnit, el, ev);
+ }
+ });
+ _this.segDragListener = null;
+ }
+ });
+
+ return dragListener;
+ },
+
+
+ // seg isn't draggable, but let's use a generic DragListener
+ // simply for the delay, so it can be selected.
+ // Has side effect of setting/unsetting `segDragListener`
+ buildSegSelectListener: function(seg) {
+ var _this = this;
+ var view = this.view;
+ var event = seg.event;
+
+ if (this.segDragListener) {
+ return this.segDragListener;
+ }
+
+ var dragListener = this.segDragListener = new DragListener({
+ dragStart: function(ev) {
+ if (dragListener.isTouch && !view.isEventSelected(event)) {
+ // if not previously selected, will fire after a delay. then, select the event
+ view.selectEvent(event);
+ }
+ },
+ interactionEnd: function(ev) {
+ _this.segDragListener = null;
+ }
+ });
+
+ return dragListener;
+ },
+
+
+ // Called before event segment dragging starts
+ segDragStart: function(seg, ev) {
+ this.isDraggingSeg = true;
+ this.view.trigger('eventDragStart', seg.el[0], seg.event, ev, {}); // last argument is jqui dummy
+ },
+
+
+ // Called after event segment dragging stops
+ segDragStop: function(seg, ev) {
+ this.isDraggingSeg = false;
+ this.view.trigger('eventDragStop', seg.el[0], seg.event, ev, {}); // last argument is jqui dummy
+ },
+
+
+ // Given the spans an event drag began, and the span event was dropped, calculates the new zoned start/end/allDay
+ // values for the event. Subclasses may override and set additional properties to be used by renderDrag.
+ // A falsy returned value indicates an invalid drop.
+ // DOES NOT consider overlap/constraint.
+ computeEventDrop: function(startSpan, endSpan, event) {
+ var calendar = this.view.calendar;
+ var dragStart = startSpan.start;
+ var dragEnd = endSpan.start;
+ var delta;
+ var dropLocation; // zoned event date properties
+
+ if (dragStart.hasTime() === dragEnd.hasTime()) {
+ delta = this.diffDates(dragEnd, dragStart);
+
+ // if an all-day event was in a timed area and it was dragged to a different time,
+ // guarantee an end and adjust start/end to have times
+ if (event.allDay && durationHasTime(delta)) {
+ dropLocation = {
+ start: event.start.clone(),
+ end: calendar.getEventEnd(event), // will be an ambig day
+ allDay: false // for normalizeEventTimes
+ };
+ calendar.normalizeEventTimes(dropLocation);
+ }
+ // othewise, work off existing values
+ else {
+ dropLocation = pluckEventDateProps(event);
+ }
+
+ dropLocation.start.add(delta);
+ if (dropLocation.end) {
+ dropLocation.end.add(delta);
+ }
+ }
+ else {
+ // if switching from day <-> timed, start should be reset to the dropped date, and the end cleared
+ dropLocation = {
+ start: dragEnd.clone(),
+ end: null, // end should be cleared
+ allDay: !dragEnd.hasTime()
+ };
+ }
+
+ return dropLocation;
+ },
+
+
+ // Utility for apply dragOpacity to a jQuery set
+ applyDragOpacity: function(els) {
+ var opacity = this.view.opt('dragOpacity');
+
+ if (opacity != null) {
+ els.css('opacity', opacity);
+ }
+ },
+
+
+ /* External Element Dragging
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Called when a jQuery UI drag is initiated anywhere in the DOM
+ externalDragStart: function(ev, ui) {
+ var view = this.view;
+ var el;
+ var accept;
+
+ if (view.opt('droppable')) { // only listen if this setting is on
+ el = $((ui ? ui.item : null) || ev.target);
+
+ // Test that the dragged element passes the dropAccept selector or filter function.
+ // FYI, the default is "*" (matches all)
+ accept = view.opt('dropAccept');
+ if ($.isFunction(accept) ? accept.call(el[0], el) : el.is(accept)) {
+ if (!this.isDraggingExternal) { // prevent double-listening if fired twice
+ this.listenToExternalDrag(el, ev, ui);
+ }
+ }
+ }
+ },
+
+
+ // Called when a jQuery UI drag starts and it needs to be monitored for dropping
+ listenToExternalDrag: function(el, ev, ui) {
+ var _this = this;
+ var calendar = this.view.calendar;
+ var meta = getDraggedElMeta(el); // extra data about event drop, including possible event to create
+ var dropLocation; // a null value signals an unsuccessful drag
+
+ // listener that tracks mouse movement over date-associated pixel regions
+ var dragListener = _this.externalDragListener = new HitDragListener(this, {
+ interactionStart: function() {
+ _this.isDraggingExternal = true;
+ },
+ hitOver: function(hit) {
+ dropLocation = _this.computeExternalDrop(
+ hit.component.getHitSpan(hit), // since we are querying the parent view, might not belong to this grid
+ meta
+ );
+
+ if ( // invalid hit?
+ dropLocation &&
+ !calendar.isExternalSpanAllowed(_this.eventToSpan(dropLocation), dropLocation, meta.eventProps)
+ ) {
+ disableCursor();
+ dropLocation = null;
+ }
+
+ if (dropLocation) {
+ _this.renderDrag(dropLocation); // called without a seg parameter
+ }
+ },
+ hitOut: function() {
+ dropLocation = null; // signal unsuccessful
+ },
+ hitDone: function() { // Called after a hitOut OR before a dragEnd
+ enableCursor();
+ _this.unrenderDrag();
+ },
+ interactionEnd: function(ev) {
+ if (dropLocation) { // element was dropped on a valid hit
+ _this.view.reportExternalDrop(meta, dropLocation, el, ev, ui);
+ }
+ _this.isDraggingExternal = false;
+ _this.externalDragListener = null;
+ }
+ });
+
+ dragListener.startDrag(ev); // start listening immediately
+ },
+
+
+ // Given a hit to be dropped upon, and misc data associated with the jqui drag (guaranteed to be a plain object),
+ // returns the zoned start/end dates for the event that would result from the hypothetical drop. end might be null.
+ // Returning a null value signals an invalid drop hit.
+ // DOES NOT consider overlap/constraint.
+ computeExternalDrop: function(span, meta) {
+ var calendar = this.view.calendar;
+ var dropLocation = {
+ start: calendar.applyTimezone(span.start), // simulate a zoned event start date
+ end: null
+ };
+
+ // if dropped on an all-day span, and element's metadata specified a time, set it
+ if (meta.startTime && !dropLocation.start.hasTime()) {
+ dropLocation.start.time(meta.startTime);
+ }
+
+ if (meta.duration) {
+ dropLocation.end = dropLocation.start.clone().add(meta.duration);
+ }
+
+ return dropLocation;
+ },
+
+
+
+ /* Drag Rendering (for both events and an external elements)
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Renders a visual indication of an event or external element being dragged.
+ // `dropLocation` contains hypothetical start/end/allDay values the event would have if dropped. end can be null.
+ // `seg` is the internal segment object that is being dragged. If dragging an external element, `seg` is null.
+ // A truthy returned value indicates this method has rendered a helper element.
+ // Must return elements used for any mock events.
+ renderDrag: function(dropLocation, seg) {
+ // subclasses must implement
+ },
+
+
+ // Unrenders a visual indication of an event or external element being dragged
+ unrenderDrag: function() {
+ // subclasses must implement
+ },
+
+
+ /* Resizing
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Creates a listener that tracks the user as they resize an event segment.
+ // Generic enough to work with any type of Grid.
+ buildSegResizeListener: function(seg, isStart) {
+ var _this = this;
+ var view = this.view;
+ var calendar = view.calendar;
+ var el = seg.el;
+ var event = seg.event;
+ var eventEnd = calendar.getEventEnd(event);
+ var isDragging;
+ var resizeLocation; // zoned event date properties. falsy if invalid resize
+
+ // Tracks mouse movement over the *grid's* coordinate map
+ var dragListener = this.segResizeListener = new HitDragListener(this, {
+ scroll: view.opt('dragScroll'),
+ subjectEl: el,
+ interactionStart: function() {
+ isDragging = false;
+ },
+ dragStart: function(ev) {
+ isDragging = true;
+ _this.handleSegMouseout(seg, ev); // ensure a mouseout on the manipulated event has been reported
+ _this.segResizeStart(seg, ev);
+ },
+ hitOver: function(hit, isOrig, origHit) {
+ var origHitSpan = _this.getHitSpan(origHit);
+ var hitSpan = _this.getHitSpan(hit);
+
+ resizeLocation = isStart ?
+ _this.computeEventStartResize(origHitSpan, hitSpan, event) :
+ _this.computeEventEndResize(origHitSpan, hitSpan, event);
+
+ if (resizeLocation) {
+ if (!calendar.isEventSpanAllowed(_this.eventToSpan(resizeLocation), event)) {
+ disableCursor();
+ resizeLocation = null;
+ }
+ // no change? (FYI, event dates might have zones)
+ else if (
+ resizeLocation.start.isSame(event.start.clone().stripZone()) &&
+ resizeLocation.end.isSame(eventEnd.clone().stripZone())
+ ) {
+ resizeLocation = null;
+ }
+ }
+
+ if (resizeLocation) {
+ view.hideEvent(event);
+ _this.renderEventResize(resizeLocation, seg);
+ }
+ },
+ hitOut: function() { // called before mouse moves to a different hit OR moved out of all hits
+ resizeLocation = null;
+ },
+ hitDone: function() { // resets the rendering to show the original event
+ _this.unrenderEventResize();
+ view.showEvent(event);
+ enableCursor();
+ },
+ interactionEnd: function(ev) {
+ if (isDragging) {
+ _this.segResizeStop(seg, ev);
+ }
+ if (resizeLocation) { // valid date to resize to?
+ view.reportEventResize(event, resizeLocation, this.largeUnit, el, ev);
+ }
+ _this.segResizeListener = null;
+ }
+ });
+
+ return dragListener;
+ },
+
+
+ // Called before event segment resizing starts
+ segResizeStart: function(seg, ev) {
+ this.isResizingSeg = true;
+ this.view.trigger('eventResizeStart', seg.el[0], seg.event, ev, {}); // last argument is jqui dummy
+ },
+
+
+ // Called after event segment resizing stops
+ segResizeStop: function(seg, ev) {
+ this.isResizingSeg = false;
+ this.view.trigger('eventResizeStop', seg.el[0], seg.event, ev, {}); // last argument is jqui dummy
+ },
+
+
+ // Returns new date-information for an event segment being resized from its start
+ computeEventStartResize: function(startSpan, endSpan, event) {
+ return this.computeEventResize('start', startSpan, endSpan, event);
+ },
+
+
+ // Returns new date-information for an event segment being resized from its end
+ computeEventEndResize: function(startSpan, endSpan, event) {
+ return this.computeEventResize('end', startSpan, endSpan, event);
+ },
+
+
+ // Returns new zoned date information for an event segment being resized from its start OR end
+ // `type` is either 'start' or 'end'.
+ // DOES NOT consider overlap/constraint.
+ computeEventResize: function(type, startSpan, endSpan, event) {
+ var calendar = this.view.calendar;
+ var delta = this.diffDates(endSpan[type], startSpan[type]);
+ var resizeLocation; // zoned event date properties
+ var defaultDuration;
+
+ // build original values to work from, guaranteeing a start and end
+ resizeLocation = {
+ start: event.start.clone(),
+ end: calendar.getEventEnd(event),
+ allDay: event.allDay
+ };
+
+ // if an all-day event was in a timed area and was resized to a time, adjust start/end to have times
+ if (resizeLocation.allDay && durationHasTime(delta)) {
+ resizeLocation.allDay = false;
+ calendar.normalizeEventTimes(resizeLocation);
+ }
+
+ resizeLocation[type].add(delta); // apply delta to start or end
+
+ // if the event was compressed too small, find a new reasonable duration for it
+ if (!resizeLocation.start.isBefore(resizeLocation.end)) {
+
+ defaultDuration =
+ this.minResizeDuration || // TODO: hack
+ (event.allDay ?
+ calendar.defaultAllDayEventDuration :
+ calendar.defaultTimedEventDuration);
+
+ if (type == 'start') { // resizing the start?
+ resizeLocation.start = resizeLocation.end.clone().subtract(defaultDuration);
+ }
+ else { // resizing the end?
+ resizeLocation.end = resizeLocation.start.clone().add(defaultDuration);
+ }
+ }
+
+ return resizeLocation;
+ },
+
+
+ // Renders a visual indication of an event being resized.
+ // `range` has the updated dates of the event. `seg` is the original segment object involved in the drag.
+ // Must return elements used for any mock events.
+ renderEventResize: function(range, seg) {
+ // subclasses must implement
+ },
+
+
+ // Unrenders a visual indication of an event being resized.
+ unrenderEventResize: function() {
+ // subclasses must implement
+ },
+
+
+ /* Rendering Utils
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Compute the text that should be displayed on an event's element.
+ // `range` can be the Event object itself, or something range-like, with at least a `start`.
+ // If event times are disabled, or the event has no time, will return a blank string.
+ // If not specified, formatStr will default to the eventTimeFormat setting,
+ // and displayEnd will default to the displayEventEnd setting.
+ getEventTimeText: function(range, formatStr, displayEnd) {
+
+ if (formatStr == null) {
+ formatStr = this.eventTimeFormat;
+ }
+
+ if (displayEnd == null) {
+ displayEnd = this.displayEventEnd;
+ }
+
+ if (this.displayEventTime && range.start.hasTime()) {
+ if (displayEnd && range.end) {
+ return this.view.formatRange(range, formatStr);
+ }
+ else {
+ return range.start.format(formatStr);
+ }
+ }
+
+ return '';
+ },
+
+
+ // Generic utility for generating the HTML classNames for an event segment's element
+ getSegClasses: function(seg, isDraggable, isResizable) {
+ var view = this.view;
+ var classes = [
+ 'fc-event',
+ seg.isStart ? 'fc-start' : 'fc-not-start',
+ seg.isEnd ? 'fc-end' : 'fc-not-end'
+ ].concat(this.getSegCustomClasses(seg));
+
+ if (isDraggable) {
+ classes.push('fc-draggable');
+ }
+ if (isResizable) {
+ classes.push('fc-resizable');
+ }
+
+ // event is currently selected? attach a className.
+ if (view.isEventSelected(seg.event)) {
+ classes.push('fc-selected');
+ }
+
+ return classes;
+ },
+
+
+ // List of classes that were defined by the caller of the API in some way
+ getSegCustomClasses: function(seg) {
+ var event = seg.event;
+
+ return [].concat(
+ event.className, // guaranteed to be an array
+ event.source ? event.source.className : []
+ );
+ },
+
+
+ // Utility for generating event skin-related CSS properties
+ getSegSkinCss: function(seg) {
+ return {
+ 'background-color': this.getSegBackgroundColor(seg),
+ 'border-color': this.getSegBorderColor(seg),
+ color: this.getSegTextColor(seg)
+ };
+ },
+
+
+ // Queries for caller-specified color, then falls back to default
+ getSegBackgroundColor: function(seg) {
+ return seg.event.backgroundColor ||
+ seg.event.color ||
+ this.getSegDefaultBackgroundColor(seg);
+ },
+
+
+ getSegDefaultBackgroundColor: function(seg) {
+ var source = seg.event.source || {};
+
+ return source.backgroundColor ||
+ source.color ||
+ this.view.opt('eventBackgroundColor') ||
+ this.view.opt('eventColor');
+ },
+
+
+ // Queries for caller-specified color, then falls back to default
+ getSegBorderColor: function(seg) {
+ return seg.event.borderColor ||
+ seg.event.color ||
+ this.getSegDefaultBorderColor(seg);
+ },
+
+
+ getSegDefaultBorderColor: function(seg) {
+ var source = seg.event.source || {};
+
+ return source.borderColor ||
+ source.color ||
+ this.view.opt('eventBorderColor') ||
+ this.view.opt('eventColor');
+ },
+
+
+ // Queries for caller-specified color, then falls back to default
+ getSegTextColor: function(seg) {
+ return seg.event.textColor ||
+ this.getSegDefaultTextColor(seg);
+ },
+
+
+ getSegDefaultTextColor: function(seg) {
+ var source = seg.event.source || {};
+
+ return source.textColor ||
+ this.view.opt('eventTextColor');
+ },
+
+
+ /* Converting events -> eventRange -> eventSpan -> eventSegs
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Generates an array of segments for the given single event
+ // Can accept an event "location" as well (which only has start/end and no allDay)
+ eventToSegs: function(event) {
+ return this.eventsToSegs([ event ]);
+ },
+
+
+ eventToSpan: function(event) {
+ return this.eventToSpans(event)[0];
+ },
+
+
+ // Generates spans (always unzoned) for the given event.
+ // Does not do any inverting for inverse-background events.
+ // Can accept an event "location" as well (which only has start/end and no allDay)
+ eventToSpans: function(event) {
+ var range = this.eventToRange(event);
+ return this.eventRangeToSpans(range, event);
+ },
+
+
+
+ // Converts an array of event objects into an array of event segment objects.
+ // A custom `segSliceFunc` may be given for arbitrarily slicing up events.
+ // Doesn't guarantee an order for the resulting array.
+ eventsToSegs: function(allEvents, segSliceFunc) {
+ var _this = this;
+ var eventsById = groupEventsById(allEvents);
+ var segs = [];
+
+ $.each(eventsById, function(id, events) {
+ var ranges = [];
+ var i;
+
+ for (i = 0; i < events.length; i++) {
+ ranges.push(_this.eventToRange(events[i]));
+ }
+
+ // inverse-background events (utilize only the first event in calculations)
+ if (isInverseBgEvent(events[0])) {
+ ranges = _this.invertRanges(ranges);
+
+ for (i = 0; i < ranges.length; i++) {
+ segs.push.apply(segs, // append to
+ _this.eventRangeToSegs(ranges[i], events[0], segSliceFunc));
+ }
+ }
+ // normal event ranges
+ else {
+ for (i = 0; i < ranges.length; i++) {
+ segs.push.apply(segs, // append to
+ _this.eventRangeToSegs(ranges[i], events[i], segSliceFunc));
+ }
+ }
+ });
+
+ return segs;
+ },
+
+
+ // Generates the unzoned start/end dates an event appears to occupy
+ // Can accept an event "location" as well (which only has start/end and no allDay)
+ eventToRange: function(event) {
+ var calendar = this.view.calendar;
+ var start = event.start.clone().stripZone();
+ var end = (
+ event.end ?
+ event.end.clone() :
+ // derive the end from the start and allDay. compute allDay if necessary
+ calendar.getDefaultEventEnd(
+ event.allDay != null ?
+ event.allDay :
+ !event.start.hasTime(),
+ event.start
+ )
+ ).stripZone();
+
+ // hack: dynamic locale change forgets to upate stored event localed
+ calendar.localizeMoment(start);
+ calendar.localizeMoment(end);
+
+ return { start: start, end: end };
+ },
+
+
+ // Given an event's range (unzoned start/end), and the event itself,
+ // slice into segments (using the segSliceFunc function if specified)
+ eventRangeToSegs: function(range, event, segSliceFunc) {
+ var spans = this.eventRangeToSpans(range, event);
+ var segs = [];
+ var i;
+
+ for (i = 0; i < spans.length; i++) {
+ segs.push.apply(segs, // append to
+ this.eventSpanToSegs(spans[i], event, segSliceFunc));
+ }
+
+ return segs;
+ },
+
+
+ // Given an event's unzoned date range, return an array of "span" objects.
+ // Subclasses can override.
+ eventRangeToSpans: function(range, event) {
+ return [ $.extend({}, range) ]; // copy into a single-item array
+ },
+
+
+ // Given an event's span (unzoned start/end and other misc data), and the event itself,
+ // slices into segments and attaches event-derived properties to them.
+ eventSpanToSegs: function(span, event, segSliceFunc) {
+ var segs = segSliceFunc ? segSliceFunc(span) : this.spanToSegs(span);
+ var i, seg;
+
+ for (i = 0; i < segs.length; i++) {
+ seg = segs[i];
+ seg.event = event;
+ seg.eventStartMS = +span.start; // TODO: not the best name after making spans unzoned
+ seg.eventDurationMS = span.end - span.start;
+ }
+
+ return segs;
+ },
+
+
+ // Produces a new array of range objects that will cover all the time NOT covered by the given ranges.
+ // SIDE EFFECT: will mutate the given array and will use its date references.
+ invertRanges: function(ranges) {
+ var view = this.view;
+ var viewStart = view.start.clone(); // need a copy
+ var viewEnd = view.end.clone(); // need a copy
+ var inverseRanges = [];
+ var start = viewStart; // the end of the previous range. the start of the new range
+ var i, range;
+
+ // ranges need to be in order. required for our date-walking algorithm
+ ranges.sort(compareRanges);
+
+ for (i = 0; i < ranges.length; i++) {
+ range = ranges[i];
+
+ // add the span of time before the event (if there is any)
+ if (range.start > start) { // compare millisecond time (skip any ambig logic)
+ inverseRanges.push({
+ start: start,
+ end: range.start
+ });
+ }
+
+ start = range.end;
+ }
+
+ // add the span of time after the last event (if there is any)
+ if (start < viewEnd) { // compare millisecond time (skip any ambig logic)
+ inverseRanges.push({
+ start: start,
+ end: viewEnd
+ });
+ }
+
+ return inverseRanges;
+ },
+
+
+ sortEventSegs: function(segs) {
+ segs.sort(proxy(this, 'compareEventSegs'));
+ },
+
+
+ // A cmp function for determining which segments should take visual priority
+ compareEventSegs: function(seg1, seg2) {
+ return seg1.eventStartMS - seg2.eventStartMS || // earlier events go first
+ seg2.eventDurationMS - seg1.eventDurationMS || // tie? longer events go first
+ seg2.event.allDay - seg1.event.allDay || // tie? put all-day events first (booleans cast to 0/1)
+ compareByFieldSpecs(seg1.event, seg2.event, this.view.eventOrderSpecs);
+ }
+
+});
+
+
+/* Utilities
+----------------------------------------------------------------------------------------------------------------------*/
+
+
+function pluckEventDateProps(event) {
+ return {
+ start: event.start.clone(),
+ end: event.end ? event.end.clone() : null,
+ allDay: event.allDay // keep it the same
+ };
+}
+FC.pluckEventDateProps = pluckEventDateProps;
+
+
+function isBgEvent(event) { // returns true if background OR inverse-background
+ var rendering = getEventRendering(event);
+ return rendering === 'background' || rendering === 'inverse-background';
+}
+FC.isBgEvent = isBgEvent; // export
+
+
+function isInverseBgEvent(event) {
+ return getEventRendering(event) === 'inverse-background';
+}
+
+
+function getEventRendering(event) {
+ return firstDefined((event.source || {}).rendering, event.rendering);
+}
+
+
+function groupEventsById(events) {
+ var eventsById = {};
+ var i, event;
+
+ for (i = 0; i < events.length; i++) {
+ event = events[i];
+ (eventsById[event._id] || (eventsById[event._id] = [])).push(event);
+ }
+
+ return eventsById;
+}
+
+
+// A cmp function for determining which non-inverted "ranges" (see above) happen earlier
+function compareRanges(range1, range2) {
+ return range1.start - range2.start; // earlier ranges go first
+}
+
+
+/* External-Dragging-Element Data
+----------------------------------------------------------------------------------------------------------------------*/
+
+// Require all HTML5 data-* attributes used by FullCalendar to have this prefix.
+// A value of '' will query attributes like data-event. A value of 'fc' will query attributes like data-fc-event.
+FC.dataAttrPrefix = '';
+
+// Given a jQuery element that might represent a dragged FullCalendar event, returns an intermediate data structure
+// to be used for Event Object creation.
+// A defined `.eventProps`, even when empty, indicates that an event should be created.
+function getDraggedElMeta(el) {
+ var prefix = FC.dataAttrPrefix;
+ var eventProps; // properties for creating the event, not related to date/time
+ var startTime; // a Duration
+ var duration;
+ var stick;
+
+ if (prefix) { prefix += '-'; }
+ eventProps = el.data(prefix + 'event') || null;
+
+ if (eventProps) {
+ if (typeof eventProps === 'object') {
+ eventProps = $.extend({}, eventProps); // make a copy
+ }
+ else { // something like 1 or true. still signal event creation
+ eventProps = {};
+ }
+
+ // pluck special-cased date/time properties
+ startTime = eventProps.start;
+ if (startTime == null) { startTime = eventProps.time; } // accept 'time' as well
+ duration = eventProps.duration;
+ stick = eventProps.stick;
+ delete eventProps.start;
+ delete eventProps.time;
+ delete eventProps.duration;
+ delete eventProps.stick;
+ }
+
+ // fallback to standalone attribute values for each of the date/time properties
+ if (startTime == null) { startTime = el.data(prefix + 'start'); }
+ if (startTime == null) { startTime = el.data(prefix + 'time'); } // accept 'time' as well
+ if (duration == null) { duration = el.data(prefix + 'duration'); }
+ if (stick == null) { stick = el.data(prefix + 'stick'); }
+
+ // massage into correct data types
+ startTime = startTime != null ? moment.duration(startTime) : null;
+ duration = duration != null ? moment.duration(duration) : null;
+ stick = Boolean(stick);
+
+ return { eventProps: eventProps, startTime: startTime, duration: duration, stick: stick };
+}
+
+
+;;
+
+/*
+A set of rendering and date-related methods for a visual component comprised of one or more rows of day columns.
+Prerequisite: the object being mixed into needs to be a *Grid*
+*/
+var DayTableMixin = FC.DayTableMixin = {
+
+ breakOnWeeks: false, // should create a new row for each week?
+ dayDates: null, // whole-day dates for each column. left to right
+ dayIndices: null, // for each day from start, the offset
+ daysPerRow: null,
+ rowCnt: null,
+ colCnt: null,
+ colHeadFormat: null,
+
+
+ // Populates internal variables used for date calculation and rendering
+ updateDayTable: function() {
+ var view = this.view;
+ var date = this.start.clone();
+ var dayIndex = -1;
+ var dayIndices = [];
+ var dayDates = [];
+ var daysPerRow;
+ var firstDay;
+ var rowCnt;
+
+ while (date.isBefore(this.end)) { // loop each day from start to end
+ if (view.isHiddenDay(date)) {
+ dayIndices.push(dayIndex + 0.5); // mark that it's between indices
+ }
+ else {
+ dayIndex++;
+ dayIndices.push(dayIndex);
+ dayDates.push(date.clone());
+ }
+ date.add(1, 'days');
+ }
+
+ if (this.breakOnWeeks) {
+ // count columns until the day-of-week repeats
+ firstDay = dayDates[0].day();
+ for (daysPerRow = 1; daysPerRow < dayDates.length; daysPerRow++) {
+ if (dayDates[daysPerRow].day() == firstDay) {
+ break;
+ }
+ }
+ rowCnt = Math.ceil(dayDates.length / daysPerRow);
+ }
+ else {
+ rowCnt = 1;
+ daysPerRow = dayDates.length;
+ }
+
+ this.dayDates = dayDates;
+ this.dayIndices = dayIndices;
+ this.daysPerRow = daysPerRow;
+ this.rowCnt = rowCnt;
+
+ this.updateDayTableCols();
+ },
+
+
+ // Computes and assigned the colCnt property and updates any options that may be computed from it
+ updateDayTableCols: function() {
+ this.colCnt = this.computeColCnt();
+ this.colHeadFormat = this.view.opt('columnFormat') || this.computeColHeadFormat();
+ },
+
+
+ // Determines how many columns there should be in the table
+ computeColCnt: function() {
+ return this.daysPerRow;
+ },
+
+
+ // Computes the ambiguously-timed moment for the given cell
+ getCellDate: function(row, col) {
+ return this.dayDates[
+ this.getCellDayIndex(row, col)
+ ].clone();
+ },
+
+
+ // Computes the ambiguously-timed date range for the given cell
+ getCellRange: function(row, col) {
+ var start = this.getCellDate(row, col);
+ var end = start.clone().add(1, 'days');
+
+ return { start: start, end: end };
+ },
+
+
+ // Returns the number of day cells, chronologically, from the first of the grid (0-based)
+ getCellDayIndex: function(row, col) {
+ return row * this.daysPerRow + this.getColDayIndex(col);
+ },
+
+
+ // Returns the numner of day cells, chronologically, from the first cell in *any given row*
+ getColDayIndex: function(col) {
+ if (this.isRTL) {
+ return this.colCnt - 1 - col;
+ }
+ else {
+ return col;
+ }
+ },
+
+
+ // Given a date, returns its chronolocial cell-index from the first cell of the grid.
+ // If the date lies between cells (because of hiddenDays), returns a floating-point value between offsets.
+ // If before the first offset, returns a negative number.
+ // If after the last offset, returns an offset past the last cell offset.
+ // Only works for *start* dates of cells. Will not work for exclusive end dates for cells.
+ getDateDayIndex: function(date) {
+ var dayIndices = this.dayIndices;
+ var dayOffset = date.diff(this.start, 'days');
+
+ if (dayOffset < 0) {
+ return dayIndices[0] - 1;
+ }
+ else if (dayOffset >= dayIndices.length) {
+ return dayIndices[dayIndices.length - 1] + 1;
+ }
+ else {
+ return dayIndices[dayOffset];
+ }
+ },
+
+
+ /* Options
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Computes a default column header formatting string if `colFormat` is not explicitly defined
+ computeColHeadFormat: function() {
+ // if more than one week row, or if there are a lot of columns with not much space,
+ // put just the day numbers will be in each cell
+ if (this.rowCnt > 1 || this.colCnt > 10) {
+ return 'ddd'; // "Sat"
+ }
+ // multiple days, so full single date string WON'T be in title text
+ else if (this.colCnt > 1) {
+ return this.view.opt('dayOfMonthFormat'); // "Sat 12/10"
+ }
+ // single day, so full single date string will probably be in title text
+ else {
+ return 'dddd'; // "Saturday"
+ }
+ },
+
+
+ /* Slicing
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Slices up a date range into a segment for every week-row it intersects with
+ sliceRangeByRow: function(range) {
+ var daysPerRow = this.daysPerRow;
+ var normalRange = this.view.computeDayRange(range); // make whole-day range, considering nextDayThreshold
+ var rangeFirst = this.getDateDayIndex(normalRange.start); // inclusive first index
+ var rangeLast = this.getDateDayIndex(normalRange.end.clone().subtract(1, 'days')); // inclusive last index
+ var segs = [];
+ var row;
+ var rowFirst, rowLast; // inclusive day-index range for current row
+ var segFirst, segLast; // inclusive day-index range for segment
+
+ for (row = 0; row < this.rowCnt; row++) {
+ rowFirst = row * daysPerRow;
+ rowLast = rowFirst + daysPerRow - 1;
+
+ // intersect segment's offset range with the row's
+ segFirst = Math.max(rangeFirst, rowFirst);
+ segLast = Math.min(rangeLast, rowLast);
+
+ // deal with in-between indices
+ segFirst = Math.ceil(segFirst); // in-between starts round to next cell
+ segLast = Math.floor(segLast); // in-between ends round to prev cell
+
+ if (segFirst <= segLast) { // was there any intersection with the current row?
+ segs.push({
+ row: row,
+
+ // normalize to start of row
+ firstRowDayIndex: segFirst - rowFirst,
+ lastRowDayIndex: segLast - rowFirst,
+
+ // must be matching integers to be the segment's start/end
+ isStart: segFirst === rangeFirst,
+ isEnd: segLast === rangeLast
+ });
+ }
+ }
+
+ return segs;
+ },
+
+
+ // Slices up a date range into a segment for every day-cell it intersects with.
+ // TODO: make more DRY with sliceRangeByRow somehow.
+ sliceRangeByDay: function(range) {
+ var daysPerRow = this.daysPerRow;
+ var normalRange = this.view.computeDayRange(range); // make whole-day range, considering nextDayThreshold
+ var rangeFirst = this.getDateDayIndex(normalRange.start); // inclusive first index
+ var rangeLast = this.getDateDayIndex(normalRange.end.clone().subtract(1, 'days')); // inclusive last index
+ var segs = [];
+ var row;
+ var rowFirst, rowLast; // inclusive day-index range for current row
+ var i;
+ var segFirst, segLast; // inclusive day-index range for segment
+
+ for (row = 0; row < this.rowCnt; row++) {
+ rowFirst = row * daysPerRow;
+ rowLast = rowFirst + daysPerRow - 1;
+
+ for (i = rowFirst; i <= rowLast; i++) {
+
+ // intersect segment's offset range with the row's
+ segFirst = Math.max(rangeFirst, i);
+ segLast = Math.min(rangeLast, i);
+
+ // deal with in-between indices
+ segFirst = Math.ceil(segFirst); // in-between starts round to next cell
+ segLast = Math.floor(segLast); // in-between ends round to prev cell
+
+ if (segFirst <= segLast) { // was there any intersection with the current row?
+ segs.push({
+ row: row,
+
+ // normalize to start of row
+ firstRowDayIndex: segFirst - rowFirst,
+ lastRowDayIndex: segLast - rowFirst,
+
+ // must be matching integers to be the segment's start/end
+ isStart: segFirst === rangeFirst,
+ isEnd: segLast === rangeLast
+ });
+ }
+ }
+ }
+
+ return segs;
+ },
+
+
+ /* Header Rendering
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ renderHeadHtml: function() {
+ var view = this.view;
+
+ return '' +
+ '<div class="fc-row ' + view.widgetHeaderClass + '">' +
+ '<table>' +
+ '<thead>' +
+ this.renderHeadTrHtml() +
+ '</thead>' +
+ '</table>' +
+ '</div>';
+ },
+
+
+ renderHeadIntroHtml: function() {
+ return this.renderIntroHtml(); // fall back to generic
+ },
+
+
+ renderHeadTrHtml: function() {
+ return '' +
+ '<tr>' +
+ (this.isRTL ? '' : this.renderHeadIntroHtml()) +
+ this.renderHeadDateCellsHtml() +
+ (this.isRTL ? this.renderHeadIntroHtml() : '') +
+ '</tr>';
+ },
+
+
+ renderHeadDateCellsHtml: function() {
+ var htmls = [];
+ var col, date;
+
+ for (col = 0; col < this.colCnt; col++) {
+ date = this.getCellDate(0, col);
+ htmls.push(this.renderHeadDateCellHtml(date));
+ }
+
+ return htmls.join('');
+ },
+
+
+ // TODO: when internalApiVersion, accept an object for HTML attributes
+ // (colspan should be no different)
+ renderHeadDateCellHtml: function(date, colspan, otherAttrs) {
+ var view = this.view;
+
+ return '' +
+ '<th class="fc-day-header ' + view.widgetHeaderClass + ' fc-' + dayIDs[date.day()] + '"' +
+ (this.rowCnt === 1 ?
+ ' data-date="' + date.format('YYYY-MM-DD') + '"' :
+ '') +
+ (colspan > 1 ?
+ ' colspan="' + colspan + '"' :
+ '') +
+ (otherAttrs ?
+ ' ' + otherAttrs :
+ '') +
+ '>' +
+ // don't make a link if the heading could represent multiple days, or if there's only one day (forceOff)
+ view.buildGotoAnchorHtml(
+ { date: date, forceOff: this.rowCnt > 1 || this.colCnt === 1 },
+ htmlEscape(date.format(this.colHeadFormat)) // inner HTML
+ ) +
+ '</th>';
+ },
+
+
+ /* Background Rendering
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ renderBgTrHtml: function(row) {
+ return '' +
+ '<tr>' +
+ (this.isRTL ? '' : this.renderBgIntroHtml(row)) +
+ this.renderBgCellsHtml(row) +
+ (this.isRTL ? this.renderBgIntroHtml(row) : '') +
+ '</tr>';
+ },
+
+
+ renderBgIntroHtml: function(row) {
+ return this.renderIntroHtml(); // fall back to generic
+ },
+
+
+ renderBgCellsHtml: function(row) {
+ var htmls = [];
+ var col, date;
+
+ for (col = 0; col < this.colCnt; col++) {
+ date = this.getCellDate(row, col);
+ htmls.push(this.renderBgCellHtml(date));
+ }
+
+ return htmls.join('');
+ },
+
+
+ renderBgCellHtml: function(date, otherAttrs) {
+ var view = this.view;
+ var classes = this.getDayClasses(date);
+
+ classes.unshift('fc-day', view.widgetContentClass);
+
+ return '<td class="' + classes.join(' ') + '"' +
+ ' data-date="' + date.format('YYYY-MM-DD') + '"' + // if date has a time, won't format it
+ (otherAttrs ?
+ ' ' + otherAttrs :
+ '') +
+ '></td>';
+ },
+
+
+ /* Generic
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Generates the default HTML intro for any row. User classes should override
+ renderIntroHtml: function() {
+ },
+
+
+ // TODO: a generic method for dealing with <tr>, RTL, intro
+ // when increment internalApiVersion
+ // wrapTr (scheduler)
+
+
+ /* Utils
+ ------------------------------------------------------------------------------------------------------------------*/
+
+
+ // Applies the generic "intro" and "outro" HTML to the given cells.
+ // Intro means the leftmost cell when the calendar is LTR and the rightmost cell when RTL. Vice-versa for outro.
+ bookendCells: function(trEl) {
+ var introHtml = this.renderIntroHtml();
+
+ if (introHtml) {
+ if (this.isRTL) {
+ trEl.append(introHtml);
+ }
+ else {
+ trEl.prepend(introHtml);
+ }
+ }
+ }
+
+};
+
+;;
+
+/* A component that renders a grid of whole-days that runs horizontally. There can be multiple rows, one per week.
+----------------------------------------------------------------------------------------------------------------------*/
+
+var DayGrid = FC.DayGrid = Grid.extend(DayTableMixin, {
+
+ numbersVisible: false, // should render a row for day/week numbers? set by outside view. TODO: make internal
+ bottomCoordPadding: 0, // hack for extending the hit area for the last row of the coordinate grid
+
+ rowEls: null, // set of fake row elements
+ cellEls: null, // set of whole-day elements comprising the row's background
+ helperEls: null, // set of cell skeleton elements for rendering the mock event "helper"
+
+ rowCoordCache: null,
+ colCoordCache: null,
+
+
+ // Renders the rows and columns into the component's `this.el`, which should already be assigned.
+ // isRigid determins whether the individual rows should ignore the contents and be a constant height.
+ // Relies on the view's colCnt and rowCnt. In the future, this component should probably be self-sufficient.
+ renderDates: function(isRigid) {
+ var view = this.view;
+ var rowCnt = this.rowCnt;
+ var colCnt = this.colCnt;
+ var html = '';
+ var row;
+ var col;
+
+ for (row = 0; row < rowCnt; row++) {
+ html += this.renderDayRowHtml(row, isRigid);
+ }
+ this.el.html(html);
+
+ this.rowEls = this.el.find('.fc-row');
+ this.cellEls = this.el.find('.fc-day');
+
+ this.rowCoordCache = new CoordCache({
+ els: this.rowEls,
+ isVertical: true
+ });
+ this.colCoordCache = new CoordCache({
+ els: this.cellEls.slice(0, this.colCnt), // only the first row
+ isHorizontal: true
+ });
+
+ // trigger dayRender with each cell's element
+ for (row = 0; row < rowCnt; row++) {
+ for (col = 0; col < colCnt; col++) {
+ view.trigger(
+ 'dayRender',
+ null,
+ this.getCellDate(row, col),
+ this.getCellEl(row, col)