Created
August 11, 2017 21:26
-
-
Save Stafie/57a127b40d3f84a78c4531d5567f9c10 to your computer and use it in GitHub Desktop.
fullcalendar minSegmentHeight option
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
/*! | |
* FullCalendar v0.0.0 Stylesheet | |
* Docs & License: https://fullcalendar.io/ | |
* (c) 2017 Adam Shaw | |
*/ | |
.fc { | |
direction: ltr; | |
text-align: left; | |
} | |
.fc-rtl { | |
text-align: right; | |
} | |
body .fc { /* extra precedence to overcome jqui */ | |
font-size: 1em; | |
} | |
/* Colors | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-highlight { /* when user is selecting cells */ | |
background: #bce8f1; | |
opacity: .3; | |
} | |
.fc-bgevent { /* default look for background events */ | |
background: rgb(143, 223, 130); | |
opacity: .3; | |
} | |
.fc-nonbusiness { /* default look for non-business-hours areas */ | |
/* will inherit .fc-bgevent's styles */ | |
background: #d7d7d7; | |
} | |
/* Buttons (styled <button> tags, normalized to work cross-browser) | |
--------------------------------------------------------------------------------------------------*/ | |
.fc button { | |
/* force height to include the border and padding */ | |
-moz-box-sizing: border-box; | |
-webkit-box-sizing: border-box; | |
box-sizing: border-box; | |
/* dimensions */ | |
margin: 0; | |
height: 2.1em; | |
padding: 0 .6em; | |
/* text & cursor */ | |
font-size: 1em; /* normalize */ | |
white-space: nowrap; | |
cursor: pointer; | |
} | |
/* Firefox has an annoying inner border */ | |
.fc button::-moz-focus-inner { margin: 0; padding: 0; } | |
.fc-state-default { /* non-theme */ | |
border: 1px solid; | |
} | |
.fc-state-default.fc-corner-left { /* non-theme */ | |
border-top-left-radius: 4px; | |
border-bottom-left-radius: 4px; | |
} | |
.fc-state-default.fc-corner-right { /* non-theme */ | |
border-top-right-radius: 4px; | |
border-bottom-right-radius: 4px; | |
} | |
/* icons in buttons */ | |
.fc button .fc-icon { /* non-theme */ | |
position: relative; | |
top: -0.05em; /* seems to be a good adjustment across browsers */ | |
margin: 0 .2em; | |
vertical-align: middle; | |
} | |
/* | |
button states | |
borrowed from twitter bootstrap (http://twitter.github.com/bootstrap/) | |
*/ | |
.fc-state-default { | |
background-color: #f5f5f5; | |
background-image: -moz-linear-gradient(top, #ffffff, #e6e6e6); | |
background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#ffffff), to(#e6e6e6)); | |
background-image: -webkit-linear-gradient(top, #ffffff, #e6e6e6); | |
background-image: -o-linear-gradient(top, #ffffff, #e6e6e6); | |
background-image: linear-gradient(to bottom, #ffffff, #e6e6e6); | |
background-repeat: repeat-x; | |
border-color: #e6e6e6 #e6e6e6 #bfbfbf; | |
border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25); | |
color: #333; | |
text-shadow: 0 1px 1px rgba(255, 255, 255, 0.75); | |
box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05); | |
} | |
.fc-state-hover, | |
.fc-state-down, | |
.fc-state-active, | |
.fc-state-disabled { | |
color: #333333; | |
background-color: #e6e6e6; | |
} | |
.fc-state-hover { | |
color: #333333; | |
text-decoration: none; | |
background-position: 0 -15px; | |
-webkit-transition: background-position 0.1s linear; | |
-moz-transition: background-position 0.1s linear; | |
-o-transition: background-position 0.1s linear; | |
transition: background-position 0.1s linear; | |
} | |
.fc-state-down, | |
.fc-state-active { | |
background-color: #cccccc; | |
background-image: none; | |
box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05); | |
} | |
.fc-state-disabled { | |
cursor: default; | |
background-image: none; | |
opacity: 0.65; | |
box-shadow: none; | |
} | |
/* Buttons Groups | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-button-group { | |
display: inline-block; | |
} | |
/* | |
every button that is not first in a button group should scootch over one pixel and cover the | |
previous button's border... | |
*/ | |
.fc .fc-button-group > * { /* extra precedence b/c buttons have margin set to zero */ | |
float: left; | |
margin: 0 0 0 -1px; | |
} | |
.fc .fc-button-group > :first-child { /* same */ | |
margin-left: 0; | |
} | |
/* Popover | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-popover { | |
position: absolute; | |
box-shadow: 0 2px 6px rgba(0,0,0,.15); | |
} | |
.fc-popover .fc-header { /* TODO: be more consistent with fc-head/fc-body */ | |
padding: 2px 4px; | |
} | |
.fc-popover .fc-header .fc-title { | |
margin: 0 2px; | |
} | |
.fc-popover .fc-header .fc-close { | |
cursor: pointer; | |
} | |
.fc-ltr .fc-popover .fc-header .fc-title, | |
.fc-rtl .fc-popover .fc-header .fc-close { | |
float: left; | |
} | |
.fc-rtl .fc-popover .fc-header .fc-title, | |
.fc-ltr .fc-popover .fc-header .fc-close { | |
float: right; | |
} | |
/* Misc Reusable Components | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-divider { | |
border-style: solid; | |
border-width: 1px; | |
} | |
hr.fc-divider { | |
height: 0; | |
margin: 0; | |
padding: 0 0 2px; /* height is unreliable across browsers, so use padding */ | |
border-width: 1px 0; | |
} | |
.fc-clear { | |
clear: both; | |
} | |
.fc-bg, | |
.fc-bgevent-skeleton, | |
.fc-highlight-skeleton, | |
.fc-helper-skeleton { | |
/* these element should always cling to top-left/right corners */ | |
position: absolute; | |
top: 0; | |
left: 0; | |
right: 0; | |
} | |
.fc-bg { | |
bottom: 0; /* strech bg to bottom edge */ | |
} | |
.fc-bg table { | |
height: 100%; /* strech bg to bottom edge */ | |
} | |
/* Tables | |
--------------------------------------------------------------------------------------------------*/ | |
.fc table { | |
width: 100%; | |
box-sizing: border-box; /* fix scrollbar issue in firefox */ | |
table-layout: fixed; | |
border-collapse: collapse; | |
border-spacing: 0; | |
font-size: 1em; /* normalize cross-browser */ | |
} | |
.fc th { | |
text-align: center; | |
} | |
.fc th, | |
.fc td { | |
border-style: solid; | |
border-width: 1px; | |
padding: 0; | |
vertical-align: top; | |
} | |
.fc td.fc-today { | |
border-style: double; /* overcome neighboring borders */ | |
} | |
/* Internal Nav Links | |
--------------------------------------------------------------------------------------------------*/ | |
a[data-goto] { | |
cursor: pointer; | |
} | |
a[data-goto]:hover { | |
text-decoration: underline; | |
} | |
/* Fake Table Rows | |
--------------------------------------------------------------------------------------------------*/ | |
.fc .fc-row { /* extra precedence to overcome themes w/ .ui-widget-content forcing a 1px border */ | |
/* no visible border by default. but make available if need be (scrollbar width compensation) */ | |
border-style: solid; | |
border-width: 0; | |
} | |
.fc-row table { | |
/* don't put left/right border on anything within a fake row. | |
the outer tbody will worry about this */ | |
border-left: 0 hidden transparent; | |
border-right: 0 hidden transparent; | |
/* no bottom borders on rows */ | |
border-bottom: 0 hidden transparent; | |
} | |
.fc-row:first-child table { | |
border-top: 0 hidden transparent; /* no top border on first row */ | |
} | |
/* Day Row (used within the header and the DayGrid) | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-row { | |
position: relative; | |
} | |
.fc-row .fc-bg { | |
z-index: 1; | |
} | |
/* highlighting cells & background event skeleton */ | |
.fc-row .fc-bgevent-skeleton, | |
.fc-row .fc-highlight-skeleton { | |
bottom: 0; /* stretch skeleton to bottom of row */ | |
} | |
.fc-row .fc-bgevent-skeleton table, | |
.fc-row .fc-highlight-skeleton table { | |
height: 100%; /* stretch skeleton to bottom of row */ | |
} | |
.fc-row .fc-highlight-skeleton td, | |
.fc-row .fc-bgevent-skeleton td { | |
border-color: transparent; | |
} | |
.fc-row .fc-bgevent-skeleton { | |
z-index: 2; | |
} | |
.fc-row .fc-highlight-skeleton { | |
z-index: 3; | |
} | |
/* | |
row content (which contains day/week numbers and events) as well as "helper" (which contains | |
temporary rendered events). | |
*/ | |
.fc-row .fc-content-skeleton { | |
position: relative; | |
z-index: 4; | |
padding-bottom: 2px; /* matches the space above the events */ | |
} | |
.fc-row .fc-helper-skeleton { | |
z-index: 5; | |
} | |
.fc .fc-row .fc-content-skeleton table, | |
.fc .fc-row .fc-content-skeleton td, | |
.fc .fc-row .fc-helper-skeleton td { | |
/* see-through to the background below */ | |
/* extra precedence to prevent theme-provided backgrounds */ | |
background: none; /* in case <td>s are globally styled */ | |
border-color: transparent; | |
} | |
.fc-row .fc-content-skeleton td, | |
.fc-row .fc-helper-skeleton td { | |
/* don't put a border between events and/or the day number */ | |
border-bottom: 0; | |
} | |
.fc-row .fc-content-skeleton tbody td, /* cells with events inside (so NOT the day number cell) */ | |
.fc-row .fc-helper-skeleton tbody td { | |
/* don't put a border between event cells */ | |
border-top: 0; | |
} | |
/* Scrolling Container | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-scroller { | |
-webkit-overflow-scrolling: touch; | |
} | |
/* TODO: move to agenda/basic */ | |
.fc-scroller > .fc-day-grid, | |
.fc-scroller > .fc-time-grid { | |
position: relative; /* re-scope all positions */ | |
width: 100%; /* hack to force re-sizing this inner element when scrollbars appear/disappear */ | |
} | |
/* Global Event Styles | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-event { | |
position: relative; /* for resize handle and other inner positioning */ | |
display: block; /* make the <a> tag block */ | |
font-size: .85em; | |
line-height: 1.3; | |
border-radius: 3px; | |
border: 1px solid #3a87ad; /* default BORDER color */ | |
} | |
.fc-event, | |
.fc-event-dot { | |
background-color: #3a87ad; /* default BACKGROUND color */ | |
} | |
.fc-event, | |
.fc-event:hover { | |
color: #fff; /* default TEXT color */ | |
text-decoration: none; /* if <a> has an href */ | |
} | |
.fc-event[href], | |
.fc-event.fc-draggable { | |
cursor: pointer; /* give events with links and draggable events a hand mouse pointer */ | |
} | |
.fc-not-allowed, /* causes a "warning" cursor. applied on body */ | |
.fc-not-allowed .fc-event { /* to override an event's custom cursor */ | |
cursor: not-allowed; | |
} | |
.fc-event .fc-bg { /* the generic .fc-bg already does position */ | |
z-index: 1; | |
background: #fff; | |
opacity: .25; | |
} | |
.fc-event .fc-content { | |
position: relative; | |
z-index: 2; | |
} | |
/* resizer (cursor AND touch devices) */ | |
.fc-event .fc-resizer { | |
position: absolute; | |
z-index: 4; | |
} | |
/* resizer (touch devices) */ | |
.fc-event .fc-resizer { | |
display: none; | |
} | |
.fc-event.fc-allow-mouse-resize .fc-resizer, | |
.fc-event.fc-selected .fc-resizer { | |
/* only show when hovering or selected (with touch) */ | |
display: block; | |
} | |
/* hit area */ | |
.fc-event.fc-selected .fc-resizer:before { | |
/* 40x40 touch area */ | |
content: ""; | |
position: absolute; | |
z-index: 9999; /* user of this util can scope within a lower z-index */ | |
top: 50%; | |
left: 50%; | |
width: 40px; | |
height: 40px; | |
margin-left: -20px; | |
margin-top: -20px; | |
} | |
/* Event Selection (only for touch devices) | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-event.fc-selected { | |
z-index: 9999 !important; /* overcomes inline z-index */ | |
box-shadow: 0 2px 5px rgba(0, 0, 0, 0.2); | |
} | |
.fc-event.fc-selected.fc-dragging { | |
box-shadow: 0 2px 7px rgba(0, 0, 0, 0.3); | |
} | |
/* Horizontal Events | |
--------------------------------------------------------------------------------------------------*/ | |
/* bigger touch area when selected */ | |
.fc-h-event.fc-selected:before { | |
content: ""; | |
position: absolute; | |
z-index: 3; /* below resizers */ | |
top: -10px; | |
bottom: -10px; | |
left: 0; | |
right: 0; | |
} | |
/* events that are continuing to/from another week. kill rounded corners and butt up against edge */ | |
.fc-ltr .fc-h-event.fc-not-start, | |
.fc-rtl .fc-h-event.fc-not-end { | |
margin-left: 0; | |
border-left-width: 0; | |
padding-left: 1px; /* replace the border with padding */ | |
border-top-left-radius: 0; | |
border-bottom-left-radius: 0; | |
} | |
.fc-ltr .fc-h-event.fc-not-end, | |
.fc-rtl .fc-h-event.fc-not-start { | |
margin-right: 0; | |
border-right-width: 0; | |
padding-right: 1px; /* replace the border with padding */ | |
border-top-right-radius: 0; | |
border-bottom-right-radius: 0; | |
} | |
/* resizer (cursor AND touch devices) */ | |
/* left resizer */ | |
.fc-ltr .fc-h-event .fc-start-resizer, | |
.fc-rtl .fc-h-event .fc-end-resizer { | |
cursor: w-resize; | |
left: -1px; /* overcome border */ | |
} | |
/* right resizer */ | |
.fc-ltr .fc-h-event .fc-end-resizer, | |
.fc-rtl .fc-h-event .fc-start-resizer { | |
cursor: e-resize; | |
right: -1px; /* overcome border */ | |
} | |
/* resizer (mouse devices) */ | |
.fc-h-event.fc-allow-mouse-resize .fc-resizer { | |
width: 7px; | |
top: -1px; /* overcome top border */ | |
bottom: -1px; /* overcome bottom border */ | |
} | |
/* resizer (touch devices) */ | |
.fc-h-event.fc-selected .fc-resizer { | |
/* 8x8 little dot */ | |
border-radius: 4px; | |
border-width: 1px; | |
width: 6px; | |
height: 6px; | |
border-style: solid; | |
border-color: inherit; | |
background: #fff; | |
/* vertically center */ | |
top: 50%; | |
margin-top: -4px; | |
} | |
/* left resizer */ | |
.fc-ltr .fc-h-event.fc-selected .fc-start-resizer, | |
.fc-rtl .fc-h-event.fc-selected .fc-end-resizer { | |
margin-left: -4px; /* centers the 8x8 dot on the left edge */ | |
} | |
/* right resizer */ | |
.fc-ltr .fc-h-event.fc-selected .fc-end-resizer, | |
.fc-rtl .fc-h-event.fc-selected .fc-start-resizer { | |
margin-right: -4px; /* centers the 8x8 dot on the right edge */ | |
} | |
/* DayGrid events | |
---------------------------------------------------------------------------------------------------- | |
We use the full "fc-day-grid-event" class instead of using descendants because the event won't | |
be a descendant of the grid when it is being dragged. | |
*/ | |
.fc-day-grid-event { | |
margin: 1px 2px 0; /* spacing between events and edges */ | |
padding: 0 1px; | |
} | |
tr:first-child > td > .fc-day-grid-event { | |
margin-top: 2px; /* a little bit more space before the first event */ | |
} | |
.fc-day-grid-event.fc-selected:after { | |
content: ""; | |
position: absolute; | |
z-index: 1; /* same z-index as fc-bg, behind text */ | |
/* overcome the borders */ | |
top: -1px; | |
right: -1px; | |
bottom: -1px; | |
left: -1px; | |
/* darkening effect */ | |
background: #000; | |
opacity: .25; | |
} | |
.fc-day-grid-event .fc-content { /* force events to be one-line tall */ | |
white-space: nowrap; | |
overflow: hidden; | |
} | |
.fc-day-grid-event .fc-time { | |
font-weight: bold; | |
} | |
/* resizer (cursor devices) */ | |
/* left resizer */ | |
.fc-ltr .fc-day-grid-event.fc-allow-mouse-resize .fc-start-resizer, | |
.fc-rtl .fc-day-grid-event.fc-allow-mouse-resize .fc-end-resizer { | |
margin-left: -2px; /* to the day cell's edge */ | |
} | |
/* right resizer */ | |
.fc-ltr .fc-day-grid-event.fc-allow-mouse-resize .fc-end-resizer, | |
.fc-rtl .fc-day-grid-event.fc-allow-mouse-resize .fc-start-resizer { | |
margin-right: -2px; /* to the day cell's edge */ | |
} | |
/* Event Limiting | |
--------------------------------------------------------------------------------------------------*/ | |
/* "more" link that represents hidden events */ | |
a.fc-more { | |
margin: 1px 3px; | |
font-size: .85em; | |
cursor: pointer; | |
text-decoration: none; | |
} | |
a.fc-more:hover { | |
text-decoration: underline; | |
} | |
.fc-limited { /* rows and cells that are hidden because of a "more" link */ | |
display: none; | |
} | |
/* popover that appears when "more" link is clicked */ | |
.fc-day-grid .fc-row { | |
z-index: 1; /* make the "more" popover one higher than this */ | |
} | |
.fc-more-popover { | |
z-index: 2; | |
width: 220px; | |
} | |
.fc-more-popover .fc-event-container { | |
padding: 10px; | |
} | |
/* Now Indicator | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-now-indicator { | |
position: absolute; | |
border: 0 solid red; | |
} | |
/* Utilities | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-unselectable { | |
-webkit-user-select: none; | |
-khtml-user-select: none; | |
-moz-user-select: none; | |
-ms-user-select: none; | |
user-select: none; | |
-webkit-touch-callout: none; | |
-webkit-tap-highlight-color: rgba(0, 0, 0, 0); | |
} | |
/* | |
TODO: more distinction between this file and common.css | |
*/ | |
/* Colors | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-unthemed th, | |
.fc-unthemed td, | |
.fc-unthemed thead, | |
.fc-unthemed tbody, | |
.fc-unthemed .fc-divider, | |
.fc-unthemed .fc-row, | |
.fc-unthemed .fc-content, /* for gutter border */ | |
.fc-unthemed .fc-popover, | |
.fc-unthemed .fc-list-view, | |
.fc-unthemed .fc-list-heading td { | |
border-color: #ddd; | |
} | |
.fc-unthemed .fc-popover { | |
background-color: #fff; | |
} | |
.fc-unthemed .fc-divider, | |
.fc-unthemed .fc-popover .fc-header, | |
.fc-unthemed .fc-list-heading td { | |
background: #eee; | |
} | |
.fc-unthemed .fc-popover .fc-header .fc-close { | |
color: #666; | |
} | |
.fc-unthemed td.fc-today { | |
background: #fcf8e3; | |
} | |
.fc-unthemed .fc-disabled-day { | |
background: #d7d7d7; | |
opacity: .3; | |
} | |
/* Icons (inline elements with styled text that mock arrow icons) | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-icon { | |
display: inline-block; | |
height: 1em; | |
line-height: 1em; | |
font-size: 1em; | |
text-align: center; | |
overflow: hidden; | |
font-family: "Courier New", Courier, monospace; | |
/* don't allow browser text-selection */ | |
-webkit-touch-callout: none; | |
-webkit-user-select: none; | |
-khtml-user-select: none; | |
-moz-user-select: none; | |
-ms-user-select: none; | |
user-select: none; | |
} | |
/* | |
Acceptable font-family overrides for individual icons: | |
"Arial", sans-serif | |
"Times New Roman", serif | |
NOTE: use percentage font sizes or else old IE chokes | |
*/ | |
.fc-icon:after { | |
position: relative; | |
} | |
.fc-icon-left-single-arrow:after { | |
content: "\02039"; | |
font-weight: bold; | |
font-size: 200%; | |
top: -7%; | |
} | |
.fc-icon-right-single-arrow:after { | |
content: "\0203A"; | |
font-weight: bold; | |
font-size: 200%; | |
top: -7%; | |
} | |
.fc-icon-left-double-arrow:after { | |
content: "\000AB"; | |
font-size: 160%; | |
top: -7%; | |
} | |
.fc-icon-right-double-arrow:after { | |
content: "\000BB"; | |
font-size: 160%; | |
top: -7%; | |
} | |
.fc-icon-left-triangle:after { | |
content: "\25C4"; | |
font-size: 125%; | |
top: 3%; | |
} | |
.fc-icon-right-triangle:after { | |
content: "\25BA"; | |
font-size: 125%; | |
top: 3%; | |
} | |
.fc-icon-down-triangle:after { | |
content: "\25BC"; | |
font-size: 125%; | |
top: 2%; | |
} | |
.fc-icon-x:after { | |
content: "\000D7"; | |
font-size: 200%; | |
top: 6%; | |
} | |
/* Popover | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-unthemed .fc-popover { | |
border-width: 1px; | |
border-style: solid; | |
} | |
.fc-unthemed .fc-popover .fc-header .fc-close { | |
font-size: .9em; | |
margin-top: 2px; | |
} | |
/* List View | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-unthemed .fc-list-item:hover td { | |
background-color: #f5f5f5; | |
} | |
/* Colors | |
--------------------------------------------------------------------------------------------------*/ | |
.ui-widget .fc-disabled-day { | |
background-image: none; | |
} | |
/* Popover | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-popover > .ui-widget-header + .ui-widget-content { | |
border-top: 0; /* where they meet, let the header have the border */ | |
} | |
/* Global Event Styles | |
--------------------------------------------------------------------------------------------------*/ | |
.ui-widget .fc-event { | |
/* overpower jqui's styles on <a> tags. TODO: more DRY */ | |
color: #fff; /* default TEXT color */ | |
text-decoration: none; /* if <a> has an href */ | |
/* undo ui-widget-header bold */ | |
font-weight: normal; | |
} | |
/* TimeGrid axis running down the side (for both the all-day area and the slot area) | |
--------------------------------------------------------------------------------------------------*/ | |
.ui-widget td.fc-axis { | |
font-weight: normal; /* overcome bold */ | |
} | |
/* TimeGrid Slats (lines that run horizontally) | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-time-grid .fc-slats .ui-widget-content { | |
background: none; /* see through to fc-bg */ | |
} | |
.fc.fc-bootstrap3 a { | |
text-decoration: none; | |
} | |
.fc.fc-bootstrap3 a[data-goto]:hover { | |
text-decoration: underline; | |
} | |
.fc-bootstrap3 .fc-divider { | |
border-color: inherit; | |
} | |
.fc-bootstrap3 .fc-today.alert { | |
border-radius: 0; | |
} | |
/* Popover | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-bootstrap3 .fc-popover .panel-body { | |
padding: 0; /* undo built-in padding */ | |
} | |
/* TimeGrid Slats (lines that run horizontally) | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-bootstrap3 .fc-time-grid .fc-slats table { | |
/* some themes have background color. see through to slats */ | |
background: none; | |
} | |
/* Toolbar | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-toolbar { | |
text-align: center; | |
} | |
.fc-toolbar.fc-header-toolbar { | |
margin-bottom: 1em; | |
} | |
.fc-toolbar.fc-footer-toolbar { | |
margin-top: 1em; | |
} | |
.fc-toolbar .fc-left { | |
float: left; | |
} | |
.fc-toolbar .fc-right { | |
float: right; | |
} | |
.fc-toolbar .fc-center { | |
display: inline-block; | |
} | |
/* the things within each left/right/center section */ | |
.fc .fc-toolbar > * > * { /* extra precedence to override button border margins */ | |
float: left; | |
margin-left: .75em; | |
} | |
/* the first thing within each left/center/right section */ | |
.fc .fc-toolbar > * > :first-child { /* extra precedence to override button border margins */ | |
margin-left: 0; | |
} | |
/* title text */ | |
.fc-toolbar h2 { | |
margin: 0; | |
} | |
/* button layering (for border precedence) */ | |
.fc-toolbar button { | |
position: relative; | |
} | |
.fc-toolbar .fc-state-hover, | |
.fc-toolbar .ui-state-hover { | |
z-index: 2; | |
} | |
.fc-toolbar .fc-state-down { | |
z-index: 3; | |
} | |
.fc-toolbar .fc-state-active, | |
.fc-toolbar .ui-state-active { | |
z-index: 4; | |
} | |
.fc-toolbar button:focus { | |
z-index: 5; | |
} | |
/* View Structure | |
--------------------------------------------------------------------------------------------------*/ | |
/* undo twitter bootstrap's box-sizing rules. normalizes positioning techniques */ | |
/* don't do this for the toolbar because we'll want bootstrap to style those buttons as some pt */ | |
.fc-view-container *, | |
.fc-view-container *:before, | |
.fc-view-container *:after { | |
-webkit-box-sizing: content-box; | |
-moz-box-sizing: content-box; | |
box-sizing: content-box; | |
} | |
.fc-view, /* scope positioning and z-index's for everything within the view */ | |
.fc-view > table { /* so dragged elements can be above the view's main element */ | |
position: relative; | |
z-index: 1; | |
} | |
/* BasicView | |
--------------------------------------------------------------------------------------------------*/ | |
/* day row structure */ | |
.fc-basicWeek-view .fc-content-skeleton, | |
.fc-basicDay-view .fc-content-skeleton { | |
/* there may be week numbers in these views, so no padding-top */ | |
padding-bottom: 1em; /* ensure a space at bottom of cell for user selecting/clicking */ | |
} | |
.fc-basic-view .fc-body .fc-row { | |
min-height: 4em; /* ensure that all rows are at least this tall */ | |
} | |
/* a "rigid" row will take up a constant amount of height because content-skeleton is absolute */ | |
.fc-row.fc-rigid { | |
overflow: hidden; | |
} | |
.fc-row.fc-rigid .fc-content-skeleton { | |
position: absolute; | |
top: 0; | |
left: 0; | |
right: 0; | |
} | |
/* week and day number styling */ | |
.fc-day-top.fc-other-month { | |
opacity: 0.3; | |
} | |
.fc-basic-view .fc-week-number, | |
.fc-basic-view .fc-day-number { | |
padding: 2px; | |
} | |
.fc-basic-view th.fc-week-number, | |
.fc-basic-view th.fc-day-number { | |
padding: 0 2px; /* column headers can't have as much v space */ | |
} | |
.fc-ltr .fc-basic-view .fc-day-top .fc-day-number { float: right; } | |
.fc-rtl .fc-basic-view .fc-day-top .fc-day-number { float: left; } | |
.fc-ltr .fc-basic-view .fc-day-top .fc-week-number { float: left; border-radius: 0 0 3px 0; } | |
.fc-rtl .fc-basic-view .fc-day-top .fc-week-number { float: right; border-radius: 0 0 0 3px; } | |
.fc-basic-view .fc-day-top .fc-week-number { | |
min-width: 1.5em; | |
text-align: center; | |
background-color: #f2f2f2; | |
color: #808080; | |
} | |
/* when week/day number have own column */ | |
.fc-basic-view td.fc-week-number { | |
text-align: center; | |
} | |
.fc-basic-view td.fc-week-number > * { | |
/* work around the way we do column resizing and ensure a minimum width */ | |
display: inline-block; | |
min-width: 1.25em; | |
} | |
/* AgendaView all-day area | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-agenda-view .fc-day-grid { | |
position: relative; | |
z-index: 2; /* so the "more.." popover will be over the time grid */ | |
} | |
.fc-agenda-view .fc-day-grid .fc-row { | |
min-height: 3em; /* all-day section will never get shorter than this */ | |
} | |
.fc-agenda-view .fc-day-grid .fc-row .fc-content-skeleton { | |
padding-bottom: 1em; /* give space underneath events for clicking/selecting days */ | |
} | |
/* TimeGrid axis running down the side (for both the all-day area and the slot area) | |
--------------------------------------------------------------------------------------------------*/ | |
.fc .fc-axis { /* .fc to overcome default cell styles */ | |
vertical-align: middle; | |
padding: 0 4px; | |
white-space: nowrap; | |
} | |
.fc-ltr .fc-axis { | |
text-align: right; | |
} | |
.fc-rtl .fc-axis { | |
text-align: left; | |
} | |
/* TimeGrid Structure | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-time-grid-container, /* so scroll container's z-index is below all-day */ | |
.fc-time-grid { /* so slats/bg/content/etc positions get scoped within here */ | |
position: relative; | |
z-index: 1; | |
} | |
.fc-time-grid { | |
min-height: 100%; /* so if height setting is 'auto', .fc-bg stretches to fill height */ | |
} | |
.fc-time-grid table { /* don't put outer borders on slats/bg/content/etc */ | |
border: 0 hidden transparent; | |
} | |
.fc-time-grid > .fc-bg { | |
z-index: 1; | |
} | |
.fc-time-grid .fc-slats, | |
.fc-time-grid > hr { /* the <hr> AgendaView injects when grid is shorter than scroller */ | |
position: relative; | |
z-index: 2; | |
} | |
.fc-time-grid .fc-content-col { | |
position: relative; /* because now-indicator lives directly inside */ | |
} | |
.fc-time-grid .fc-content-skeleton { | |
position: absolute; | |
z-index: 3; | |
top: 0; | |
left: 0; | |
right: 0; | |
} | |
/* divs within a cell within the fc-content-skeleton */ | |
.fc-time-grid .fc-business-container { | |
position: relative; | |
z-index: 1; | |
} | |
.fc-time-grid .fc-bgevent-container { | |
position: relative; | |
z-index: 2; | |
} | |
.fc-time-grid .fc-highlight-container { | |
position: relative; | |
z-index: 3; | |
} | |
.fc-time-grid .fc-event-container { | |
position: relative; | |
z-index: 4; | |
} | |
.fc-time-grid .fc-now-indicator-line { | |
z-index: 5; | |
} | |
.fc-time-grid .fc-helper-container { /* also is fc-event-container */ | |
position: relative; | |
z-index: 6; | |
} | |
/* TimeGrid Slats (lines that run horizontally) | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-time-grid .fc-slats td { | |
height: 1.5em; | |
border-bottom: 0; /* each cell is responsible for its top border */ | |
} | |
.fc-time-grid .fc-slats .fc-minor td { | |
border-top-style: dotted; | |
} | |
/* TimeGrid Highlighting Slots | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-time-grid .fc-highlight-container { /* a div within a cell within the fc-highlight-skeleton */ | |
position: relative; /* scopes the left/right of the fc-highlight to be in the column */ | |
} | |
.fc-time-grid .fc-highlight { | |
position: absolute; | |
left: 0; | |
right: 0; | |
/* top and bottom will be in by JS */ | |
} | |
/* TimeGrid Event Containment | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-ltr .fc-time-grid .fc-event-container { /* space on the sides of events for LTR (default) */ | |
margin: 0 2.5% 0 2px; | |
} | |
.fc-rtl .fc-time-grid .fc-event-container { /* space on the sides of events for RTL */ | |
margin: 0 2px 0 2.5%; | |
} | |
.fc-time-grid .fc-event, | |
.fc-time-grid .fc-bgevent { | |
position: absolute; | |
z-index: 1; /* scope inner z-index's */ | |
} | |
.fc-time-grid .fc-bgevent { | |
/* background events always span full width */ | |
left: 0; | |
right: 0; | |
} | |
/* Generic Vertical Event | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-v-event.fc-not-start { /* events that are continuing from another day */ | |
/* replace space made by the top border with padding */ | |
border-top-width: 0; | |
padding-top: 1px; | |
/* remove top rounded corners */ | |
border-top-left-radius: 0; | |
border-top-right-radius: 0; | |
} | |
.fc-v-event.fc-not-end { | |
/* replace space made by the top border with padding */ | |
border-bottom-width: 0; | |
padding-bottom: 1px; | |
/* remove bottom rounded corners */ | |
border-bottom-left-radius: 0; | |
border-bottom-right-radius: 0; | |
} | |
/* TimeGrid Event Styling | |
---------------------------------------------------------------------------------------------------- | |
We use the full "fc-time-grid-event" class instead of using descendants because the event won't | |
be a descendant of the grid when it is being dragged. | |
*/ | |
.fc-time-grid-event { | |
overflow: hidden; /* don't let the bg flow over rounded corners */ | |
} | |
.fc-time-grid-event.fc-selected { | |
/* need to allow touch resizers to extend outside event's bounding box */ | |
/* common fc-selected styles hide the fc-bg, so don't need this anyway */ | |
overflow: visible; | |
} | |
.fc-time-grid-event.fc-selected .fc-bg { | |
display: none; /* hide semi-white background, to appear darker */ | |
} | |
.fc-time-grid-event .fc-content { | |
overflow: hidden; /* for when .fc-selected */ | |
} | |
.fc-time-grid-event .fc-time, | |
.fc-time-grid-event .fc-title { | |
padding: 0 1px; | |
} | |
.fc-time-grid-event .fc-time { | |
font-size: .85em; | |
white-space: nowrap; | |
} | |
/* short mode, where time and title are on the same line */ | |
.fc-time-grid-event.fc-short:hover { | |
z-index: 999 !important; | |
right: auto !important; | |
} | |
.fc-time-grid-event.fc-short .fc-content { | |
/* don't wrap to second line (now that contents will be inline) */ | |
white-space: nowrap; | |
} | |
.fc-time-grid-event.fc-short .fc-time, | |
.fc-time-grid-event.fc-short .fc-title { | |
/* put the time and title on the same line */ | |
display: inline-block; | |
vertical-align: top; | |
} | |
.fc-time-grid-event.fc-short .fc-time span { | |
display: none; /* don't display the full time text... */ | |
} | |
.fc-time-grid-event.fc-short .fc-time:before { | |
content: attr(data-start); /* ...instead, display only the start time */ | |
} | |
.fc-time-grid-event.fc-short .fc-time:after { | |
content: "\000A0-\000A0"; /* seperate with a dash, wrapped in nbsp's */ | |
} | |
.fc-time-grid-event.fc-short .fc-title { | |
font-size: .85em; /* make the title text the same size as the time */ | |
padding: 0; /* undo padding from above */ | |
} | |
/* resizer (cursor device) */ | |
.fc-time-grid-event.fc-allow-mouse-resize .fc-resizer { | |
left: 0; | |
right: 0; | |
bottom: 0; | |
height: 8px; | |
overflow: hidden; | |
line-height: 8px; | |
font-size: 11px; | |
font-family: monospace; | |
text-align: center; | |
cursor: s-resize; | |
} | |
.fc-time-grid-event.fc-allow-mouse-resize .fc-resizer:after { | |
content: "="; | |
} | |
/* resizer (touch device) */ | |
.fc-time-grid-event.fc-selected .fc-resizer { | |
/* 10x10 dot */ | |
border-radius: 5px; | |
border-width: 1px; | |
width: 8px; | |
height: 8px; | |
border-style: solid; | |
border-color: inherit; | |
background: #fff; | |
/* horizontally center */ | |
left: 50%; | |
margin-left: -5px; | |
/* center on the bottom edge */ | |
bottom: -5px; | |
} | |
/* Now Indicator | |
--------------------------------------------------------------------------------------------------*/ | |
.fc-time-grid .fc-now-indicator-line { | |
border-top-width: 1px; | |
left: 0; | |
right: 0; | |
} | |
/* arrow on axis */ | |
.fc-time-grid .fc-now-indicator-arrow { | |
margin-top: -5px; /* vertically center on top coordinate */ | |
} | |
.fc-ltr .fc-time-grid .fc-now-indicator-arrow { | |
left: 0; | |
/* triangle pointing right... */ | |
border-width: 5px 0 5px 6px; | |
border-top-color: transparent; | |
border-bottom-color: transparent; | |
} | |
.fc-rtl .fc-time-grid .fc-now-indicator-arrow { | |
right: 0; | |
/* triangle pointing left... */ | |
border-width: 5px 6px 5px 0; | |
border-top-color: transparent; | |
border-bottom-color: transparent; | |
} | |
/* List View | |
--------------------------------------------------------------------------------------------------*/ | |
/* possibly reusable */ | |
.fc-event-dot { | |
display: inline-block; | |
width: 10px; | |
height: 10px; | |
border-radius: 5px; | |
} | |
/* view wrapper */ | |
.fc-rtl .fc-list-view { | |
direction: rtl; /* unlike core views, leverage browser RTL */ | |
} | |
.fc-list-view { | |
border-width: 1px; | |
border-style: solid; | |
} | |
/* table resets */ | |
.fc .fc-list-table { | |
table-layout: auto; /* for shrinkwrapping cell content */ | |
} | |
.fc-list-table td { | |
border-width: 1px 0 0; | |
padding: 8px 14px; | |
} | |
.fc-list-table tr:first-child td { | |
border-top-width: 0; | |
} | |
/* day headings with the list */ | |
.fc-list-heading { | |
border-bottom-width: 1px; | |
} | |
.fc-list-heading td { | |
font-weight: bold; | |
} | |
.fc-ltr .fc-list-heading-main { float: left; } | |
.fc-ltr .fc-list-heading-alt { float: right; } | |
.fc-rtl .fc-list-heading-main { float: right; } | |
.fc-rtl .fc-list-heading-alt { float: left; } | |
/* event list items */ | |
.fc-list-item.fc-has-url { | |
cursor: pointer; /* whole row will be clickable */ | |
} | |
.fc-list-item-marker, | |
.fc-list-item-time { | |
white-space: nowrap; | |
width: 1px; | |
} | |
/* make the dot closer to the event title */ | |
.fc-ltr .fc-list-item-marker { padding-right: 0; } | |
.fc-rtl .fc-list-item-marker { padding-left: 0; } | |
.fc-list-item-title a { | |
/* every event title cell has an <a> tag */ | |
text-decoration: none; | |
color: inherit; | |
} | |
.fc-list-item-title a[href]:hover { | |
/* hover effect only on titles with hrefs */ | |
text-decoration: underline; | |
} | |
/* message when no events */ | |
.fc-list-empty-wrap2 { | |
position: absolute; | |
top: 0; | |
left: 0; | |
right: 0; | |
bottom: 0; | |
} | |
.fc-list-empty-wrap1 { | |
width: 100%; | |
height: 100%; | |
display: table; | |
} | |
.fc-list-empty { | |
display: table-cell; | |
vertical-align: middle; | |
text-align: center; | |
} | |
.fc-unthemed .fc-list-empty { /* theme will provide own background */ | |
background-color: #eee; | |
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
/*! | |
* FullCalendar v0.0.0 | |
* Docs & License: https://fullcalendar.io/ | |
* (c) 2017 Adam Shaw | |
*/ | |
(function(factory) { | |
if (typeof define === 'function' && define.amd) { | |
define([ 'jquery', 'moment' ], factory); | |
} | |
else if (typeof exports === 'object') { // Node/CommonJS | |
module.exports = factory(require('jquery'), require('moment')); | |
} | |
else { | |
factory(jQuery, moment); | |
} | |
})(function($, moment) { | |
;; | |
var FC = $.fullCalendar = { | |
version: "0.0.0", | |
// When introducing internal API incompatibilities (where fullcalendar plugins would break), | |
// the minor version of the calendar should be upped (ex: 2.7.2 -> 2.8.0) | |
// and the below integer should be incremented. | |
internalApiVersion: 9 | |
}; | |
var fcViews = FC.views = {}; | |
$.fn.fullCalendar = function(options) { | |
var args = Array.prototype.slice.call(arguments, 1); // for a possible method call | |
var res = this; // what this function will return (this jQuery object by default) | |
this.each(function(i, _element) { // loop each DOM element involved | |
var element = $(_element); | |
var calendar = element.data('fullCalendar'); // get the existing calendar object (if any) | |
var singleRes; // the returned value of this single method call | |
// a method call | |
if (typeof options === 'string') { | |
if (options === 'getCalendar') { | |
if (!i) { // first element only | |
res = calendar; | |
} | |
} | |
else if (options === 'destroy') { // don't warn if no calendar object | |
if (calendar) { | |
calendar.destroy(); | |
element.removeData('fullCalendar'); | |
} | |
} | |
else if (!calendar) { | |
FC.warn("Attempting to call a FullCalendar method on an element with no calendar."); | |
} | |
else if ($.isFunction(calendar[options])) { | |
singleRes = calendar[options].apply(calendar, args); | |
if (!i) { | |
res = singleRes; // record the first method call result | |
} | |
if (options === 'destroy') { // for the destroy method, must remove Calendar object data | |
element.removeData('fullCalendar'); | |
} | |
} | |
else { | |
FC.warn("'" + options + "' is an unknown FullCalendar method."); | |
} | |
} | |
// a new calendar initialization | |
else if (!calendar) { // don't initialize twice | |
calendar = new Calendar(element, options); | |
element.data('fullCalendar', calendar); | |
calendar.render(); | |
} | |
}); | |
return res; | |
}; | |
var complexOptions = [ // names of options that are objects whose properties should be combined | |
'header', | |
'footer', | |
'buttonText', | |
'buttonIcons', | |
'themeButtonIcons' | |
]; | |
// Merges an array of option objects into a single object | |
function mergeOptions(optionObjs) { | |
return mergeProps(optionObjs, complexOptions); | |
} | |
;; | |
// exports | |
FC.applyAll = applyAll; | |
FC.debounce = debounce; | |
FC.isInt = isInt; | |
FC.htmlEscape = htmlEscape; | |
FC.cssToStr = cssToStr; | |
FC.proxy = proxy; | |
FC.capitaliseFirstLetter = capitaliseFirstLetter; | |
/* FullCalendar-specific DOM Utilities | |
----------------------------------------------------------------------------------------------------------------------*/ | |
// Given the scrollbar widths of some other container, create borders/margins on rowEls in order to match the left | |
// and right space that was offset by the scrollbars. A 1-pixel border first, then margin beyond that. | |
function compensateScroll(rowEls, scrollbarWidths) { | |
if (scrollbarWidths.left) { | |
rowEls.css({ | |
'border-left-width': 1, | |
'margin-left': scrollbarWidths.left - 1 | |
}); | |
} | |
if (scrollbarWidths.right) { | |
rowEls.css({ | |
'border-right-width': 1, | |
'margin-right': scrollbarWidths.right - 1 | |
}); | |
} | |
} | |
// Undoes compensateScroll and restores all borders/margins | |
function uncompensateScroll(rowEls) { | |
rowEls.css({ | |
'margin-left': '', | |
'margin-right': '', | |
'border-left-width': '', | |
'border-right-width': '' | |
}); | |
} | |
// Make the mouse cursor express that an event is not allowed in the current area | |
function disableCursor() { | |
$('body').addClass('fc-not-allowed'); | |
} | |
// Returns the mouse cursor to its original look | |
function enableCursor() { | |
$('body').removeClass('fc-not-allowed'); | |
} | |
// Given a total available height to fill, have `els` (essentially child rows) expand to accomodate. | |
// By default, all elements that are shorter than the recommended height are expanded uniformly, not considering | |
// any other els that are already too tall. if `shouldRedistribute` is on, it considers these tall rows and | |
// reduces the available height. | |
function distributeHeight(els, availableHeight, shouldRedistribute) { | |
// *FLOORING NOTE*: we floor in certain places because zoom can give inaccurate floating-point dimensions, | |
// and it is better to be shorter than taller, to avoid creating unnecessary scrollbars. | |
var minOffset1 = Math.floor(availableHeight / els.length); // for non-last element | |
var minOffset2 = Math.floor(availableHeight - minOffset1 * (els.length - 1)); // for last element *FLOORING NOTE* | |
var flexEls = []; // elements that are allowed to expand. array of DOM nodes | |
var flexOffsets = []; // amount of vertical space it takes up | |
var flexHeights = []; // actual css height | |
var usedHeight = 0; | |
undistributeHeight(els); // give all elements their natural height | |
// find elements that are below the recommended height (expandable). | |
// important to query for heights in a single first pass (to avoid reflow oscillation). | |
els.each(function(i, el) { | |
var minOffset = i === els.length - 1 ? minOffset2 : minOffset1; | |
var naturalOffset = $(el).outerHeight(true); | |
if (naturalOffset < minOffset) { | |
flexEls.push(el); | |
flexOffsets.push(naturalOffset); | |
flexHeights.push($(el).height()); | |
} | |
else { | |
// this element stretches past recommended height (non-expandable). mark the space as occupied. | |
usedHeight += naturalOffset; | |
} | |
}); | |
// readjust the recommended height to only consider the height available to non-maxed-out rows. | |
if (shouldRedistribute) { | |
availableHeight -= usedHeight; | |
minOffset1 = Math.floor(availableHeight / flexEls.length); | |
minOffset2 = Math.floor(availableHeight - minOffset1 * (flexEls.length - 1)); // *FLOORING NOTE* | |
} | |
// assign heights to all expandable elements | |
$(flexEls).each(function(i, el) { | |
var minOffset = i === flexEls.length - 1 ? minOffset2 : minOffset1; | |
var naturalOffset = flexOffsets[i]; | |
var naturalHeight = flexHeights[i]; | |
var newHeight = minOffset - (naturalOffset - naturalHeight); // subtract the margin/padding | |
if (naturalOffset < minOffset) { // we check this again because redistribution might have changed things | |
$(el).height(newHeight); | |
} | |
}); | |
} | |
// Undoes distrubuteHeight, restoring all els to their natural height | |
function undistributeHeight(els) { | |
els.height(''); | |
} | |
// Given `els`, a jQuery set of <td> cells, find the cell with the largest natural width and set the widths of all the | |
// cells to be that width. | |
// PREREQUISITE: if you want a cell to take up width, it needs to have a single inner element w/ display:inline | |
function matchCellWidths(els) { | |
var maxInnerWidth = 0; | |
els.find('> *').each(function(i, innerEl) { | |
var innerWidth = $(innerEl).outerWidth(); | |
if (innerWidth > maxInnerWidth) { | |
maxInnerWidth = innerWidth; | |
} | |
}); | |
maxInnerWidth++; // sometimes not accurate of width the text needs to stay on one line. insurance | |
els.width(maxInnerWidth); | |
return maxInnerWidth; | |
} | |
// Given one element that resides inside another, | |
// Subtracts the height of the inner element from the outer element. | |
function subtractInnerElHeight(outerEl, innerEl) { | |
var both = outerEl.add(innerEl); | |
var diff; | |
// effin' IE8/9/10/11 sometimes returns 0 for dimensions. this weird hack was the only thing that worked | |
both.css({ | |
position: 'relative', // cause a reflow, which will force fresh dimension recalculation | |
left: -1 // ensure reflow in case the el was already relative. negative is less likely to cause new scroll | |
}); | |
diff = outerEl.outerHeight() - innerEl.outerHeight(); // grab the dimensions | |
both.css({ position: '', left: '' }); // undo hack | |
return diff; | |
} | |
/* Element Geom Utilities | |
----------------------------------------------------------------------------------------------------------------------*/ | |
FC.getOuterRect = getOuterRect; | |
FC.getClientRect = getClientRect; | |
FC.getContentRect = getContentRect; | |
FC.getScrollbarWidths = getScrollbarWidths; | |
// borrowed from https://github.com/jquery/jquery-ui/blob/1.11.0/ui/core.js#L51 | |
function getScrollParent(el) { | |
var position = el.css('position'), | |
scrollParent = el.parents().filter(function() { | |
var parent = $(this); | |
return (/(auto|scroll)/).test( | |
parent.css('overflow') + parent.css('overflow-y') + parent.css('overflow-x') | |
); | |
}).eq(0); | |
return position === 'fixed' || !scrollParent.length ? $(el[0].ownerDocument || document) : scrollParent; | |
} | |
// Queries the outer bounding area of a jQuery element. | |
// Returns a rectangle with absolute coordinates: left, right (exclusive), top, bottom (exclusive). | |
// Origin is optional. | |
function getOuterRect(el, origin) { | |
var offset = el.offset(); | |
var left = offset.left - (origin ? origin.left : 0); | |
var top = offset.top - (origin ? origin.top : 0); | |
return { | |
left: left, | |
right: left + el.outerWidth(), | |
top: top, | |
bottom: top + el.outerHeight() | |
}; | |
} | |
// Queries the area within the margin/border/scrollbars of a jQuery element. Does not go within the padding. | |
// Returns a rectangle with absolute coordinates: left, right (exclusive), top, bottom (exclusive). | |
// Origin is optional. | |
// WARNING: given element can't have borders | |
// NOTE: should use clientLeft/clientTop, but very unreliable cross-browser. | |
function getClientRect(el, origin) { | |
var offset = el.offset(); | |
var scrollbarWidths = getScrollbarWidths(el); | |
var left = offset.left + getCssFloat(el, 'border-left-width') + scrollbarWidths.left - (origin ? origin.left : 0); | |
var top = offset.top + getCssFloat(el, 'border-top-width') + scrollbarWidths.top - (origin ? origin.top : 0); | |
return { | |
left: left, | |
right: left + el[0].clientWidth, // clientWidth includes padding but NOT scrollbars | |
top: top, | |
bottom: top + el[0].clientHeight // clientHeight includes padding but NOT scrollbars | |
}; | |
} | |
// Queries the area within the margin/border/padding of a jQuery element. Assumed not to have scrollbars. | |
// Returns a rectangle with absolute coordinates: left, right (exclusive), top, bottom (exclusive). | |
// Origin is optional. | |
function getContentRect(el, origin) { | |
var offset = el.offset(); // just outside of border, margin not included | |
var left = offset.left + getCssFloat(el, 'border-left-width') + getCssFloat(el, 'padding-left') - | |
(origin ? origin.left : 0); | |
var top = offset.top + getCssFloat(el, 'border-top-width') + getCssFloat(el, 'padding-top') - | |
(origin ? origin.top : 0); | |
return { | |
left: left, | |
right: left + el.width(), | |
top: top, | |
bottom: top + el.height() | |
}; | |
} | |
// Returns the computed left/right/top/bottom scrollbar widths for the given jQuery element. | |
// WARNING: given element can't have borders (which will cause offsetWidth/offsetHeight to be larger). | |
// NOTE: should use clientLeft/clientTop, but very unreliable cross-browser. | |
function getScrollbarWidths(el) { | |
var leftRightWidth = el[0].offsetWidth - el[0].clientWidth; | |
var bottomWidth = el[0].offsetHeight - el[0].clientHeight; | |
var widths; | |
leftRightWidth = sanitizeScrollbarWidth(leftRightWidth); | |
bottomWidth = sanitizeScrollbarWidth(bottomWidth); | |
widths = { left: 0, right: 0, top: 0, bottom: bottomWidth }; | |
if (getIsLeftRtlScrollbars() && el.css('direction') == 'rtl') { // is the scrollbar on the left side? | |
widths.left = leftRightWidth; | |
} | |
else { | |
widths.right = leftRightWidth; | |
} | |
return widths; | |
} | |
// The scrollbar width computations in getScrollbarWidths are sometimes flawed when it comes to | |
// retina displays, rounding, and IE11. Massage them into a usable value. | |
function sanitizeScrollbarWidth(width) { | |
width = Math.max(0, width); // no negatives | |
width = Math.round(width); | |
return width; | |
} | |
// Logic for determining if, when the element is right-to-left, the scrollbar appears on the left side | |
var _isLeftRtlScrollbars = null; | |
function getIsLeftRtlScrollbars() { // responsible for caching the computation | |
if (_isLeftRtlScrollbars === null) { | |
_isLeftRtlScrollbars = computeIsLeftRtlScrollbars(); | |
} | |
return _isLeftRtlScrollbars; | |
} | |
function computeIsLeftRtlScrollbars() { // creates an offscreen test element, then removes it | |
var el = $('<div><div/></div>') | |
.css({ | |
position: 'absolute', | |
top: -1000, | |
left: 0, | |
border: 0, | |
padding: 0, | |
overflow: 'scroll', | |
direction: 'rtl' | |
}) | |
.appendTo('body'); | |
var innerEl = el.children(); | |
var res = innerEl.offset().left > el.offset().left; // is the inner div shifted to accommodate a left scrollbar? | |
el.remove(); | |
return res; | |
} | |
// Retrieves a jQuery element's computed CSS value as a floating-point number. | |
// If the queried value is non-numeric (ex: IE can return "medium" for border width), will just return zero. | |
function getCssFloat(el, prop) { | |
return parseFloat(el.css(prop)) || 0; | |
} | |
/* Mouse / Touch Utilities | |
----------------------------------------------------------------------------------------------------------------------*/ | |
FC.preventDefault = preventDefault; | |
// Returns a boolean whether this was a left mouse click and no ctrl key (which means right click on Mac) | |
function isPrimaryMouseButton(ev) { | |
return ev.which == 1 && !ev.ctrlKey; | |
} | |
function getEvX(ev) { | |
var touches = ev.originalEvent.touches; | |
// on mobile FF, pageX for touch events is present, but incorrect, | |
// so, look at touch coordinates first. | |
if (touches && touches.length) { | |
return touches[0].pageX; | |
} | |
return ev.pageX; | |
} | |
function getEvY(ev) { | |
var touches = ev.originalEvent.touches; | |
// on mobile FF, pageX for touch events is present, but incorrect, | |
// so, look at touch coordinates first. | |
if (touches && touches.length) { | |
return touches[0].pageY; | |
} | |
return ev.pageY; | |
} | |
function getEvIsTouch(ev) { | |
return /^touch/.test(ev.type); | |
} | |
function preventSelection(el) { | |
el.addClass('fc-unselectable') | |
.on('selectstart', preventDefault); | |
} | |
function allowSelection(el) { | |
el.removeClass('fc-unselectable') | |
.off('selectstart', preventDefault); | |
} | |
// Stops a mouse/touch event from doing it's native browser action | |
function preventDefault(ev) { | |
ev.preventDefault(); | |
} | |
/* General Geometry Utils | |
----------------------------------------------------------------------------------------------------------------------*/ | |
FC.intersectRects = intersectRects; | |
// Returns a new rectangle that is the intersection of the two rectangles. If they don't intersect, returns false | |
function intersectRects(rect1, rect2) { | |
var res = { | |
left: Math.max(rect1.left, rect2.left), | |
right: Math.min(rect1.right, rect2.right), | |
top: Math.max(rect1.top, rect2.top), | |
bottom: Math.min(rect1.bottom, rect2.bottom) | |
}; | |
if (res.left < res.right && res.top < res.bottom) { | |
return res; | |
} | |
return false; | |
} | |
// Returns a new point that will have been moved to reside within the given rectangle | |
function constrainPoint(point, rect) { | |
return { | |
left: Math.min(Math.max(point.left, rect.left), rect.right), | |
top: Math.min(Math.max(point.top, rect.top), rect.bottom) | |
}; | |
} | |
// Returns a point that is the center of the given rectangle | |
function getRectCenter(rect) { | |
return { | |
left: (rect.left + rect.right) / 2, | |
top: (rect.top + rect.bottom) / 2 | |
}; | |
} | |
// Subtracts point2's coordinates from point1's coordinates, returning a delta | |
function diffPoints(point1, point2) { | |
return { | |
left: point1.left - point2.left, | |
top: point1.top - point2.top | |
}; | |
} | |
/* Object Ordering by Field | |
----------------------------------------------------------------------------------------------------------------------*/ | |
FC.parseFieldSpecs = parseFieldSpecs; | |
FC.compareByFieldSpecs = compareByFieldSpecs; | |
FC.compareByFieldSpec = compareByFieldSpec; | |
FC.flexibleCompare = flexibleCompare; | |
function parseFieldSpecs(input) { | |
var specs = []; | |
var tokens = []; | |
var i, token; | |
if (typeof input === 'string') { | |
tokens = input.split(/\s*,\s*/); | |
} | |
else if (typeof input === 'function') { | |
tokens = [ input ]; | |
} | |
else if ($.isArray(input)) { | |
tokens = input; | |
} | |
for (i = 0; i < tokens.length; i++) { | |
token = tokens[i]; | |
if (typeof token === 'string') { | |
specs.push( | |
token.charAt(0) == '-' ? | |
{ field: token.substring(1), order: -1 } : | |
{ field: token, order: 1 } | |
); | |
} | |
else if (typeof token === 'function') { | |
specs.push({ func: token }); | |
} | |
} | |
return specs; | |
} | |
function compareByFieldSpecs(obj1, obj2, fieldSpecs) { | |
var i; | |
var cmp; | |
for (i = 0; i < fieldSpecs.length; i++) { | |
cmp = compareByFieldSpec(obj1, obj2, fieldSpecs[i]); | |
if (cmp) { | |
return cmp; | |
} | |
} | |
return 0; | |
} | |
function compareByFieldSpec(obj1, obj2, fieldSpec) { | |
if (fieldSpec.func) { | |
return fieldSpec.func(obj1, obj2); | |
} | |
return flexibleCompare(obj1[fieldSpec.field], obj2[fieldSpec.field]) * | |
(fieldSpec.order || 1); | |
} | |
function flexibleCompare(a, b) { | |
if (!a && !b) { | |
return 0; | |
} | |
if (b == null) { | |
return -1; | |
} | |
if (a == null) { | |
return 1; | |
} | |
if ($.type(a) === 'string' || $.type(b) === 'string') { | |
return String(a).localeCompare(String(b)); | |
} | |
return a - b; | |
} | |
/* Date Utilities | |
----------------------------------------------------------------------------------------------------------------------*/ | |
FC.computeGreatestUnit = computeGreatestUnit; | |
FC.divideRangeByDuration = divideRangeByDuration; | |
FC.divideDurationByDuration = divideDurationByDuration; | |
FC.multiplyDuration = multiplyDuration; | |
FC.durationHasTime = durationHasTime; | |
var dayIDs = [ 'sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat' ]; | |
var unitsDesc = [ 'year', 'month', 'week', 'day', 'hour', 'minute', 'second', 'millisecond' ]; // descending | |
// Diffs the two moments into a Duration where full-days are recorded first, then the remaining time. | |
// Moments will have their timezones normalized. | |
function diffDayTime(a, b) { | |
return moment.duration({ | |
days: a.clone().stripTime().diff(b.clone().stripTime(), 'days'), | |
ms: a.time() - b.time() // time-of-day from day start. disregards timezone | |
}); | |
} | |
// Diffs the two moments via their start-of-day (regardless of timezone). Produces whole-day durations. | |
function diffDay(a, b) { | |
return moment.duration({ | |
days: a.clone().stripTime().diff(b.clone().stripTime(), 'days') | |
}); | |
} | |
// Diffs two moments, producing a duration, made of a whole-unit-increment of the given unit. Uses rounding. | |
function diffByUnit(a, b, unit) { | |
return moment.duration( | |
Math.round(a.diff(b, unit, true)), // returnFloat=true | |
unit | |
); | |
} | |
// Computes the unit name of the largest whole-unit period of time. | |
// For example, 48 hours will be "days" whereas 49 hours will be "hours". | |
// Accepts start/end, a range object, or an original duration object. | |
function computeGreatestUnit(start, end) { | |
var i, unit; | |
var val; | |
for (i = 0; i < unitsDesc.length; i++) { | |
unit = unitsDesc[i]; | |
val = computeRangeAs(unit, start, end); | |
if (val >= 1 && isInt(val)) { | |
break; | |
} | |
} | |
return unit; // will be "milliseconds" if nothing else matches | |
} | |
// like computeGreatestUnit, but has special abilities to interpret the source input for clues | |
function computeDurationGreatestUnit(duration, durationInput) { | |
var unit = computeGreatestUnit(duration); | |
// prevent days:7 from being interpreted as a week | |
if (unit === 'week' && typeof durationInput === 'object' && durationInput.days) { | |
unit = 'day'; | |
} | |
return unit; | |
} | |
// Computes the number of units (like "hours") in the given range. | |
// Range can be a {start,end} object, separate start/end args, or a Duration. | |
// Results are based on Moment's .as() and .diff() methods, so results can depend on internal handling | |
// of month-diffing logic (which tends to vary from version to version). | |
function computeRangeAs(unit, start, end) { | |
if (end != null) { // given start, end | |
return end.diff(start, unit, true); | |
} | |
else if (moment.isDuration(start)) { // given duration | |
return start.as(unit); | |
} | |
else { // given { start, end } range object | |
return start.end.diff(start.start, unit, true); | |
} | |
} | |
// Intelligently divides a range (specified by a start/end params) by a duration | |
function divideRangeByDuration(start, end, dur) { | |
var months; | |
if (durationHasTime(dur)) { | |
return (end - start) / dur; | |
} | |
months = dur.asMonths(); | |
if (Math.abs(months) >= 1 && isInt(months)) { | |
return end.diff(start, 'months', true) / months; | |
} | |
return end.diff(start, 'days', true) / dur.asDays(); | |
} | |
// Intelligently divides one duration by another | |
function divideDurationByDuration(dur1, dur2) { | |
var months1, months2; | |
if (durationHasTime(dur1) || durationHasTime(dur2)) { | |
return dur1 / dur2; | |
} | |
months1 = dur1.asMonths(); | |
months2 = dur2.asMonths(); | |
if ( | |
Math.abs(months1) >= 1 && isInt(months1) && | |
Math.abs(months2) >= 1 && isInt(months2) | |
) { | |
return months1 / months2; | |
} | |
return dur1.asDays() / dur2.asDays(); | |
} | |
// Intelligently multiplies a duration by a number | |
function multiplyDuration(dur, n) { | |
var months; | |
if (durationHasTime(dur)) { | |
return moment.duration(dur * n); | |
} | |
months = dur.asMonths(); | |
if (Math.abs(months) >= 1 && isInt(months)) { | |
return moment.duration({ months: months * n }); | |
} | |
return moment.duration({ days: dur.asDays() * n }); | |
} | |
// 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 typeof str === 'string' && | |
/^\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; | |
} | |
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); | |
} | |
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 removeMatching(array, testFunc) { | |
var removeCnt = 0; | |
var i = 0; | |
while (i < array.length) { | |
if (testFunc(array[i])) { // truthy value means *remove* | |
array.splice(i, 1); | |
removeCnt++; | |
} | |
else { | |
i++; | |
} | |
} | |
return removeCnt; | |
} | |
function removeExact(array, exactVal) { | |
var removeCnt = 0; | |
var i = 0; | |
while (i < array.length) { | |
if (array[i] === exactVal) { | |
array.splice(i, 1); | |
removeCnt++; | |
} | |
else { | |
i++; | |
} | |
} | |
return removeCnt; | |
} | |
FC.removeExact = removeExact; | |
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; | |
}; | |
} | |
;; | |
/* | |
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(englishMoment(this), 'YYYY-MM-DD'); | |
} | |
if (this._ambigZone) { | |
return oldMomentFormat(englishMoment(this), 'YYYY-MM-DD[T]HH:mm:ss'); | |
} | |
if (this._fullCalendar) { // enhanced non-ambig moment? | |
// moment.format() doesn't ensure english, but we want to. | |
return oldMomentFormat(englishMoment(this)); | |
} | |
return oldMomentProto.format.apply(this, arguments); | |
}; | |
newMomentProto.toISOString = function() { | |
if (this._ambigTime) { | |
return oldMomentFormat(englishMoment(this), 'YYYY-MM-DD'); | |
} | |
if (this._ambigZone) { | |
return oldMomentFormat(englishMoment(this), 'YYYY-MM-DD[T]HH:mm:ss'); | |
} | |
if (this._fullCalendar) { // enhanced non-ambig moment? | |
// depending on browser, moment might not output english. ensure english. | |
// https://github.com/moment/moment/blob/2.18.1/src/lib/moment/format.js#L22 | |
return oldMomentProto.toISOString.apply(englishMoment(this), arguments); | |
} | |
return oldMomentProto.toISOString.apply(this, arguments); | |
}; | |
function englishMoment(mom) { | |
if (mom.locale() !== 'en') { | |
return mom.clone().locale('en'); | |
} | |
return mom; | |
} | |
;; | |
(function() { | |
// exports | |
FC.formatDate = formatDate; | |
FC.formatRange = formatRange; | |
FC.oldMomentFormat = oldMomentFormat; | |
FC.queryMostGranularFormatUnit = queryMostGranularFormatUnit; | |
// Config | |
// --------------------------------------------------------------------------------------------------------------------- | |
/* | |
Inserted between chunks in the fake ("intermediate") formatting string. | |
Important that it passes as whitespace (\s) because moment often identifies non-standalone months | |
via a regexp with an \s. | |
*/ | |
var PART_SEPARATOR = '\u000b'; // vertical tab | |
/* | |
Inserted as the first character of a literal-text chunk to indicate that the literal text is not actually literal text, | |
but rather, a "special" token that has custom rendering (see specialTokens map). | |
*/ | |
var SPECIAL_TOKEN_MARKER = '\u001f'; // information separator 1 | |
/* | |
Inserted at the beginning and end of a span of text that must have non-zero numeric characters. | |
Handling of these markers is done in a post-processing step at the very end of text rendering. | |
*/ | |
var MAYBE_MARKER = '\u001e'; // information separator 2 | |
var MAYBE_REGEXP = new RegExp(MAYBE_MARKER + '([^' + MAYBE_MARKER + ']*)' + MAYBE_MARKER, 'g'); // must be global | |
/* | |
Addition formatting tokens we want recognized | |
*/ | |
var specialTokens = { | |
t: function(date) { // "a" or "p" | |
return oldMomentFormat(date, 'a').charAt(0); | |
}, | |
T: function(date) { // "A" or "P" | |
return oldMomentFormat(date, 'A').charAt(0); | |
} | |
}; | |
/* | |
The first characters of formatting tokens for units that are 1 day or larger. | |
`value` is for ranking relative size (lower means bigger). | |
`unit` is a normalized unit, used for comparing moments. | |
*/ | |
var largeTokenMap = { | |
Y: { value: 1, unit: 'year' }, | |
M: { value: 2, unit: 'month' }, | |
W: { value: 3, unit: 'week' }, // ISO week | |
w: { value: 3, unit: 'week' }, // local week | |
D: { value: 4, unit: 'day' }, // day of month | |
d: { value: 4, unit: 'day' } // day of week | |
}; | |
// Single Date Formatting | |
// --------------------------------------------------------------------------------------------------------------------- | |
/* | |
Formats `date` with a Moment formatting string, but allow our non-zero areas and special token | |
*/ | |
function formatDate(date, formatStr) { | |
return renderFakeFormatString( | |
getParsedFormatString(formatStr).fakeFormatString, | |
date | |
); | |
} | |
/* | |
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 | |
} | |
// 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". | |
// 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. | |
formatStr = localeData.longDateFormat(formatStr) || formatStr; | |
return renderParsedFormat( | |
getParsedFormatString(formatStr), | |
date1, | |
date2, | |
separator || ' - ', | |
isRTL | |
); | |
} | |
/* | |
Renders a range with an already-parsed format string. | |
*/ | |
function renderParsedFormat(parsedFormat, date1, date2, separator, isRTL) { | |
var sameUnits = parsedFormat.sameUnits; | |
var unzonedDate1 = date1.clone().stripZone(); // for same-unit comparisons | |
var unzonedDate2 = date2.clone().stripZone(); // " | |
var renderedParts1 = renderFakeFormatStringParts(parsedFormat.fakeFormatString, date1); | |
var renderedParts2 = renderFakeFormatStringParts(parsedFormat.fakeFormatString, date2); | |
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 < sameUnits.length && (!sameUnits[leftI] || unzonedDate1.isSame(unzonedDate2, sameUnits[leftI])); | |
leftI++ | |
) { | |
leftStr += renderedParts1[leftI]; | |
} | |
// Similarly, start at the rightmost side of the formatting string and move left | |
for ( | |
rightI = sameUnits.length - 1; | |
rightI > leftI && (!sameUnits[rightI] || unzonedDate1.isSame(unzonedDate2, sameUnits[rightI])); | |
rightI-- | |
) { | |
// If current chunk is on the boundary of unique date-content, and is a special-case | |
// date-formatting postfix character, then don't consume it. Consider it unique date-content. | |
// TODO: make configurable | |
if (rightI - 1 === leftI && renderedParts1[rightI] === '.') { | |
break; | |
} | |
rightStr = renderedParts1[rightI] + 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 += renderedParts1[middleI]; | |
middleStr2 += renderedParts2[middleI]; | |
} | |
if (middleStr1 || middleStr2) { | |
if (isRTL) { | |
middleStr = middleStr2 + separator + middleStr1; | |
} | |
else { | |
middleStr = middleStr1 + separator + middleStr2; | |
} | |
} | |
return processMaybeMarkers( | |
leftStr + middleStr + rightStr | |
); | |
} | |
// Format String Parsing | |
// --------------------------------------------------------------------------------------------------------------------- | |
var parsedFormatStrCache = {}; | |
/* | |
Returns a parsed format string, leveraging a cache. | |
*/ | |
function getParsedFormatString(formatStr) { | |
return parsedFormatStrCache[formatStr] || | |
(parsedFormatStrCache[formatStr] = parseFormatString(formatStr)); | |
} | |
/* | |
Parses a format string into the following: | |
- fakeFormatString: a momentJS formatting string, littered with special control characters that get post-processed. | |
- sameUnits: for every part in fakeFormatString, if the part is a token, the value will be a unit string (like "day"), | |
that indicates how similar a range's start & end must be in order to share the same formatted text. | |
If not a token, then the value is null. | |
Always a flat array (not nested liked "chunks"). | |
*/ | |
function parseFormatString(formatStr) { | |
var chunks = chunkFormatString(formatStr); | |
return { | |
fakeFormatString: buildFakeFormatString(chunks), | |
sameUnits: buildSameUnits(chunks) | |
}; | |
} | |
/* | |
Break the formatting string into an array of chunks. | |
A 'maybe' chunk will have nested chunks. | |
*/ | |
function chunkFormatString(formatStr) { | |
var chunks = []; | |
var match; | |
// TODO: more descrimination | |
// \4 is a backreference to the first character of a multi-character set. | |
var chunker = /\[([^\]]*)\]|\(([^\)]*)\)|(LTS|LT|(\w)\4*o?)|([^\w\[\(]+)/g; | |
while ((match = chunker.exec(formatStr))) { | |
if (match[1]) { // a literal string inside [ ... ] | |
chunks.push.apply(chunks, // append | |
splitStringLiteral(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.apply(chunks, // append | |
splitStringLiteral(match[5]) | |
); | |
} | |
} | |
return chunks; | |
} | |
/* | |
Potentially splits a literal-text string into multiple parts. For special cases. | |
*/ | |
function splitStringLiteral(s) { | |
if (s === '. ') { | |
return [ '.', ' ' ]; // for locales with periods bound to the end of each year/month/date | |
} | |
else { | |
return [ s ]; | |
} | |
} | |
/* | |
Given chunks parsed from a real format string, generate a fake (aka "intermediate") format string with special control | |
characters that will eventually be given to moment for formatting, and then post-processed. | |
*/ | |
function buildFakeFormatString(chunks) { | |
var parts = []; | |
var i, chunk; | |
for (i = 0; i < chunks.length; i++) { | |
chunk = chunks[i]; | |
if (typeof chunk === 'string') { | |
parts.push('[' + chunk + ']'); | |
} | |
else if (chunk.token) { | |
if (chunk.token in specialTokens) { | |
parts.push( | |
SPECIAL_TOKEN_MARKER + // useful during post-processing | |
'[' + chunk.token + ']' // preserve as literal text | |
); | |
} | |
else { | |
parts.push(chunk.token); // unprotected text implies a format string | |
} | |
} | |
else if (chunk.maybe) { | |
parts.push( | |
MAYBE_MARKER + // useful during post-processing | |
buildFakeFormatString(chunk.maybe) + | |
MAYBE_MARKER | |
); | |
} | |
} | |
return parts.join(PART_SEPARATOR); | |
} | |
/* | |
Given parsed chunks from a real formatting string, generates an array of unit strings (like "day") that indicate | |
in which regard two dates must be similar in order to share range formatting text. | |
The `chunks` can be nested (because of "maybe" chunks), however, the returned array will be flat. | |
*/ | |
function buildSameUnits(chunks) { | |
var units = []; | |
var i, chunk; | |
var tokenInfo; | |
for (i = 0; i < chunks.length; i++) { | |
chunk = chunks[i]; | |
if (chunk.token) { | |
tokenInfo = largeTokenMap[chunk.token.charAt(0)]; | |
units.push(tokenInfo ? tokenInfo.unit : 'second'); // default to a very strict same-second | |
} | |
else if (chunk.maybe) { | |
units.push.apply(units, // append | |
buildSameUnits(chunk.maybe) | |
); | |
} | |
else { | |
units.push(null); | |
} | |
} | |
return units; | |
} | |
// Rendering to text | |
// --------------------------------------------------------------------------------------------------------------------- | |
/* | |
Formats a date with a fake format string, post-processes the control characters, then returns. | |
*/ | |
function renderFakeFormatString(fakeFormatString, date) { | |
return processMaybeMarkers( | |
renderFakeFormatStringParts(fakeFormatString, date).join('') | |
); | |
} | |
/* | |
Formats a date into parts that will have been post-processed, EXCEPT for the "maybe" markers. | |
*/ | |
function renderFakeFormatStringParts(fakeFormatString, date) { | |
var parts = []; | |
var fakeRender = oldMomentFormat(date, fakeFormatString); | |
var fakeParts = fakeRender.split(PART_SEPARATOR); | |
var i, fakePart; | |
for (i = 0; i < fakeParts.length; i++) { | |
fakePart = fakeParts[i]; | |
if (fakePart.charAt(0) === SPECIAL_TOKEN_MARKER) { | |
parts.push( | |
// the literal string IS the token's name. | |
// call special token's registered function. | |
specialTokens[fakePart.substring(1)](date) | |
); | |
} | |
else { | |
parts.push(fakePart); | |
} | |
} | |
return parts; | |
} | |
/* | |
Accepts an almost-finally-formatted string and processes the "maybe" control characters, returning a new string. | |
*/ | |
function processMaybeMarkers(s) { | |
return s.replace(MAYBE_REGEXP, function(m0, m1) { // regex assumed to have 'g' flag | |
if (m1.match(/[1-9]/)) { // any non-zero numeric characters? | |
return m1; | |
} | |
else { | |
return ''; | |
} | |
}); | |
} | |
// Misc Utils | |
// ------------------------------------------------------------------------------------------------- | |
/* | |
Returns a unit string, either 'year', 'month', 'day', or null for the most granular formatting token in the string. | |
*/ | |
function queryMostGranularFormatUnit(formatStr) { | |
var chunks = chunkFormatString(formatStr); | |
var i, chunk; | |
var candidate; | |
var best; | |
for (i = 0; i < chunks.length; i++) { | |
chunk = chunks[i]; | |
if (chunk.token) { | |
candidate = largeTokenMap[chunk.token.charAt(0)]; | |
if (candidate) { | |
if (!best || candidate.value > best.value) { | |
best = candidate; | |
} | |
} | |
} | |
} | |
if (best) { | |
return best.unit; | |
} | |
return null; | |
}; | |
})(); | |
// quick local references | |
var formatDate = FC.formatDate; | |
var formatRange = FC.formatRange; | |
var oldMomentFormat = FC.oldMomentFormat; | |
;; | |
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 members = {}; | |
var i; | |
for (i = 0; i < arguments.length; i++) { | |
copyOwnProps(arguments[i], members); | |
} | |
return extendClass(this, members); | |
}; | |
// 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) { | |
copyOwnProps(members, this.prototype); | |
}; | |
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 = Object.create(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; | |
} | |
;; | |
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) { | |
$(this).on(types, this._prepareIntercept(handler)); | |
return this; // for chaining | |
}, | |
one: function(types, handler) { | |
$(this).one(types, this._prepareIntercept(handler)); | |
return this; // for chaining | |
}, | |
_prepareIntercept: function(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; | |
return intercept; | |
}, | |
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 | |
}, | |
hasHandlers: function(type) { | |
var hash = $._data(this, 'events'); // http://blog.jquery.com/2012/08/09/jquery-1-8-released/ | |
return hash && hash[type] && hash[type].length > 0; | |
} | |
}; | |
;; | |
/* | |
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; | |
})(); | |
;; | |
var ParsableModelMixin = { | |
standardPropMap: {}, // will be cloned by allowRawProps | |
/* | |
Returns true/false for success | |
*/ | |
applyRawProps: function(rawProps) { | |
var standardPropMap = this.standardPropMap; | |
var manualProps = {}; | |
var otherProps = {}; | |
var propName; | |
for (propName in rawProps) { | |
if (standardPropMap[propName] === true) { // copy automatically | |
this[propName] = rawProps[propName]; | |
} | |
else if (standardPropMap[propName] === false) { | |
manualProps[propName] = rawProps[propName]; | |
} | |
else { | |
otherProps[propName] = rawProps[propName]; | |
} | |
} | |
this.applyOtherRawProps(otherProps); | |
return this.applyManualRawProps(manualProps); | |
}, | |
/* | |
If subclasses override, they must call this supermethod and return the boolean response. | |
*/ | |
applyManualRawProps: function(rawProps) { | |
return true; | |
}, | |
applyOtherRawProps: function(rawProps) { | |
// subclasses can implement | |
} | |
}; | |
/* | |
TODO: devise a better system | |
*/ | |
var ParsableModelMixin_allowRawProps = function(propDefs) { | |
var proto = this.prototype; | |
proto.standardPropMap = Object.create(proto.standardPropMap); | |
copyOwnProps(propDefs, proto.standardPropMap); | |
}; | |
/* | |
TODO: devise a better system | |
*/ | |
var ParsableModelMixin_copyVerbatimStandardProps = function(src, dest) { | |
var map = this.prototype.standardPropMap; | |
var propName; | |
for (propName in map) { | |
if ( | |
src[propName] != null && // in the src object? | |
map[propName] === true // false means "copy verbatim" | |
) { | |
dest[propName] = src[propName]; | |
} | |
} | |
}; | |
;; | |
var Model = Class.extend(EmitterMixin, ListenerMixin, { | |
_props: null, | |
_watchers: null, | |
_globalWatchArgs: null, | |
constructor: function() { | |
this._watchers = {}; | |
this._props = {}; | |
this.applyGlobalWatchers(); | |
}, | |
applyGlobalWatchers: function() { | |
var argSets = this._globalWatchArgs || []; | |
var i; | |
for (i = 0; i < argSets.length; i++) { | |
this.watch.apply(this, argSets[i]); | |
} | |
}, | |
has: function(name) { | |
return name in this._props; | |
}, | |
get: function(name) { | |
if (name === undefined) { | |
return this._props; | |
} | |
return this._props[name]; | |
}, | |
set: function(name, val) { | |
var newProps; | |
if (typeof name === 'string') { | |
newProps = {}; | |
newProps[name] = val === undefined ? null : val; | |
} | |
else { | |
newProps = name; | |
} | |
this.setProps(newProps); | |
}, | |
reset: function(newProps) { | |
var oldProps = this._props; | |
var changeset = {}; // will have undefined's to signal unsets | |
var name; | |
for (name in oldProps) { | |
changeset[name] = undefined; | |
} | |
for (name in newProps) { | |
changeset[name] = newProps[name]; | |
} | |
this.setProps(changeset); | |
}, | |
unset: function(name) { // accepts a string or array of strings | |
var newProps = {}; | |
var names; | |
var i; | |
if (typeof name === 'string') { | |
names = [ name ]; | |
} | |
else { | |
names = name; | |
} | |
for (i = 0; i < names.length; i++) { | |
newProps[names[i]] = undefined; | |
} | |
this.setProps(newProps); | |
}, | |
setProps: function(newProps) { | |
var changedProps = {}; | |
var changedCnt = 0; | |
var name, val; | |
for (name in newProps) { | |
val = newProps[name]; | |
// a change in value? | |
// if an object, don't check equality, because might have been mutated internally. | |
// TODO: eventually enforce immutability. | |
if ( | |
typeof val === 'object' || | |
val !== this._props[name] | |
) { | |
changedProps[name] = val; | |
changedCnt++; | |
} | |
} | |
if (changedCnt) { | |
this.trigger('before:batchChange', changedProps); | |
for (name in changedProps) { | |
val = changedProps[name]; | |
this.trigger('before:change', name, val); | |
this.trigger('before:change:' + name, val); | |
} | |
for (name in changedProps) { | |
val = changedProps[name]; | |
if (val === undefined) { | |
delete this._props[name]; | |
} | |
else { | |
this._props[name] = val; | |
} | |
this.trigger('change:' + name, val); | |
this.trigger('change', name, val); | |
} | |
this.trigger('batchChange', changedProps); | |
} | |
}, | |
watch: function(name, depList, startFunc, stopFunc) { | |
var _this = this; | |
this.unwatch(name); | |
this._watchers[name] = this._watchDeps(depList, function(deps) { | |
var res = startFunc.call(_this, deps); | |
if (res && res.then) { | |
_this.unset(name); // put in an unset state while resolving | |
res.then(function(val) { | |
_this.set(name, val); | |
}); | |
} | |
else { | |
_this.set(name, res); | |
} | |
}, function() { | |
_this.unset(name); | |
if (stopFunc) { | |
stopFunc.call(_this); | |
} | |
}); | |
}, | |
unwatch: function(name) { | |
var watcher = this._watchers[name]; | |
if (watcher) { | |
delete this._watchers[name]; | |
watcher.teardown(); | |
} | |
}, | |
_watchDeps: function(depList, startFunc, stopFunc) { | |
var _this = this; | |
var queuedChangeCnt = 0; | |
var depCnt = depList.length; | |
var satisfyCnt = 0; | |
var values = {}; // what's passed as the `deps` arguments | |
var bindTuples = []; // array of [ eventName, handlerFunc ] arrays | |
var isCallingStop = false; | |
function onBeforeDepChange(depName, val, isOptional) { | |
queuedChangeCnt++; | |
if (queuedChangeCnt === 1) { // first change to cause a "stop" ? | |
if (satisfyCnt === depCnt) { // all deps previously satisfied? | |
isCallingStop = true; | |
stopFunc(); | |
isCallingStop = false; | |
} | |
} | |
} | |
function onDepChange(depName, val, isOptional) { | |
if (val === undefined) { // unsetting a value? | |
// required dependency that was previously set? | |
if (!isOptional && values[depName] !== undefined) { | |
satisfyCnt--; | |
} | |
delete values[depName]; | |
} | |
else { // setting a value? | |
// required dependency that was previously unset? | |
if (!isOptional && values[depName] === undefined) { | |
satisfyCnt++; | |
} | |
values[depName] = val; | |
} | |
queuedChangeCnt--; | |
if (!queuedChangeCnt) { // last change to cause a "start"? | |
// now finally satisfied or satisfied all along? | |
if (satisfyCnt === depCnt) { | |
// if the stopFunc initiated another value change, ignore it. | |
// it will be processed by another change event anyway. | |
if (!isCallingStop) { | |
startFunc(values); | |
} | |
} | |
} | |
} | |
// intercept for .on() that remembers handlers | |
function bind(eventName, handler) { | |
_this.on(eventName, handler); | |
bindTuples.push([ eventName, handler ]); | |
} | |
// listen to dependency changes | |
depList.forEach(function(depName) { | |
var isOptional = false; | |
if (depName.charAt(0) === '?') { // TODO: more DRY | |
depName = depName.substring(1); | |
isOptional = true; | |
} | |
bind('before:change:' + depName, function(val) { | |
onBeforeDepChange(depName, val, isOptional); | |
}); | |
bind('change:' + depName, function(val) { | |
onDepChange(depName, val, isOptional); | |
}); | |
}); | |
// process current dependency values | |
depList.forEach(function(depName) { | |
var isOptional = false; | |
if (depName.charAt(0) === '?') { // TODO: more DRY | |
depName = depName.substring(1); | |
isOptional = true; | |
} | |
if (_this.has(depName)) { | |
values[depName] = _this.get(depName); | |
satisfyCnt++; | |
} | |
else if (isOptional) { | |
satisfyCnt++; | |
} | |
}); | |
// initially satisfied | |
if (satisfyCnt === depCnt) { | |
startFunc(values); | |
} | |
return { | |
teardown: function() { | |
// remove all handlers | |
for (var i = 0; i < bindTuples.length; i++) { | |
_this.off(bindTuples[i][0], bindTuples[i][1]); | |
} | |
bindTuples = null; | |
// was satisfied, so call stopFunc | |
if (satisfyCnt === depCnt) { | |
stopFunc(); | |
} | |
}, | |
flash: function() { | |
if (satisfyCnt === depCnt) { | |
stopFunc(); | |
startFunc(values); | |
} | |
} | |
}; | |
}, | |
flash: function(name) { | |
var watcher = this._watchers[name]; | |
if (watcher) { | |
watcher.flash(); | |
} | |
} | |
}); | |
Model.watch = function(/* same arguments as this.watch() */) { | |
// creates new array every time, to not mess with subclass prototypes | |
// TODO: make more efficient | |
this.prototype._globalWatchArgs = (this.prototype._globalWatchArgs || []).concat(arguments); | |
}; | |
FC.Model = Model; | |
;; | |
var Promise = { | |
construct: function(executor) { | |
var deferred = $.Deferred(); | |
var promise = deferred.promise(); | |
if (typeof executor === 'function') { | |
executor( | |
function(val) { // resolve | |
deferred.resolve(val); | |
attachImmediatelyResolvingThen(promise, val); | |
}, | |
function() { // reject | |
deferred.reject(); | |
attachImmediatelyRejectingThen(promise); | |
} | |
); | |
} | |
return promise; | |
}, | |
resolve: function(val) { | |
var deferred = $.Deferred().resolve(val); | |
var promise = deferred.promise(); | |
attachImmediatelyResolvingThen(promise, val); | |
return promise; | |
}, | |
reject: function() { | |
var deferred = $.Deferred().reject(); | |
var promise = deferred.promise(); | |
attachImmediatelyRejectingThen(promise); | |
return promise; | |
} | |
}; | |
function attachImmediatelyResolvingThen(promise, val) { | |
promise.then = function(onResolve) { | |
if (typeof onResolve === 'function') { | |
return Promise.resolve(onResolve(val)); | |
} | |
return promise; | |
}; | |
} | |
function attachImmediatelyRejectingThen(promise) { | |
promise.then = function(onResolve, onReject) { | |
if (typeof onReject === 'function') { | |
onReject(); | |
} | |
return promise; | |
}; | |
} | |
FC.Promise = Promise; | |
;; | |
var TaskQueue = Class.extend(EmitterMixin, { | |
q: null, | |
isPaused: false, | |
isRunning: false, | |
constructor: function() { | |
this.q = []; | |
}, | |
queue: function(/* taskFunc, taskFunc... */) { | |
this.q.push.apply(this.q, arguments); // append | |
this.tryStart(); | |
}, | |
pause: function() { | |
this.isPaused = true; | |
}, | |
resume: function() { | |
this.isPaused = false; | |
this.tryStart(); | |
}, | |
tryStart: function() { | |
if (!this.isRunning && this.canRunNext()) { | |
this.isRunning = true; | |
this.trigger('start'); | |
this.runNext(); | |
} | |
}, | |
canRunNext: function() { | |
return !this.isPaused && this.q.length; | |
}, | |
runNext: function() { // does not check canRunNext | |
this.runTask(this.q.shift()); | |
}, | |
runTask: function(task) { | |
this.runTaskFunc(task); | |
}, | |
runTaskFunc: function(taskFunc) { | |
var _this = this; | |
var res = taskFunc(); | |
if (res && res.then) { | |
res.then(done); | |
} | |
else { | |
done(); | |
} | |
function done() { | |
if (_this.canRunNext()) { | |
_this.runNext(); | |
} | |
else { | |
_this.isRunning = false; | |
_this.trigger('stop'); | |
} | |
} | |
} | |
}); | |
FC.TaskQueue = TaskQueue; | |
;; | |
var RenderQueue = TaskQueue.extend({ | |
waitsByNamespace: null, | |
waitNamespace: null, | |
waitId: null, | |
isKilled: false, // prevents any new tasks from being added | |
constructor: function(waitsByNamespace) { | |
TaskQueue.call(this); // super-constructor | |
this.waitsByNamespace = waitsByNamespace || {}; | |
}, | |
/* | |
all args are required | |
*/ | |
queue: function(entityId, namespace, actionType, taskFunc) { | |
if (this.isKilled) { | |
return; | |
} | |
var task = { | |
entityId: entityId, | |
namespace: namespace, | |
actionType: actionType, | |
func: taskFunc | |
}; | |
var waitMs; | |
if (namespace) { | |
waitMs = this.waitsByNamespace[namespace]; | |
} | |
if (this.waitNamespace) { | |
if (namespace === this.waitNamespace && waitMs != null) { | |
this.delayWait(waitMs); | |
} | |
} | |
if (this.compoundTask(task)) { // appended to queue? | |
if (!this.waitNamespace && waitMs != null) { | |
this.startWait(namespace, waitMs); | |
} | |
else { | |
this.tryStart(); | |
} | |
} | |
}, | |
/* | |
Prevents any new tasks from being added AND clears all tasks related to rendering *new* things, | |
however, keeps destroy-related tasks to allow proper cleanup. | |
*/ | |
kill: function() { | |
this.isKilled = true; | |
this.q = this.q.filter(function(task) { | |
return task.actionType === 'destroy'; | |
}); | |
}, | |
startWait: function(namespace, waitMs) { | |
this.waitNamespace = namespace; | |
this.spawnWait(waitMs); | |
}, | |
delayWait: function(waitMs) { | |
clearTimeout(this.waitId); | |
this.spawnWait(waitMs); | |
}, | |
spawnWait: function(waitMs) { | |
var _this = this; | |
this.waitId = setTimeout(function() { | |
_this.waitNamespace = null; | |
_this.tryStart(); | |
}, waitMs); | |
}, | |
canRunNext: function() { | |
return TaskQueue.prototype.canRunNext.apply(this, arguments) && | |
!this.isKilled && | |
(!this.waitNamespace || this.q[0].namespace !== this.waitNamespace); | |
}, | |
runTask: function(task) { | |
this.runTaskFunc(task.func); | |
}, | |
compoundTask: function(newTask) { | |
var q = this.q; | |
var shouldAppend = true; | |
var i, task; | |
if (newTask.actionType === 'destroy') { | |
// remove ops with same entityId and namespace | |
for (i = q.length - 1; i >= 0; i--) { | |
task = q[i]; | |
if ( | |
task.entityId === newTask.entityId && | |
task.namespace === newTask.namespace | |
) { | |
if (task.actionType === 'init') { // cancels out the destroy | |
shouldAppend = false; | |
} | |
q.splice(i, 1); // remove task | |
} | |
} | |
} | |
if (shouldAppend) { | |
q.push(newTask); | |
} | |
return shouldAppend; | |
} | |
}); | |
FC.RenderQueue = RenderQueue; | |
;; | |
/* 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; | |
if (!offsetParentEl && this.els.length > 0) { | |
offsetParentEl = this.els.eq(0).offsetParent(); | |
} | |
this.origin = offsetParentEl ? | |
offsetParentEl.offset() : | |
null; | |
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. | |
// Returns null if there are no elements | |
queryBoundingRect: function() { | |
var scrollParentEl; | |
if (this.els.length > 0) { | |
scrollParentEl = getScrollParent(this.els.eq(0)); | |
if (!scrollParentEl.is(document)) { | |
return getClientRect(scrollParentEl); | |
} | |
} | |
return null; | |
}, | |
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, { | |
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, | |
isGeneric: false, // initiated by 'dragstart' (jqui) | |
delay: null, | |
delayTimeoutId: null, | |
minDistance: null, | |
shouldCancelTouchScroll: true, | |
scrollAlwaysKills: false, | |
constructor: function(options) { | |
this.options = options || {}; | |
}, | |
// Interaction (high-level) | |
// ----------------------------------------------------------------------------------------------------------------- | |
startInteraction: function(ev, extraOptions) { | |
if (ev.type === 'mousedown') { | |
if (GlobalEmitter.get().shouldIgnoreMouse()) { | |
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; | |
preventSelection($('body')); | |
this.isInteracting = true; | |
this.isTouch = getEvIsTouch(ev); | |
this.isGeneric = ev.type === 'dragstart'; | |
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); | |
allowSelection($('body')); | |
} | |
}, | |
handleInteractionEnd: function(ev, isCancelled) { | |
this.trigger('interactionEnd', ev, isCancelled || false); | |
}, | |
// Binding To DOM | |
// ----------------------------------------------------------------------------------------------------------------- | |
bindHandlers: function() { | |
// some browsers (Safari in iOS 10) don't allow preventDefault on touch events that are bound after touchstart, | |
// so listen to the GlobalEmitter singleton, which is always bound, instead of the document directly. | |
var globalEmitter = GlobalEmitter.get(); | |
if (this.isGeneric) { | |
this.listenTo($(document), { // might only work on iOS because of GlobalEmitter's bind :( | |
drag: this.handleMove, | |
dragstop: this.endInteraction | |
}); | |
} | |
else if (this.isTouch) { | |
this.listenTo(globalEmitter, { | |
touchmove: this.handleTouchMove, | |
touchend: this.endInteraction, | |
scroll: this.handleTouchScroll | |
}); | |
} | |
else { | |
this.listenTo(globalEmitter, { | |
mousemove: this.handleMouseMove, | |
mouseup: this.endInteraction | |
}); | |
} | |
this.listenTo(globalEmitter, { | |
selectstart: preventDefault, // don't allow selection while dragging | |
contextmenu: preventDefault // long taps would open menu on Chrome dev tools | |
}); | |
}, | |
unbindHandlers: function() { | |
this.stopListeningTo(GlobalEmitter.get()); | |
this.stopListeningTo($(document)); // for isGeneric | |
}, | |
// 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 && this.shouldCancelTouchScroll) { | |
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.scrollAlwaysKills) { | |
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: hitsNeeded, hitsNotNeeded, 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.component.hitsNeeded(); | |
this.computeScrollBounds(); // for autoscroll | |
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); | |
}, | |
// 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.hitsNotNeeded(); | |
}, | |
// 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 | |
// hits' absolute positions will be in new places after a user's scroll. | |
// HACK for recomputing. | |
if (this.isDragging) { | |
this.component.releaseHits(); | |
this.component.prepareHits(); | |
} | |
}, | |
// 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; | |
} | |
;; | |
/* | |
Listens to document and window-level user-interaction events, like touch events and mouse events, | |
and fires these events as-is to whoever is observing a GlobalEmitter. | |
Best when used as a singleton via GlobalEmitter.get() | |
Normalizes mouse/touch events. For examples: | |
- ignores the the simulated mouse events that happen after a quick tap: mousemove+mousedown+mouseup+click | |
- compensates for various buggy scenarios where a touchend does not fire | |
*/ | |
FC.touchMouseIgnoreWait = 500; | |
var GlobalEmitter = Class.extend(ListenerMixin, EmitterMixin, { | |
isTouching: false, | |
mouseIgnoreDepth: 0, | |
handleScrollProxy: null, | |
bind: function() { | |
var _this = this; | |
this.listenTo($(document), { | |
touchstart: this.handleTouchStart, | |
touchcancel: this.handleTouchCancel, | |
touchend: this.handleTouchEnd, | |
mousedown: this.handleMouseDown, | |
mousemove: this.handleMouseMove, | |
mouseup: this.handleMouseUp, | |
click: this.handleClick, | |
selectstart: this.handleSelectStart, | |
contextmenu: this.handleContextMenu | |
}); | |
// because we need to call preventDefault | |
// because https://www.chromestatus.com/features/5093566007214080 | |
// TODO: investigate performance because this is a global handler | |
window.addEventListener( | |
'touchmove', | |
this.handleTouchMoveProxy = function(ev) { | |
_this.handleTouchMove($.Event(ev)); | |
}, | |
{ passive: false } // allows preventDefault() | |
); | |
// attach a handler to get called when ANY scroll action happens on the page. | |
// this was impossible to do with normal on/off because 'scroll' doesn't bubble. | |
// http://stackoverflow.com/a/32954565/96342 | |
window.addEventListener( | |
'scroll', | |
this.handleScrollProxy = function(ev) { | |
_this.handleScroll($.Event(ev)); | |
}, | |
true // useCapture | |
); | |
}, | |
unbind: function() { | |
this.stopListeningTo($(document)); | |
window.removeEventListener( | |
'touchmove', | |
this.handleTouchMoveProxy | |
); | |
window.removeEventListener( | |
'scroll', | |
this.handleScrollProxy, | |
true // useCapture | |
); | |
}, | |
// Touch Handlers | |
// ----------------------------------------------------------------------------------------------------------------- | |
handleTouchStart: function(ev) { | |
// if a previous touch interaction never ended with a touchend, then implicitly end it, | |
// but since a new touch interaction is about to begin, don't start the mouse ignore period. | |
this.stopTouch(ev, true); // skipMouseIgnore=true | |
this.isTouching = true; | |
this.trigger('touchstart', ev); | |
}, | |
handleTouchMove: function(ev) { | |
if (this.isTouching) { | |
this.trigger('touchmove', ev); | |
} | |
}, | |
handleTouchCancel: function(ev) { | |
if (this.isTouching) { | |
this.trigger('touchcancel', ev); | |
// Have touchcancel fire an artificial touchend. That way, handlers won't need to listen to both. | |
// If touchend fires later, it won't have any effect b/c isTouching will be false. | |
this.stopTouch(ev); | |
} | |
}, | |
handleTouchEnd: function(ev) { | |
this.stopTouch(ev); | |
}, | |
// Mouse Handlers | |
// ----------------------------------------------------------------------------------------------------------------- | |
handleMouseDown: function(ev) { | |
if (!this.shouldIgnoreMouse()) { | |
this.trigger('mousedown', ev); | |
} | |
}, | |
handleMouseMove: function(ev) { | |
if (!this.shouldIgnoreMouse()) { | |
this.trigger('mousemove', ev); | |
} | |
}, | |
handleMouseUp: function(ev) { | |
if (!this.shouldIgnoreMouse()) { | |
this.trigger('mouseup', ev); | |
} | |
}, | |
handleClick: function(ev) { | |
if (!this.shouldIgnoreMouse()) { | |
this.trigger('click', ev); | |
} | |
}, | |
// Misc Handlers | |
// ----------------------------------------------------------------------------------------------------------------- | |
handleSelectStart: function(ev) { | |
this.trigger('selectstart', ev); | |
}, | |
handleContextMenu: function(ev) { | |
this.trigger('contextmenu', ev); | |
}, | |
handleScroll: function(ev) { | |
this.trigger('scroll', ev); | |
}, | |
// Utils | |
// ----------------------------------------------------------------------------------------------------------------- | |
stopTouch: function(ev, skipMouseIgnore) { | |
if (this.isTouching) { | |
this.isTouching = false; | |
this.trigger('touchend', ev); | |
if (!skipMouseIgnore) { | |
this.startTouchMouseIgnore(); | |
} | |
} | |
}, | |
startTouchMouseIgnore: function() { | |
var _this = this; | |
var wait = FC.touchMouseIgnoreWait; | |
if (wait) { | |
this.mouseIgnoreDepth++; | |
setTimeout(function() { | |
_this.mouseIgnoreDepth--; | |
}, wait); | |
} | |
}, | |
shouldIgnoreMouse: function() { | |
return this.isTouching || Boolean(this.mouseIgnoreDepth); | |
} | |
}); | |
// Singleton | |
// --------------------------------------------------------------------------------------------------------------------- | |
(function() { | |
var globalEmitter = null; | |
var neededCount = 0; | |
// gets the singleton | |
GlobalEmitter.get = function() { | |
if (!globalEmitter) { | |
globalEmitter = new GlobalEmitter(); | |
globalEmitter.bind(); | |
} | |
return globalEmitter; | |
}; | |
// called when an object knows it will need a GlobalEmitter in the near future. | |
GlobalEmitter.needed = function() { | |
GlobalEmitter.get(); // ensures globalEmitter | |
neededCount++; | |
}; | |
// called when the object that originally called needed() doesn't need a GlobalEmitter anymore. | |
GlobalEmitter.unneeded = function() { | |
neededCount--; | |
if (!neededCount) { // nobody else needs it | |
globalEmitter.unbind(); | |
globalEmitter = null; | |
} | |
}; | |
})(); | |
;; | |
/* 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(); | |
} | |
} | |
}); | |
;; | |
/* | |
Embodies a div that has potential scrollbars | |
*/ | |
var Scroller = FC.Scroller = Class.extend({ | |
el: null, // the guaranteed outer element | |
scrollEl: null, // the element with the scrollbars | |
overflowX: null, | |
overflowY: null, | |
constructor: function(options) { | |
options = options || {}; | |
this.overflowX = options.overflowX || options.overflow || 'auto'; | |
this.overflowY = options.overflowY || options.overflow || 'auto'; | |
}, | |
render: function() { | |
this.el = this.renderEl(); | |
this.applyOverflow(); | |
}, | |
renderEl: function() { | |
return (this.scrollEl = $('<div class="fc-scroller"></div>')); | |
}, | |
// sets to natural height, unlocks overflow | |
clear: function() { | |
this.setHeight('auto'); | |
this.applyOverflow(); | |
}, | |
destroy: function() { | |
this.el.remove(); | |
}, | |
// Overflow | |
// ----------------------------------------------------------------------------------------------------------------- | |
applyOverflow: function() { | |
this.scrollEl.css({ | |
'overflow-x': this.overflowX, | |
'overflow-y': this.overflowY | |
}); | |
}, | |
// Causes any 'auto' overflow values to resolves to 'scroll' or 'hidden'. | |
// Useful for preserving scrollbar widths regardless of future resizes. | |
// Can pass in scrollbarWidths for optimization. | |
lockOverflow: function(scrollbarWidths) { | |
var overflowX = this.overflowX; | |
var overflowY = this.overflowY; | |
scrollbarWidths = scrollbarWidths || this.getScrollbarWidths(); | |
if (overflowX === 'auto') { | |
overflowX = ( | |
scrollbarWidths.top || scrollbarWidths.bottom || // horizontal scrollbars? | |
// OR scrolling pane with massless scrollbars? | |
this.scrollEl[0].scrollWidth - 1 > this.scrollEl[0].clientWidth | |
// subtract 1 because of IE off-by-one issue | |
) ? 'scroll' : 'hidden'; | |
} | |
if (overflowY === 'auto') { | |
overflowY = ( | |
scrollbarWidths.left || scrollbarWidths.right || // vertical scrollbars? | |
// OR scrolling pane with massless scrollbars? | |
this.scrollEl[0].scrollHeight - 1 > this.scrollEl[0].clientHeight | |
// subtract 1 because of IE off-by-one issue | |
) ? 'scroll' : 'hidden'; | |
} | |
this.scrollEl.css({ 'overflow-x': overflowX, 'overflow-y': overflowY }); | |
}, | |
// Getters / Setters | |
// ----------------------------------------------------------------------------------------------------------------- | |
setHeight: function(height) { | |
this.scrollEl.height(height); | |
}, | |
getScrollTop: function() { | |
return this.scrollEl.scrollTop(); | |
}, | |
setScrollTop: function(top) { | |
this.scrollEl.scrollTop(top); | |
}, | |
getClientWidth: function() { | |
return this.scrollEl[0].clientWidth; | |
}, | |
getClientHeight: function() { | |
return this.scrollEl[0].clientHeight; | |
}, | |
getScrollbarWidths: function() { | |
return getScrollbarWidths(this.scrollEl); | |
} | |
}); | |
;; | |
function Iterator(items) { | |
this.items = items || []; | |
} | |
/* Calls a method on every item passing the arguments through */ | |
Iterator.prototype.proxyCall = function(methodName) { | |
var args = Array.prototype.slice.call(arguments, 1); | |
var results = []; | |
this.items.forEach(function(item) { | |
results.push(item[methodName].apply(item, args)); | |
}); | |
return results; | |
}; | |
;; | |
function buildMessageAggregator(parent, initName, destroyName) { | |
var childCnt = 0; | |
var reportCnt = 0; | |
parent.on(initName, up); | |
parent.on('before:' + destroyName, down); | |
function addChild(child) { | |
child.on('all:' + initName, up); | |
child.on('before:all:' + destroyName, down); | |
childCnt++; | |
} | |
function up() { | |
if (++reportCnt === childCnt + 1) { | |
parent.trigger('all:' + initName); | |
} | |
} | |
function down() { | |
if (--reportCnt === childCnt) { | |
parent.trigger('before:all:' + destroyName); | |
} | |
} | |
return { addChild: addChild }; | |
} | |
;; | |
var Interaction = Class.extend({ | |
view: null, | |
component: null, | |
constructor: function(component) { | |
this.view = component._getView(); | |
this.component = component; | |
}, | |
opt: function(name) { | |
return this.view.opt(name); | |
}, | |
end: function() { | |
// subclasses can implement | |
} | |
}); | |
;; | |
var DateClicking = Interaction.extend({ | |
dragListener: null, | |
/* | |
component must implement: | |
- bindDateHandlerToEl | |
- getSafeHitFootprint | |
- getHitEl | |
*/ | |
constructor: function(component) { | |
Interaction.call(this, component); | |
this.dragListener = this.buildDragListener(); | |
}, | |
end: function() { | |
this.dragListener.endInteraction(); | |
}, | |
bindToEl: function(el) { | |
var component = this.component; | |
var dragListener = this.dragListener; | |
component.bindDateHandlerToEl(el, 'mousedown', function(ev) { | |
if (!component.shouldIgnoreMouse()) { | |
dragListener.startInteraction(ev); | |
} | |
}); | |
component.bindDateHandlerToEl(el, 'touchstart', function(ev) { | |
if (!component.shouldIgnoreTouch()) { | |
dragListener.startInteraction(ev); | |
} | |
}); | |
}, | |
// Creates a listener that tracks the user's drag across day elements, for day clicking. | |
buildDragListener: function() { | |
var _this = this; | |
var component = this.component; | |
var dayClickHit; // null if invalid dayClick | |
var dragListener = new HitDragListener(component, { | |
scroll: this.opt('dragScroll'), | |
interactionStart: function() { | |
dayClickHit = dragListener.origHit; | |
}, | |
hitOver: function(hit, isOrig, origHit) { | |
// if user dragged to another cell at any point, it can no longer be a dayClick | |
if (!isOrig) { | |
dayClickHit = null; | |
} | |
}, | |
hitOut: function() { // called before mouse moves to a different hit OR moved out of all hits | |
dayClickHit = null; | |
}, | |
interactionEnd: function(ev, isCancelled) { | |
var componentFootprint; | |
if (!isCancelled && dayClickHit) { | |
componentFootprint = component.getSafeHitFootprint(dayClickHit); | |
if (componentFootprint) { | |
_this.view.triggerDayClick(componentFootprint, component.getHitEl(dayClickHit), ev); | |
} | |
} | |
} | |
}); | |
// because dragListener won't be called with any time delay, "dragging" will begin immediately, | |
// which will kill any touchmoving/scrolling. Prevent this. | |
dragListener.shouldCancelTouchScroll = false; | |
dragListener.scrollAlwaysKills = true; | |
return dragListener; | |
} | |
}); | |
;; | |
var DateSelecting = Interaction.extend({ | |
dragListener: null, | |
/* | |
component must implement: | |
- bindDateHandlerToEl | |
- getSafeHitFootprint | |
- renderHighlight | |
- unrenderHighlight | |
*/ | |
constructor: function(component) { | |
Interaction.call(this, component); | |
this.dragListener = this.buildDragListener(); | |
}, | |
end: function() { | |
this.dragListener.endInteraction(); | |
}, | |
getDelay: function() { | |
var delay = this.opt('selectLongPressDelay'); | |
if (delay == null) { | |
delay = this.opt('longPressDelay'); // fallback | |
} | |
return delay; | |
}, | |
bindToEl: function(el) { | |
var _this = this; | |
var component = this.component; | |
var dragListener = this.dragListener; | |
component.bindDateHandlerToEl(el, 'mousedown', function(ev) { | |
if (_this.opt('selectable') && !component.shouldIgnoreMouse()) { | |
dragListener.startInteraction(ev, { | |
distance: _this.opt('selectMinDistance') | |
}); | |
} | |
}); | |
component.bindDateHandlerToEl(el, 'touchstart', function(ev) { | |
if (_this.opt('selectable') && !component.shouldIgnoreTouch()) { | |
dragListener.startInteraction(ev, { | |
delay: _this.getDelay() | |
}); | |
} | |
}); | |
preventSelection(el); | |
}, | |
// Creates a listener that tracks the user's drag across day elements, for day selecting. | |
buildDragListener: function() { | |
var _this = this; | |
var component = this.component; | |
var selectionFootprint; // null if invalid selection | |
var dragListener = new HitDragListener(component, { | |
scroll: this.opt('dragScroll'), | |
interactionStart: function() { | |
selectionFootprint = null; | |
}, | |
dragStart: function() { | |
_this.view.unselect(); // since we could be rendering a new selection, we want to clear any old one | |
}, | |
hitOver: function(hit, isOrig, origHit) { | |
var origHitFootprint; | |
var hitFootprint; | |
if (origHit) { // click needs to have started on a hit | |
origHitFootprint = component.getSafeHitFootprint(origHit); | |
hitFootprint = component.getSafeHitFootprint(hit); | |
if (origHitFootprint && hitFootprint) { | |
selectionFootprint = _this.computeSelection(origHitFootprint, hitFootprint); | |
} | |
else { | |
selectionFootprint = null; | |
} | |
if (selectionFootprint) { | |
component.renderSelectionFootprint(selectionFootprint); | |
} | |
else if (selectionFootprint === false) { | |
disableCursor(); | |
} | |
} | |
}, | |
hitOut: function() { // called before mouse moves to a different hit OR moved out of all hits | |
selectionFootprint = null; | |
component.unrenderSelection(); | |
}, | |
hitDone: function() { // called after a hitOut OR before a dragEnd | |
enableCursor(); | |
}, | |
interactionEnd: function(ev, isCancelled) { | |
if (!isCancelled && selectionFootprint) { | |
// the selection will already have been rendered. just report it | |
_this.view.reportSelection(selectionFootprint, ev); | |
} | |
} | |
}); | |
return dragListener; | |
}, | |
// 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 renderSelectionFootprint(). | |
// 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(footprint0, footprint1) { | |
var wholeFootprint = this.computeSelectionFootprint(footprint0, footprint1); | |
if (wholeFootprint && !this.isSelectionFootprintAllowed(wholeFootprint)) { | |
return false; | |
} | |
return wholeFootprint; | |
}, | |
// Given two spans, must return the combination of the two. | |
// TODO: do this separation of concerns (combining VS validation) for event dnd/resize too. | |
// Assumes both footprints are non-open-ended. | |
computeSelectionFootprint: function(footprint0, footprint1) { | |
var ms = [ | |
footprint0.unzonedRange.startMs, | |
footprint0.unzonedRange.endMs, | |
footprint1.unzonedRange.startMs, | |
footprint1.unzonedRange.endMs | |
]; | |
ms.sort(compareNumbers); | |
return new ComponentFootprint( | |
new UnzonedRange(ms[0], ms[3]), | |
footprint0.isAllDay | |
); | |
}, | |
isSelectionFootprintAllowed: function(componentFootprint) { | |
return this.component.get('dateProfile').validUnzonedRange.containsRange(componentFootprint.unzonedRange) && | |
this.view.calendar.isSelectionFootprintAllowed(componentFootprint); | |
} | |
}); | |
;; | |
var EventDragging = Interaction.extend({ | |
dragListener: null, | |
isDragging: false, | |
/* | |
component impements: | |
- bindSegHandlerToEl | |
- publiclyTrigger | |
- diffDates | |
- eventRangesToEventFootprints | |
- isEventInstanceGroupAllowed | |
- eventPointing (!) | |
*/ | |
end: function() { | |
if (this.dragListener) { | |
this.dragListener.endInteraction(); | |
} | |
}, | |
getSelectionDelay: function() { | |
var delay = this.opt('eventLongPressDelay'); | |
if (delay == null) { | |
delay = this.opt('longPressDelay'); // fallback | |
} | |
return delay; | |
}, | |
bindToEl: function(el) { | |
var component = this.component; | |
component.bindSegHandlerToEl(el, 'mousedown', this.handleMousedown.bind(this)); | |
component.bindSegHandlerToEl(el, 'touchstart', this.handleTouchStart.bind(this)); | |
}, | |
handleMousedown: function(seg, ev) { | |
if (this.component.canStartDrag(seg, ev)) { | |
this.buildDragListener(seg).startInteraction(ev, { distance: 5 }); | |
} | |
}, | |
handleTouchStart: function(seg, ev) { | |
var component = this.component; | |
var settings = { | |
delay: this.view.isEventDefSelected(seg.footprint.eventDef) ? // already selected? | |
0 : this.getSelectionDelay() | |
}; | |
if (component.canStartDrag(seg, ev)) { | |
this.buildDragListener(seg).startInteraction(ev, settings); | |
} | |
else if (component.canStartSelection(seg, ev)) { | |
this.buildSelectListener(seg).startInteraction(ev, settings); | |
} | |
}, | |
// 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 `dragListener` | |
buildSelectListener: function(seg) { | |
var _this = this; | |
var view = this.view; | |
var eventDef = seg.footprint.eventDef; | |
var eventInstance = seg.footprint.eventInstance; // null for inverse-background events | |
if (this.dragListener) { | |
return this.dragListener; | |
} | |
var dragListener = this.dragListener = new DragListener({ | |
dragStart: function(ev) { | |
if ( | |
dragListener.isTouch && | |
!view.isEventDefSelected(eventDef) && | |
eventInstance | |
) { | |
// if not previously selected, will fire after a delay. then, select the event | |
view.selectEventInstance(eventInstance); | |
} | |
}, | |
interactionEnd: function(ev) { | |
_this.dragListener = null; | |
} | |
}); | |
return dragListener; | |
}, | |
// 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 `dragListener` | |
buildDragListener: function(seg) { | |
var _this = this; | |
var component = this.component; | |
var view = this.view; | |
var calendar = view.calendar; | |
var eventManager = calendar.eventManager; | |
var el = seg.el; | |
var eventDef = seg.footprint.eventDef; | |
var eventInstance = seg.footprint.eventInstance; // null for inverse-background events | |
var isDragging; | |
var mouseFollower; // A clone of the original element that will move with the mouse | |
var eventDefMutation; | |
if (this.dragListener) { | |
return this.dragListener; | |
} | |
// Tracks mouse movement over the *view's* coordinate map. Allows dragging and dropping between subcomponents | |
// of the view. | |
var dragListener = this.dragListener = new HitDragListener(view, { | |
scroll: this.opt('dragScroll'), | |
subjectEl: el, | |
subjectCenter: true, | |
interactionStart: function(ev) { | |
seg.component = component; // for renderDrag | |
isDragging = false; | |
mouseFollower = new MouseFollower(seg.el, { | |
additionalClass: 'fc-dragging', | |
parentEl: view.el, | |
opacity: dragListener.isTouch ? null : _this.opt('dragOpacity'), | |
revertDuration: _this.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.isEventDefSelected(eventDef) && | |
eventInstance | |
) { | |
// if not previously selected, will fire after a delay. then, select the event | |
view.selectEventInstance(eventInstance); | |
} | |
isDragging = true; | |
// ensure a mouseout on the manipulated event has been reported | |
// TODO: okay to call this? | |
component.eventPointing.handleMouseout(seg, ev); | |
_this.segDragStart(seg, ev); | |
view.hideEventsWithId(eventDef.id); // hide all event segments. our mouseFollower will take over | |
}, | |
hitOver: function(hit, isOrig, origHit) { | |
var isAllowed = true; | |
var origFootprint; | |
var footprint; | |
var mutatedEventInstanceGroup; | |
// starting hit could be forced (DayGrid.limit) | |
if (seg.hit) { | |
origHit = seg.hit; | |
} | |
// hit might not belong to this grid, so query origin grid | |
origFootprint = origHit.component.getSafeHitFootprint(origHit); | |
footprint = hit.component.getSafeHitFootprint(hit); | |
if (origFootprint && footprint) { | |
eventDefMutation = _this.computeEventDropMutation(origFootprint, footprint, eventDef); | |
if (eventDefMutation) { | |
mutatedEventInstanceGroup = eventManager.buildMutatedEventInstanceGroup( | |
eventDef.id, | |
eventDefMutation | |
); | |
isAllowed = component.isEventInstanceGroupAllowed(mutatedEventInstanceGroup); | |
} | |
else { | |
isAllowed = false; | |
} | |
} | |
else { | |
isAllowed = false; | |
} | |
if (!isAllowed) { | |
eventDefMutation = null; | |
disableCursor(); | |
} | |
// if a valid drop location, have the subclass render a visual indication | |
if ( | |
eventDefMutation && | |
view.renderDrag( // truthy if rendered something | |
component.eventRangesToEventFootprints( | |
mutatedEventInstanceGroup.sliceRenderRanges(component.get('dateProfile').renderUnzonedRange, calendar) | |
), | |
seg, | |
dragListener.isTouch | |
) | |
) { | |
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) { | |
// needs to have moved hits to be a valid drop | |
eventDefMutation = null; | |
} | |
}, | |
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 | |
eventDefMutation = 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(!eventDefMutation, function() { | |
if (isDragging) { | |
view.unrenderDrag(); | |
_this.segDragStop(seg, ev); | |
} | |
if (eventDefMutation) { | |
// no need to re-show original, will rerender all anyways. esp important if eventRenderWait | |
view.reportEventDrop(eventInstance, eventDefMutation, el, ev); | |
} | |
else { | |
view.showEventsWithId(eventDef.id); | |
} | |
}); | |
_this.dragListener = null; | |
} | |
}); | |
return dragListener; | |
}, | |
// Called before event segment dragging starts | |
segDragStart: function(seg, ev) { | |
this.isDragging = true; | |
this.component.publiclyTrigger('eventDragStart', { | |
context: seg.el[0], | |
args: [ | |
seg.footprint.getEventLegacy(), | |
ev, | |
{}, // jqui dummy | |
this.view | |
] | |
}); | |
}, | |
// Called after event segment dragging stops | |
segDragStop: function(seg, ev) { | |
this.isDragging = false; | |
this.component.publiclyTrigger('eventDragStop', { | |
context: seg.el[0], | |
args: [ | |
seg.footprint.getEventLegacy(), | |
ev, | |
{}, // jqui dummy | |
this.view | |
] | |
}); | |
}, | |
// DOES NOT consider overlap/constraint | |
computeEventDropMutation: function(startFootprint, endFootprint, eventDef) { | |
var date0 = startFootprint.unzonedRange.getStart(); | |
var date1 = endFootprint.unzonedRange.getStart(); | |
var clearEnd = false; | |
var forceTimed = false; | |
var forceAllDay = false; | |
var dateDelta; | |
var dateMutation; | |
var eventDefMutation; | |
if (startFootprint.isAllDay !== endFootprint.isAllDay) { | |
clearEnd = true; | |
if (endFootprint.isAllDay) { | |
forceAllDay = true; | |
date0.stripTime(); | |
} | |
else { | |
forceTimed = true; | |
} | |
} | |
dateDelta = this.component.diffDates(date1, date0); | |
dateMutation = new EventDefDateMutation(); | |
dateMutation.clearEnd = clearEnd; | |
dateMutation.forceTimed = forceTimed; | |
dateMutation.forceAllDay = forceAllDay; | |
dateMutation.setDateDelta(dateDelta); | |
eventDefMutation = new EventDefMutation(); | |
eventDefMutation.setDateMutation(dateMutation); | |
return eventDefMutation; | |
} | |
}); | |
;; | |
var EventResizing = Interaction.extend({ | |
dragListener: null, | |
isResizing: false, | |
/* | |
component impements: | |
- bindSegHandlerToEl | |
- publiclyTrigger | |
- diffDates | |
- eventRangesToEventFootprints | |
- isEventInstanceGroupAllowed | |
- getSafeHitFootprint | |
- eventPointing (!) | |
*/ | |
end: function() { | |
if (this.dragListener) { | |
this.dragListener.endInteraction(); | |
} | |
}, | |
bindToEl: function(el) { | |
var component = this.component; | |
component.bindSegHandlerToEl(el, 'mousedown', this.handleMouseDown.bind(this)); | |
component.bindSegHandlerToEl(el, 'touchstart', this.handleTouchStart.bind(this)); | |
}, | |
handleMouseDown: function(seg, ev) { | |
if (this.component.canStartResize(seg, ev)) { | |
this.buildDragListener(seg, $(ev.target).is('.fc-start-resizer')) | |
.startInteraction(ev, { distance: 5 }); | |
} | |
}, | |
handleTouchStart: function(seg, ev) { | |
if (this.component.canStartResize(seg, ev)) { | |
this.buildDragListener(seg, $(ev.target).is('.fc-start-resizer')) | |
.startInteraction(ev); | |
} | |
}, | |
// Creates a listener that tracks the user as they resize an event segment. | |
// Generic enough to work with any type of Grid. | |
buildDragListener: function(seg, isStart) { | |
var _this = this; | |
var component = this.component; | |
var view = this.view; | |
var calendar = view.calendar; | |
var eventManager = calendar.eventManager; | |
var el = seg.el; | |
var eventDef = seg.footprint.eventDef; | |
var eventInstance = seg.footprint.eventInstance; | |
var isDragging; | |
var resizeMutation; // zoned event date properties. falsy if invalid resize | |
// Tracks mouse movement over the *grid's* coordinate map | |
var dragListener = this.dragListener = new HitDragListener(component, { | |
scroll: this.opt('dragScroll'), | |
subjectEl: el, | |
interactionStart: function() { | |
isDragging = false; | |
}, | |
dragStart: function(ev) { | |
isDragging = true; | |
// ensure a mouseout on the manipulated event has been reported | |
// TODO: okay to call this? | |
component.eventPointing.handleMouseout(seg, ev); | |
_this.segResizeStart(seg, ev); | |
}, | |
hitOver: function(hit, isOrig, origHit) { | |
var isAllowed = true; | |
var origHitFootprint = component.getSafeHitFootprint(origHit); | |
var hitFootprint = component.getSafeHitFootprint(hit); | |
var mutatedEventInstanceGroup; | |
if (origHitFootprint && hitFootprint) { | |
resizeMutation = isStart ? | |
_this.computeEventStartResizeMutation(origHitFootprint, hitFootprint, seg.footprint) : | |
_this.computeEventEndResizeMutation(origHitFootprint, hitFootprint, seg.footprint); | |
if (resizeMutation) { | |
mutatedEventInstanceGroup = eventManager.buildMutatedEventInstanceGroup( | |
eventDef.id, | |
resizeMutation | |
); | |
isAllowed = component.isEventInstanceGroupAllowed(mutatedEventInstanceGroup); | |
} | |
else { | |
isAllowed = false; | |
} | |
} | |
else { | |
isAllowed = false; | |
} | |
if (!isAllowed) { | |
resizeMutation = null; | |
disableCursor(); | |
} | |
else if (resizeMutation.isEmpty()) { | |
// no change. (FYI, event dates might have zones) | |
resizeMutation = null; | |
} | |
if (resizeMutation) { | |
view.hideEventsWithId(eventDef.id); | |
component.renderEventResize( | |
component.eventRangesToEventFootprints( | |
mutatedEventInstanceGroup.sliceRenderRanges(component.get('dateProfile').renderUnzonedRange, calendar) | |
), | |
seg | |
); | |
} | |
}, | |
hitOut: function() { // called before mouse moves to a different hit OR moved out of all hits | |
resizeMutation = null; | |
view.showEventsWithId(eventDef.id); // for when out-of-bounds. show original | |
}, | |
hitDone: function() { // resets the rendering to show the original event | |
component.unrenderEventResize(); | |
enableCursor(); | |
}, | |
interactionEnd: function(ev) { | |
if (isDragging) { | |
_this.segResizeStop(seg, ev); | |
} | |
if (resizeMutation) { // valid date to resize to? | |
// no need to re-show original, will rerender all anyways. esp important if eventRenderWait | |
view.reportEventResize(eventInstance, resizeMutation, el, ev); | |
} | |
else { | |
view.showEventsWithId(eventDef.id); | |
} | |
_this.dragListener = null; | |
} | |
}); | |
return dragListener; | |
}, | |
// Called before event segment resizing starts | |
segResizeStart: function(seg, ev) { | |
this.isResizing = true; | |
this.component.publiclyTrigger('eventResizeStart', { | |
context: seg.el[0], | |
args: [ | |
seg.footprint.getEventLegacy(), | |
ev, | |
{}, // jqui dummy | |
this.view | |
] | |
}); | |
}, | |
// Called after event segment resizing stops | |
segResizeStop: function(seg, ev) { | |
this.isResizing = false; | |
this.component.publiclyTrigger('eventResizeStop', { | |
context: seg.el[0], | |
args: [ | |
seg.footprint.getEventLegacy(), | |
ev, | |
{}, // jqui dummy | |
this.view | |
] | |
}); | |
}, | |
// Returns new date-information for an event segment being resized from its start | |
computeEventStartResizeMutation: function(startFootprint, endFootprint, origEventFootprint) { | |
var origRange = origEventFootprint.componentFootprint.unzonedRange; | |
var startDelta = this.component.diffDates( | |
endFootprint.unzonedRange.getStart(), | |
startFootprint.unzonedRange.getStart() | |
); | |
var dateMutation; | |
var eventDefMutation; | |
if (origRange.getStart().add(startDelta) < origRange.getEnd()) { | |
dateMutation = new EventDefDateMutation(); | |
dateMutation.setStartDelta(startDelta); | |
eventDefMutation = new EventDefMutation(); | |
eventDefMutation.setDateMutation(dateMutation); | |
return eventDefMutation; | |
} | |
return false; | |
}, | |
// Returns new date-information for an event segment being resized from its end | |
computeEventEndResizeMutation: function(startFootprint, endFootprint, origEventFootprint) { | |
var origRange = origEventFootprint.componentFootprint.unzonedRange; | |
var endDelta = this.component.diffDates( | |
endFootprint.unzonedRange.getEnd(), | |
startFootprint.unzonedRange.getEnd() | |
); | |
var dateMutation; | |
var eventDefMutation; | |
if (origRange.getEnd().add(endDelta) > origRange.getStart()) { | |
dateMutation = new EventDefDateMutation(); | |
dateMutation.setEndDelta(endDelta); | |
eventDefMutation = new EventDefMutation(); | |
eventDefMutation.setDateMutation(dateMutation); | |
return eventDefMutation; | |
} | |
return false; | |
} | |
}); | |
;; | |
var ExternalDropping = Interaction.extend(ListenerMixin, { | |
dragListener: null, | |
isDragging: false, // jqui-dragging an external element? boolean | |
/* | |
component impements: | |
- eventRangesToEventFootprints | |
- isEventInstanceGroupAllowed | |
- isExternalInstanceGroupAllowed | |
- renderDrag | |
- unrenderDrag | |
*/ | |
end: function() { | |
if (this.dragListener) { | |
this.dragListener.endInteraction(); | |
} | |
}, | |
bindToDocument: function() { | |
this.listenTo($(document), { | |
dragstart: this.handleDragStart, // jqui | |
sortstart: this.handleDragStart // jqui | |
}); | |
}, | |
unbindFromDocument: function() { | |
this.stopListeningTo($(document)); | |
}, | |
// Called when a jQuery UI drag is initiated anywhere in the DOM | |
handleDragStart: function(ev, ui) { | |
var el; | |
var accept; | |
if (this.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 = this.opt('dropAccept'); | |
if ($.isFunction(accept) ? accept.call(el[0], el) : el.is(accept)) { | |
if (!this.isDragging) { // 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 component = this.component; | |
var view = this.view; | |
var meta = getDraggedElMeta(el); // extra data about event drop, including possible event to create | |
var singleEventDef; // a null value signals an unsuccessful drag | |
// listener that tracks mouse movement over date-associated pixel regions | |
var dragListener = _this.dragListener = new HitDragListener(component, { | |
interactionStart: function() { | |
_this.isDragging = true; | |
}, | |
hitOver: function(hit) { | |
var isAllowed = true; | |
var hitFootprint = hit.component.getSafeHitFootprint(hit); // hit might not belong to this grid | |
var mutatedEventInstanceGroup; | |
if (hitFootprint) { | |
singleEventDef = _this.computeExternalDrop(hitFootprint, meta); | |
if (singleEventDef) { | |
mutatedEventInstanceGroup = new EventInstanceGroup( | |
singleEventDef.buildInstances() | |
); | |
isAllowed = meta.eventProps ? // isEvent? | |
component.isEventInstanceGroupAllowed(mutatedEventInstanceGroup) : | |
component.isExternalInstanceGroupAllowed(mutatedEventInstanceGroup); | |
} | |
else { | |
isAllowed = false; | |
} | |
} | |
else { | |
isAllowed = false; | |
} | |
if (!isAllowed) { | |
singleEventDef = null; | |
disableCursor(); | |
} | |
if (singleEventDef) { | |
component.renderDrag( // called without a seg parameter | |
component.eventRangesToEventFootprints( | |
mutatedEventInstanceGroup.sliceRenderRanges(component.get('dateProfile').renderUnzonedRange, view.calendar) | |
) | |
); | |
} | |
}, | |
hitOut: function() { | |
singleEventDef = null; // signal unsuccessful | |
}, | |
hitDone: function() { // Called after a hitOut OR before a dragEnd | |
enableCursor(); | |
component.unrenderDrag(); | |
}, | |
interactionEnd: function(ev) { | |
if (singleEventDef) { // element was dropped on a valid hit | |
view.reportExternalDrop( | |
singleEventDef, | |
Boolean(meta.eventProps), // isEvent | |
Boolean(meta.stick), // isSticky | |
el, ev, ui | |
); | |
} | |
_this.isDragging = false; | |
_this.dragListener = 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. | |
// Assumes both footprints are non-open-ended. | |
computeExternalDrop: function(componentFootprint, meta) { | |
var calendar = this.view.calendar; | |
var start = FC.moment.utc(componentFootprint.unzonedRange.startMs).stripZone(); | |
var end; | |
var eventDef; | |
if (componentFootprint.isAllDay) { | |
// if dropped on an all-day span, and element's metadata specified a time, set it | |
if (meta.startTime) { | |
start.time(meta.startTime); | |
} | |
else { | |
start.stripTime(); | |
} | |
} | |
if (meta.duration) { | |
end = start.clone().add(meta.duration); | |
} | |
start = calendar.applyTimezone(start); | |
if (end) { | |
end = calendar.applyTimezone(end); | |
} | |
eventDef = SingleEventDef.parse( | |
$.extend({}, meta.eventProps, { | |
start: start, | |
end: end | |
}), | |
new EventSource(calendar) | |
); | |
return eventDef; | |
} | |
}); | |
/* 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 }; | |
} | |
;; | |
var EventPointing = Interaction.extend({ | |
mousedOverSeg: null, // the segment object the user's mouse is over. null if over nothing | |
/* | |
component must implement: | |
- publiclyTrigger | |
*/ | |
bindToEl: function(el) { | |
var component = this.component; | |
component.bindSegHandlerToEl(el, 'click', this.handleClick.bind(this)); | |
component.bindSegHandlerToEl(el, 'mouseenter', this.handleMouseover.bind(this)); | |
component.bindSegHandlerToEl(el, 'mouseleave', this.handleMouseout.bind(this)); | |
}, | |
handleClick: function(seg, ev) { | |
var res = this.component.publiclyTrigger('eventClick', { // can return `false` to cancel | |
context: seg.el[0], | |
args: [ seg.footprint.getEventLegacy(), ev, this.view ] | |
}); | |
if (res === false) { | |
ev.preventDefault(); | |
} | |
}, | |
// Updates internal state and triggers handlers for when an event element is moused over | |
handleMouseover: function(seg, ev) { | |
if ( | |
!GlobalEmitter.get().shouldIgnoreMouse() && | |
!this.mousedOverSeg | |
) { | |
this.mousedOverSeg = seg; | |
// TODO: move to EventSelecting's responsibility | |
if (this.view.isEventDefResizable(seg.footprint.eventDef)) { | |
seg.el.addClass('fc-allow-mouse-resize'); | |
} | |
this.component.publiclyTrigger('eventMouseover', { | |
context: seg.el[0], | |
args: [ seg.footprint.getEventLegacy(), ev, this.view ] | |
}); | |
} | |
}, | |
// 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. | |
handleMouseout: function(seg, ev) { | |
if (this.mousedOverSeg) { | |
this.mousedOverSeg = null; | |
// TODO: move to EventSelecting's responsibility | |
if (this.view.isEventDefResizable(seg.footprint.eventDef)) { | |
seg.el.removeClass('fc-allow-mouse-resize'); | |
} | |
this.component.publiclyTrigger('eventMouseout', { | |
context: seg.el[0], | |
args: [ | |
seg.footprint.getEventLegacy(), | |
ev || {}, // if given no arg, make a mock mouse event | |
this.view | |
] | |
}); | |
} | |
}, | |
end: function() { | |
if (this.mousedOverSeg) { | |
this.handleMouseout(this.mousedOverSeg); | |
} | |
} | |
}); | |
;; | |
var StandardInteractionsMixin = { | |
dateClickingClass: DateClicking, | |
dateSelectingClass: DateSelecting, | |
eventPointingClass: EventPointing, | |
eventDraggingClass: EventDragging, | |
eventResizingClass: EventResizing, | |
externalDroppingClass: ExternalDropping | |
}; | |
;; | |
var EventRenderer = Class.extend({ | |
view: null, | |
component: null, | |
fillRenderer: null, // might remain null | |
fgSegs: null, | |
bgSegs: null, | |
// derived from options | |
eventTimeFormat: null, | |
displayEventTime: null, | |
displayEventEnd: null, | |
constructor: function(component, fillRenderer) { // fillRenderer is optional | |
this.view = component._getView(); | |
this.component = component; | |
this.fillRenderer = fillRenderer; | |
}, | |
opt: function(name) { | |
return this.view.opt(name); | |
}, | |
// Updates values that rely on options and also relate to range | |
rangeUpdated: function() { | |
var displayEventTime; | |
var displayEventEnd; | |
this.eventTimeFormat = | |
this.opt('eventTimeFormat') || | |
this.opt('timeFormat') || // deprecated | |
this.computeEventTimeFormat(); | |
displayEventTime = this.opt('displayEventTime'); | |
if (displayEventTime == null) { | |
displayEventTime = this.computeDisplayEventTime(); // might be based off of range | |
} | |
displayEventEnd = this.opt('displayEventEnd'); | |
if (displayEventEnd == null) { | |
displayEventEnd = this.computeDisplayEventEnd(); // might be based off of range | |
} | |
this.displayEventTime = displayEventTime; | |
this.displayEventEnd = displayEventEnd; | |
}, | |
renderFgFootprints: function(eventFootprints) { | |
var segs = this.component.eventFootprintsToSegs(eventFootprints); | |
// render an `.el` on each seg | |
// returns a subset of the segs. segs that were actually rendered | |
segs = this.renderFgSegEls(segs); | |
if (this.renderFgSegs(segs) !== false) { // no failure? | |
this.fgSegs = segs; | |
} | |
}, | |
unrenderFgFootprints: function() { | |
this.unrenderFgSegs(); | |
this.fgSegs = null; | |
}, | |
renderBgFootprints: function(eventFootprints) { | |
var segs = this.component.eventFootprintsToSegs(eventFootprints); | |
if (this.renderBgSegs(segs) !== false) { // no failure? | |
this.bgSegs = segs; | |
} | |
}, | |
unrenderBgFootprints: function() { | |
this.unrenderBgSegs(); | |
this.bgSegs = null; | |
}, | |
getSegs: function() { | |
return (this.bgSegs || []).concat(this.fgSegs || []); | |
}, | |
// Renders foreground event segments onto the grid | |
renderFgSegs: function(segs) { | |
// subclasses must implement | |
// segs already has rendered els, and has been filtered. | |
return false; // signal failure if not implemented | |
}, | |
// Unrenders all currently rendered foreground segments | |
unrenderFgSegs: function() { | |
// subclasses must implement | |
}, | |
renderBgSegs: function(segs) { | |
var _this = this; | |
if (this.fillRenderer) { | |
this.fillRenderer.render('bgEvents', segs, { | |
getClasses: function(seg) { | |
return _this.getBgClasses(seg.footprint); | |
}, | |
getCss: function(seg) { | |
return { | |
'background-color': _this.getBgColor(seg.footprint) | |
}; | |
}, | |
filterEl: function(seg, el) { | |
return _this.filterEventRenderEl(seg.footprint, el); | |
} | |
}); | |
} | |
else { | |
return false; // signal failure if no fillRenderer | |
} | |
}, | |
unrenderBgSegs: function() { | |
if (this.fillRenderer) { | |
this.fillRenderer.unrender('bgEvent'); | |
} | |
}, | |
// Renders and assigns an `el` property for each foreground event segment. | |
// Only returns segments that successfully rendered. | |
renderFgSegEls: function(segs, disableResizing) { | |
var _this = this; | |
var hasEventRenderHandlers = this.view.hasPublicHandlers('eventRender'); | |
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 = $(node); | |
if (hasEventRenderHandlers) { // optimization | |
el = _this.filterEventRenderEl(seg.footprint, el); | |
} | |
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 | |
}, | |
// Generic utility for generating the HTML classNames for an event segment's element | |
getSegClasses: function(seg, isDraggable, isResizable) { | |
var classes = [ | |
'fc-event', | |
seg.isStart ? 'fc-start' : 'fc-not-start', | |
seg.isEnd ? 'fc-end' : 'fc-not-end' | |
].concat(this.getClasses(seg.footprint)); | |
if (isDraggable) { | |
classes.push('fc-draggable'); | |
} | |
if (isResizable) { | |
classes.push('fc-resizable'); | |
} | |
// event is currently selected? attach a className. | |
if (this.view.isEventDefSelected(seg.footprint.eventDef)) { | |
classes.push('fc-selected'); | |
} | |
return classes; | |
}, | |
// Given an event and the default element used for rendering, returns the element that should actually be used. | |
// Basically runs events and elements through the eventRender hook. | |
filterEventRenderEl: function(eventFootprint, el) { | |
var legacy = eventFootprint.getEventLegacy(); | |
var custom = this.view.publiclyTrigger('eventRender', { | |
context: legacy, | |
args: [ legacy, el, this.view ] | |
}); | |
if (custom === false) { // means don't render at all | |
el = null; | |
} | |
else if (custom && custom !== true) { | |
el = $(custom); | |
} | |
return el; | |
}, | |
// 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. | |
getTimeText: function(eventFootprint, formatStr, displayEnd) { | |
return this._getTimeText( | |
eventFootprint.eventInstance.dateProfile.start, | |
eventFootprint.eventInstance.dateProfile.end, | |
eventFootprint.componentFootprint.isAllDay, | |
formatStr, | |
displayEnd | |
); | |
}, | |
_getTimeText: function(start, end, isAllDay, formatStr, displayEnd) { | |
if (formatStr == null) { | |
formatStr = this.eventTimeFormat; | |
} | |
if (displayEnd == null) { | |
displayEnd = this.displayEventEnd; | |
} | |
if (this.displayEventTime && !isAllDay) { | |
if (displayEnd && end) { | |
return this.view.formatRange( | |
{ start: start, end: end }, | |
false, // allDay | |
formatStr | |
); | |
} | |
else { | |
return start.format(formatStr); | |
} | |
} | |
return ''; | |
}, | |
computeEventTimeFormat: function() { | |
return this.opt('smallTimeFormat'); | |
}, | |
computeDisplayEventTime: function() { | |
return true; | |
}, | |
computeDisplayEventEnd: function() { | |
return true; | |
}, | |
getBgClasses: function(eventFootprint) { | |
var classNames = this.getClasses(eventFootprint); | |
classNames.push('fc-bgevent'); | |
return classNames; | |
}, | |
getClasses: function(eventFootprint) { | |
var eventDef = eventFootprint.eventDef; | |
return [].concat( | |
eventDef.className, // guaranteed to be an array | |
eventDef.source.className | |
); | |
}, | |
// Utility for generating event skin-related CSS properties | |
getSkinCss: function(eventFootprint) { | |
return { | |
'background-color': this.getBgColor(eventFootprint), | |
'border-color': this.getBorderColor(eventFootprint), | |
color: this.getTextColor(eventFootprint) | |
}; | |
}, | |
// Queries for caller-specified color, then falls back to default | |
getBgColor: function(eventFootprint) { | |
return eventFootprint.eventDef.backgroundColor || | |
eventFootprint.eventDef.color || | |
this.getDefaultBgColor(eventFootprint); | |
}, | |
getDefaultBgColor: function(eventFootprint) { | |
var source = eventFootprint.eventDef.source; | |
return source.backgroundColor || | |
source.color || | |
this.opt('eventBackgroundColor') || | |
this.opt('eventColor'); | |
}, | |
// Queries for caller-specified color, then falls back to default | |
getBorderColor: function(eventFootprint) { | |
return eventFootprint.eventDef.borderColor || | |
eventFootprint.eventDef.color || | |
this.getDefaultBorderColor(eventFootprint); | |
}, | |
getDefaultBorderColor: function(eventFootprint) { | |
var source = eventFootprint.eventDef.source; | |
return source.borderColor || | |
source.color || | |
this.opt('eventBorderColor') || | |
this.opt('eventColor'); | |
}, | |
// Queries for caller-specified color, then falls back to default | |
getTextColor: function(eventFootprint) { | |
return eventFootprint.eventDef.textColor || | |
this.getDefaultTextColor(eventFootprint); | |
}, | |
getDefaultTextColor: function(eventFootprint) { | |
var source = eventFootprint.eventDef.source; | |
return source.textColor || this.opt('eventTextColor'); | |
}, | |
sortEventSegs: function(segs) { | |
segs.sort(proxy(this, 'compareEventSegs')); | |
}, | |
// A cmp function for determining which segments should take visual priority | |
compareEventSegs: function(seg1, seg2) { | |
var f1 = seg1.footprint.componentFootprint; | |
var r1 = f1.unzonedRange; | |
var f2 = seg2.footprint.componentFootprint; | |
var r2 = f2.unzonedRange; | |
return r1.startMs - r2.startMs || // earlier events go first | |
(r2.endMs - r2.startMs) - (r1.endMs - r1.startMs) || // tie? longer events go first | |
f2.isAllDay - f1.isAllDay || // tie? put all-day events first (booleans cast to 0/1) | |
compareByFieldSpecs( | |
seg1.footprint.eventDef, | |
seg2.footprint.eventDef, | |
this.view.eventOrderSpecs | |
); | |
} | |
}); | |
;; | |
var BusinessHourRenderer = Class.extend({ | |
isAllDay: false, // subclasses can config | |
component: null, | |
fillRenderer: null, | |
segs: null, | |
/* | |
component implements: | |
- eventRangesToEventFootprints | |
- eventFootprintsToSegs | |
*/ | |
constructor: function(component, fillRenderer) { | |
this.component = component; | |
this.fillRenderer = fillRenderer; | |
}, | |
render: function(businessHours) { | |
var eventRanges = businessHours.sliceRenderRanges(this.isAllDay); | |
var eventFootprints = this.component.eventRangesToEventFootprints(eventRanges); | |
this.renderEventFootprints(eventFootprints); | |
}, | |
renderEventFootprints: function(eventFootprints) { | |
var segs = this.component.eventFootprintsToSegs(eventFootprints); | |
this.renderSegs(segs); | |
this.segs = segs; | |
}, | |
renderSegs: function(segs) { | |
if (this.fillRenderer) { | |
this.fillRenderer.render('businessHours', segs, { | |
getClasses: function(seg) { | |
return [ 'fc-nonbusiness', 'fc-bgevent' ]; | |
} | |
}); | |
} | |
}, | |
unrender: function() { | |
if (this.fillRenderer) { | |
this.fillRenderer.unrender('businessHours'); | |
} | |
this.segs = null; | |
}, | |
getSegs: function() { | |
return this.segs || []; | |
} | |
}); | |
;; | |
var FillRenderer = Class.extend({ // use for highlight, background events, business hours | |
fillSegTag: 'div', | |
elsByFill: null, // a hash of jQuery element sets used for rendering each fill. Keyed by fill name. | |
constructor: function() { | |
this.elsByFill = {}; | |
}, | |
render: function(type, segs, props) { | |
var els; | |
segs = this.buildSegEls(type, segs, props); // assignes `.el` to each seg. returns successfully rendered segs | |
els = this.attachSegEls(type, segs); | |
if (els) { | |
this.reportEls(type, els); | |
} | |
return segs; | |
}, | |
// Unrenders a specific type of fill that is currently rendered on the grid | |
unrender: 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. | |
buildSegEls: function(type, segs, props) { | |
var _this = this; | |
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.buildSegHtml(type, segs[i], props); | |
} | |
// 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 (props.filterEl) { | |
el = props.filterEl(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; | |
}, | |
// Builds the HTML needed for one fill segment. Generic enough to work with different types. | |
buildSegHtml: function(type, seg, props) { | |
// custom hooks per-type | |
var classes = props.getClasses ? props.getClasses(seg) : []; | |
var css = cssToStr(props.getCss ? props.getCss(seg) : {}); | |
return '<' + this.fillSegTag + | |
(classes.length ? ' class="' + classes.join(' ') + '"' : '') + | |
(css ? ' style="' + css + '"' : '') + | |
' />'; | |
}, | |
// Should return wrapping DOM structure | |
attachSegEls: function(type, segs) { | |
// subclasses must implement | |
}, | |
reportEls: function(type, nodes) { | |
if (this.elsByFill[type]) { | |
this.elsByFill[type] = this.elsByFill[type].add(nodes); | |
} | |
else { | |
this.elsByFill[type] = $(nodes); | |
} | |
} | |
}); | |
;; | |
var HelperRenderer = Class.extend({ | |
view: null, | |
component: null, | |
eventRenderer: null, | |
helperEls: null, | |
constructor: function(component, eventRenderer) { | |
this.view = component._getView(); | |
this.component = component; | |
this.eventRenderer = eventRenderer; | |
}, | |
renderComponentFootprint: function(componentFootprint) { | |
this.renderEventFootprints([ | |
this.fabricateEventFootprint(componentFootprint) | |
]); | |
}, | |
renderEventDraggingFootprints: function(eventFootprints, sourceSeg, isTouch) { | |
this.renderEventFootprints( | |
eventFootprints, | |
sourceSeg, | |
'fc-dragging', | |
isTouch ? null : this.view.opt('dragOpacity') | |
); | |
}, | |
renderEventResizingFootprints: function(eventFootprints, sourceSeg, isTouch) { | |
this.renderEventFootprints( | |
eventFootprints, | |
sourceSeg, | |
'fc-resizing' | |
); | |
}, | |
renderEventFootprints: function(eventFootprints, sourceSeg, extraClassNames, opacity) { | |
var segs = this.component.eventFootprintsToSegs(eventFootprints); | |
var classNames = 'fc-helper ' + (extraClassNames || ''); | |
var i; | |
// assigns each seg's el and returns a subset of segs that were rendered | |
segs = this.eventRenderer.renderFgSegEls(segs); | |
for (i = 0; i < segs.length; i++) { | |
segs[i].el.addClass(classNames); | |
} | |
if (opacity != null) { | |
for (i = 0; i < segs.length; i++) { | |
segs[i].el.css('opacity', opacity); | |
} | |
} | |
this.helperEls = this.renderSegs(segs, sourceSeg); | |
}, | |
/* | |
Must return all mock event elements | |
*/ | |
renderSegs: function(segs, sourceSeg) { | |
// Subclasses must implement | |
}, | |
unrender: function() { | |
if (this.helperEls) { | |
this.helperEls.remove(); | |
this.helperEls = null; | |
} | |
}, | |
fabricateEventFootprint: function(componentFootprint) { | |
var calendar = this.view.calendar; | |
var eventDateProfile = calendar.footprintToDateProfile(componentFootprint); | |
var dummyEvent = new SingleEventDef(new EventSource(calendar)); | |
var dummyInstance; | |
dummyEvent.dateProfile = eventDateProfile; | |
dummyInstance = dummyEvent.buildInstance(); | |
return new EventFootprint(componentFootprint, dummyEvent, dummyInstance); | |
} | |
}); | |
;; | |
var Component = Model.extend({ | |
el: null, | |
setElement: function(el) { | |
this.el = el; | |
this.bindGlobalHandlers(); | |
this.renderSkeleton(); | |
}, | |
removeElement: function() { | |
this.unrenderSkeleton(); | |
this.unbindGlobalHandlers(); | |
this.el.remove(); | |
// NOTE: don't null-out this.el in case the View was destroyed within an API callback. | |
// We don't null-out the View's other jQuery element references upon destroy, | |
// so we shouldn't kill this.el either. | |
}, | |
bindGlobalHandlers: function() { | |
}, | |
unbindGlobalHandlers: function() { | |
}, | |
/* | |
NOTE: Can't have a `render` method. Read the deprecation notice in View::executeDateRender | |
*/ | |
// Renders the basic structure of the view before any content is rendered | |
renderSkeleton: function() { | |
// subclasses should implement | |
}, | |
// Unrenders the basic structure of the view | |
unrenderSkeleton: function() { | |
// subclasses should implement | |
} | |
}); | |
;; | |
var DateComponent = Component.extend({ | |
uid: null, | |
children: null, | |
isRTL: false, // frequently accessed options | |
nextDayThreshold: null, // " | |
eventRendererClass: null, | |
helperRendererClass: null, | |
businessHourRendererClass: null, | |
fillRendererClass: null, | |
eventRenderer: null, | |
helperRenderer: null, | |
businessHourRenderer: null, | |
fillRenderer: null, | |
hitsNeededDepth: 0, // necessary because multiple callers might need the same hits | |
dateMessageAggregator: null, | |
eventMessageAggregator: null, | |
constructor: function() { | |
Component.call(this); | |
this.uid = String(DateComponent.guid++); | |
this.children = []; | |
this.nextDayThreshold = moment.duration(this.opt('nextDayThreshold')); | |
this.isRTL = this.opt('isRTL'); | |
if (this.fillRendererClass) { | |
this.fillRenderer = new this.fillRendererClass(this); | |
} | |
if (this.eventRendererClass) { // fillRenderer is optional -----v | |
this.eventRenderer = new this.eventRendererClass(this, this.fillRenderer); | |
} | |
if (this.helperRendererClass && this.eventRenderer) { | |
this.helperRenderer = new this.helperRendererClass(this, this.eventRenderer); | |
} | |
if (this.businessHourRendererClass && this.fillRenderer) { | |
this.businessHourRenderer = new this.businessHourRendererClass(this, this.fillRenderer); | |
} | |
this.dateMessageAggregator = buildMessageAggregator(this, 'dateRender', 'dateUnrender'); | |
this.eventMessageAggregator = buildMessageAggregator(this, 'eventRender', 'eventUnrender'); | |
}, | |
addChild: function(child) { | |
this.children.push(child); | |
this.dateMessageAggregator.addChild(child); | |
this.eventMessageAggregator.addChild(child); | |
}, | |
requestRender: function(namespace, actionType, method, args) { | |
var _this = this; | |
this._getView().calendar.renderQueue.queue(this.uid, namespace, actionType, function() { | |
method.apply(_this, args); | |
}); | |
}, | |
startBatchRender: function() { | |
this._getView().calendar.startBatchRender(); | |
}, | |
stopBatchRender: function() { | |
this._getView().calendar.stopBatchRender(); | |
}, | |
updateSize: function(totalHeight, isAuto, isResize) { | |
this.callChildren('updateSize', arguments); | |
}, | |
// Options | |
// ----------------------------------------------------------------------------------------------------------------- | |
opt: function(name) { | |
// subclasses must implement | |
}, | |
publiclyTrigger: function(/**/) { | |
var calendar = this._getCalendar(); | |
return calendar.publiclyTrigger.apply(calendar, arguments); | |
}, | |
hasPublicHandlers: function(/**/) { | |
var calendar = this._getCalendar(); | |
return calendar.hasPublicHandlers.apply(calendar, arguments); | |
}, | |
// Date | |
// ----------------------------------------------------------------------------------------------------------------- | |
handleDateProfileSet: function(dateProfile) { | |
this.setDateProfileInChildren(dateProfile); | |
}, | |
handleDateProfileUnset: function() { | |
this.unsetDateProfileInChildren(); | |
}, | |
setDateProfileInChildren: function(dateProfile) { | |
this.setInChildren('dateProfile', dateProfile); | |
}, | |
unsetDateProfileInChildren: function() { | |
this.unsetInChildren('dateProfile'); | |
}, | |
executeDateRender: function(dateProfile, skipScroll) { // wrapper | |
this.renderDates(dateProfile); | |
this.trigger('dateRender'); | |
}, | |
executeDateUnrender: function() { // wrapper | |
this.trigger('before:dateUnrender'); | |
this.unrenderDates(); | |
}, | |
// date-cell content only | |
renderDates: function(dateProfile) { | |
// subclasses should implement | |
}, | |
// date-cell content only | |
unrenderDates: function() { | |
// subclasses should override | |
}, | |
// Now-Indicator | |
// ----------------------------------------------------------------------------------------------------------------- | |
// Returns a string unit, like 'second' or 'minute' that defined how often the current time indicator | |
// should be refreshed. If something falsy is returned, no time indicator is rendered at all. | |
getNowIndicatorUnit: function() { | |
// subclasses should implement | |
}, | |
// Renders a current time indicator at the given datetime | |
renderNowIndicator: function(date) { | |
this.callChildren('renderNowIndicator', arguments); | |
}, | |
// Undoes the rendering actions from renderNowIndicator | |
unrenderNowIndicator: function() { | |
this.callChildren('unrenderNowIndicator', arguments); | |
}, | |
// Business Hours | |
// --------------------------------------------------------------------------------------------------------------- | |
setBusinessHoursInChildren: function(businessHours) { | |
this.setInChildren('businessHours', businessHours); | |
}, | |
unsetBusinessHoursInChildren: function() { | |
this.unsetInChildren('businessHours'); | |
}, | |
// Renders business-hours onto the view. Assumes updateSize has already been called. | |
renderBusinessHours: function(businessHours) { | |
if (this.businessHourRenderer) { | |
this.businessHourRenderer.render(businessHours); | |
} | |
}, | |
// Unrenders previously-rendered business-hours | |
unrenderBusinessHours: function() { | |
if (this.businessHourRenderer) { | |
this.businessHourRenderer.unrender(); | |
} | |
}, | |
// Events | |
// ----------------------------------------------------------------------------------------------------------------- | |
// initial handling (to be called by initial data receipt) | |
handleEventsSet: function(eventsPayload) { | |
this.set('currentEvents', eventsPayload); | |
this.set('hasEvents', true); | |
this.setEventsInChildren(eventsPayload); | |
}, | |
handleEventsUnset: function() { | |
this.unset('hasEvents'); | |
this.unset('currentEvents'); | |
this.unsetEventsInChildren(); | |
}, | |
// dynamic handling (to be called by post-binding updates) | |
handleEventsReset: function(eventsPayload) { | |
this.startBatchRender(); | |
this.handleEventsUnset(); | |
this.handleEventsSet(eventsPayload); | |
this.stopBatchRender(); | |
}, | |
handleEventAddOrUpdate: function(id, eventInstanceGroup) { | |
var currentEvents = this.get('currentEvents'); | |
currentEvents[id] = eventInstanceGroup; | |
this.set('currentEvents', currentEvents); | |
this.addOrUpdateEventInChildren(id, eventInstanceGroup); | |
if (this.get('displayingEvents')) { | |
this.requestRender('event', 'add', this.renderEventAddOrUpdate, arguments); | |
} | |
}, | |
handleEventRemove: function(id) { | |
var currentEvents = this.get('currentEvents'); | |
if (id in currentEvents) { | |
delete currentEvents[id]; | |
this.set('currentEvents', currentEvents); | |
this.removeEventInChildren(id); | |
} | |
if (this.get('displayingEvents')) { | |
this.requestRender('event', 'remove', this.renderEventRemove, arguments); | |
} | |
}, | |
// for children | |
setEventsInChildren: function(eventsPayload) { | |
this.callChildren('handleEventsSet', arguments); | |
}, | |
unsetEventsInChildren: function() { | |
this.callChildren('handleEventsUnset', arguments); | |
}, | |
addOrUpdateEventInChildren: function(id, eventInstanceGroup) { | |
this.callChildren('handleEventAddOrUpdate', arguments); | |
}, | |
removeEventInChildren: function(id) { | |
this.callChildren('handleEventRemove', arguments); | |
}, | |
// rendering | |
executeEventsRender: function(eventsPayload) { // wrapper | |
this.renderEventsPayload(eventsPayload); | |
this.trigger('eventRender'); | |
}, | |
executeEventsUnrender: function() { // wrapper | |
this.trigger('before:eventUnrender'); | |
this.unrenderEvents(); | |
}, | |
// TODO: eventually rename to `renderEvents` once legacy is gone. | |
renderEventsPayload: function(eventsPayload) { | |
var dateProfile = this.get('dateProfile'); | |
var id, eventInstanceGroup; | |
var eventRenderRanges; | |
var eventFootprints; | |
var bgFootprints = []; | |
var fgFootprints = []; | |
for (id in eventsPayload) { | |
eventInstanceGroup = eventsPayload[id]; | |
eventRenderRanges = eventInstanceGroup.sliceRenderRanges(dateProfile.activeUnzonedRange); | |
eventFootprints = this.eventRangesToEventFootprints(eventRenderRanges); | |
if (eventInstanceGroup.getEventDef().hasBgRendering()) { | |
bgFootprints.push.apply(bgFootprints, eventFootprints); | |
} | |
else { | |
fgFootprints.push.apply(fgFootprints, eventFootprints); | |
} | |
} | |
this.renderBgEventFootprints(bgFootprints); | |
this.renderFgEventFootprints(fgFootprints); | |
}, | |
// Unrenders all events currently rendered on the grid | |
unrenderEvents: function() { | |
this.unrenderFgEventFootprints(); | |
this.unrenderBgEventFootprints(); | |
// we DON'T need to call updateHeight() because | |
// a renderEventsPayload() call always happens after this, which will eventually call updateHeight() | |
}, | |
renderEventAddOrUpdate: function(id, eventsPayload) { | |
// by default, rerender all | |
this.unrenderEvents(); | |
this.renderEventsPayload(this.get('currentEvents')); | |
}, | |
renderEventRemove: function() { | |
// by default, rerender all | |
this.unrenderEvents(); | |
this.renderEventsPayload(this.get('currentEvents')); | |
}, | |
// fg & bg delegation | |
// NOTE: parents should never call these | |
// TODO: make EventRenderer responsible for routing FG vs BG? | |
renderFgEventFootprints: function(eventFootprints) { | |
if (this.eventRenderer) { | |
this.eventRenderer.renderFgFootprints(eventFootprints); | |
} | |
}, | |
renderBgEventFootprints: function(eventFootprints) { | |
if (this.eventRenderer) { | |
this.eventRenderer.renderBgFootprints(eventFootprints); | |
} | |
}, | |
// Removes event elements from the view. | |
unrenderFgEventFootprints: function() { | |
this.endInteractions(); // TODO: called too frequently | |
if (this.eventRenderer) { | |
this.eventRenderer.unrenderFgFootprints(); | |
} | |
}, | |
// Removes event elements from the view. | |
unrenderBgEventFootprints: function() { | |
this.endInteractions(); // TODO: called too frequently | |
if (this.eventRenderer) { | |
this.eventRenderer.unrenderBgFootprints(); | |
} | |
}, | |
// Retrieves all segment objects that are rendered in the view | |
getEventSegs: function() { | |
var segs = this.eventRenderer ? | |
this.eventRenderer.getSegs() : | |
[]; | |
var children = this.children; | |
var i; | |
for (i = 0; i < children.length; i++) { | |
segs.push.apply( // append | |
segs, | |
children[i].getEventSegs() | |
); | |
} | |
return segs; | |
}, | |
// Drag-n-Drop Rendering (for both events and external elements) | |
// --------------------------------------------------------------------------------------------------------------- | |
// Renders a visual indication of a event or external-element drag over the given drop zone. | |
// If an external-element, seg will be `null`. | |
// Must return elements used for any mock events. | |
renderDrag: function(eventFootprints, seg, isTouch) { | |
this.callChildren('renderDrag', arguments); | |
}, | |
// Unrenders a visual indication of an event or external-element being dragged. | |
unrenderDrag: function() { | |
this.callChildren('unrenderDrag', arguments); | |
}, | |
// Event Resizing | |
// --------------------------------------------------------------------------------------------------------------- | |
// Renders a visual indication of an event being resized. | |
renderEventResize: function(eventFootprints, seg, isTouch) { | |
// subclasses must implement | |
}, | |
// Unrenders a visual indication of an event being resized. | |
unrenderEventResize: function() { | |
// subclasses must implement | |
}, | |
// Selection | |
// --------------------------------------------------------------------------------------------------------------- | |
// Renders a visual indication of the selection | |
// TODO: rename to `renderSelection` after legacy is gone | |
renderSelectionFootprint: function(componentFootprint) { | |
this.renderHighlight(componentFootprint); | |
this.callChildren('renderSelectionFootprint', arguments); | |
}, | |
// Unrenders a visual indication of selection | |
unrenderSelection: function() { | |
this.unrenderHighlight(); | |
this.callChildren('unrenderSelection', arguments); | |
}, | |
// Highlight | |
// --------------------------------------------------------------------------------------------------------------- | |
// Renders an emphasis on the given date range. Given a span (unzoned start/end and other misc data) | |
renderHighlight: function(componentFootprint) { | |
if (this.fillRenderer) { | |
this.fillRenderer.render( | |
'highlight', | |
this.componentFootprintToSegs(componentFootprint), | |
{ | |
getClasses: function() { | |
return [ 'fc-highlight' ]; | |
} | |
} | |
); | |
} | |
this.callChildren('renderHighlight', arguments); | |
}, | |
// Unrenders the emphasis on a date range | |
unrenderHighlight: function() { | |
if (this.fillRenderer) { | |
this.fillRenderer.unrender('highlight'); | |
} | |
this.callChildren('unrenderHighlight', arguments); | |
}, | |
// Hit Areas | |
// --------------------------------------------------------------------------------------------------------------- | |
// just because all DateComponents support this interface | |
// doesn't mean they need to have their own internal coord system. they can defer to sub-components. | |
hitsNeeded: function() { | |
if (!(this.hitsNeededDepth++)) { | |
this.prepareHits(); | |
} | |
this.callChildren('hitsNeeded', arguments); | |
}, | |
hitsNotNeeded: function() { | |
if (this.hitsNeededDepth && !(--this.hitsNeededDepth)) { | |
this.releaseHits(); | |
} | |
this.callChildren('hitsNotNeeded', arguments); | |
}, | |
prepareHits: function() { | |
// subclasses can implement | |
}, | |
releaseHits: function() { | |
// subclasses can implement | |
}, | |
// 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 getHitFootprint and getHitEl. | |
queryHit: function(leftOffset, topOffset) { | |
var children = this.children; | |
var i; | |
var hit; | |
for (i = 0; i < children.length; i++) { | |
hit = children[i].queryHit(leftOffset, topOffset); | |
if (hit) { | |
break; | |
} | |
} | |
return hit; | |
}, | |
getSafeHitFootprint: function(hit) { | |
var dateProfile = this.get('dateProfile'); | |
var footprint = this.getHitFootprint(hit); | |
if (!dateProfile.activeUnzonedRange.containsRange(footprint.unzonedRange)) { | |
return null; | |
} | |
return footprint; | |
}, | |
getHitFootprint: 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) { | |
}, | |
/* Converting eventRange -> eventFootprint | |
------------------------------------------------------------------------------------------------------------------*/ | |
eventRangesToEventFootprints: function(eventRanges) { | |
var eventFootprints = []; | |
var i; | |
for (i = 0; i < eventRanges.length; i++) { | |
eventFootprints.push.apply(eventFootprints, | |
this.eventRangeToEventFootprints(eventRanges[i]) | |
); | |
} | |
return eventFootprints; | |
}, | |
// Given an event's unzoned date range, return an array of eventSpan objects. | |
// eventSpan - { start, end, isStart, isEnd, otherthings... } | |
// Subclasses can override. | |
// Subclasses are obligated to forward eventRange.isStart/isEnd to the resulting spans. | |
// TODO: somehow more DRY with Calendar::eventRangeToEventFootprints | |
eventRangeToEventFootprints: function(eventRange) { | |
return [ | |
new EventFootprint( | |
new ComponentFootprint( | |
eventRange.unzonedRange, | |
eventRange.eventDef.isAllDay() | |
), | |
eventRange.eventDef, | |
eventRange.eventInstance // might not exist | |
) | |
]; | |
}, | |
/* Converting componentFootprint/eventFootprint -> segs | |
------------------------------------------------------------------------------------------------------------------*/ | |
eventFootprintsToSegs: function(eventFootprints) { | |
var segs = []; | |
var i; | |
for (i = 0; i < eventFootprints.length; i++) { | |
segs.push.apply(segs, | |
this.eventFootprintToSegs(eventFootprints[i]) | |
); | |
} | |
return segs; | |
}, | |
// 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. | |
// eventSpan - { start, end, isStart, isEnd, otherthings... } | |
// constraintRange allow additional clipping. optional. eventually remove this. | |
eventFootprintToSegs: function(eventFootprint, constraintRange) { | |
var unzonedRange = eventFootprint.componentFootprint.unzonedRange; | |
var segs; | |
var i, seg; | |
if (constraintRange) { | |
unzonedRange = unzonedRange.intersect(constraintRange); | |
} | |
segs = this.componentFootprintToSegs(eventFootprint.componentFootprint); | |
for (i = 0; i < segs.length; i++) { | |
seg = segs[i]; | |
if (!unzonedRange.isStart) { | |
seg.isStart = false; | |
} | |
if (!unzonedRange.isEnd) { | |
seg.isEnd = false; | |
} | |
seg.footprint = eventFootprint; | |
// TODO: rename to seg.eventFootprint | |
} | |
return segs; | |
}, | |
componentFootprintToSegs: function(componentFootprint) { | |
return []; | |
}, | |
// Utils | |
// --------------------------------------------------------------------------------------------------------------- | |
callChildren: function(methodName, args) { | |
var children = this.children; | |
var i; | |
for (i = 0; i < children.length; i++) { | |
children[i][methodName].apply(children[i], args); | |
} | |
}, | |
setInChildren: function(propName, propValue) { | |
var children = this.children; | |
var i; | |
for (i = 0; i < children.length; i++) { | |
children[i].set(propName, propValue); | |
} | |
}, | |
unsetInChildren: function(propName) { | |
var children = this.children; | |
var i; | |
for (i = 0; i < children.length; i++) { | |
children[i].unset(propName); | |
} | |
}, | |
_getCalendar: function() { // TODO: strip out. move to generic parent. | |
return this.calendar || this.view.calendar; | |
}, | |
_getView: function() { // TODO: strip out. move to generic parent. | |
return this.view; | |
} | |
}); | |
DateComponent.guid = 0; // TODO: better system for this? | |
DateComponent.watch('handleDateProfile', [ 'dateProfile' ], function(deps) { | |
this.handleDateProfileSet(deps.dateProfile); | |
}, function() { | |
this.handleDateProfileUnset(); | |
}); | |
DateComponent.watch('businessHoursInChildren', [ 'businessHours' ], function(deps) { | |
this.setBusinessHoursInChildren(deps.businessHours); | |
}, function() { | |
this.unsetBusinessHoursInChildren(); | |
}); | |
DateComponent.watch('displayingDates', [ 'dateProfile' ], function(deps) { | |
this.requestRender('date', 'init', this.executeDateRender, [ deps.dateProfile ]); | |
}, function() { | |
this.requestRender('date', 'destroy', this.executeDateUnrender); | |
}); | |
DateComponent.watch('displayingBusinessHours', [ 'displayingDates', 'businessHours' ], function(deps) { | |
this.requestRender('businessHours', 'init', this.renderBusinessHours, [ deps.businessHours ]); | |
}, function() { | |
this.requestRender('businessHours', 'destroy', this.unrenderBusinessHours); | |
}); | |
DateComponent.watch('displayingEvents', [ 'displayingDates', 'hasEvents' ], function() { | |
// pass currentEvents in case there were event mutations after initialEvents | |
this.requestRender('event', 'init', this.executeEventsRender, [ this.get('currentEvents') ]); | |
}, function() { | |
this.requestRender('event', 'destroy', this.executeEventsUnrender); | |
}); | |
;; | |
DateComponent.mixin({ | |
// Generates HTML for an anchor to another view into the calendar. | |
// Will either generate an <a> tag or a non-clickable <span> tag, depending on enabled settings. | |
// `gotoOptions` can either be a moment input, or an object with the form: | |
// { date, type, forceOff } | |
// `type` is a view-type like "day" or "week". default value is "day". | |
// `attrs` and `innerHtml` are use to generate the rest of the HTML tag. | |
buildGotoAnchorHtml: function(gotoOptions, attrs, innerHtml) { | |
var date, type, forceOff; | |
var finalOptions; | |
if ($.isPlainObject(gotoOptions)) { | |
date = gotoOptions.date; | |
type = gotoOptions.type; | |
forceOff = gotoOptions.forceOff; | |
} | |
else { | |
date = gotoOptions; // a single moment input | |
} | |
date = FC.moment(date); // if a string, parse it | |
finalOptions = { // for serialization into the link | |
date: date.format('YYYY-MM-DD'), | |
type: type || 'day' | |
}; | |
if (typeof attrs === 'string') { | |
innerHtml = attrs; | |
attrs = null; | |
} | |
attrs = attrs ? ' ' + attrsToStr(attrs) : ''; // will have a leading space | |
innerHtml = innerHtml || ''; | |
if (!forceOff && this.opt('navLinks')) { | |
return '<a' + attrs + | |
' data-goto="' + htmlEscape(JSON.stringify(finalOptions)) + '">' + | |
innerHtml + | |
'</a>'; | |
} | |
else { | |
return '<span' + attrs + '>' + | |
innerHtml + | |
'</span>'; | |
} | |
}, | |
getAllDayHtml: function() { | |
return this.opt('allDayHtml') || htmlEscape(this.opt('allDayText')); | |
}, | |
// Computes HTML classNames for a single-day element | |
getDayClasses: function(date, noThemeHighlight) { | |
var view = this._getView(); | |
var classes = []; | |
var today; | |
if (!this.get('dateProfile').activeUnzonedRange.containsDate(date)) { | |
classes.push('fc-disabled-day'); // TODO: jQuery UI theme? | |
} | |
else { | |
classes.push('fc-' + dayIDs[date.day()]); | |
if (view.isDateInOtherMonth(date)) { // TODO: use DateComponent subclass somehow | |
classes.push('fc-other-month'); | |
} | |
today = view.calendar.getNow(); | |
if (date.isSame(today, 'day')) { | |
classes.push('fc-today'); | |
if (noThemeHighlight !== true) { | |
classes.push(view.calendar.theme.getClass('today')); | |
} | |
} | |
else if (date < today) { | |
classes.push('fc-past'); | |
} | |
else { | |
classes.push('fc-future'); | |
} | |
} | |
return classes; | |
}, | |
// Utility for formatting a range. Accepts a range object, formatting string, and optional separator. | |
// Displays all-day ranges naturally, with an inclusive end. Takes the current isRTL into account. | |
// The timezones of the dates within `range` will be respected. | |
formatRange: function(range, isAllDay, formatStr, separator) { | |
var end = range.end; | |
if (isAllDay) { | |
end = end.clone().subtract(1); // convert to inclusive. last ms of previous day | |
} | |
return formatRange(range.start, end, formatStr, separator, this.isRTL); | |
}, | |
// Returns the date range of the full days the given range visually appears to occupy. | |
// Returns a plain object with start/end, NOT an UnzonedRange! | |
computeDayRange: function(unzonedRange) { | |
var calendar = this._getCalendar(); | |
var startDay = calendar.msToUtcMoment(unzonedRange.startMs, true); // the beginning of the day the range starts | |
var end = calendar.msToUtcMoment(unzonedRange.endMs); | |
var endTimeMS = +end.time(); // # of milliseconds into `endDay` | |
var endDay = end.clone().stripTime(); // the beginning of the day the range exclusively ends | |
// If the end time is actually inclusively part of the next day and is equal to or | |
// beyond the next day threshold, adjust the end to be the exclusive end of `endDay`. | |
// Otherwise, leaving it as inclusive will cause it to exclude `endDay`. | |
if (endTimeMS && endTimeMS >= this.nextDayThreshold) { | |
endDay.add(1, 'days'); | |
} | |
// If end is within `startDay` but not past nextDayThreshold, assign the default duration of one day. | |
if (endDay <= startDay) { | |
endDay = startDay.clone().add(1, 'days'); | |
} | |
return { start: startDay, end: endDay }; | |
}, | |
// Does the given range visually appear to occupy more than one day? | |
isMultiDayRange: function(unzonedRange) { | |
var dayRange = this.computeDayRange(unzonedRange); | |
return dayRange.end.diff(dayRange.start, 'days') > 1; | |
} | |
}); | |
;; | |
var InteractiveDateComponent = DateComponent.extend({ | |
dateClickingClass: null, | |
dateSelectingClass: null, | |
eventPointingClass: null, | |
eventDraggingClass: null, | |
eventResizingClass: null, | |
externalDroppingClass: null, | |
dateClicking: null, | |
dateSelecting: null, | |
eventPointing: null, | |
eventDragging: null, | |
eventResizing: null, | |
externalDropping: null, | |
// self-config, overridable by subclasses | |
segSelector: '.fc-event-container > *', // what constitutes an event element? | |
// 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, | |
constructor: function() { | |
DateComponent.call(this); | |
if (this.dateSelectingClass) { | |
this.dateClicking = new this.dateClickingClass(this); | |
} | |
if (this.dateSelectingClass) { | |
this.dateSelecting = new this.dateSelectingClass(this); | |
} | |
if (this.eventPointingClass) { | |
this.eventPointing = new this.eventPointingClass(this); | |
} | |
if (this.eventDraggingClass) { | |
this.eventDragging = new this.eventDraggingClass(this); | |
} | |
if (this.eventResizingClass) { | |
this.eventResizing = new this.eventResizingClass(this); | |
} | |
if (this.externalDroppingClass) { | |
this.externalDropping = new this.externalDroppingClass(this); | |
} | |
}, | |
// Sets the container element that the view should render inside of, does global DOM-related initializations, | |
// and renders all the non-date-related content inside. | |
setElement: function(el) { | |
Component.prototype.setElement.apply(this, arguments); | |
if (this.dateClicking) { | |
this.dateClicking.bindToEl(el); | |
} | |
if (this.dateSelecting) { | |
this.dateSelecting.bindToEl(el); | |
} | |
this.bindAllSegHandlersToEl(el); | |
}, | |
unrender: function() { | |
this.endInteractions(); | |
Component.prototype.unrender.apply(this, arguments); | |
}, | |
bindGlobalHandlers: function() { | |
Component.prototype.bindGlobalHandlers.apply(this, arguments); | |
if (this.externalDropping) { | |
this.externalDropping.bindToDocument(); | |
} | |
}, | |
unbindGlobalHandlers: function() { | |
Component.prototype.unbindGlobalHandlers.apply(this, arguments); | |
if (this.externalDropping) { | |
this.externalDropping.unbindFromDocument(); | |
} | |
}, | |
bindDateHandlerToEl: function(el, 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); | |
} | |
}); | |
}, | |
bindAllSegHandlersToEl: function(el) { | |
[ | |
this.eventPointing, | |
this.eventDragging, | |
this.eventResizing | |
].forEach(function(eventInteraction) { | |
if (eventInteraction) { | |
eventInteraction.bindToEl(el); | |
} | |
}); | |
}, | |
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::renderEventsPayload | |
if (seg && !_this.shouldIgnoreEventPointing()) { | |
return handler.call(_this, seg, ev); // context will be the Grid | |
} | |
}); | |
}, | |
shouldIgnoreMouse: function() { | |
// HACK | |
// This will still work even though bindDateHandlerToEl doesn't use GlobalEmitter. | |
return GlobalEmitter.get().shouldIgnoreMouse(); | |
}, | |
shouldIgnoreTouch: function() { | |
var view = this._getView(); | |
// On iOS (and Android?) when a new selection is initiated overtop another selection, | |
// the touchend never fires because the elements gets removed mid-touch-interaction (my theory). | |
// HACK: simply don't allow this to happen. | |
// ALSO: prevent selection when an *event* is already raised. | |
return view.isSelected || view.selectedEvent; | |
}, | |
shouldIgnoreEventPointing: function() { | |
// only call the handlers if there is not a drag/resize in progress | |
return (this.eventDragging && this.eventDragging.isDragging) || | |
(this.eventResizing && this.eventResizing.isResizing); | |
}, | |
canStartSelection: function(seg, ev) { | |
return getEvIsTouch(ev) && | |
!this.canStartResize(seg, ev) && | |
(this.isEventDefDraggable(seg.footprint.eventDef) || | |
this.isEventDefResizable(seg.footprint.eventDef)); | |
}, | |
canStartDrag: function(seg, ev) { | |
return !this.canStartResize(seg, ev) && | |
this.isEventDefDraggable(seg.footprint.eventDef); | |
}, | |
canStartResize: function(seg, ev) { | |
var view = this._getView(); | |
var eventDef = seg.footprint.eventDef; | |
return (!getEvIsTouch(ev) || view.isEventDefSelected(eventDef)) && | |
this.isEventDefResizable(eventDef) && | |
$(ev.target).is('.fc-resizer'); | |
}, | |
// 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. | |
endInteractions: function() { | |
[ | |
this.dateClicking, | |
this.dateSelecting, | |
this.eventPointing, | |
this.eventDragging, | |
this.eventResizing | |
].forEach(function(interaction) { | |
if (interaction) { | |
interaction.end(); | |
} | |
}); | |
}, | |
// Event Drag-n-Drop | |
// --------------------------------------------------------------------------------------------------------------- | |
// Computes if the given event is allowed to be dragged by the user | |
isEventDefDraggable: function(eventDef) { | |
return this.isEventDefStartEditable(eventDef); | |
}, | |
isEventDefStartEditable: function(eventDef) { | |
var isEditable = eventDef.isStartExplicitlyEditable(); | |
if (isEditable == null) { | |
isEditable = this.opt('eventStartEditable'); | |
if (isEditable == null) { | |
isEditable = this.isEventDefGenerallyEditable(eventDef); | |
} | |
} | |
return isEditable; | |
}, | |
isEventDefGenerallyEditable: function(eventDef) { | |
var isEditable = eventDef.isExplicitlyEditable(); | |
if (isEditable == null) { | |
isEditable = this.opt('editable'); | |
} | |
return isEditable; | |
}, | |
// Event Resizing | |
// --------------------------------------------------------------------------------------------------------------- | |
// Computes if the given event is allowed to be resized from its starting edge | |
isEventDefResizableFromStart: function(eventDef) { | |
return this.opt('eventResizableFromStart') && this.isEventDefResizable(eventDef); | |
}, | |
// Computes if the given event is allowed to be resized from its ending edge | |
isEventDefResizableFromEnd: function(eventDef) { | |
return this.isEventDefResizable(eventDef); | |
}, | |
// Computes if the given event is allowed to be resized by the user at all | |
isEventDefResizable: function(eventDef) { | |
var isResizable = eventDef.isDurationExplicitlyEditable(); | |
if (isResizable == null) { | |
isResizable = this.opt('eventDurationEditable'); | |
if (isResizable == null) { | |
isResizable = this.isEventDefGenerallyEditable(eventDef); | |
} | |
} | |
return isResizable; | |
}, | |
// Event Mutation / Constraints | |
// --------------------------------------------------------------------------------------------------------------- | |
// 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); | |
} | |
}, | |
// is it allowed, in relation to the view's validRange? | |
// NOTE: very similar to isExternalInstanceGroupAllowed | |
isEventInstanceGroupAllowed: function(eventInstanceGroup) { | |
var view = this._getView(); | |
var dateProfile = this.get('dateProfile'); | |
var eventFootprints = this.eventRangesToEventFootprints(eventInstanceGroup.getAllEventRanges()); | |
var i; | |
for (i = 0; i < eventFootprints.length; i++) { | |
// TODO: just use getAllEventRanges directly | |
if (!dateProfile.validUnzonedRange.containsRange(eventFootprints[i].componentFootprint.unzonedRange)) { | |
return false; | |
} | |
} | |
return view.calendar.isEventInstanceGroupAllowed(eventInstanceGroup); | |
}, | |
// NOTE: very similar to isEventInstanceGroupAllowed | |
// when it's a completely anonymous external drag, no event. | |
isExternalInstanceGroupAllowed: function(eventInstanceGroup) { | |
var view = this._getView(); | |
var dateProfile = this.get('dateProfile'); | |
var eventFootprints = this.eventRangesToEventFootprints(eventInstanceGroup.getAllEventRanges()); | |
var i; | |
for (i = 0; i < eventFootprints.length; i++) { | |
if (!dateProfile.validUnzonedRange.containsRange(eventFootprints[i].componentFootprint.unzonedRange)) { | |
return false; | |
} | |
} | |
for (i = 0; i < eventFootprints.length; i++) { | |
// treat it as a selection | |
// TODO: pass in eventInstanceGroup instead | |
// because we don't want calendar's constraint system to depend on a component's | |
// determination of footprints. | |
if (!view.calendar.isSelectionFootprintAllowed(eventFootprints[i].componentFootprint)) { | |
return false; | |
} | |
} | |
return true; | |
} | |
}); | |
;; | |
/* | |
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 calendar = view.calendar; | |
var dateProfile = this.get('dateProfile'); | |
var date = calendar.msToUtcMoment(dateProfile.renderUnzonedRange.startMs, true); | |
var end = calendar.msToUtcMoment(dateProfile.renderUnzonedRange.endMs, true); | |
var dayIndex = -1; | |
var dayIndices = []; | |
var dayDates = []; | |
var daysPerRow; | |
var firstDay; | |
var rowCnt; | |
while (date.isBefore(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.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.dayDates[0], '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.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(unzonedRange) { | |
var daysPerRow = this.daysPerRow; | |
var normalRange = this.view.computeDayRange(unzonedRange); // 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(unzonedRange) { | |
var daysPerRow = this.daysPerRow; | |
var normalRange = this.view.computeDayRange(unzonedRange); // 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 theme = this.view.calendar.theme; | |
return '' + | |
'<div class="fc-row ' + theme.getClass('headerRow') + '">' + | |
'<table class="' + theme.getClass('tableGrid') + '">' + | |
'<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; | |
var isDateValid = this.get('dateProfile').activeUnzonedRange.containsDate(date); // TODO: called too frequently. cache somehow. | |
var classNames = [ | |
'fc-day-header', | |
view.calendar.theme.getClass('widgetHeader') | |
]; | |
var innerHtml = htmlEscape(date.format(this.colHeadFormat)); | |
// if only one row of days, the classNames on the header can represent the specific days beneath | |
if (this.rowCnt === 1) { | |
classNames = classNames.concat( | |
// includes the day-of-week class | |
// noThemeHighlight=true (don't highlight the header) | |
this.getDayClasses(date, true) | |
); | |
} | |
else { | |
classNames.push('fc-' + dayIDs[date.day()]); // only add the day-of-week class | |
} | |
return '' + | |
'<th class="' + classNames.join(' ') + '"' + | |
((isDateValid && this.rowCnt) === 1 ? | |
' data-date="' + date.format('YYYY-MM-DD') + '"' : | |
'') + | |
(colspan > 1 ? | |
' colspan="' + colspan + '"' : | |
'') + | |
(otherAttrs ? | |
' ' + otherAttrs : | |
'') + | |
'>' + | |
(isDateValid ? | |
// 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 }, | |
innerHtml | |
) : | |
// if not valid, display text, but no link | |
innerHtml | |
) + | |
'</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 isDateValid = this.get('dateProfile').activeUnzonedRange.containsDate(date); // TODO: called too frequently. cache somehow. | |
var classes = this.getDayClasses(date); | |
classes.unshift('fc-day', view.calendar.theme.getClass('widgetContent')); | |
return '<td class="' + classes.join(' ') + '"' + | |
(isDateValid ? | |
' 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); | |
} | |
} | |
} | |
}; | |
;; | |
/* An abstract class from which other views inherit from | |
----------------------------------------------------------------------------------------------------------------------*/ | |
var View = FC.View = InteractiveDateComponent.extend({ | |
type: null, // subclass' view name (string) | |
name: null, // deprecated. use `type` instead | |
title: null, // the text that will be displayed in the header's title | |
calendar: null, // owner Calendar object | |
viewSpec: null, | |
options: null, // hash containing all options. already merged with view-specific-options | |
isDatesRendered: false, | |
queuedScroll: null, | |
isSelected: false, // boolean whether a range of time is user-selected or not | |
selectedEventInstance: null, | |
eventOrderSpecs: null, // criteria for ordering events when they have same date/time | |
// for date utils, computed from options | |
isHiddenDayHash: null, | |
// now indicator | |
isNowIndicatorRendered: null, | |
initialNowDate: null, // result first getNow call | |
initialNowQueriedMs: null, // ms time the getNow was called | |
nowIndicatorTimeoutID: null, // for refresh timing of now indicator | |
nowIndicatorIntervalID: null, // " | |
minSegmentHeight: 0, // allows setting a min-height to the event segment to prevent short events overlapping each other | |
constructor: function(calendar, viewSpec) { | |
this.calendar = calendar; | |
this.viewSpec = viewSpec; | |
// shortcuts | |
this.type = viewSpec.type; | |
this.options = viewSpec.options; | |
// .name is deprecated | |
this.name = this.type; | |
InteractiveDateComponent.call(this); | |
this.initHiddenDays(); | |
this.eventOrderSpecs = parseFieldSpecs(this.opt('eventOrder')); | |
// legacy | |
if (this.initialize) { | |
this.initialize(); | |
} | |
this.on('all:dateRender', this.onAllDateRender); | |
this.on('before:all:dateUnrender', this.onBeforeAllDateUnrender); | |
this.on('all:eventRender', this.onAllEventRender); | |
this.on('before:all:eventUnrender', this.onBeforeAllEventUnrender); | |
}, | |
_getView: function() { | |
return this; | |
}, | |
// Retrieves an option with the given name | |
opt: function(name) { | |
return this.options[name]; | |
}, | |
/* Title and Date Formatting | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Computes what the title at the top of the calendar should be for this view | |
computeTitle: function(dateProfile) { | |
var unzonedRange; | |
// for views that span a large unit of time, show the proper interval, ignoring stray days before and after | |
if (/^(year|month)$/.test(dateProfile.currentRangeUnit)) { | |
unzonedRange = dateProfile.currentUnzonedRange; | |
} | |
else { // for day units or smaller, use the actual day range | |
unzonedRange = dateProfile.activeUnzonedRange; | |
} | |
return this.formatRange( | |
{ | |
start: this.calendar.msToMoment(unzonedRange.startMs, dateProfile.isRangeAllDay), | |
end: this.calendar.msToMoment(unzonedRange.endMs, dateProfile.isRangeAllDay) | |
}, | |
dateProfile.isRangeAllDay, | |
this.opt('titleFormat') || this.computeTitleFormat(), | |
this.opt('titleRangeSeparator') | |
); | |
}, | |
// Generates the format string that should be used to generate the title for the current date range. | |
// Attempts to compute the most appropriate format if not explicitly specified with `titleFormat`. | |
computeTitleFormat: function() { | |
var currentRangeUnit = this.get('dateProfile').currentRangeUnit; | |
if (currentRangeUnit == 'year') { | |
return 'YYYY'; | |
} | |
else if (currentRangeUnit == 'month') { | |
return this.opt('monthYearFormat'); // like "September 2014" | |
} | |
else if (this.currentRangeAs('days') > 1) { | |
return 'll'; // multi-day range. shorter, like "Sep 9 - 10 2014" | |
} | |
else { | |
return 'LL'; // one day. longer, like "September 9 2014" | |
} | |
}, | |
// Element | |
// ----------------------------------------------------------------------------------------------------------------- | |
setElement: function(el) { | |
var _this = this; | |
InteractiveDateComponent.prototype.setElement.apply(this, arguments); | |
// TODO: not best place for this | |
// TODO: better way of forwarding options from calendar -> view | |
this.calendar.optionsModel.watch('viewRawBusinessHours' + this.uid, [ 'businessHours' ], function(deps) { | |
_this.set('rawBusinessHours', deps.businessHours); | |
}, function() { | |
_this.unset('rawBusinessHours'); | |
}); | |
}, | |
removeElement: function() { | |
this.calendar.optionsModel.unwatch('viewRawBusinessHours' + this.uid); | |
InteractiveDateComponent.prototype.removeElement.apply(this, arguments); | |
}, | |
// Date Setting/Unsetting | |
// ----------------------------------------------------------------------------------------------------------------- | |
setDate: function(date) { | |
var currentDateProfile = this.get('dateProfile'); | |
var newDateProfile = this.buildDateProfile(date, null, true); // forceToValid=true | |
if ( | |
!currentDateProfile || | |
!currentDateProfile.activeUnzonedRange.equals(newDateProfile.activeUnzonedRange) | |
) { | |
this.set('dateProfile', newDateProfile); | |
} | |
}, | |
unsetDate: function() { | |
this.unset('dateProfile'); | |
}, | |
handleDateProfileSet: function(dateProfile) { | |
InteractiveDateComponent.prototype.handleDateProfileSet.apply(this, arguments); | |
var calendar = this.calendar; | |
// DEPRECATED, but we need to keep it updated... | |
this.start = calendar.msToMoment(dateProfile.activeUnzonedRange.startMs, dateProfile.isRangeAllDay); | |
this.end = calendar.msToMoment(dateProfile.activeUnzonedRange.endMs, dateProfile.isRangeAllDay); | |
this.intervalStart = calendar.msToMoment(dateProfile.currentUnzonedRange.startMs, dateProfile.isRangeAllDay); | |
this.intervalEnd = calendar.msToMoment(dateProfile.currentUnzonedRange.endMs, dateProfile.isRangeAllDay); | |
this.title = this.computeTitle(dateProfile); | |
calendar.reportViewDatesChanged(this, dateProfile); // TODO: reverse the pubsub | |
}, | |
// Event Data | |
// ----------------------------------------------------------------------------------------------------------------- | |
fetchInitialEvents: function(dateProfile) { | |
var calendar = this.calendar; | |
var forceAllDay = dateProfile.isRangeAllDay && !this.usesMinMaxTime; | |
return calendar.requestEvents( | |
calendar.msToMoment(dateProfile.activeUnzonedRange.startMs, forceAllDay), | |
calendar.msToMoment(dateProfile.activeUnzonedRange.endMs, forceAllDay) | |
); | |
}, | |
bindEventChanges: function() { | |
// can write this shorter? | |
this.listenTo(this.calendar, 'eventsReset', this.handleEventsReset); | |
//this.listenTo(this.calendar, 'eventAdd', this.handleEventAddOrUpdate); | |
//this.listenTo(this.calendar, 'eventUpdate', this.handleEventAddOrUpdate); | |
//this.listenTo(this.calendar, 'eventRemove', this.handleEventRemove); | |
}, | |
unbindEventChanges: function() { | |
// can write this shorter? | |
this.stopListeningTo(this.calendar, 'eventsReset'); | |
//this.stopListeningTo(this.calendar, 'eventAdd'); | |
//this.stopListeningTo(this.calendar, 'eventUpdate'); | |
//this.stopListeningTo(this.calendar, 'eventRemove'); | |
}, | |
// Date High-level Rendering | |
// ----------------------------------------------------------------------------------------------------------------- | |
// if dateProfile not specified, uses current | |
executeDateRender: function(dateProfile, skipScroll) { | |
if (this.render) { | |
this.render(); // TODO: deprecate | |
} | |
this.renderDates(dateProfile); | |
this.startNowIndicator(); // shouldn't render yet because updateSize will be called soon | |
if (!skipScroll) { | |
this.addScroll(this.computeInitialDateScroll()); | |
} | |
this.trigger('dateRender'); | |
this.isDatesRendered = true; | |
}, | |
executeDateUnrender: function() { | |
this.unselect(); | |
this.stopNowIndicator(); | |
this.trigger('before:dateUnrender'); | |
this.unrenderDates(); | |
if (this.destroy) { | |
this.destroy(); // TODO: deprecate | |
} | |
this.isDatesRendered = false; | |
}, | |
// Determing when the "meat" of the view is rendered (aka the base) | |
// ----------------------------------------------------------------------------------------------------------------- | |
onAllDateRender: function() { | |
if (this.hasPublicHandlers('viewRender')) { | |
this.applyScreenState(); | |
this.publiclyTrigger('viewRender', { | |
context: this, | |
args: [ this, this.el ] | |
}); | |
} | |
}, | |
onBeforeAllDateUnrender: function() { | |
if (this.hasPublicHandlers('viewDestroy')) { | |
this.applyScreenState(); // TODO: only call if hasHandlers! | |
this.publiclyTrigger('viewDestroy', { | |
context: this, | |
args: [ this, this.el ] | |
}); | |
} | |
}, | |
// Misc view rendering utils | |
// ----------------------------------------------------------------------------------------------------------------- | |
// Binds DOM handlers to elements that reside outside the view container, such as the document | |
bindGlobalHandlers: function() { | |
InteractiveDateComponent.prototype.bindGlobalHandlers.apply(this, arguments); | |
this.listenTo(GlobalEmitter.get(), { | |
touchstart: this.processUnselect, | |
mousedown: this.handleDocumentMousedown | |
}); | |
}, | |
// Unbinds DOM handlers from elements that reside outside the view container | |
unbindGlobalHandlers: function() { | |
InteractiveDateComponent.prototype.unbindGlobalHandlers.apply(this, arguments); | |
this.stopListeningTo(GlobalEmitter.get()); | |
}, | |
/* Now Indicator | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Immediately render the current time indicator and begins re-rendering it at an interval, | |
// which is defined by this.getNowIndicatorUnit(). | |
// TODO: somehow do this for the current whole day's background too | |
startNowIndicator: function() { | |
var _this = this; | |
var unit; | |
var update; | |
var delay; // ms wait value | |
if (this.opt('nowIndicator')) { | |
unit = this.getNowIndicatorUnit(); | |
if (unit) { | |
update = proxy(this, 'updateNowIndicator'); // bind to `this` | |
this.initialNowDate = this.calendar.getNow(); | |
this.initialNowQueriedMs = +new Date(); | |
// wait until the beginning of the next interval | |
delay = this.initialNowDate.clone().startOf(unit).add(1, unit) - this.initialNowDate; | |
this.nowIndicatorTimeoutID = setTimeout(function() { | |
_this.nowIndicatorTimeoutID = null; | |
update(); | |
delay = +moment.duration(1, unit); | |
delay = Math.max(100, delay); // prevent too frequent | |
_this.nowIndicatorIntervalID = setInterval(update, delay); // update every interval | |
}, delay); | |
} | |
// rendering will be initiated in updateSize | |
} | |
}, | |
// rerenders the now indicator, computing the new current time from the amount of time that has passed | |
// since the initial getNow call. | |
updateNowIndicator: function() { | |
if (this.nowIndicatorTimeoutID) { // activated? | |
this.unrenderNowIndicator(); // won't unrender if unnecessary | |
this.renderNowIndicator( | |
this.initialNowDate.clone().add(new Date() - this.initialNowQueriedMs) // add ms | |
); | |
this.isNowIndicatorRendered = true; | |
} | |
}, | |
// Immediately unrenders the view's current time indicator and stops any re-rendering timers. | |
// Won't cause side effects if indicator isn't rendered. | |
stopNowIndicator: function() { | |
if (this.isNowIndicatorRendered) { | |
if (this.nowIndicatorTimeoutID) { | |
clearTimeout(this.nowIndicatorTimeoutID); | |
this.nowIndicatorTimeoutID = null; | |
} | |
if (this.nowIndicatorIntervalID) { | |
clearTimeout(this.nowIndicatorIntervalID); | |
this.nowIndicatorIntervalID = null; | |
} | |
this.unrenderNowIndicator(); | |
this.isNowIndicatorRendered = false; | |
} | |
}, | |
/* Dimensions | |
------------------------------------------------------------------------------------------------------------------*/ | |
updateSize: function(totalHeight, isAuto, isResize) { | |
if (this.setHeight) { // for legacy API | |
this.setHeight(totalHeight, isAuto); | |
} | |
else { | |
InteractiveDateComponent.prototype.updateSize.apply(this, arguments); | |
} | |
this.updateNowIndicator(); | |
}, | |
/* Scroller | |
------------------------------------------------------------------------------------------------------------------*/ | |
addForcedScroll: function(scroll) { | |
this.addScroll( | |
$.extend(scroll, { isForced: true }) | |
); | |
}, | |
addScroll: function(scroll) { | |
var queuedScroll = this.queuedScroll || (this.queuedScroll = {}); | |
if (!queuedScroll.isForced) { | |
$.extend(queuedScroll, scroll); | |
} | |
}, | |
popScroll: function() { | |
this.applyQueuedScroll(); | |
this.queuedScroll = null; | |
}, | |
applyQueuedScroll: function() { | |
if (this.queuedScroll) { | |
this.applyScroll(this.queuedScroll); | |
} | |
}, | |
queryScroll: function() { | |
var scroll = {}; | |
if (this.isDatesRendered) { | |
$.extend(scroll, this.queryDateScroll()); | |
} | |
return scroll; | |
}, | |
applyScroll: function(scroll) { | |
if (this.isDatesRendered) { | |
this.applyDateScroll(scroll); | |
} | |
}, | |
computeInitialDateScroll: function() { | |
return {}; // subclasses must implement | |
}, | |
queryDateScroll: function() { | |
return {}; // subclasses must implement | |
}, | |
applyDateScroll: function(scroll) { | |
; // subclasses must implement | |
}, | |
// Event High-level Rendering | |
// ----------------------------------------------------------------------------------------------------------------- | |
executeEventsRender: function(eventsPayload) { | |
if (this.renderEvents) { // for legacy custom views | |
this.renderEvents(convertEventsPayloadToLegacyArray(eventsPayload)); | |
} | |
else { | |
this.renderEventsPayload(eventsPayload); | |
} | |
this.trigger('eventRender'); | |
}, | |
executeEventsUnrender: function() { | |
this.trigger('before:eventUnrender'); | |
if (this.destroyEvents) { | |
this.destroyEvents(); // TODO: deprecate | |
} | |
this.unrenderEvents(); | |
}, | |
rerenderEvents: function() { | |
if (this.has('currentEvents')) { | |
// re-transmit events to this DateComponent, which will forward on the events to children as well. | |
this.handleEventsReset(this.get('currentEvents')); | |
} | |
}, | |
// Event Rendering Triggers | |
// ----------------------------------------------------------------------------------------------------------------- | |
// Signals that all events have been rendered | |
onAllEventRender: function() { | |
var _this = this; | |
var hasSingleHandlers = this.hasPublicHandlers('eventAfterRender'); | |
if (hasSingleHandlers || this.hasPublicHandlers('eventAfterAllRender')) { | |
this.applyScreenState(); | |
} | |
if (hasSingleHandlers) { | |
this.getEventSegs().forEach(function(seg) { | |
var legacy; | |
if (seg.el) { // necessary? | |
legacy = seg.footprint.getEventLegacy(); | |
_this.publiclyTrigger('eventAfterRender', { | |
context: legacy, | |
args: [ legacy, seg.el, _this ] | |
}); | |
} | |
}); | |
} | |
this.publiclyTrigger('eventAfterAllRender', { | |
context: this, | |
args: [ this ] | |
}); | |
}, | |
// Signals that all event elements are about to be removed | |
onBeforeAllEventUnrender: function() { | |
var _this = this; | |
if (this.hasPublicHandlers('eventDestroy')) { | |
this.applyScreenState(); | |
this.getEventSegs().forEach(function(seg) { | |
var legacy; | |
if (seg.el) { // necessary? | |
legacy = seg.footprint.getEventLegacy(); | |
_this.publiclyTrigger('eventDestroy', { | |
context: legacy, | |
args: [ legacy, seg.el, _this ] | |
}); | |
} | |
}); | |
} | |
}, | |
// TODO: move this to Calendar, as well as scroll system | |
applyScreenState: function() { | |
this.calendar.updateViewSize( | |
false, // isResize | |
this // view (because Calendar::view might have changed) | |
); | |
// bring to natural height, then freeze again | |
this.calendar.thawContentHeight(); | |
this.calendar.freezeContentHeight(); | |
this.applyQueuedScroll(); | |
}, | |
// Event Rendering Utils | |
// ----------------------------------------------------------------------------------------------------------------- | |
// TODO: move this to DateComponent | |
// Hides all rendered event segments linked to the given event | |
showEventsWithId: function(eventDefId) { | |
this.getEventSegs().forEach(function(seg) { | |
if ( | |
seg.footprint.eventDef.id === eventDefId && | |
seg.el // necessary? | |
) { | |
seg.el.css('visibility', ''); | |
} | |
}); | |
}, | |
// Shows all rendered event segments linked to the given event | |
hideEventsWithId: function(eventDefId) { | |
this.getEventSegs().forEach(function(seg) { | |
if ( | |
seg.footprint.eventDef.id === eventDefId && | |
seg.el // necessary? | |
) { | |
seg.el.css('visibility', 'hidden'); | |
} | |
}); | |
}, | |
/* Event Drag-n-Drop | |
------------------------------------------------------------------------------------------------------------------*/ | |
reportEventDrop: function(eventInstance, eventMutation, el, ev) { | |
var eventManager = this.calendar.eventManager; | |
var undoFunc = eventManager.mutateEventsWithId( | |
eventInstance.def.id, | |
eventMutation, | |
this.calendar | |
); | |
var dateMutation = eventMutation.dateMutation; | |
// update the EventInstance, for handlers | |
if (dateMutation) { | |
eventInstance.dateProfile = dateMutation.buildNewDateProfile( | |
eventInstance.dateProfile, | |
this.calendar | |
); | |
} | |
this.triggerEventDrop( | |
eventInstance, | |
// a drop doesn't necessarily mean a date mutation (ex: resource change) | |
(dateMutation && dateMutation.dateDelta) || moment.duration(), | |
undoFunc, | |
el, ev | |
); | |
}, | |
// Triggers event-drop handlers that have subscribed via the API | |
triggerEventDrop: function(eventInstance, dateDelta, undoFunc, el, ev) { | |
this.publiclyTrigger('eventDrop', { | |
context: el[0], | |
args: [ | |
eventInstance.toLegacy(), | |
dateDelta, | |
undoFunc, | |
ev, | |
{}, // {} = jqui dummy | |
this | |
] | |
}); | |
}, | |
/* External Element Drag-n-Drop | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Must be called when an external element, via jQuery UI, has been dropped onto the calendar. | |
// `meta` is the parsed data that has been embedded into the dragging event. | |
// `dropLocation` is an object that contains the new zoned start/end/allDay values for the event. | |
reportExternalDrop: function(singleEventDef, isEvent, isSticky, el, ev, ui) { | |
if (isEvent) { | |
this.calendar.eventManager.addEventDef(singleEventDef, isSticky); | |
} | |
this.triggerExternalDrop(singleEventDef, isEvent, el, ev, ui); | |
}, | |
// Triggers external-drop handlers that have subscribed via the API | |
triggerExternalDrop: function(singleEventDef, isEvent, el, ev, ui) { | |
// trigger 'drop' regardless of whether element represents an event | |
this.publiclyTrigger('drop', { | |
context: el[0], | |
args: [ | |
singleEventDef.dateProfile.start.clone(), | |
ev, | |
ui, | |
this | |
] | |
}); | |
if (isEvent) { | |
// signal an external event landed | |
this.publiclyTrigger('eventReceive', { | |
context: this, | |
args: [ | |
singleEventDef.buildInstance().toLegacy(), | |
this | |
] | |
}); | |
} | |
}, | |
/* Event Resizing | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Must be called when an event in the view has been resized to a new length | |
reportEventResize: function(eventInstance, eventMutation, el, ev) { | |
var eventManager = this.calendar.eventManager; | |
var undoFunc = eventManager.mutateEventsWithId( | |
eventInstance.def.id, | |
eventMutation, | |
this.calendar | |
); | |
// update the EventInstance, for handlers | |
eventInstance.dateProfile = eventMutation.dateMutation.buildNewDateProfile( | |
eventInstance.dateProfile, | |
this.calendar | |
); | |
this.triggerEventResize( | |
eventInstance, | |
eventMutation.dateMutation.endDelta, | |
undoFunc, | |
el, ev | |
); | |
}, | |
// Triggers event-resize handlers that have subscribed via the API | |
triggerEventResize: function(eventInstance, durationDelta, undoFunc, el, ev) { | |
this.publiclyTrigger('eventResize', { | |
context: el[0], | |
args: [ | |
eventInstance.toLegacy(), | |
durationDelta, | |
undoFunc, | |
ev, | |
{}, // {} = jqui dummy | |
this | |
] | |
}); | |
}, | |
/* Selection (time range) | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Selects a date span on the view. `start` and `end` are both Moments. | |
// `ev` is the native mouse event that begin the interaction. | |
select: function(footprint, ev) { | |
this.unselect(ev); | |
this.renderSelectionFootprint(footprint); | |
this.reportSelection(footprint, ev); | |
}, | |
renderSelectionFootprint: function(footprint, ev) { | |
if (this.renderSelection) { // legacy method in custom view classes | |
this.renderSelection( | |
footprint.toLegacy(this.calendar) | |
); | |
} | |
else { | |
InteractiveDateComponent.prototype.renderSelectionFootprint.apply(this, arguments); | |
} | |
}, | |
// Called when a new selection is made. Updates internal state and triggers handlers. | |
reportSelection: function(footprint, ev) { | |
this.isSelected = true; | |
this.triggerSelect(footprint, ev); | |
}, | |
// Triggers handlers to 'select' | |
triggerSelect: function(footprint, ev) { | |
var dateProfile = this.calendar.footprintToDateProfile(footprint); // abuse of "Event"DateProfile? | |
this.publiclyTrigger('select', { | |
context: this, | |
args: [ | |
dateProfile.start, | |
dateProfile.end, | |
ev, | |
this | |
] | |
}); | |
}, | |
// Undoes a selection. updates in the internal state and triggers handlers. | |
// `ev` is the native mouse event that began the interaction. | |
unselect: function(ev) { | |
if (this.isSelected) { | |
this.isSelected = false; | |
if (this.destroySelection) { | |
this.destroySelection(); // TODO: deprecate | |
} | |
this.unrenderSelection(); | |
this.publiclyTrigger('unselect', { | |
context: this, | |
args: [ ev, this ] | |
}); | |
} | |
}, | |
/* Event Selection | |
------------------------------------------------------------------------------------------------------------------*/ | |
selectEventInstance: function(eventInstance) { | |
if ( | |
!this.selectedEventInstance || | |
this.selectedEventInstance !== eventInstance | |
) { | |
this.unselectEventInstance(); | |
this.getEventSegs().forEach(function(seg) { | |
if ( | |
seg.footprint.eventInstance === eventInstance && | |
seg.el // necessary? | |
) { | |
seg.el.addClass('fc-selected'); | |
} | |
}); | |
this.selectedEventInstance = eventInstance; | |
} | |
}, | |
unselectEventInstance: function() { | |
if (this.selectedEventInstance) { | |
this.getEventSegs().forEach(function(seg) { | |
if (seg.el) { // necessary? | |
seg.el.removeClass('fc-selected'); | |
} | |
}); | |
this.selectedEventInstance = null; | |
} | |
}, | |
isEventDefSelected: function(eventDef) { | |
// event references might change on refetchEvents(), while selectedEventInstance doesn't, | |
// so compare IDs | |
return this.selectedEventInstance && this.selectedEventInstance.def.id === eventDef.id; | |
}, | |
/* Mouse / Touch Unselecting (time range & event unselection) | |
------------------------------------------------------------------------------------------------------------------*/ | |
// TODO: move consistently to down/start or up/end? | |
// TODO: don't kill previous selection if touch scrolling | |
handleDocumentMousedown: function(ev) { | |
if (isPrimaryMouseButton(ev)) { | |
this.processUnselect(ev); | |
} | |
}, | |
processUnselect: function(ev) { | |
this.processRangeUnselect(ev); | |
this.processEventUnselect(ev); | |
}, | |
processRangeUnselect: function(ev) { | |
var ignore; | |
// is there a time-range selection? | |
if (this.isSelected && this.opt('unselectAuto')) { | |
// only unselect if the clicked element is not identical to or inside of an 'unselectCancel' element | |
ignore = this.opt('unselectCancel'); | |
if (!ignore || !$(ev.target).closest(ignore).length) { | |
this.unselect(ev); | |
} | |
} | |
}, | |
processEventUnselect: function(ev) { | |
if (this.selectedEventInstance) { | |
if (!$(ev.target).closest('.fc-selected').length) { | |
this.unselectEventInstance(); | |
} | |
} | |
}, | |
/* Day Click | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Triggers handlers to 'dayClick' | |
// Span has start/end of the clicked area. Only the start is useful. | |
triggerDayClick: function(footprint, dayEl, ev) { | |
var dateProfile = this.calendar.footprintToDateProfile(footprint); // abuse of "Event"DateProfile? | |
this.publiclyTrigger('dayClick', { | |
context: dayEl, | |
args: [ dateProfile.start, ev, this ] | |
}); | |
} | |
}); | |
// responsible for populating data that DateComponent relies on | |
View.watch('businessHours', [ 'rawBusinessHours', 'dateProfile' ], function(deps) { | |
return new BusinessHours( | |
deps.rawBusinessHours, | |
deps.dateProfile.activeUnzonedRange, | |
this.calendar | |
); | |
}); | |
View.watch('initialEvents', [ 'dateProfile' ], function(deps) { | |
return this.fetchInitialEvents(deps.dateProfile); | |
}); | |
View.watch('bindingEvents', [ 'initialEvents' ], function(deps) { | |
this.handleEventsSet(deps.initialEvents); | |
this.bindEventChanges(); | |
}, function() { | |
this.unbindEventChanges(); | |
this.handleEventsUnset(); | |
}); | |
// legacy | |
function convertEventsPayloadToLegacyArray(eventsPayload) { | |
var legacyEvents = []; | |
var id; | |
var eventInstances; | |
var i; | |
for (id in eventsPayload) { | |
eventInstances = eventsPayload[id].eventInstances; | |
for (i = 0; i < eventInstances.length; i++) { | |
legacyEvents.push( | |
eventInstances[i].toLegacy() | |
); | |
} | |
} | |
return legacyEvents; | |
} | |
;; | |
View.mixin({ | |
usesMinMaxTime: false, // whether minTime/maxTime will affect the activeUnzonedRange. Views must opt-in. | |
// DEPRECATED | |
start: null, // use activeUnzonedRange | |
end: null, // use activeUnzonedRange | |
intervalStart: null, // use currentUnzonedRange | |
intervalEnd: null, // use currentUnzonedRange | |
/* Date Range Computation | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Builds a structure with info about what the dates/ranges will be for the "prev" view. | |
buildPrevDateProfile: function(date) { | |
var dateProfile = this.get('dateProfile'); | |
var prevDate = date.clone().startOf(dateProfile.currentRangeUnit) | |
.subtract(dateProfile.dateIncrement); | |
return this.buildDateProfile(prevDate, -1); | |
}, | |
// Builds a structure with info about what the dates/ranges will be for the "next" view. | |
buildNextDateProfile: function(date) { | |
var dateProfile = this.get('dateProfile'); | |
var nextDate = date.clone().startOf(dateProfile.currentRangeUnit) | |
.add(dateProfile.dateIncrement); | |
return this.buildDateProfile(nextDate, 1); | |
}, | |
// Builds a structure holding dates/ranges for rendering around the given date. | |
// Optional direction param indicates whether the date is being incremented/decremented | |
// from its previous value. decremented = -1, incremented = 1 (default). | |
buildDateProfile: function(date, direction, forceToValid) { | |
var isDateAllDay = !date.hasTime(); | |
var validUnzonedRange = this.buildValidRange(); | |
var minTime = null; | |
var maxTime = null; | |
var currentInfo; | |
var isRangeAllDay; | |
var renderUnzonedRange; | |
var activeUnzonedRange; | |
var isValid; | |
if (forceToValid) { | |
date = this.calendar.msToUtcMoment( | |
validUnzonedRange.constrainDate(date), // returns MS | |
isDateAllDay | |
); | |
} | |
currentInfo = this.buildCurrentRangeInfo(date, direction); | |
isRangeAllDay = /^(year|month|week|day)$/.test(currentInfo.unit); | |
renderUnzonedRange = this.buildRenderRange(currentInfo.unzonedRange, currentInfo.unit, isRangeAllDay); | |
activeUnzonedRange = renderUnzonedRange.clone(); | |
if (!this.opt('showNonCurrentDates')) { | |
activeUnzonedRange = activeUnzonedRange.intersect(currentInfo.unzonedRange); | |
} | |
minTime = moment.duration(this.opt('minTime')); | |
maxTime = moment.duration(this.opt('maxTime')); | |
activeUnzonedRange = this.adjustActiveRange(activeUnzonedRange, minTime, maxTime); | |
activeUnzonedRange = activeUnzonedRange.intersect(validUnzonedRange); | |
if (activeUnzonedRange) { | |
date = this.calendar.msToUtcMoment( | |
activeUnzonedRange.constrainDate(date), // returns MS | |
isDateAllDay | |
); | |
} | |
// it's invalid if the originally requested date is not contained, | |
// or if the range is completely outside of the valid range. | |
isValid = currentInfo.unzonedRange.intersectsWith(validUnzonedRange); | |
return { | |
// constraint for where prev/next operations can go and where events can be dragged/resized to. | |
// an object with optional start and end properties. | |
validUnzonedRange: validUnzonedRange, | |
// range the view is formally responsible for. | |
// for example, a month view might have 1st-31st, excluding padded dates | |
currentUnzonedRange: currentInfo.unzonedRange, | |
// name of largest unit being displayed, like "month" or "week" | |
currentRangeUnit: currentInfo.unit, | |
isRangeAllDay: isRangeAllDay, | |
// dates that display events and accept drag-n-drop | |
activeUnzonedRange: activeUnzonedRange, | |
// date range with a rendered skeleton | |
// includes not-active days that need some sort of DOM | |
renderUnzonedRange: renderUnzonedRange, | |
// Duration object that denotes the first visible time of any given day | |
minTime: minTime, | |
// Duration object that denotes the exclusive visible end time of any given day | |
maxTime: maxTime, | |
isValid: isValid, | |
date: date, | |
// how far the current date will move for a prev/next operation | |
dateIncrement: this.buildDateIncrement(currentInfo.duration) | |
// pass a fallback (might be null) ^ | |
}; | |
}, | |
// Builds an object with optional start/end properties. | |
// Indicates the minimum/maximum dates to display. | |
buildValidRange: function() { | |
return this.getUnzonedRangeOption('validRange', this.calendar.getNow()) || | |
new UnzonedRange(); // completely open-ended | |
}, | |
// Builds a structure with info about the "current" range, the range that is | |
// highlighted as being the current month for example. | |
// See buildDateProfile for a description of `direction`. | |
// Guaranteed to have `range` and `unit` properties. `duration` is optional. | |
// TODO: accept a MS-time instead of a moment `date`? | |
buildCurrentRangeInfo: function(date, direction) { | |
var duration = null; | |
var unit = null; | |
var unzonedRange = null; | |
var dayCount; | |
if (this.viewSpec.duration) { | |
duration = this.viewSpec.duration; | |
unit = this.viewSpec.durationUnit; | |
unzonedRange = this.buildRangeFromDuration(date, direction, duration, unit); | |
} | |
else if ((dayCount = this.opt('dayCount'))) { | |
unit = 'day'; | |
unzonedRange = this.buildRangeFromDayCount(date, direction, dayCount); | |
} | |
else if ((unzonedRange = this.buildCustomVisibleRange(date))) { | |
unit = computeGreatestUnit(unzonedRange.getStart(), unzonedRange.getEnd()); | |
} | |
else { | |
duration = this.getFallbackDuration(); | |
unit = computeGreatestUnit(duration); | |
unzonedRange = this.buildRangeFromDuration(date, direction, duration, unit); | |
} | |
return { duration: duration, unit: unit, unzonedRange: unzonedRange }; | |
}, | |
getFallbackDuration: function() { | |
return moment.duration({ days: 1 }); | |
}, | |
// Returns a new activeUnzonedRange to have time values (un-ambiguate) | |
// minTime or maxTime causes the range to expand. | |
adjustActiveRange: function(unzonedRange, minTime, maxTime) { | |
var start = unzonedRange.getStart(); | |
var end = unzonedRange.getEnd(); | |
if (this.usesMinMaxTime) { | |
if (minTime < 0) { | |
start.time(0).add(minTime); | |
} | |
if (maxTime > 24 * 60 * 60 * 1000) { // beyond 24 hours? | |
end.time(maxTime - (24 * 60 * 60 * 1000)); | |
} | |
} | |
return new UnzonedRange(start, end); | |
}, | |
// Builds the "current" range when it is specified as an explicit duration. | |
// `unit` is the already-computed computeGreatestUnit value of duration. | |
// TODO: accept a MS-time instead of a moment `date`? | |
buildRangeFromDuration: function(date, direction, duration, unit) { | |
var alignment = this.opt('dateAlignment'); | |
var start = date.clone(); | |
var end; | |
var dateIncrementInput; | |
var dateIncrementDuration; | |
// if the view displays a single day or smaller | |
if (duration.as('days') <= 1) { | |
if (this.isHiddenDay(start)) { | |
start = this.skipHiddenDays(start, direction); | |
start.startOf('day'); | |
} | |
} | |
// compute what the alignment should be | |
if (!alignment) { | |
dateIncrementInput = this.opt('dateIncrement'); | |
if (dateIncrementInput) { | |
dateIncrementDuration = moment.duration(dateIncrementInput); | |
// use the smaller of the two units | |
if (dateIncrementDuration < duration) { | |
alignment = computeDurationGreatestUnit(dateIncrementDuration, dateIncrementInput); | |
} | |
else { | |
alignment = unit; | |
} | |
} | |
else { | |
alignment = unit; | |
} | |
} | |
start.startOf(alignment); | |
end = start.clone().add(duration); | |
return new UnzonedRange(start, end); | |
}, | |
// Builds the "current" range when a dayCount is specified. | |
// TODO: accept a MS-time instead of a moment `date`? | |
buildRangeFromDayCount: function(date, direction, dayCount) { | |
var customAlignment = this.opt('dateAlignment'); | |
var runningCount = 0; | |
var start = date.clone(); | |
var end; | |
if (customAlignment) { | |
start.startOf(customAlignment); | |
} | |
start.startOf('day'); | |
start = this.skipHiddenDays(start, direction); | |
end = start.clone(); | |
do { | |
end.add(1, 'day'); | |
if (!this.isHiddenDay(end)) { | |
runningCount++; | |
} | |
} while (runningCount < dayCount); | |
return new UnzonedRange(start, end); | |
}, | |
// Builds a normalized range object for the "visible" range, | |
// which is a way to define the currentUnzonedRange and activeUnzonedRange at the same time. | |
// TODO: accept a MS-time instead of a moment `date`? | |
buildCustomVisibleRange: function(date) { | |
var visibleUnzonedRange = this.getUnzonedRangeOption( | |
'visibleRange', | |
this.calendar.applyTimezone(date) // correct zone. also generates new obj that avoids mutations | |
); | |
if (visibleUnzonedRange && (visibleUnzonedRange.startMs === null || visibleUnzonedRange.endMs === null)) { | |
return null; | |
} | |
return visibleUnzonedRange; | |
}, | |
// Computes the range that will represent the element/cells for *rendering*, | |
// but which may have voided days/times. | |
buildRenderRange: function(currentUnzonedRange, currentRangeUnit, isRangeAllDay) { | |
// cut off days in the currentUnzonedRange that are hidden | |
return this.trimHiddenDays(currentUnzonedRange); | |
}, | |
// Compute the duration value that should be added/substracted to the current date | |
// when a prev/next operation happens. | |
buildDateIncrement: function(fallback) { | |
var dateIncrementInput = this.opt('dateIncrement'); | |
var customAlignment; | |
if (dateIncrementInput) { | |
return moment.duration(dateIncrementInput); | |
} | |
else if ((customAlignment = this.opt('dateAlignment'))) { | |
return moment.duration(1, customAlignment); | |
} | |
else if (fallback) { | |
return fallback; | |
} | |
else { | |
return moment.duration({ days: 1 }); | |
} | |
}, | |
// Remove days from the beginning and end of the range that are computed as hidden. | |
trimHiddenDays: function(inputUnzonedRange) { | |
var start = inputUnzonedRange.getStart(); | |
var end = inputUnzonedRange.getEnd(); | |
start = this.skipHiddenDays(start); | |
end = this.skipHiddenDays(end, -1, true); | |
return new UnzonedRange(start, end); | |
}, | |
// Compute the number of the give units in the "current" range. | |
// Will return a floating-point number. Won't round. | |
currentRangeAs: function(unit) { | |
var currentUnzonedRange = this.get('dateProfile').currentUnzonedRange; | |
return moment.utc(currentUnzonedRange.endMs).diff( | |
moment.utc(currentUnzonedRange.startMs), | |
unit, | |
true | |
); | |
}, | |
// For DateComponent::getDayClasses | |
isDateInOtherMonth: function(date) { | |
return false; | |
}, | |
// Arguments after name will be forwarded to a hypothetical function value | |
// WARNING: passed-in arguments will be given to generator functions as-is and can cause side-effects. | |
// Always clone your objects if you fear mutation. | |
getUnzonedRangeOption: function(name) { | |
var val = this.opt(name); | |
if (typeof val === 'function') { | |
val = val.apply( | |
null, | |
Array.prototype.slice.call(arguments, 1) | |
); | |
} | |
if (val) { | |
return this.calendar.parseUnzonedRange(val); | |
} | |
}, | |
/* Hidden Days | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Initializes internal variables related to calculating hidden days-of-week | |
initHiddenDays: function() { | |
var hiddenDays = this.opt('hiddenDays') || []; // array of day-of-week indices that are hidden | |
var isHiddenDayHash = []; // is the day-of-week hidden? (hash with day-of-week-index -> bool) | |
var dayCnt = 0; | |
var i; | |
if (this.opt('weekends') === false) { | |
hiddenDays.push(0, 6); // 0=sunday, 6=saturday | |
} | |
for (i = 0; i < 7; i++) { | |
if ( | |
!(isHiddenDayHash[i] = $.inArray(i, hiddenDays) !== -1) | |
) { | |
dayCnt++; | |
} | |
} | |
if (!dayCnt) { | |
throw 'invalid hiddenDays'; // all days were hidden? bad. | |
} | |
this.isHiddenDayHash = isHiddenDayHash; | |
}, | |
// Is the current day hidden? | |
// `day` is a day-of-week index (0-6), or a Moment | |
isHiddenDay: function(day) { | |
if (moment.isMoment(day)) { | |
day = day.day(); | |
} | |
return this.isHiddenDayHash[day]; | |
}, | |
// Incrementing the current day until it is no longer a hidden day, returning a copy. | |
// DOES NOT CONSIDER validUnzonedRange! | |
// If the initial value of `date` is not a hidden day, don't do anything. | |
// Pass `isExclusive` as `true` if you are dealing with an end date. | |
// `inc` defaults to `1` (increment one day forward each time) | |
skipHiddenDays: function(date, inc, isExclusive) { | |
var out = date.clone(); | |
inc = inc || 1; | |
while ( | |
this.isHiddenDayHash[(out.day() + (isExclusive ? inc : 0) + 7) % 7] | |
) { | |
out.add(inc, 'days'); | |
} | |
return out; | |
} | |
}); | |
;; | |
/* Toolbar with buttons and title | |
----------------------------------------------------------------------------------------------------------------------*/ | |
function Toolbar(calendar, toolbarOptions) { | |
var t = this; | |
// exports | |
t.setToolbarOptions = setToolbarOptions; | |
t.render = render; | |
t.removeElement = removeElement; | |
t.updateTitle = updateTitle; | |
t.activateButton = activateButton; | |
t.deactivateButton = deactivateButton; | |
t.disableButton = disableButton; | |
t.enableButton = enableButton; | |
t.getViewsWithButtons = getViewsWithButtons; | |
t.el = null; // mirrors local `el` | |
// locals | |
var el; | |
var viewsWithButtons = []; | |
// method to update toolbar-specific options, not calendar-wide options | |
function setToolbarOptions(newToolbarOptions) { | |
toolbarOptions = newToolbarOptions; | |
} | |
// can be called repeatedly and will rerender | |
function render() { | |
var sections = toolbarOptions.layout; | |
if (sections) { | |
if (!el) { | |
el = this.el = $("<div class='fc-toolbar "+ toolbarOptions.extraClasses + "'/>"); | |
} | |
else { | |
el.empty(); | |
} | |
el.append(renderSection('left')) | |
.append(renderSection('right')) | |
.append(renderSection('center')) | |
.append('<div class="fc-clear"/>'); | |
} | |
else { | |
removeElement(); | |
} | |
} | |
function removeElement() { | |
if (el) { | |
el.remove(); | |
el = t.el = null; | |
} | |
} | |
function renderSection(position) { | |
var theme = calendar.theme; | |
var sectionEl = $('<div class="fc-' + position + '"/>'); | |
var buttonStr = toolbarOptions.layout[position]; | |
var calendarCustomButtons = calendar.opt('customButtons') || {}; | |
var calendarButtonTextOverrides = calendar.overrides.buttonText || {}; | |
var calendarButtonText = calendar.opt('buttonText') || {}; | |
if (buttonStr) { | |
$.each(buttonStr.split(' '), function(i) { | |
var groupChildren = $(); | |
var isOnlyButtons = true; | |
var groupEl; | |
$.each(this.split(','), function(j, buttonName) { | |
var customButtonProps; | |
var viewSpec; | |
var buttonClick; | |
var buttonIcon; // only one of these will be set | |
var buttonText; // " | |
var buttonInnerHtml; | |
var buttonClasses; | |
var buttonEl; | |
if (buttonName == 'title') { | |
groupChildren = groupChildren.add($('<h2> </h2>')); // we always want it to take up height | |
isOnlyButtons = false; | |
} | |
else { | |
if ((customButtonProps = calendarCustomButtons[buttonName])) { | |
buttonClick = function(ev) { | |
if (customButtonProps.click) { | |
customButtonProps.click.call(buttonEl[0], ev); | |
} | |
}; | |
(buttonIcon = theme.getCustomButtonIconClass(customButtonProps)) || | |
(buttonIcon = theme.getIconClass(buttonName)) || | |
(buttonText = customButtonProps.text); // jshint ignore:line | |
} | |
else if ((viewSpec = calendar.getViewSpec(buttonName))) { | |
viewsWithButtons.push(buttonName); | |
buttonClick = function() { | |
calendar.changeView(buttonName); | |
}; | |
(buttonText = viewSpec.buttonTextOverride) || | |
(buttonIcon = theme.getIconClass(buttonName)) || | |
(buttonText = viewSpec.buttonTextDefault); // jshint ignore:line | |
} | |
else if (calendar[buttonName]) { // a calendar method | |
buttonClick = function() { | |
calendar[buttonName](); | |
}; | |
(buttonText = calendarButtonTextOverrides[buttonName]) || | |
(buttonIcon = theme.getIconClass(buttonName)) || | |
(buttonText = calendarButtonText[buttonName]); // jshint ignore:line | |
// ^ everything else is considered default | |
} | |
if (buttonClick) { | |
buttonClasses = [ | |
'fc-' + buttonName + '-button', | |
theme.getClass('button'), | |
theme.getClass('stateDefault') | |
]; | |
if (buttonText) { | |
buttonInnerHtml = htmlEscape(buttonText); | |
} | |
else if (buttonIcon) { | |
buttonInnerHtml = "<span class='" + buttonIcon + "'></span>"; | |
} | |
buttonEl = $( // type="button" so that it doesn't submit a form | |
'<button type="button" class="' + buttonClasses.join(' ') + '">' + | |
buttonInnerHtml + | |
'</button>' | |
) | |
.click(function(ev) { | |
// don't process clicks for disabled buttons | |
if (!buttonEl.hasClass(theme.getClass('stateDisabled'))) { | |
buttonClick(ev); | |
// after the click action, if the button becomes the "active" tab, or disabled, | |
// it should never have a hover class, so remove it now. | |
if ( | |
buttonEl.hasClass(theme.getClass('stateActive')) || | |
buttonEl.hasClass(theme.getClass('stateDisabled')) | |
) { | |
buttonEl.removeClass(theme.getClass('stateHover')); | |
} | |
} | |
}) | |
.mousedown(function() { | |
// the *down* effect (mouse pressed in). | |
// only on buttons that are not the "active" tab, or disabled | |
buttonEl | |
.not('.' + theme.getClass('stateActive')) | |
.not('.' + theme.getClass('stateDisabled')) | |
.addClass(theme.getClass('stateDown')); | |
}) | |
.mouseup(function() { | |
// undo the *down* effect | |
buttonEl.removeClass(theme.getClass('stateDown')); | |
}) | |
.hover( | |
function() { | |
// the *hover* effect. | |
// only on buttons that are not the "active" tab, or disabled | |
buttonEl | |
.not('.' + theme.getClass('stateActive')) | |
.not('.' + theme.getClass('stateDisabled')) | |
.addClass(theme.getClass('stateHover')); | |
}, | |
function() { | |
// undo the *hover* effect | |
buttonEl | |
.removeClass(theme.getClass('stateHover')) | |
.removeClass(theme.getClass('stateDown')); // if mouseleave happens before mouseup | |
} | |
); | |
groupChildren = groupChildren.add(buttonEl); | |
} | |
} | |
}); | |
if (isOnlyButtons) { | |
groupChildren | |
.first().addClass(theme.getClass('cornerLeft')).end() | |
.last().addClass(theme.getClass('cornerRight')).end(); | |
} | |
if (groupChildren.length > 1) { | |
groupEl = $('<div/>'); | |
if (isOnlyButtons) { | |
groupEl.addClass(theme.getClass('buttonGroup')); | |
} | |
groupEl.append(groupChildren); | |
sectionEl.append(groupEl); | |
} | |
else { | |
sectionEl.append(groupChildren); // 1 or 0 children | |
} | |
}); | |
} | |
return sectionEl; | |
} | |
function updateTitle(text) { | |
if (el) { | |
el.find('h2').text(text); | |
} | |
} | |
function activateButton(buttonName) { | |
if (el) { | |
el.find('.fc-' + buttonName + '-button') | |
.addClass(calendar.theme.getClass('stateActive')); | |
} | |
} | |
function deactivateButton(buttonName) { | |
if (el) { | |
el.find('.fc-' + buttonName + '-button') | |
.removeClass(calendar.theme.getClass('stateActive')); | |
} | |
} | |
function disableButton(buttonName) { | |
if (el) { | |
el.find('.fc-' + buttonName + '-button') | |
.prop('disabled', true) | |
.addClass(calendar.theme.getClass('stateDisabled')); | |
} | |
} | |
function enableButton(buttonName) { | |
if (el) { | |
el.find('.fc-' + buttonName + '-button') | |
.prop('disabled', false) | |
.removeClass(calendar.theme.getClass('stateDisabled')); | |
} | |
} | |
function getViewsWithButtons() { | |
return viewsWithButtons; | |
} | |
} | |
;; | |
var Calendar = FC.Calendar = Class.extend(EmitterMixin, { | |
view: null, // current View object | |
viewsByType: null, // holds all instantiated view instances, current or not | |
currentDate: null, // unzoned moment. private (public API should use getDate instead) | |
theme: null, | |
loadingLevel: 0, // number of simultaneous loading tasks | |
renderQueue: null, | |
batchRenderDepth: 0, | |
constructor: function(el, overrides) { | |
// declare the current calendar instance relies on GlobalEmitter. needed for garbage collection. | |
// unneeded() is called in destroy. | |
GlobalEmitter.needed(); | |
this.el = el; | |
this.viewsByType = {}; | |
this.viewSpecCache = {}; | |
this.initOptionsInternals(overrides); | |
this.initMomentInternals(); // needs to happen after options hash initialized | |
this.initCurrentDate(); | |
this.initEventManager(); | |
this.renderQueue = this.buildRenderQueue(); | |
this.on('afterRenderInit:date', function() { | |
this.view.onAfterBaseRender(); | |
}); | |
this.on('beforeRenderDestroy:date', function() { | |
this.view.onBeforeBaseUnrender(); | |
}); | |
this.on('afterRenderInit:event', function() { | |
this.view.onAfterEventsRender(); | |
}); | |
this.on('beforeRenderDestroy:event', function() { | |
this.view.onBeforeEventsUnrender(); | |
}); | |
}, | |
// Public API | |
// ----------------------------------------------------------------------------------------------------------------- | |
getView: function() { | |
return this.view; | |
}, | |
publiclyTrigger: function(name, triggerInfo) { | |
var optHandler = this.opt(name); | |
var context; | |
var args; | |
if ($.isPlainObject(triggerInfo)) { | |
context = triggerInfo.context; | |
args = triggerInfo.args; | |
} | |
else if ($.isArray(triggerInfo)) { | |
args = triggerInfo; | |
} | |
if (context == null) { | |
context = this.el[0]; // fallback context | |
} | |
if (!args) { | |
args = []; | |
} | |
this.triggerWith(name, context, args); // Emitter's method | |
if (optHandler) { | |
return optHandler.apply(context, args); | |
} | |
}, | |
hasPublicHandlers: function(name) { | |
return this.hasHandlers(name) || | |
this.opt(name); // handler specified in options | |
}, | |
// View | |
// ----------------------------------------------------------------------------------------------------------------- | |
// Given a view name for a custom view or a standard view, creates a ready-to-go View object | |
instantiateView: function(viewType) { | |
var spec = this.getViewSpec(viewType); | |
return new spec['class'](this, spec); | |
}, | |
// Returns a boolean about whether the view is okay to instantiate at some point | |
isValidViewType: function(viewType) { | |
return Boolean(this.getViewSpec(viewType)); | |
}, | |
changeView: function(viewName, dateOrRange) { | |
if (dateOrRange) { | |
if (dateOrRange.start && dateOrRange.end) { // a range | |
this.recordOptionOverrides({ // will not rerender | |
visibleRange: dateOrRange | |
}); | |
} | |
else { // a date | |
this.currentDate = this.moment(dateOrRange).stripZone(); // just like gotoDate | |
} | |
} | |
this.renderView(viewName); | |
}, | |
// Forces navigation to a view for the given date. | |
// `viewType` can be a specific view name or a generic one like "week" or "day". | |
zoomTo: function(newDate, viewType) { | |
var spec; | |
viewType = viewType || 'day'; // day is default zoom | |
spec = this.getViewSpec(viewType) || this.getUnitViewSpec(viewType); | |
this.currentDate = newDate.clone(); | |
this.renderView(spec ? spec.type : null); | |
}, | |
// Current Date | |
// ----------------------------------------------------------------------------------------------------------------- | |
initCurrentDate: function() { | |
var defaultDateInput = this.opt('defaultDate'); | |
// compute the initial ambig-timezone date | |
if (defaultDateInput != null) { | |
this.currentDate = this.moment(defaultDateInput).stripZone(); | |
} | |
else { | |
this.currentDate = this.getNow(); // getNow already returns unzoned | |
} | |
}, | |
reportViewDatesChanged: function(view, dateProfile) { | |
this.currentDate = dateProfile.date; // might have been constrained by view dates | |
this.setToolbarsTitle(view.title); | |
this.updateToolbarButtons(); | |
}, | |
prev: function() { | |
var prevInfo = this.view.buildPrevDateProfile(this.currentDate); | |
if (prevInfo.isValid) { | |
this.currentDate = prevInfo.date; | |
this.renderView(); | |
} | |
}, | |
next: function() { | |
var nextInfo = this.view.buildNextDateProfile(this.currentDate); | |
if (nextInfo.isValid) { | |
this.currentDate = nextInfo.date; | |
this.renderView(); | |
} | |
}, | |
prevYear: function() { | |
this.currentDate.add(-1, 'years'); | |
this.renderView(); | |
}, | |
nextYear: function() { | |
this.currentDate.add(1, 'years'); | |
this.renderView(); | |
}, | |
today: function() { | |
this.currentDate = this.getNow(); // should deny like prev/next? | |
this.renderView(); | |
}, | |
gotoDate: function(zonedDateInput) { | |
this.currentDate = this.moment(zonedDateInput).stripZone(); | |
this.renderView(); | |
}, | |
incrementDate: function(delta) { | |
this.currentDate.add(moment.duration(delta)); | |
this.renderView(); | |
}, | |
// for external API | |
getDate: function() { | |
return this.applyTimezone(this.currentDate); // infuse the calendar's timezone | |
}, | |
// Loading Triggering | |
// ----------------------------------------------------------------------------------------------------------------- | |
// Should be called when any type of async data fetching begins | |
pushLoading: function() { | |
if (!(this.loadingLevel++)) { | |
this.publiclyTrigger('loading', [ true, this.view ]); | |
} | |
}, | |
// Should be called when any type of async data fetching completes | |
popLoading: function() { | |
if (!(--this.loadingLevel)) { | |
this.publiclyTrigger('loading', [ false, this.view ]); | |
} | |
}, | |
// Selection | |
// ----------------------------------------------------------------------------------------------------------------- | |
// this public method receives start/end dates in any format, with any timezone | |
select: function(zonedStartInput, zonedEndInput) { | |
this.view.select( | |
this.buildSelectFootprint.apply(this, arguments) | |
); | |
}, | |
unselect: function() { // safe to be called before renderView | |
if (this.view) { | |
this.view.unselect(); | |
} | |
}, | |
// Given arguments to the select method in the API, returns a span (unzoned start/end and other info) | |
buildSelectFootprint: function(zonedStartInput, zonedEndInput) { | |
var start = this.moment(zonedStartInput).stripZone(); | |
var end; | |
if (zonedEndInput) { | |
end = this.moment(zonedEndInput).stripZone(); | |
} | |
else if (start.hasTime()) { | |
end = start.clone().add(this.defaultTimedEventDuration); | |
} | |
else { | |
end = start.clone().add(this.defaultAllDayEventDuration); | |
} | |
return new ComponentFootprint( | |
new UnzonedRange(start, end), | |
!start.hasTime() | |
); | |
}, | |
// Misc | |
// ----------------------------------------------------------------------------------------------------------------- | |
// will return `null` if invalid range | |
parseUnzonedRange: function(rangeInput) { | |
var start = null; | |
var end = null; | |
if (rangeInput.start) { | |
start = this.moment(rangeInput.start).stripZone(); | |
} | |
if (rangeInput.end) { | |
end = this.moment(rangeInput.end).stripZone(); | |
} | |
if (!start && !end) { | |
return null; | |
} | |
if (start && end && end.isBefore(start)) { | |
return null; | |
} | |
return new UnzonedRange(start, end); | |
}, | |
rerenderEvents: function() { // API method. destroys old events if previously rendered. | |
if (this.elementVisible()) { | |
this.view.rerenderEvents(); | |
} | |
}, | |
initEventManager: function() { | |
var _this = this; | |
var eventManager = new EventManager(this); | |
var rawSources = this.opt('eventSources') || []; | |
var singleRawSource = this.opt('events'); | |
this.eventManager = eventManager; | |
if (singleRawSource) { | |
rawSources.unshift(singleRawSource); | |
} | |
eventManager.on('release', function(eventsPayload) { | |
_this.trigger('eventsReset', eventsPayload); | |
}); | |
eventManager.freeze(); | |
rawSources.forEach(function(rawSource) { | |
var source = EventSourceParser.parse(rawSource, _this); | |
if (source) { | |
eventManager.addSource(source); | |
} | |
}); | |
eventManager.thaw(); | |
}, | |
requestEvents: function(start, end) { | |
return this.eventManager.requestEvents( | |
start, | |
end, | |
this.opt('timezone'), | |
this.opt('lazyFetching') | |
); | |
} | |
}); | |
;; | |
/* | |
Options binding/triggering system. | |
*/ | |
Calendar.mixin({ | |
dirDefaults: null, // option defaults related to LTR or RTL | |
localeDefaults: null, // option defaults related to current locale | |
overrides: null, // option overrides given to the fullCalendar constructor | |
dynamicOverrides: null, // options set with dynamic setter method. higher precedence than view overrides. | |
optionsModel: null, // all defaults combined with overrides | |
initOptionsInternals: function(overrides) { | |
this.overrides = $.extend({}, overrides); // make a copy | |
this.dynamicOverrides = {}; | |
this.optionsModel = new Model(); | |
this.populateOptionsHash(); | |
}, | |
// public getter/setter | |
option: function(name, value) { | |
var newOptionHash; | |
if (typeof name === 'string') { | |
if (value === undefined) { // getter | |
return this.optionsModel.get(name); | |
} | |
else { // setter for individual option | |
newOptionHash = {}; | |
newOptionHash[name] = value; | |
this.setOptions(newOptionHash); | |
} | |
} | |
else if (typeof name === 'object') { // compound setter with object input | |
this.setOptions(name); | |
} | |
}, | |
// private getter | |
opt: function(name) { | |
return this.optionsModel.get(name); | |
}, | |
setOptions: function(newOptionHash) { | |
var optionCnt = 0; | |
var optionName; | |
this.recordOptionOverrides(newOptionHash); // will trigger optionsModel watchers | |
for (optionName in newOptionHash) { | |
optionCnt++; | |
} | |
// special-case handling of single option change. | |
// if only one option change, `optionName` will be its name. | |
if (optionCnt === 1) { | |
if (optionName === 'height' || optionName === 'contentHeight' || optionName === 'aspectRatio') { | |
this.updateViewSize(true); // isResize=true | |
return; | |
} | |
else if (optionName === 'defaultDate') { | |
return; // can't change date this way. use gotoDate instead | |
} | |
else if (optionName === 'businessHours') { | |
return; // optionsModel already reacts to this | |
} | |
else if (optionName === 'timezone') { | |
this.view.flash('initialEvents'); // refetches and reprocesses events | |
return; | |
} | |
} | |
// catch-all. rerender the header and footer and rebuild/rerender the current view | |
this.renderHeader(); | |
this.renderFooter(); | |
// even non-current views will be affected by this option change. do before rerender | |
// TODO: detangle | |
this.viewsByType = {}; | |
this.reinitView(); | |
}, | |
// Computes the flattened options hash for the calendar and assigns to `this.options`. | |
// Assumes this.overrides and this.dynamicOverrides have already been initialized. | |
populateOptionsHash: function() { | |
var locale, localeDefaults; | |
var isRTL, dirDefaults; | |
var rawOptions; | |
locale = firstDefined( // explicit locale option given? | |
this.dynamicOverrides.locale, | |
this.overrides.locale | |
); | |
localeDefaults = localeOptionHash[locale]; | |
if (!localeDefaults) { // explicit locale option not given or invalid? | |
locale = Calendar.defaults.locale; | |
localeDefaults = localeOptionHash[locale] || {}; | |
} | |
isRTL = firstDefined( // based on options computed so far, is direction RTL? | |
this.dynamicOverrides.isRTL, | |
this.overrides.isRTL, | |
localeDefaults.isRTL, | |
Calendar.defaults.isRTL | |
); | |
dirDefaults = isRTL ? Calendar.rtlDefaults : {}; | |
this.dirDefaults = dirDefaults; | |
this.localeDefaults = localeDefaults; | |
rawOptions = mergeOptions([ // merge defaults and overrides. lowest to highest precedence | |
Calendar.defaults, // global defaults | |
dirDefaults, | |
localeDefaults, | |
this.overrides, | |
this.dynamicOverrides | |
]); | |
populateInstanceComputableOptions(rawOptions); // fill in gaps with computed options | |
this.optionsModel.reset(rawOptions); | |
}, | |
// stores the new options internally, but does not rerender anything. | |
recordOptionOverrides: function(newOptionHash) { | |
var optionName; | |
for (optionName in newOptionHash) { | |
this.dynamicOverrides[optionName] = newOptionHash[optionName]; | |
} | |
this.viewSpecCache = {}; // the dynamic override invalidates the options in this cache, so just clear it | |
this.populateOptionsHash(); // this.options needs to be recomputed after the dynamic override | |
} | |
}); | |
;; | |
Calendar.mixin({ | |
defaultAllDayEventDuration: null, | |
defaultTimedEventDuration: null, | |
localeData: null, | |
initMomentInternals: function() { | |
var _this = this; | |
this.defaultAllDayEventDuration = moment.duration(this.opt('defaultAllDayEventDuration')); | |
this.defaultTimedEventDuration = moment.duration(this.opt('defaultTimedEventDuration')); | |
// Called immediately, and when any of the options change. | |
// Happens before any internal objects rebuild or rerender, because this is very core. | |
this.optionsModel.watch('buildingMomentLocale', [ | |
'?locale', '?monthNames', '?monthNamesShort', '?dayNames', '?dayNamesShort', | |
'?firstDay', '?weekNumberCalculation' | |
], function(opts) { | |
var weekNumberCalculation = opts.weekNumberCalculation; | |
var firstDay = opts.firstDay; | |
var _week; | |
// normalize | |
if (weekNumberCalculation === 'iso') { | |
weekNumberCalculation = 'ISO'; // normalize | |
} | |
var localeData = Object.create( // make a cheap copy | |
getMomentLocaleData(opts.locale) // will fall back to en | |
); | |
if (opts.monthNames) { | |
localeData._months = opts.monthNames; | |
} | |
if (opts.monthNamesShort) { | |
localeData._monthsShort = opts.monthNamesShort; | |
} | |
if (opts.dayNames) { | |
localeData._weekdays = opts.dayNames; | |
} | |
if (opts.dayNamesShort) { | |
localeData._weekdaysShort = opts.dayNamesShort; | |
} | |
if (firstDay == null && weekNumberCalculation === 'ISO') { | |
firstDay = 1; | |
} | |
if (firstDay != null) { | |
_week = Object.create(localeData._week); // _week: { dow: # } | |
_week.dow = firstDay; | |
localeData._week = _week; | |
} | |
if ( // whitelist certain kinds of input | |
weekNumberCalculation === 'ISO' || | |
weekNumberCalculation === 'local' || | |
typeof weekNumberCalculation === 'function' | |
) { | |
localeData._fullCalendar_weekCalc = weekNumberCalculation; // moment-ext will know what to do with it | |
} | |
_this.localeData = localeData; | |
// If the internal current date object already exists, move to new locale. | |
// We do NOT need to do this technique for event dates, because this happens when converting to "segments". | |
if (_this.currentDate) { | |
_this.localizeMoment(_this.currentDate); // sets to localeData | |
} | |
}); | |
}, | |
// Builds a moment using the settings of the current calendar: timezone and locale. | |
// Accepts anything the vanilla moment() constructor accepts. | |
moment: function() { | |
var mom; | |
if (this.opt('timezone') === 'local') { | |
mom = FC.moment.apply(null, arguments); | |
// Force the moment to be local, because FC.moment doesn't guarantee it. | |
if (mom.hasTime()) { // don't give ambiguously-timed moments a local zone | |
mom.local(); | |
} | |
} | |
else if (this.opt('timezone') === 'UTC') { | |
mom = FC.moment.utc.apply(null, arguments); // process as UTC | |
} | |
else { | |
mom = FC.moment.parseZone.apply(null, arguments); // let the input decide the zone | |
} | |
this.localizeMoment(mom); // TODO | |
return mom; | |
}, | |
msToMoment: function(ms, forceAllDay) { | |
var mom = FC.moment.utc(ms); // TODO: optimize by using Date.UTC | |
if (forceAllDay) { | |
mom.stripTime(); | |
} | |
else { | |
mom = this.applyTimezone(mom); // may or may not apply locale | |
} | |
this.localizeMoment(mom); | |
return mom; | |
}, | |
msToUtcMoment: function(ms, forceAllDay) { | |
var mom = FC.moment.utc(ms); // TODO: optimize by using Date.UTC | |
if (forceAllDay) { | |
mom.stripTime(); | |
} | |
this.localizeMoment(mom); | |
return mom; | |
}, | |
// Updates the given moment's locale settings to the current calendar locale settings. | |
localizeMoment: function(mom) { | |
mom._locale = this.localeData; | |
}, | |
// Returns a boolean about whether or not the calendar knows how to calculate | |
// the timezone offset of arbitrary dates in the current timezone. | |
getIsAmbigTimezone: function() { | |
return this.opt('timezone') !== 'local' && this.opt('timezone') !== 'UTC'; | |
}, | |
// Returns a copy of the given date in the current timezone. Has no effect on dates without times. | |
applyTimezone: function(date) { | |
if (!date.hasTime()) { | |
return date.clone(); | |
} | |
var zonedDate = this.moment(date.toArray()); | |
var timeAdjust = date.time() - zonedDate.time(); | |
var adjustedZonedDate; | |
// Safari sometimes has problems with this coersion when near DST. Adjust if necessary. (bug #2396) | |
if (timeAdjust) { // is the time result different than expected? | |
adjustedZonedDate = zonedDate.clone().add(timeAdjust); // add milliseconds | |
if (date.time() - adjustedZonedDate.time() === 0) { // does it match perfectly now? | |
zonedDate = adjustedZonedDate; | |
} | |
} | |
return zonedDate; | |
}, | |
/* | |
Assumes the footprint is non-open-ended. | |
*/ | |
footprintToDateProfile: function(componentFootprint, ignoreEnd) { | |
var start = FC.moment.utc(componentFootprint.unzonedRange.startMs); | |
var end; | |
if (!ignoreEnd) { | |
end = FC.moment.utc(componentFootprint.unzonedRange.endMs); | |
} | |
if (componentFootprint.isAllDay) { | |
start.stripTime(); | |
if (end) { | |
end.stripTime(); | |
} | |
} | |
else { | |
start = this.applyTimezone(start); | |
if (end) { | |
end = this.applyTimezone(end); | |
} | |
} | |
return new EventDateProfile(start, end, this); | |
}, | |
// Returns a moment for the current date, as defined by the client's computer or from the `now` option. | |
// Will return an moment with an ambiguous timezone. | |
getNow: function() { | |
var now = this.opt('now'); | |
if (typeof now === 'function') { | |
now = now(); | |
} | |
return this.moment(now).stripZone(); | |
}, | |
// Produces a human-readable string for the given duration. | |
// Side-effect: changes the locale of the given duration. | |
humanizeDuration: function(duration) { | |
return duration.locale(this.opt('locale')).humanize(); | |
}, | |
// Event-Specific Date Utilities. TODO: move | |
// ----------------------------------------------------------------------------------------------------------------- | |
// Get an event's normalized end date. If not present, calculate it from the defaults. | |
getEventEnd: function(event) { | |
if (event.end) { | |
return event.end.clone(); | |
} | |
else { | |
return this.getDefaultEventEnd(event.allDay, event.start); | |
} | |
}, | |
// Given an event's allDay status and start date, return what its fallback end date should be. | |
// TODO: rename to computeDefaultEventEnd | |
getDefaultEventEnd: function(allDay, zonedStart) { | |
var end = zonedStart.clone(); | |
if (allDay) { | |
end.stripTime().add(this.defaultAllDayEventDuration); | |
} | |
else { | |
end.add(this.defaultTimedEventDuration); | |
} | |
if (this.getIsAmbigTimezone()) { | |
end.stripZone(); // we don't know what the tzo should be | |
} | |
return end; | |
} | |
}); | |
;; | |
Calendar.mixin({ | |
viewSpecCache: null, // cache of view definitions (initialized in Calendar.js) | |
// Gets information about how to create a view. Will use a cache. | |
getViewSpec: function(viewType) { | |
var cache = this.viewSpecCache; | |
return cache[viewType] || (cache[viewType] = this.buildViewSpec(viewType)); | |
}, | |
// Given a duration singular unit, like "week" or "day", finds a matching view spec. | |
// Preference is given to views that have corresponding buttons. | |
getUnitViewSpec: function(unit) { | |
var viewTypes; | |
var i; | |
var spec; | |
if ($.inArray(unit, unitsDesc) != -1) { | |
// put views that have buttons first. there will be duplicates, but oh well | |
viewTypes = this.header.getViewsWithButtons(); // TODO: include footer as well? | |
$.each(FC.views, function(viewType) { // all views | |
viewTypes.push(viewType); | |
}); | |
for (i = 0; i < viewTypes.length; i++) { | |
spec = this.getViewSpec(viewTypes[i]); | |
if (spec) { | |
if (spec.singleUnit == unit) { | |
return spec; | |
} | |
} | |
} | |
} | |
}, | |
// Builds an object with information on how to create a given view | |
buildViewSpec: function(requestedViewType) { | |
var viewOverrides = this.overrides.views || {}; | |
var specChain = []; // for the view. lowest to highest priority | |
var defaultsChain = []; // for the view. lowest to highest priority | |
var overridesChain = []; // for the view. lowest to highest priority | |
var viewType = requestedViewType; | |
var spec; // for the view | |
var overrides; // for the view | |
var durationInput; | |
var duration; | |
var unit; | |
// iterate from the specific view definition to a more general one until we hit an actual View class | |
while (viewType) { | |
spec = fcViews[viewType]; | |
overrides = viewOverrides[viewType]; | |
viewType = null; // clear. might repopulate for another iteration | |
if (typeof spec === 'function') { // TODO: deprecate | |
spec = { 'class': spec }; | |
} | |
if (spec) { | |
specChain.unshift(spec); | |
defaultsChain.unshift(spec.defaults || {}); | |
durationInput = durationInput || spec.duration; | |
viewType = viewType || spec.type; | |
} | |
if (overrides) { | |
overridesChain.unshift(overrides); // view-specific option hashes have options at zero-level | |
durationInput = durationInput || overrides.duration; | |
viewType = viewType || overrides.type; | |
} | |
} | |
spec = mergeProps(specChain); | |
spec.type = requestedViewType; | |
if (!spec['class']) { | |
return false; | |
} | |
// fall back to top-level `duration` option | |
durationInput = durationInput || | |
this.dynamicOverrides.duration || | |
this.overrides.duration; | |
if (durationInput) { | |
duration = moment.duration(durationInput); | |
if (duration.valueOf()) { // valid? | |
unit = computeDurationGreatestUnit(duration, durationInput); | |
spec.duration = duration; | |
spec.durationUnit = unit; | |
// view is a single-unit duration, like "week" or "day" | |
// incorporate options for this. lowest priority | |
if (duration.as(unit) === 1) { | |
spec.singleUnit = unit; | |
overridesChain.unshift(viewOverrides[unit] || {}); | |
} | |
} | |
} | |
spec.defaults = mergeOptions(defaultsChain); | |
spec.overrides = mergeOptions(overridesChain); | |
this.buildViewSpecOptions(spec); | |
this.buildViewSpecButtonText(spec, requestedViewType); | |
return spec; | |
}, | |
// Builds and assigns a view spec's options object from its already-assigned defaults and overrides | |
buildViewSpecOptions: function(spec) { | |
spec.options = mergeOptions([ // lowest to highest priority | |
Calendar.defaults, // global defaults | |
spec.defaults, // view's defaults (from ViewSubclass.defaults) | |
this.dirDefaults, | |
this.localeDefaults, // locale and dir take precedence over view's defaults! | |
this.overrides, // calendar's overrides (options given to constructor) | |
spec.overrides, // view's overrides (view-specific options) | |
this.dynamicOverrides // dynamically set via setter. highest precedence | |
]); | |
populateInstanceComputableOptions(spec.options); | |
}, | |
// Computes and assigns a view spec's buttonText-related options | |
buildViewSpecButtonText: function(spec, requestedViewType) { | |
// given an options object with a possible `buttonText` hash, lookup the buttonText for the | |
// requested view, falling back to a generic unit entry like "week" or "day" | |
function queryButtonText(options) { | |
var buttonText = options.buttonText || {}; | |
return buttonText[requestedViewType] || | |
// view can decide to look up a certain key | |
(spec.buttonTextKey ? buttonText[spec.buttonTextKey] : null) || | |
// a key like "month" | |
(spec.singleUnit ? buttonText[spec.singleUnit] : null); | |
} | |
// highest to lowest priority | |
spec.buttonTextOverride = | |
queryButtonText(this.dynamicOverrides) || | |
queryButtonText(this.overrides) || // constructor-specified buttonText lookup hash takes precedence | |
spec.overrides.buttonText; // `buttonText` for view-specific options is a string | |
// highest to lowest priority. mirrors buildViewSpecOptions | |
spec.buttonTextDefault = | |
queryButtonText(this.localeDefaults) || | |
queryButtonText(this.dirDefaults) || | |
spec.defaults.buttonText || // a single string. from ViewSubclass.defaults | |
queryButtonText(Calendar.defaults) || | |
(spec.duration ? this.humanizeDuration(spec.duration) : null) || // like "3 days" | |
requestedViewType; // fall back to given view name | |
} | |
}); | |
;; | |
Calendar.mixin({ | |
el: null, | |
contentEl: null, | |
suggestedViewHeight: null, | |
ignoreUpdateViewSize: 0, | |
windowResizeProxy: null, | |
render: function() { | |
if (!this.contentEl) { | |
this.initialRender(); | |
} | |
else if (this.elementVisible()) { | |
// mainly for the public API | |
this.calcSize(); | |
this.renderView(); | |
} | |
}, | |
initialRender: function() { | |
var _this = this; | |
var el = this.el; | |
el.addClass('fc'); | |
// event delegation for nav links | |
el.on('click.fc', 'a[data-goto]', function(ev) { | |
var anchorEl = $(this); | |
var gotoOptions = anchorEl.data('goto'); // will automatically parse JSON | |
var date = _this.moment(gotoOptions.date); | |
var viewType = gotoOptions.type; | |
// property like "navLinkDayClick". might be a string or a function | |
var customAction = _this.view.opt('navLink' + capitaliseFirstLetter(viewType) + 'Click'); | |
if (typeof customAction === 'function') { | |
customAction(date, ev); | |
} | |
else { | |
if (typeof customAction === 'string') { | |
viewType = customAction; | |
} | |
_this.zoomTo(date, viewType); | |
} | |
}); | |
// called immediately, and upon option change | |
this.optionsModel.watch('settingTheme', [ '?theme' ], function(opts) { | |
var themeClass = ThemeRegistry.getThemeClass(opts.theme); | |
var theme = new themeClass(_this.optionsModel); | |
var widgetClass = theme.getClass('widget'); | |
_this.theme = theme; | |
if (widgetClass) { | |
el.addClass(widgetClass); | |
} | |
}, function() { | |
var widgetClass = _this.theme.getClass('widget'); | |
_this.theme = null; | |
if (widgetClass) { | |
el.removeClass(widgetClass); | |
} | |
}); | |
// called immediately, and upon option change. | |
// HACK: locale often affects isRTL, so we explicitly listen to that too. | |
this.optionsModel.watch('applyingDirClasses', [ '?isRTL', '?locale' ], function(opts) { | |
el.toggleClass('fc-ltr', !opts.isRTL); | |
el.toggleClass('fc-rtl', opts.isRTL); | |
}); | |
this.contentEl = $("<div class='fc-view-container'/>").prependTo(el); | |
this.initToolbars(); | |
this.renderHeader(); | |
this.renderFooter(); | |
this.renderView(this.opt('defaultView')); | |
if (this.opt('handleWindowResize')) { | |
$(window).resize( | |
this.windowResizeProxy = debounce( // prevents rapid calls | |
this.windowResize.bind(this), | |
this.opt('windowResizeDelay') | |
) | |
); | |
} | |
}, | |
destroy: function() { | |
this.renderQueue.kill(); | |
if (this.view) { | |
this.view.removeElement(); | |
// NOTE: don't null-out this.view in case API methods are called after destroy. | |
// It is still the "current" view, just not rendered. | |
} | |
this.toolbarsManager.proxyCall('removeElement'); | |
this.contentEl.remove(); | |
this.el.removeClass('fc fc-ltr fc-rtl'); | |
// removes theme-related root className | |
this.optionsModel.unwatch('settingTheme'); | |
this.el.off('.fc'); // unbind nav link handlers | |
if (this.windowResizeProxy) { | |
$(window).unbind('resize', this.windowResizeProxy); | |
this.windowResizeProxy = null; | |
} | |
GlobalEmitter.unneeded(); | |
}, | |
elementVisible: function() { | |
return this.el.is(':visible'); | |
}, | |
// Render Queue | |
// ----------------------------------------------------------------------------------------------------------------- | |
buildRenderQueue: function() { | |
var _this = this; | |
var renderQueue = new RenderQueue({ | |
event: this.opt('eventRenderWait') | |
}); | |
renderQueue.on('start', function() { | |
var view = _this.view; | |
_this.freezeContentHeight(); | |
view.addScroll(view.queryScroll()); // TODO: move to Calendar | |
}); | |
renderQueue.on('stop', function() { | |
var view = _this.view; | |
if (_this.updateViewSize()) { // success? | |
view.popScroll(); // TODO: move to Calendar | |
} | |
_this.thawContentHeight(); | |
}); | |
return renderQueue; | |
}, | |
// TODO: evenutally make Calendar a DateComponent | |
initBatchRenderingForView: function(view) { | |
var _this = this; | |
view.on('before:change.batchRender', function() { | |
_this.startBatchRender(); | |
}); | |
view.on('change.batchRender', function() { | |
_this.stopBatchRender(); | |
}); | |
}, | |
// TODO: evenutally make Calendar a DateComponent | |
destroyBatchRenderingForView: function(view) { | |
view.off('.batchRender'); | |
}, | |
startBatchRender: function() { | |
if (!(this.batchRenderDepth++)) { | |
this.renderQueue.pause(); | |
} | |
}, | |
stopBatchRender: function() { | |
if (!(--this.batchRenderDepth)) { | |
this.renderQueue.resume(); | |
} | |
}, | |
// View Rendering | |
// ----------------------------------------------------------------------------------- | |
// Renders a view because of a date change, view-type change, or for the first time. | |
// If not given a viewType, keep the current view but render different dates. | |
// Accepts an optional scroll state to restore to. | |
renderView: function(viewType, forcedScroll) { | |
var _this = this; | |
var oldView = this.view; | |
var newView; | |
this.startBatchRender(); | |
if (oldView && viewType && oldView.type !== viewType) { | |
this.clearView(); | |
this.destroyBatchRenderingForView(oldView); // do AFTER the clear b/c the clear updates lots of props | |
} | |
// if viewType changed, or the view was never created, create a fresh view | |
if (!this.view && viewType) { | |
newView = this.view = | |
this.viewsByType[viewType] || | |
(this.viewsByType[viewType] = this.instantiateView(viewType)); | |
this.initBatchRenderingForView(newView); | |
newView.setElement($("<div class='fc-view fc-" + viewType + "-view' />")); | |
this.renderQueue.queue('_calendar', 'el', 'init', function() { | |
newView.el.appendTo(_this.contentEl); | |
}); | |
this.toolbarsManager.proxyCall('activateButton', viewType); | |
} | |
if (this.view) { | |
if (forcedScroll) { | |
this.view.addForcedScroll(forcedScroll); | |
} | |
if (this.elementVisible()) { | |
this.view.setDate(this.currentDate); | |
} | |
} | |
this.stopBatchRender(); | |
}, | |
// Unrenders the current view and reflects this change in the Header. | |
// Unregsiters the `view`, but does not remove from viewByType hash. | |
clearView: function() { | |
var currentView = this.view; | |
this.toolbarsManager.proxyCall('deactivateButton', currentView.type); | |
currentView.unsetDate(); | |
this.renderQueue.queue('_calendar', 'el', 'destroy', function() { | |
currentView.removeElement(); | |
}); | |
this.view = null; | |
}, | |
// Destroys the view, including the view object. Then, re-instantiates it and renders it. | |
// Maintains the same scroll state. | |
// TODO: maintain any other user-manipulated state. | |
reinitView: function() { | |
this.startBatchRender(); | |
var viewType = this.view.type; | |
var scrollState = this.view.queryScroll(); | |
this.clearView(); | |
this.calcSize(); | |
this.renderView(viewType, scrollState); | |
this.stopBatchRender(); | |
}, | |
// Resizing | |
// ----------------------------------------------------------------------------------- | |
getSuggestedViewHeight: function() { | |
if (this.suggestedViewHeight === null) { | |
this.calcSize(); | |
} | |
return this.suggestedViewHeight; | |
}, | |
isHeightAuto: function() { | |
return this.opt('contentHeight') === 'auto' || this.opt('height') === 'auto'; | |
}, | |
updateViewSize: function(isResize, explicitView) { | |
var view = explicitView || this.view; | |
var scroll; | |
if (!this.ignoreUpdateViewSize && this.elementVisible()) { | |
if (isResize) { | |
this._calcSize(); | |
scroll = view.queryScroll(); | |
} | |
this.ignoreUpdateViewSize++; | |
view.updateSize( | |
this.getSuggestedViewHeight(), | |
this.isHeightAuto(), | |
isResize | |
); | |
this.ignoreUpdateViewSize--; | |
if (isResize) { | |
view.applyScroll(scroll); | |
} | |
return true; // signal success | |
} | |
}, | |
calcSize: function() { | |
if (this.elementVisible()) { | |
this._calcSize(); | |
} | |
}, | |
_calcSize: function() { // assumes elementVisible | |
var contentHeightInput = this.opt('contentHeight'); | |
var heightInput = this.opt('height'); | |
if (typeof contentHeightInput === 'number') { // exists and not 'auto' | |
this.suggestedViewHeight = contentHeightInput; | |
} | |
else if (typeof contentHeightInput === 'function') { // exists and is a function | |
this.suggestedViewHeight = contentHeightInput(); | |
} | |
else if (typeof heightInput === 'number') { // exists and not 'auto' | |
this.suggestedViewHeight = heightInput - this.queryToolbarsHeight(); | |
} | |
else if (typeof heightInput === 'function') { // exists and is a function | |
this.suggestedViewHeight = heightInput() - this.queryToolbarsHeight(); | |
} | |
else if (heightInput === 'parent') { // set to height of parent element | |
this.suggestedViewHeight = this.el.parent().height() - this.queryToolbarsHeight(); | |
} | |
else { | |
this.suggestedViewHeight = Math.round( | |
this.contentEl.width() / | |
Math.max(this.opt('aspectRatio'), .5) | |
); | |
} | |
}, | |
windowResize: function(ev) { | |
if ( | |
ev.target === window && // so we don't process jqui "resize" events that have bubbled up | |
this.view.isDatesRendered | |
) { | |
if (this.updateViewSize(true)) { // isResize=true, returns true on success | |
this.publiclyTrigger('windowResize', [ this.view ]); | |
} | |
} | |
}, | |
/* Height "Freezing" | |
-----------------------------------------------------------------------------*/ | |
freezeContentHeight: function() { | |
this.contentEl.css({ | |
width: '100%', | |
height: this.contentEl.height(), | |
overflow: 'hidden' | |
}); | |
}, | |
thawContentHeight: function() { | |
this.contentEl.css({ | |
width: '', | |
height: '', | |
overflow: '' | |
}); | |
} | |
}); | |
;; | |
Calendar.mixin({ | |
header: null, | |
footer: null, | |
toolbarsManager: null, | |
initToolbars: function() { | |
this.header = new Toolbar(this, this.computeHeaderOptions()); | |
this.footer = new Toolbar(this, this.computeFooterOptions()); | |
this.toolbarsManager = new Iterator([ this.header, this.footer ]); | |
}, | |
computeHeaderOptions: function() { | |
return { | |
extraClasses: 'fc-header-toolbar', | |
layout: this.opt('header') | |
}; | |
}, | |
computeFooterOptions: function() { | |
return { | |
extraClasses: 'fc-footer-toolbar', | |
layout: this.opt('footer') | |
}; | |
}, | |
// can be called repeatedly and Header will rerender | |
renderHeader: function() { | |
var header = this.header; | |
header.setToolbarOptions(this.computeHeaderOptions()); | |
header.render(); | |
if (header.el) { | |
this.el.prepend(header.el); | |
} | |
}, | |
// can be called repeatedly and Footer will rerender | |
renderFooter: function() { | |
var footer = this.footer; | |
footer.setToolbarOptions(this.computeFooterOptions()); | |
footer.render(); | |
if (footer.el) { | |
this.el.append(footer.el); | |
} | |
}, | |
setToolbarsTitle: function(title) { | |
this.toolbarsManager.proxyCall('updateTitle', title); | |
}, | |
updateToolbarButtons: function() { | |
var now = this.getNow(); | |
var view = this.view; | |
var todayInfo = view.buildDateProfile(now); | |
var prevInfo = view.buildPrevDateProfile(this.currentDate); | |
var nextInfo = view.buildNextDateProfile(this.currentDate); | |
this.toolbarsManager.proxyCall( | |
(todayInfo.isValid && !view.get('dateProfile').currentUnzonedRange.containsDate(now)) ? | |
'enableButton' : | |
'disableButton', | |
'today' | |
); | |
this.toolbarsManager.proxyCall( | |
prevInfo.isValid ? | |
'enableButton' : | |
'disableButton', | |
'prev' | |
); | |
this.toolbarsManager.proxyCall( | |
nextInfo.isValid ? | |
'enableButton' : | |
'disableButton', | |
'next' | |
); | |
}, | |
queryToolbarsHeight: function() { | |
return this.toolbarsManager.items.reduce(function(accumulator, toolbar) { | |
var toolbarHeight = toolbar.el ? toolbar.el.outerHeight(true) : 0; // includes margin | |
return accumulator + toolbarHeight; | |
}, 0); | |
} | |
}); | |
;; | |
/* | |
determines if eventInstanceGroup is allowed, | |
in relation to other EVENTS and business hours. | |
*/ | |
Calendar.prototype.isEventInstanceGroupAllowed = function(eventInstanceGroup) { | |
var eventDef = eventInstanceGroup.getEventDef(); | |
var eventFootprints = this.eventRangesToEventFootprints(eventInstanceGroup.getAllEventRanges()); | |
var i; | |
var peerEventInstances = this.getPeerEventInstances(eventDef); | |
var peerEventRanges = eventInstancesToEventRanges(peerEventInstances); | |
var peerEventFootprints = this.eventRangesToEventFootprints(peerEventRanges); | |
var constraintVal = eventDef.getConstraint(); | |
var overlapVal = eventDef.getOverlap(); | |
var eventAllowFunc = this.opt('eventAllow'); | |
for (i = 0; i < eventFootprints.length; i++) { | |
if ( | |
!this.isFootprintAllowed( | |
eventFootprints[i].componentFootprint, | |
peerEventFootprints, | |
constraintVal, | |
overlapVal, | |
eventFootprints[i].eventInstance | |
) | |
) { | |
return false; | |
} | |
} | |
if (eventAllowFunc) { | |
for (i = 0; i < eventFootprints.length; i++) { | |
if ( | |
eventAllowFunc( | |
eventFootprints[i].componentFootprint.toLegacy(this), | |
eventFootprints[i].getEventLegacy() | |
) === false | |
) { | |
return false; | |
} | |
} | |
} | |
return true; | |
}; | |
Calendar.prototype.getPeerEventInstances = function(eventDef) { | |
return this.eventManager.getEventInstancesWithoutId(eventDef.id); | |
}; | |
Calendar.prototype.isSelectionFootprintAllowed = function(componentFootprint) { | |
var peerEventInstances = this.eventManager.getEventInstances(); | |
var peerEventRanges = eventInstancesToEventRanges(peerEventInstances); | |
var peerEventFootprints = this.eventRangesToEventFootprints(peerEventRanges); | |
var selectAllowFunc; | |
if ( | |
this.isFootprintAllowed( | |
componentFootprint, | |
peerEventFootprints, | |
this.opt('selectConstraint'), | |
this.opt('selectOverlap') | |
) | |
) { | |
selectAllowFunc = this.opt('selectAllow'); | |
if (selectAllowFunc) { | |
return selectAllowFunc(componentFootprint.toLegacy(this)) !== false; | |
} | |
else { | |
return true; | |
} | |
} | |
return false; | |
}; | |
Calendar.prototype.isFootprintAllowed = function( | |
componentFootprint, | |
peerEventFootprints, | |
constraintVal, | |
overlapVal, | |
subjectEventInstance // optional | |
) { | |
var constraintFootprints; // ComponentFootprint[] | |
var overlapEventFootprints; // EventFootprint[] | |
if (constraintVal != null) { | |
constraintFootprints = this.constraintValToFootprints(constraintVal, componentFootprint.isAllDay); | |
if (!this.isFootprintWithinConstraints(componentFootprint, constraintFootprints)) { | |
return false; | |
} | |
} | |
overlapEventFootprints = this.collectOverlapEventFootprints(peerEventFootprints, componentFootprint); | |
if (overlapVal === false) { | |
if (overlapEventFootprints.length) { | |
return false; | |
} | |
} | |
else if (typeof overlapVal === 'function') { | |
if (!isOverlapsAllowedByFunc(overlapEventFootprints, overlapVal, subjectEventInstance)) { | |
return false; | |
} | |
} | |
if (subjectEventInstance) { | |
if (!isOverlapEventInstancesAllowed(overlapEventFootprints, subjectEventInstance)) { | |
return false; | |
} | |
} | |
return true; | |
}; | |
// Constraint | |
// ------------------------------------------------------------------------------------------------ | |
Calendar.prototype.isFootprintWithinConstraints = function(componentFootprint, constraintFootprints) { | |
var i; | |
for (i = 0; i < constraintFootprints.length; i++) { | |
if (this.footprintContainsFootprint(constraintFootprints[i], componentFootprint)) { | |
return true; | |
} | |
} | |
return false; | |
}; | |
Calendar.prototype.constraintValToFootprints = function(constraintVal, isAllDay) { | |
var businessHours; | |
var eventInstances; | |
if (constraintVal === 'businessHours') { | |
// TODO: is it good rely on view for this? | |
if (this.view) { | |
businessHours = this.view.get('businessHours'); | |
if (businessHours) { | |
return eventFootprintsToComponentFootprints( | |
this.eventRangesToEventFootprints( | |
businessHours.getAllEventRanges(isAllDay) | |
) | |
); | |
} | |
} | |
return []; | |
} | |
else if (typeof constraintVal === 'object') { | |
eventInstances = this.parseEventDefToInstances(constraintVal); // handles recurring events | |
if (!eventInstances) { // invalid input. fallback to parsing footprint directly | |
return this.parseFootprints(constraintVal); | |
} | |
else { | |
return this.eventInstancesToFootprints(eventInstances); | |
} | |
} | |
else if (constraintVal != null) { // an ID | |
eventInstances = this.eventManager.getEventInstancesWithId(constraintVal); | |
return this.eventInstancesToFootprints(eventInstances); | |
} | |
}; | |
// conversion util | |
Calendar.prototype.eventInstancesToFootprints = function(eventInstances) { | |
return eventFootprintsToComponentFootprints( | |
this.eventRangesToEventFootprints( | |
eventInstancesToEventRanges(eventInstances) | |
) | |
); | |
}; | |
// Overlap | |
// ------------------------------------------------------------------------------------------------ | |
Calendar.prototype.collectOverlapEventFootprints = function(peerEventFootprints, targetFootprint) { | |
var overlapEventFootprints = []; | |
var i; | |
for (i = 0; i < peerEventFootprints.length; i++) { | |
if ( | |
this.footprintsIntersect( | |
targetFootprint, | |
peerEventFootprints[i].componentFootprint | |
) | |
) { | |
overlapEventFootprints.push(peerEventFootprints[i]); | |
} | |
} | |
return overlapEventFootprints; | |
}; | |
// optional subjectEventInstance | |
function isOverlapsAllowedByFunc(overlapEventFootprints, overlapFunc, subjectEventInstance) { | |
var i; | |
for (i = 0; i < overlapEventFootprints.length; i++) { | |
if ( | |
!overlapFunc( | |
overlapEventFootprints[i].eventInstance.toLegacy(), | |
subjectEventInstance ? subjectEventInstance.toLegacy() : null | |
) | |
) { | |
return false; | |
} | |
} | |
return true; | |
} | |
function isOverlapEventInstancesAllowed(overlapEventFootprints, subjectEventInstance) { | |
var subjectLegacyInstance = subjectEventInstance.toLegacy(); | |
var i; | |
var overlapEventInstance; | |
var overlapEventDef; | |
var overlapVal; | |
for (i = 0; i < overlapEventFootprints.length; i++) { | |
overlapEventInstance = overlapEventFootprints[i].eventInstance; | |
overlapEventDef = overlapEventInstance.def; | |
// don't need to pass in calendar, because don't want to consider global eventOverlap property, | |
// because we already considered that earlier in the process. | |
overlapVal = overlapEventDef.getOverlap(); | |
if (overlapVal === false) { | |
return false; | |
} | |
else if (typeof overlapVal === 'function') { | |
if ( | |
!overlapVal( | |
overlapEventInstance.toLegacy(), | |
subjectLegacyInstance | |
) | |
) { | |
return false; | |
} | |
} | |
} | |
return true; | |
} | |
// Conversion: eventDefs -> eventInstances -> eventRanges -> eventFootprints -> componentFootprints | |
// ------------------------------------------------------------------------------------------------ | |
// NOTE: this might seem like repetitive code with the Grid class, however, this code is related to | |
// constraints whereas the Grid code is related to rendering. Each approach might want to convert | |
// eventRanges -> eventFootprints in a different way. Regardless, there are opportunities to make | |
// this more DRY. | |
/* | |
Returns false on invalid input. | |
*/ | |
Calendar.prototype.parseEventDefToInstances = function(eventInput) { | |
var eventPeriod = this.eventManager.currentPeriod; | |
var eventDef = EventDefParser.parse(eventInput, new EventSource(this)); | |
if (!eventDef) { // invalid | |
return false; | |
} | |
if (eventPeriod) { | |
return eventDef.buildInstances(eventPeriod.unzonedRange); | |
} | |
else { | |
return []; | |
} | |
}; | |
Calendar.prototype.eventRangesToEventFootprints = function(eventRanges) { | |
var i; | |
var eventFootprints = []; | |
for (i = 0; i < eventRanges.length; i++) { | |
eventFootprints.push.apply(eventFootprints, // append | |
this.eventRangeToEventFootprints(eventRanges[i]) | |
); | |
} | |
return eventFootprints; | |
}; | |
/* | |
TODO: somehow more DRY with Grid::eventRangeToEventFootprints | |
*/ | |
Calendar.prototype.eventRangeToEventFootprints = function(eventRange) { | |
return [ | |
new EventFootprint( | |
new ComponentFootprint( | |
eventRange.unzonedRange, | |
eventRange.eventDef.isAllDay() | |
), | |
eventRange.eventDef, | |
eventRange.eventInstance // might not exist | |
) | |
]; | |
}; | |
/* | |
Parses footprints directly. | |
Very similar to EventDateProfile::parse :( | |
*/ | |
Calendar.prototype.parseFootprints = function(rawInput) { | |
var start, end; | |
if (rawInput.start) { | |
start = this.moment(rawInput.start); | |
if (!start.isValid()) { | |
start = null; | |
} | |
} | |
if (rawInput.end) { | |
end = this.moment(rawInput.end); | |
if (!end.isValid()) { | |
end = null; | |
} | |
} | |
return [ | |
new ComponentFootprint( | |
new UnzonedRange(start, end), | |
(start && !start.hasTime()) || (end && !end.hasTime()) // isAllDay | |
) | |
]; | |
}; | |
// Footprint Utils | |
// ---------------------------------------------------------------------------------------- | |
Calendar.prototype.footprintContainsFootprint = function(outerFootprint, innerFootprint) { | |
return outerFootprint.unzonedRange.containsRange(innerFootprint.unzonedRange); | |
}; | |
Calendar.prototype.footprintsIntersect = function(footprint0, footprint1) { | |
return footprint0.unzonedRange.intersectsWith(footprint1.unzonedRange); | |
}; | |
;; | |
Calendar.mixin({ | |
// Sources | |
// ------------------------------------------------------------------------------------ | |
getEventSources: function() { | |
return this.eventManager.otherSources.slice(); // clone | |
}, | |
getEventSourceById: function(id) { | |
return this.eventManager.getSourceById( | |
EventSource.normalizeId(id) | |
); | |
}, | |
addEventSource: function(sourceInput) { | |
var source = EventSourceParser.parse(sourceInput, this); | |
if (source) { | |
this.eventManager.addSource(source); | |
} | |
}, | |
removeEventSources: function(sourceMultiQuery) { | |
var eventManager = this.eventManager; | |
var sources; | |
var i; | |
if (sourceMultiQuery == null) { | |
this.eventManager.removeAllSources(); | |
} | |
else { | |
sources = eventManager.multiQuerySources(sourceMultiQuery); | |
eventManager.freeze(); | |
for (i = 0; i < sources.length; i++) { | |
eventManager.removeSource(sources[i]); | |
} | |
eventManager.thaw(); | |
} | |
}, | |
removeEventSource: function(sourceQuery) { | |
var eventManager = this.eventManager; | |
var sources = eventManager.querySources(sourceQuery); | |
var i; | |
eventManager.freeze(); | |
for (i = 0; i < sources.length; i++) { | |
eventManager.removeSource(sources[i]); | |
} | |
eventManager.thaw(); | |
}, | |
refetchEventSources: function(sourceMultiQuery) { | |
var eventManager = this.eventManager; | |
var sources = eventManager.multiQuerySources(sourceMultiQuery); | |
var i; | |
eventManager.freeze(); | |
for (i = 0; i < sources.length; i++) { | |
eventManager.refetchSource(sources[i]); | |
} | |
eventManager.thaw(); | |
}, | |
// Events | |
// ------------------------------------------------------------------------------------ | |
refetchEvents: function() { | |
this.eventManager.refetchAllSources(); | |
}, | |
renderEvents: function(eventInputs, isSticky) { | |
this.eventManager.freeze(); | |
for (var i = 0; i < eventInputs.length; i++) { | |
this.renderEvent(eventInputs[i], isSticky); | |
} | |
this.eventManager.thaw(); | |
}, | |
renderEvent: function(eventInput, isSticky) { | |
var eventManager = this.eventManager; | |
var eventDef = EventDefParser.parse( | |
eventInput, | |
eventInput.source || eventManager.stickySource | |
); | |
if (eventDef) { | |
eventManager.addEventDef(eventDef, isSticky); | |
} | |
}, | |
// legacyQuery operates on legacy event instance objects | |
removeEvents: function(legacyQuery) { | |
var eventManager = this.eventManager; | |
var eventInstances = eventManager.getEventInstances(); | |
var legacyInstances; | |
var idMap = {}; | |
var eventDef; | |
var i; | |
if (legacyQuery == null) { // shortcut for removing all | |
eventManager.removeAllEventDefs(); | |
} | |
else { | |
legacyInstances = eventInstances.map(function(eventInstance) { | |
return eventInstance.toLegacy(); | |
}); | |
legacyInstances = filterLegacyEventInstances(legacyInstances, legacyQuery); | |
// compute unique IDs | |
for (i = 0; i < legacyInstances.length; i++) { | |
eventDef = this.eventManager.getEventDefByUid(legacyInstances[i]._id); | |
idMap[eventDef.id] = true; | |
} | |
eventManager.freeze(); | |
for (i in idMap) { // reuse `i` as an "id" | |
eventManager.removeEventDefsById(i); | |
} | |
eventManager.thaw(); | |
} | |
}, | |
// legacyQuery operates on legacy event instance objects | |
clientEvents: function(legacyQuery) { | |
var eventInstances = this.eventManager.getEventInstances(); | |
var legacyEventInstances = eventInstances.map(function(eventInstance) { | |
return eventInstance.toLegacy(); | |
}); | |
return filterLegacyEventInstances(legacyEventInstances, legacyQuery); | |
}, | |
updateEvents: function(eventPropsArray) { | |
this.eventManager.freeze(); | |
for (var i = 0; i < eventPropsArray.length; i++) { | |
this.updateEvent(eventPropsArray[i]); | |
} | |
this.eventManager.thaw(); | |
}, | |
updateEvent: function(eventProps) { | |
var eventDef = this.eventManager.getEventDefByUid(eventProps._id); | |
var eventInstance; | |
var eventDefMutation; | |
if (eventDef instanceof SingleEventDef) { | |
eventInstance = eventDef.buildInstance(); | |
eventDefMutation = EventDefMutation.createFromRawProps( | |
eventInstance, | |
eventProps, // raw props | |
null // largeUnit -- who uses it? | |
); | |
this.eventManager.mutateEventsWithId(eventDef.id, eventDefMutation); // will release | |
} | |
} | |
}); | |
function filterLegacyEventInstances(legacyEventInstances, legacyQuery) { | |
if (legacyQuery == null) { | |
return legacyEventInstances; | |
} | |
else if ($.isFunction(legacyQuery)) { | |
return legacyEventInstances.filter(legacyQuery); | |
} | |
else { // an event ID | |
legacyQuery += ''; // normalize to string | |
return legacyEventInstances.filter(function(legacyEventInstance) { | |
// soft comparison because id not be normalized to string | |
return legacyEventInstance.id == legacyQuery; | |
}); | |
} | |
} | |
;; | |
Calendar.defaults = { | |
titleRangeSeparator: ' \u2013 ', // en dash | |
monthYearFormat: 'MMMM YYYY', // required for en. other locales rely on datepicker computable option | |
defaultTimedEventDuration: '02:00:00', | |
defaultAllDayEventDuration: { days: 1 }, | |
forceEventDuration: false, | |
nextDayThreshold: '09:00:00', // 9am | |
// display | |
defaultView: 'month', | |
aspectRatio: 1.35, | |
header: { | |
left: 'title', | |
center: '', | |
right: 'today prev,next' | |
}, | |
weekends: true, | |
weekNumbers: false, | |
weekNumberTitle: 'W', | |
weekNumberCalculation: 'local', | |
//editable: false, | |
//nowIndicator: false, | |
scrollTime: '06:00:00', | |
minTime: '00:00:00', | |
maxTime: '24:00:00', | |
showNonCurrentDates: true, | |
// event ajax | |
lazyFetching: true, | |
startParam: 'start', | |
endParam: 'end', | |
timezoneParam: 'timezone', | |
timezone: false, | |
//allDayDefault: undefined, | |
// locale | |
isRTL: false, | |
buttonText: { | |
prev: "prev", | |
next: "next", | |
prevYear: "prev year", | |
nextYear: "next year", | |
year: 'year', // TODO: locale files need to specify this | |
today: 'today', | |
month: 'month', | |
week: 'week', | |
day: 'day' | |
}, | |
//buttonIcons: null, | |
allDayText: 'all-day', | |
// jquery-ui theming | |
theme: false, | |
//themeButtonIcons: null, | |
//eventResizableFromStart: false, | |
dragOpacity: .75, | |
dragRevertDuration: 500, | |
dragScroll: true, | |
//selectable: false, | |
unselectAuto: true, | |
//selectMinDistance: 0, | |
dropAccept: '*', | |
eventOrder: 'title', | |
//eventRenderWait: null, | |
eventLimit: false, | |
eventLimitText: 'more', | |
eventLimitClick: 'popover', | |
dayPopoverFormat: 'LL', | |
handleWindowResize: true, | |
windowResizeDelay: 100, // milliseconds before an updateSize happens | |
longPressDelay: 1000 | |
}; | |
Calendar.englishDefaults = { // used by locale.js | |
dayPopoverFormat: 'dddd, MMMM D' | |
}; | |
Calendar.rtlDefaults = { // right-to-left defaults | |
header: { // TODO: smarter solution (first/center/last ?) | |
left: 'next,prev today', | |
center: '', | |
right: 'title' | |
}, | |
buttonIcons: { | |
prev: 'right-single-arrow', | |
next: 'left-single-arrow', | |
prevYear: 'right-double-arrow', | |
nextYear: 'left-double-arrow' | |
}, | |
themeButtonIcons: { | |
prev: 'circle-triangle-e', | |
next: 'circle-triangle-w', | |
nextYear: 'seek-prev', | |
prevYear: 'seek-next' | |
} | |
}; | |
;; | |
var localeOptionHash = FC.locales = {}; // initialize and expose | |
// TODO: document the structure and ordering of a FullCalendar locale file | |
// Initialize jQuery UI datepicker translations while using some of the translations | |
// Will set this as the default locales for datepicker. | |
FC.datepickerLocale = function(localeCode, dpLocaleCode, dpOptions) { | |
// get the FullCalendar internal option hash for this locale. create if necessary | |
var fcOptions = localeOptionHash[localeCode] || (localeOptionHash[localeCode] = {}); | |
// transfer some simple options from datepicker to fc | |
fcOptions.isRTL = dpOptions.isRTL; | |
fcOptions.weekNumberTitle = dpOptions.weekHeader; | |
// compute some more complex options from datepicker | |
$.each(dpComputableOptions, function(name, func) { | |
fcOptions[name] = func(dpOptions); | |
}); | |
// is jQuery UI Datepicker is on the page? | |
if ($.datepicker) { | |
// Register the locale data. | |
// FullCalendar and MomentJS use locale codes like "pt-br" but Datepicker | |
// does it like "pt-BR" or if it doesn't have the locale, maybe just "pt". | |
// Make an alias so the locale can be referenced either way. | |
$.datepicker.regional[dpLocaleCode] = | |
$.datepicker.regional[localeCode] = // alias | |
dpOptions; | |
// Alias 'en' to the default locale data. Do this every time. | |
$.datepicker.regional.en = $.datepicker.regional['']; | |
// Set as Datepicker's global defaults. | |
$.datepicker.setDefaults(dpOptions); | |
} | |
}; | |
// Sets FullCalendar-specific translations. Will set the locales as the global default. | |
FC.locale = function(localeCode, newFcOptions) { | |
var fcOptions; | |
var momOptions; | |
// get the FullCalendar internal option hash for this locale. create if necessary | |
fcOptions = localeOptionHash[localeCode] || (localeOptionHash[localeCode] = {}); | |
// provided new options for this locales? merge them in | |
if (newFcOptions) { | |
fcOptions = localeOptionHash[localeCode] = mergeOptions([ fcOptions, newFcOptions ]); | |
} | |
// compute locale options that weren't defined. | |
// always do this. newFcOptions can be undefined when initializing from i18n file, | |
// so no way to tell if this is an initialization or a default-setting. | |
momOptions = getMomentLocaleData(localeCode); // will fall back to en | |
$.each(momComputableOptions, function(name, func) { | |
if (fcOptions[name] == null) { | |
fcOptions[name] = func(momOptions, fcOptions); | |
} | |
}); | |
// set it as the default locale for FullCalendar | |
Calendar.defaults.locale = localeCode; | |
}; | |
// NOTE: can't guarantee any of these computations will run because not every locale has datepicker | |
// configs, so make sure there are English fallbacks for these in the defaults file. | |
var dpComputableOptions = { | |
buttonText: function(dpOptions) { | |
return { | |
// the translations sometimes wrongly contain HTML entities | |
prev: stripHtmlEntities(dpOptions.prevText), | |
next: stripHtmlEntities(dpOptions.nextText), | |
today: stripHtmlEntities(dpOptions.currentText) | |
}; | |
}, | |
// Produces format strings like "MMMM YYYY" -> "September 2014" | |
monthYearFormat: function(dpOptions) { | |
return dpOptions.showMonthAfterYear ? | |
'YYYY[' + dpOptions.yearSuffix + '] MMMM' : | |
'MMMM YYYY[' + dpOptions.yearSuffix + ']'; | |
} | |
}; | |
var momComputableOptions = { | |
// Produces format strings like "ddd M/D" -> "Fri 9/15" | |
dayOfMonthFormat: function(momOptions, fcOptions) { | |
var format = momOptions.longDateFormat('l'); // for the format like "M/D/YYYY" | |
// strip the year off the edge, as well as other misc non-whitespace chars | |
format = format.replace(/^Y+[^\w\s]*|[^\w\s]*Y+$/g, ''); | |
if (fcOptions.isRTL) { | |
format += ' ddd'; // for RTL, add day-of-week to end | |
} | |
else { | |
format = 'ddd ' + format; // for LTR, add day-of-week to beginning | |
} | |
return format; | |
}, | |
// Produces format strings like "h:mma" -> "6:00pm" | |
mediumTimeFormat: function(momOptions) { // can't be called `timeFormat` because collides with option | |
return momOptions.longDateFormat('LT') | |
.replace(/\s*a$/i, 'a'); // convert AM/PM/am/pm to lowercase. remove any spaces beforehand | |
}, | |
// Produces format strings like "h(:mm)a" -> "6pm" / "6:30pm" | |
smallTimeFormat: function(momOptions) { | |
return momOptions.longDateFormat('LT') | |
.replace(':mm', '(:mm)') | |
.replace(/(\Wmm)$/, '($1)') // like above, but for foreign locales | |
.replace(/\s*a$/i, 'a'); // convert AM/PM/am/pm to lowercase. remove any spaces beforehand | |
}, | |
// Produces format strings like "h(:mm)t" -> "6p" / "6:30p" | |
extraSmallTimeFormat: function(momOptions) { | |
return momOptions.longDateFormat('LT') | |
.replace(':mm', '(:mm)') | |
.replace(/(\Wmm)$/, '($1)') // like above, but for foreign locales | |
.replace(/\s*a$/i, 't'); // convert to AM/PM/am/pm to lowercase one-letter. remove any spaces beforehand | |
}, | |
// Produces format strings like "ha" / "H" -> "6pm" / "18" | |
hourFormat: function(momOptions) { | |
return momOptions.longDateFormat('LT') | |
.replace(':mm', '') | |
.replace(/(\Wmm)$/, '') // like above, but for foreign locales | |
.replace(/\s*a$/i, 'a'); // convert AM/PM/am/pm to lowercase. remove any spaces beforehand | |
}, | |
// Produces format strings like "h:mm" -> "6:30" (with no AM/PM) | |
noMeridiemTimeFormat: function(momOptions) { | |
return momOptions.longDateFormat('LT') | |
.replace(/\s*a$/i, ''); // remove trailing AM/PM | |
} | |
}; | |
// options that should be computed off live calendar options (considers override options) | |
// TODO: best place for this? related to locale? | |
// TODO: flipping text based on isRTL is a bad idea because the CSS `direction` might want to handle it | |
var instanceComputableOptions = { | |
// Produces format strings for results like "Mo 16" | |
smallDayDateFormat: function(options) { | |
return options.isRTL ? | |
'D dd' : | |
'dd D'; | |
}, | |
// Produces format strings for results like "Wk 5" | |
weekFormat: function(options) { | |
return options.isRTL ? | |
'w[ ' + options.weekNumberTitle + ']' : | |
'[' + options.weekNumberTitle + ' ]w'; | |
}, | |
// Produces format strings for results like "Wk5" | |
smallWeekFormat: function(options) { | |
return options.isRTL ? | |
'w[' + options.weekNumberTitle + ']' : | |
'[' + options.weekNumberTitle + ']w'; | |
} | |
}; | |
// TODO: make these computable properties in optionsModel | |
function populateInstanceComputableOptions(options) { | |
$.each(instanceComputableOptions, function(name, func) { | |
if (options[name] == null) { | |
options[name] = func(options); | |
} | |
}); | |
} | |
// Returns moment's internal locale data. If doesn't exist, returns English. | |
function getMomentLocaleData(localeCode) { | |
return moment.localeData(localeCode) || moment.localeData('en'); | |
} | |
// Initialize English by forcing computation of moment-derived options. | |
// Also, sets it as the default. | |
FC.locale('en', Calendar.englishDefaults); | |
;; | |
var UnzonedRange = FC.UnzonedRange = Class.extend({ | |
startMs: null, // if null, no start constraint | |
endMs: null, // if null, no end constraint | |
// TODO: move these into footprint. | |
// Especially, doesn't make sense for null startMs/endMs. | |
isStart: true, | |
isEnd: true, | |
constructor: function(startInput, endInput) { | |
if (moment.isMoment(startInput)) { | |
startInput = startInput.clone().stripZone(); | |
} | |
if (moment.isMoment(endInput)) { | |
endInput = endInput.clone().stripZone(); | |
} | |
if (startInput) { | |
this.startMs = startInput.valueOf(); | |
} | |
if (endInput) { | |
this.endMs = endInput.valueOf(); | |
} | |
}, | |
intersect: function(otherRange) { | |
var startMs = this.startMs; | |
var endMs = this.endMs; | |
var newRange = null; | |
if (otherRange.startMs !== null) { | |
if (startMs === null) { | |
startMs = otherRange.startMs; | |
} | |
else { | |
startMs = Math.max(startMs, otherRange.startMs); | |
} | |
} | |
if (otherRange.endMs !== null) { | |
if (endMs === null) { | |
endMs = otherRange.endMs; | |
} | |
else { | |
endMs = Math.min(endMs, otherRange.endMs); | |
} | |
} | |
if (startMs === null || endMs === null || startMs < endMs) { | |
newRange = new UnzonedRange(startMs, endMs); | |
newRange.isStart = this.isStart && startMs === this.startMs; | |
newRange.isEnd = this.isEnd && endMs === this.endMs; | |
} | |
return newRange; | |
}, | |
intersectsWith: function(otherRange) { | |
return (this.endMs === null || otherRange.startMs === null || this.endMs > otherRange.startMs) && | |
(this.startMs === null || otherRange.endMs === null || this.startMs < otherRange.endMs); | |
}, | |
containsRange: function(innerRange) { | |
return (this.startMs === null || (innerRange.startMs !== null && innerRange.startMs >= this.startMs)) && | |
(this.endMs === null || (innerRange.endMs !== null && innerRange.endMs <= this.endMs)); | |
}, | |
// `date` can be a moment, a Date, or a millisecond time. | |
containsDate: function(date) { | |
var ms = date.valueOf(); | |
return (this.startMs === null || ms >= this.startMs) && | |
(this.endMs === null || ms < this.endMs); | |
}, | |
// If the given date is not within the given range, move it inside. | |
// (If it's past the end, make it one millisecond before the end). | |
// `date` can be a moment, a Date, or a millisecond time. | |
// Returns a MS-time. | |
constrainDate: function(date) { | |
var ms = date.valueOf(); | |
if (this.startMs !== null && ms < this.startMs) { | |
ms = this.startMs; | |
} | |
if (this.endMs !== null && ms >= this.endMs) { | |
ms = this.endMs - 1; | |
} | |
return ms; | |
}, | |
equals: function(otherRange) { | |
return this.startMs === otherRange.startMs && this.endMs === otherRange.endMs; | |
}, | |
clone: function() { | |
var range = new UnzonedRange(this.startMs, this.endMs); | |
range.isStart = this.isStart; | |
range.isEnd = this.isEnd; | |
return range; | |
}, | |
// Returns an ambig-zoned moment from startMs. | |
// BEWARE: returned moment is not localized. | |
// Formatting and start-of-week will be default. | |
getStart: function() { | |
if (this.startMs !== null) { | |
return FC.moment.utc(this.startMs).stripZone(); | |
} | |
}, | |
// Returns an ambig-zoned moment from startMs. | |
// BEWARE: returned moment is not localized. | |
// Formatting and start-of-week will be default. | |
getEnd: function() { | |
if (this.endMs !== null) { | |
return FC.moment.utc(this.endMs).stripZone(); | |
} | |
} | |
}); | |
/* | |
SIDEEFFECT: will mutate eventRanges. | |
Will return a new array result. | |
Only works for non-open-ended ranges. | |
*/ | |
function invertUnzonedRanges(ranges, constraintRange) { | |
var invertedRanges = []; | |
var startMs = constraintRange.startMs; // the end of the previous range. the start of the new range | |
var i; | |
var dateRange; | |
// ranges need to be in order. required for our date-walking algorithm | |
ranges.sort(compareUnzonedRanges); | |
for (i = 0; i < ranges.length; i++) { | |
dateRange = ranges[i]; | |
// add the span of time before the event (if there is any) | |
if (dateRange.startMs > startMs) { // compare millisecond time (skip any ambig logic) | |
invertedRanges.push( | |
new UnzonedRange(startMs, dateRange.startMs) | |
); | |
} | |
if (dateRange.endMs > startMs) { | |
startMs = dateRange.endMs; | |
} | |
} | |
// add the span of time after the last event (if there is any) | |
if (startMs < constraintRange.endMs) { // compare millisecond time (skip any ambig logic) | |
invertedRanges.push( | |
new UnzonedRange(startMs, constraintRange.endMs) | |
); | |
} | |
return invertedRanges; | |
} | |
/* | |
Only works for non-open-ended ranges. | |
*/ | |
function compareUnzonedRanges(range1, range2) { | |
return range1.startMs - range2.startMs; // earlier ranges go first | |
} | |
;; | |
/* | |
Meant to be immutable | |
*/ | |
var ComponentFootprint = FC.ComponentFootprint = Class.extend({ | |
unzonedRange: null, | |
isAllDay: false, // component can choose to ignore this | |
constructor: function(unzonedRange, isAllDay) { | |
this.unzonedRange = unzonedRange; | |
this.isAllDay = isAllDay; | |
}, | |
/* | |
Only works for non-open-ended ranges. | |
*/ | |
toLegacy: function(calendar) { | |
return { | |
start: calendar.msToMoment(this.unzonedRange.startMs, this.isAllDay), | |
end: calendar.msToMoment(this.unzonedRange.endMs, this.isAllDay) | |
}; | |
} | |
}); | |
;; | |
var EventManager = Class.extend(EmitterMixin, ListenerMixin, { | |
currentPeriod: null, | |
calendar: null, | |
stickySource: null, | |
otherSources: null, // does not include sticky source | |
constructor: function(calendar) { | |
this.calendar = calendar; | |
this.stickySource = new ArrayEventSource(calendar); | |
this.otherSources = []; | |
}, | |
requestEvents: function(start, end, timezone, force) { | |
if ( | |
force || | |
!this.currentPeriod || | |
!this.currentPeriod.isWithinRange(start, end) | |
) { | |
this.setPeriod( // will change this.currentPeriod | |
new EventPeriod(start, end, timezone) | |
); | |
} | |
return this.currentPeriod.whenReleased(); | |
}, | |
// Source Adding/Removing | |
// ----------------------------------------------------------------------------------------------------------------- | |
addSource: function(eventSource) { | |
this.otherSources.push(eventSource); | |
if (this.currentPeriod) { | |
this.currentPeriod.requestSource(eventSource); // might release | |
} | |
}, | |
removeSource: function(doomedSource) { | |
removeExact(this.otherSources, doomedSource); | |
if (this.currentPeriod) { | |
this.currentPeriod.purgeSource(doomedSource); // might release | |
} | |
}, | |
removeAllSources: function() { | |
this.otherSources = []; | |
if (this.currentPeriod) { | |
this.currentPeriod.purgeAllSources(); // might release | |
} | |
}, | |
// Source Refetching | |
// ----------------------------------------------------------------------------------------------------------------- | |
refetchSource: function(eventSource) { | |
var currentPeriod = this.currentPeriod; | |
if (currentPeriod) { | |
currentPeriod.freeze(); | |
currentPeriod.purgeSource(eventSource); | |
currentPeriod.requestSource(eventSource); | |
currentPeriod.thaw(); | |
} | |
}, | |
refetchAllSources: function() { | |
var currentPeriod = this.currentPeriod; | |
if (currentPeriod) { | |
currentPeriod.freeze(); | |
currentPeriod.purgeAllSources(); | |
currentPeriod.requestSources(this.getSources()); | |
currentPeriod.thaw(); | |
} | |
}, | |
// Source Querying | |
// ----------------------------------------------------------------------------------------------------------------- | |
getSources: function() { | |
return [ this.stickySource ].concat(this.otherSources); | |
}, | |
// like querySources, but accepts multple match criteria (like multiple IDs) | |
multiQuerySources: function(matchInputs) { | |
// coerce into an array | |
if (!matchInputs) { | |
matchInputs = []; | |
} | |
else if (!$.isArray(matchInputs)) { | |
matchInputs = [ matchInputs ]; | |
} | |
var matchingSources = []; | |
var i; | |
// resolve raw inputs to real event source objects | |
for (i = 0; i < matchInputs.length; i++) { | |
matchingSources.push.apply( // append | |
matchingSources, | |
this.querySources(matchInputs[i]) | |
); | |
} | |
return matchingSources; | |
}, | |
// matchInput can either by a real event source object, an ID, or the function/URL for the source. | |
// returns an array of matching source objects. | |
querySources: function(matchInput) { | |
var sources = this.otherSources; | |
var i, source; | |
// given a proper event source object | |
for (i = 0; i < sources.length; i++) { | |
source = sources[i]; | |
if (source === matchInput) { | |
return [ source ]; | |
} | |
} | |
// an ID match | |
source = this.getSourceById(EventSource.normalizeId(matchInput)); | |
if (source) { | |
return [ source ]; | |
} | |
// parse as an event source | |
matchInput = EventSourceParser.parse(matchInput, this.calendar); | |
if (matchInput) { | |
return $.grep(sources, function(source) { | |
return isSourcesEquivalent(matchInput, source); | |
}); | |
} | |
}, | |
/* | |
ID assumed to already be normalized | |
*/ | |
getSourceById: function(id) { | |
return $.grep(this.otherSources, function(source) { | |
return source.id && source.id === id; | |
})[0]; | |
}, | |
// Event-Period | |
// ----------------------------------------------------------------------------------------------------------------- | |
setPeriod: function(eventPeriod) { | |
if (this.currentPeriod) { | |
this.unbindPeriod(this.currentPeriod); | |
this.currentPeriod = null; | |
} | |
this.currentPeriod = eventPeriod; | |
this.bindPeriod(eventPeriod); | |
eventPeriod.requestSources(this.getSources()); | |
}, | |
bindPeriod: function(eventPeriod) { | |
this.listenTo(eventPeriod, 'release', function(eventsPayload) { | |
this.trigger('release', eventsPayload); | |
}); | |
}, | |
unbindPeriod: function(eventPeriod) { | |
this.stopListeningTo(eventPeriod); | |
}, | |
// Event Getting/Adding/Removing | |
// ----------------------------------------------------------------------------------------------------------------- | |
getEventDefByUid: function(uid) { | |
if (this.currentPeriod) { | |
return this.currentPeriod.getEventDefByUid(uid); | |
} | |
}, | |
addEventDef: function(eventDef, isSticky) { | |
if (isSticky) { | |
this.stickySource.addEventDef(eventDef); | |
} | |
if (this.currentPeriod) { | |
this.currentPeriod.addEventDef(eventDef); // might release | |
} | |
}, | |
removeEventDefsById: function(eventId) { | |
this.getSources().forEach(function(eventSource) { | |
eventSource.removeEventDefsById(eventId); | |
}); | |
if (this.currentPeriod) { | |
this.currentPeriod.removeEventDefsById(eventId); // might release | |
} | |
}, | |
removeAllEventDefs: function() { | |
this.getSources().forEach(function(eventSource) { | |
eventSource.removeAllEventDefs(); | |
}); | |
if (this.currentPeriod) { | |
this.currentPeriod.removeAllEventDefs(); | |
} | |
}, | |
// Event Mutating | |
// ----------------------------------------------------------------------------------------------------------------- | |
/* | |
Returns an undo function. | |
*/ | |
mutateEventsWithId: function(eventDefId, eventDefMutation) { | |
var currentPeriod = this.currentPeriod; | |
var eventDefs; | |
var undoFuncs = []; | |
if (currentPeriod) { | |
currentPeriod.freeze(); | |
eventDefs = currentPeriod.getEventDefsById(eventDefId); | |
eventDefs.forEach(function(eventDef) { | |
// add/remove esp because id might change | |
currentPeriod.removeEventDef(eventDef); | |
undoFuncs.push(eventDefMutation.mutateSingle(eventDef)); | |
currentPeriod.addEventDef(eventDef); | |
}); | |
currentPeriod.thaw(); | |
return function() { | |
currentPeriod.freeze(); | |
for (var i = 0; i < eventDefs.length; i++) { | |
currentPeriod.removeEventDef(eventDefs[i]); | |
undoFuncs[i](); | |
currentPeriod.addEventDef(eventDefs[i]); | |
} | |
currentPeriod.thaw(); | |
}; | |
} | |
return function() { }; | |
}, | |
/* | |
copies and then mutates | |
*/ | |
buildMutatedEventInstanceGroup: function(eventDefId, eventDefMutation) { | |
var eventDefs = this.getEventDefsById(eventDefId); | |
var i; | |
var defCopy; | |
var allInstances = []; | |
for (i = 0; i < eventDefs.length; i++) { | |
defCopy = eventDefs[i].clone(); | |
if (defCopy instanceof SingleEventDef) { | |
eventDefMutation.mutateSingle(defCopy); | |
allInstances.push.apply(allInstances, // append | |
defCopy.buildInstances() | |
); | |
} | |
} | |
return new EventInstanceGroup(allInstances); | |
}, | |
// Freezing | |
// ----------------------------------------------------------------------------------------------------------------- | |
freeze: function() { | |
if (this.currentPeriod) { | |
this.currentPeriod.freeze(); | |
} | |
}, | |
thaw: function() { | |
if (this.currentPeriod) { | |
this.currentPeriod.thaw(); | |
} | |
} | |
}); | |
// Methods that straight-up query the current EventPeriod for an array of results. | |
[ | |
'getEventDefsById', | |
'getEventInstances', | |
'getEventInstancesWithId', | |
'getEventInstancesWithoutId' | |
].forEach(function(methodName) { | |
EventManager.prototype[methodName] = function() { | |
var currentPeriod = this.currentPeriod; | |
if (currentPeriod) { | |
return currentPeriod[methodName].apply(currentPeriod, arguments); | |
} | |
return []; | |
}; | |
}); | |
function isSourcesEquivalent(source0, source1) { | |
return source0.getPrimitive() == source1.getPrimitive(); | |
} | |
;; | |
var EventPeriod = Class.extend(EmitterMixin, { | |
start: null, | |
end: null, | |
timezone: null, | |
unzonedRange: null, | |
requestsByUid: null, | |
pendingCnt: 0, | |
freezeDepth: 0, | |
stuntedReleaseCnt: 0, | |
releaseCnt: 0, | |
eventDefsByUid: null, | |
eventDefsById: null, | |
eventInstanceGroupsById: null, | |
constructor: function(start, end, timezone) { | |
this.start = start; | |
this.end = end; | |
this.timezone = timezone; | |
this.unzonedRange = new UnzonedRange( | |
start.clone().stripZone(), | |
end.clone().stripZone() | |
); | |
this.requestsByUid = {}; | |
this.eventDefsByUid = {}; | |
this.eventDefsById = {}; | |
this.eventInstanceGroupsById = {}; | |
}, | |
isWithinRange: function(start, end) { | |
// TODO: use a range util function? | |
return !start.isBefore(this.start) && !end.isAfter(this.end); | |
}, | |
// Requesting and Purging | |
// ----------------------------------------------------------------------------------------------------------------- | |
requestSources: function(sources) { | |
this.freeze(); | |
for (var i = 0; i < sources.length; i++) { | |
this.requestSource(sources[i]); | |
} | |
this.thaw(); | |
}, | |
requestSource: function(source) { | |
var _this = this; | |
var request = { source: source, status: 'pending' }; | |
this.requestsByUid[source.uid] = request; | |
this.pendingCnt += 1; | |
source.fetch(this.start, this.end, this.timezone).then(function(eventDefs) { | |
if (request.status !== 'cancelled') { | |
request.status = 'completed'; | |
request.eventDefs = eventDefs; | |
_this.addEventDefs(eventDefs); | |
_this.pendingCnt--; | |
_this.tryRelease(); | |
} | |
}, function() { // failure | |
if (request.status !== 'cancelled') { | |
request.status = 'failed'; | |
_this.pendingCnt--; | |
_this.tryRelease(); | |
} | |
}); | |
}, | |
purgeSource: function(source) { | |
var request = this.requestsByUid[source.uid]; | |
if (request) { | |
delete this.requestsByUid[source.uid]; | |
if (request.status === 'pending') { | |
request.status = 'cancelled'; | |
this.pendingCnt--; | |
this.tryRelease(); | |
} | |
else if (request.status === 'completed') { | |
request.eventDefs.forEach(this.removeEventDef.bind(this)); | |
} | |
} | |
}, | |
purgeAllSources: function() { | |
var requestsByUid = this.requestsByUid; | |
var uid, request; | |
var completedCnt = 0; | |
for (uid in requestsByUid) { | |
request = requestsByUid[uid]; | |
if (request.status === 'pending') { | |
request.status = 'cancelled'; | |
} | |
else if (request.status === 'completed') { | |
completedCnt++; | |
} | |
} | |
this.requestsByUid = {}; | |
this.pendingCnt = 0; | |
if (completedCnt) { | |
this.removeAllEventDefs(); // might release | |
} | |
}, | |
// Event Definitions | |
// ----------------------------------------------------------------------------------------------------------------- | |
getEventDefByUid: function(eventDefUid) { | |
return this.eventDefsByUid[eventDefUid]; | |
}, | |
getEventDefsById: function(eventDefId) { | |
var a = this.eventDefsById[eventDefId]; | |
if (a) { | |
return a.slice(); // clone | |
} | |
return []; | |
}, | |
addEventDefs: function(eventDefs) { | |
for (var i = 0; i < eventDefs.length; i++) { | |
this.addEventDef(eventDefs[i]); | |
} | |
}, | |
addEventDef: function(eventDef) { | |
var eventDefsById = this.eventDefsById; | |
var eventDefId = eventDef.id; | |
var eventDefs = eventDefsById[eventDefId] || (eventDefsById[eventDefId] = []); | |
var eventInstances = eventDef.buildInstances(this.unzonedRange); | |
var i; | |
eventDefs.push(eventDef); | |
this.eventDefsByUid[eventDef.uid] = eventDef; | |
for (i = 0; i < eventInstances.length; i++) { | |
this.addEventInstance(eventInstances[i], eventDefId); | |
} | |
}, | |
removeEventDefsById: function(eventDefId) { | |
var _this = this; | |
this.getEventDefsById(eventDefId).forEach(function(eventDef) { | |
_this.removeEventDef(eventDef); | |
}); | |
}, | |
removeAllEventDefs: function() { | |
var isEmpty = $.isEmptyObject(this.eventDefsByUid); | |
this.eventDefsByUid = {}; | |
this.eventDefsById = {}; | |
this.eventInstanceGroupsById = {}; | |
if (!isEmpty) { | |
this.tryRelease(); | |
} | |
}, | |
removeEventDef: function(eventDef) { | |
var eventDefsById = this.eventDefsById; | |
var eventDefs = eventDefsById[eventDef.id]; | |
delete this.eventDefsByUid[eventDef.uid]; | |
if (eventDefs) { | |
removeExact(eventDefs, eventDef); | |
if (!eventDefs.length) { | |
delete eventDefsById[eventDef.id]; | |
} | |
this.removeEventInstancesForDef(eventDef); | |
} | |
}, | |
// Event Instances | |
// ----------------------------------------------------------------------------------------------------------------- | |
getEventInstances: function() { // TODO: consider iterator | |
var eventInstanceGroupsById = this.eventInstanceGroupsById; | |
var eventInstances = []; | |
var id; | |
for (id in eventInstanceGroupsById) { | |
eventInstances.push.apply(eventInstances, // append | |
eventInstanceGroupsById[id].eventInstances | |
); | |
} | |
return eventInstances; | |
}, | |
getEventInstancesWithId: function(eventDefId) { | |
var eventInstanceGroup = this.eventInstanceGroupsById[eventDefId]; | |
if (eventInstanceGroup) { | |
return eventInstanceGroup.eventInstances.slice(); // clone | |
} | |
return []; | |
}, | |
getEventInstancesWithoutId: function(eventDefId) { // TODO: consider iterator | |
var eventInstanceGroupsById = this.eventInstanceGroupsById; | |
var matchingInstances = []; | |
var id; | |
for (id in eventInstanceGroupsById) { | |
if (id !== eventDefId) { | |
matchingInstances.push.apply(matchingInstances, // append | |
eventInstanceGroupsById[id].eventInstances | |
); | |
} | |
} | |
return matchingInstances; | |
}, | |
addEventInstance: function(eventInstance, eventDefId) { | |
var eventInstanceGroupsById = this.eventInstanceGroupsById; | |
var eventInstanceGroup = eventInstanceGroupsById[eventDefId] || | |
(eventInstanceGroupsById[eventDefId] = new EventInstanceGroup()); | |
eventInstanceGroup.eventInstances.push(eventInstance); | |
this.tryRelease(); | |
}, | |
removeEventInstancesForDef: function(eventDef) { | |
var eventInstanceGroupsById = this.eventInstanceGroupsById; | |
var eventInstanceGroup = eventInstanceGroupsById[eventDef.id]; | |
var removeCnt; | |
if (eventInstanceGroup) { | |
removeCnt = removeMatching(eventInstanceGroup.eventInstances, function(currentEventInstance) { | |
return currentEventInstance.def === eventDef; | |
}); | |
if (!eventInstanceGroup.eventInstances.length) { | |
delete eventInstanceGroupsById[eventDef.id]; | |
} | |
if (removeCnt) { | |
this.tryRelease(); | |
} | |
} | |
}, | |
// Releasing and Freezing | |
// ----------------------------------------------------------------------------------------------------------------- | |
tryRelease: function() { | |
if (!this.pendingCnt) { | |
if (!this.freezeDepth) { | |
this.release(); | |
} | |
else { | |
this.stuntedReleaseCnt++; | |
} | |
} | |
}, | |
release: function() { | |
this.releaseCnt++; | |
this.trigger('release', this.eventInstanceGroupsById); | |
}, | |
whenReleased: function() { | |
var _this = this; | |
if (this.releaseCnt) { | |
return Promise.resolve(this.eventInstanceGroupsById); | |
} | |
else { | |
return Promise.construct(function(onResolve) { | |
_this.one('release', onResolve); | |
}); | |
} | |
}, | |
freeze: function() { | |
if (!(this.freezeDepth++)) { | |
this.stuntedReleaseCnt = 0; | |
} | |
}, | |
thaw: function() { | |
if (!(--this.freezeDepth) && this.stuntedReleaseCnt && !this.pendingCnt) { | |
this.release(); | |
} | |
} | |
}); | |
;; | |
var BUSINESS_HOUR_EVENT_DEFAULTS = { | |
start: '09:00', | |
end: '17:00', | |
dow: [ 1, 2, 3, 4, 5 ], // monday - friday | |
rendering: 'inverse-background' | |
// classNames are defined in businessHoursSegClasses | |
}; | |
var BusinessHours = Class.extend({ | |
rawComplexDef: null, | |
unzonedRange: null, | |
calendar: null, // for eventRangesToEventFootprints AND anonymous EventSource | |
cache: null, | |
constructor: function(rawComplexDef, unzonedRange, calendar) { | |
this.rawComplexDef = rawComplexDef; | |
this.unzonedRange = unzonedRange; | |
this.calendar = calendar; | |
this.cache = {}; | |
}, | |
getAllEventRanges: function(isAllDay) { | |
var key = 'getAllEventRanges' + (isAllDay ? 1 : 0); | |
var instanceGroup; | |
if (!this.cache[key]) { | |
instanceGroup = this.buildInstanceGroup(isAllDay); | |
this.cache[key] = instanceGroup ? instanceGroup.getAllEventRanges() : []; | |
} | |
return this.cache[key]; | |
}, | |
sliceRenderRanges: function(isAllDay) { | |
var key = 'sliceRenderRanges' + (isAllDay ? 1 : 0); | |
var instanceGroup; | |
if (!this.cache[key]) { | |
instanceGroup = this.buildInstanceGroup(isAllDay); | |
this.cache[key] = instanceGroup ? instanceGroup.sliceRenderRanges(this.unzonedRange) : []; | |
} | |
return this.cache[key]; | |
}, | |
buildInstanceGroup: function(isAllDay) { | |
var eventDefs = this.buildEventDefs(isAllDay); | |
var eventInstanceGroup; | |
if (eventDefs.length) { | |
eventInstanceGroup = new EventInstanceGroup( | |
eventDefsToEventInstances(eventDefs, this.unzonedRange) | |
); | |
// so that inverse-background rendering can happen even when no eventRanges in view | |
eventInstanceGroup.explicitEventDef = eventDefs[0]; | |
return eventInstanceGroup; | |
} | |
}, | |
buildEventDefs: function(isAllDay) { | |
var rawComplexDef = this.rawComplexDef; | |
var rawDefs = []; | |
var requireDow = false; | |
var i; | |
var defs = []; | |
if (rawComplexDef === true) { | |
rawDefs = [ {} ]; // will get BUSINESS_HOUR_EVENT_DEFAULTS verbatim | |
} | |
else if ($.isPlainObject(rawComplexDef)) { | |
rawDefs = [ rawComplexDef ]; | |
} | |
else if ($.isArray(rawComplexDef)) { | |
rawDefs = rawComplexDef; | |
requireDow = true; // every sub-definition NEEDS a day-of-week | |
} | |
for (i = 0; i < rawDefs.length; i++) { | |
if (!requireDow || rawDefs[i].dow) { | |
defs.push( | |
this.buildEventDef(isAllDay, rawDefs[i]) | |
); | |
} | |
} | |
return defs; | |
}, | |
buildEventDef: function(isAllDay, rawDef) { | |
var fullRawDef = $.extend({}, BUSINESS_HOUR_EVENT_DEFAULTS, rawDef); | |
if (isAllDay) { | |
fullRawDef.start = null; | |
fullRawDef.end = null; | |
} | |
return RecurringEventDef.parse( | |
fullRawDef, | |
new EventSource(this.calendar) // dummy source | |
); | |
} | |
}); | |
;; | |
var EventDefParser = { | |
parse: function(eventInput, source) { | |
if ( | |
isTimeString(eventInput.start) || moment.isDuration(eventInput.start) || | |
isTimeString(eventInput.end) || moment.isDuration(eventInput.end) | |
) { | |
return RecurringEventDef.parse(eventInput, source); | |
} | |
else { | |
return SingleEventDef.parse(eventInput, source); | |
} | |
} | |
}; | |
;; | |
var EventDef = FC.EventDef = Class.extend(ParsableModelMixin, { | |
source: null, // required | |
id: null, // normalized supplied ID | |
rawId: null, // unnormalized supplied ID | |
uid: null, // internal ID. new ID for every definition | |
// NOTE: eventOrder sorting relies on these | |
title: null, | |
url: null, | |
rendering: null, | |
constraint: null, | |
overlap: null, | |
editable: null, | |
startEditable: null, | |
durationEditable: null, | |
color: null, | |
backgroundColor: null, | |
borderColor: null, | |
textColor: null, | |
className: null, // an array. TODO: rename to className*s* (API breakage) | |
miscProps: null, | |
constructor: function(source) { | |
this.uid = String(EventDef.uuid++); | |
this.source = source; | |
this.className = []; | |
this.miscProps = {}; | |
}, | |
isAllDay: function() { | |
// subclasses must implement | |
}, | |
buildInstances: function(unzonedRange) { | |
// subclasses must implement | |
}, | |
clone: function() { | |
var copy = new this.constructor(this.source); | |
copy.id = this.id; | |
copy.rawId = this.rawId; | |
copy.uid = this.uid; // not really unique anymore :( | |
EventDef.copyVerbatimStandardProps(this, copy); | |
copy.className = this.className; // should clone? | |
copy.miscProps = $.extend({}, this.miscProps); | |
return copy; | |
}, | |
hasInverseRendering: function() { | |
return this.getRendering() === 'inverse-background'; | |
}, | |
hasBgRendering: function() { | |
var rendering = this.getRendering(); | |
return rendering === 'inverse-background' || rendering === 'background'; | |
}, | |
getRendering: function() { | |
if (this.rendering != null) { | |
return this.rendering; | |
} | |
return this.source.rendering; | |
}, | |
getConstraint: function() { | |
if (this.constraint != null) { | |
return this.constraint; | |
} | |
if (this.source.constraint != null) { | |
return this.source.constraint; | |
} | |
return this.source.calendar.opt('eventConstraint'); // what about View option? | |
}, | |
getOverlap: function() { | |
if (this.overlap != null) { | |
return this.overlap; | |
} | |
if (this.source.overlap != null) { | |
return this.source.overlap; | |
} | |
return this.source.calendar.opt('eventOverlap'); // what about View option? | |
}, | |
isStartExplicitlyEditable: function() { | |
if (this.startEditable !== null) { | |
return this.startEditable; | |
} | |
return this.source.startEditable; | |
}, | |
isDurationExplicitlyEditable: function() { | |
if (this.durationEditable !== null) { | |
return this.durationEditable; | |
} | |
return this.source.durationEditable; | |
}, | |
isExplicitlyEditable: function() { | |
if (this.editable !== null) { | |
return this.editable; | |
} | |
return this.source.editable; | |
}, | |
toLegacy: function() { | |
var obj = $.extend({}, this.miscProps); | |
obj._id = this.uid; | |
obj.source = this.source; | |
obj.className = this.className; // should clone? | |
obj.allDay = this.isAllDay(); | |
if (this.rawId != null) { | |
obj.id = this.rawId; | |
} | |
EventDef.copyVerbatimStandardProps(this, obj); | |
return obj; | |
}, | |
applyManualRawProps: function(rawProps) { | |
if (rawProps.id != null) { | |
this.id = EventDef.normalizeId((this.rawId = rawProps.id)); | |
} | |
else { | |
this.id = EventDef.generateId(); | |
} | |
// TODO: converge with EventSource | |
if ($.isArray(rawProps.className)) { | |
this.className = rawProps.className; | |
} | |
if (typeof rawProps.className === 'string') { | |
this.className = rawProps.className.split(/\s+/); | |
} | |
return true; | |
}, | |
applyOtherRawProps: function(rawProps) { | |
this.miscProps = rawProps; | |
} | |
}); | |
// finish initializing the mixin | |
EventDef.allowRawProps = ParsableModelMixin_allowRawProps; | |
EventDef.copyVerbatimStandardProps = ParsableModelMixin_copyVerbatimStandardProps; | |
// IDs | |
// --------------------------------------------------------------------------------------------------------------------- | |
// TODO: converge with EventSource | |
EventDef.uuid = 0; | |
EventDef.normalizeId = function(id) { | |
return String(id); | |
}; | |
EventDef.generateId = function() { | |
return '_fc' + (EventDef.uuid++); | |
}; | |
// Parsing | |
// --------------------------------------------------------------------------------------------------------------------- | |
EventDef.allowRawProps({ | |
// not automatically assigned (`false`) | |
id: false, | |
className: false, | |
source: false, // will ignored | |
// automatically assigned (`true`) | |
title: true, | |
url: true, | |
rendering: true, | |
constraint: true, | |
overlap: true, | |
editable: true, | |
startEditable: true, | |
durationEditable: true, | |
color: true, | |
backgroundColor: true, | |
borderColor: true, | |
textColor: true | |
}); | |
EventDef.parse = function(rawInput, source) { | |
var def = new this(source); | |
var calendarTransform = source.calendar.opt('eventDataTransform'); | |
var sourceTransform = source.eventDataTransform; | |
if (calendarTransform) { | |
rawInput = calendarTransform(rawInput); | |
} | |
if (sourceTransform) { | |
rawInput = sourceTransform(rawInput); | |
} | |
if (def.applyRawProps(rawInput)) { | |
return def; | |
} | |
return false; | |
}; | |
;; | |
var SingleEventDef = EventDef.extend({ | |
dateProfile: null, | |
/* | |
Will receive start/end params, but will be ignored. | |
*/ | |
buildInstances: function() { | |
return [ this.buildInstance() ]; | |
}, | |
buildInstance: function() { | |
return new EventInstance( | |
this, // definition | |
this.dateProfile | |
); | |
}, | |
isAllDay: function() { | |
return this.dateProfile.isAllDay(); | |
}, | |
clone: function() { | |
var def = EventDef.prototype.clone.call(this); | |
def.dateProfile = this.dateProfile; | |
return def; | |
}, | |
rezone: function() { | |
var calendar = this.source.calendar; | |
var dateProfile = this.dateProfile; | |
this.dateProfile = new EventDateProfile( | |
calendar.moment(dateProfile.start), | |
dateProfile.end ? calendar.moment(dateProfile.end) : null, | |
calendar | |
); | |
}, | |
/* | |
NOTE: if super-method fails, should still attempt to apply | |
*/ | |
applyManualRawProps: function(rawProps) { | |
var superSuccess = EventDef.prototype.applyManualRawProps.apply(this, arguments); | |
var dateProfile = EventDateProfile.parse(rawProps, this.source); // returns null on failure | |
if (dateProfile) { | |
this.dateProfile = dateProfile; | |
return superSuccess; | |
} | |
else { | |
return false; | |
} | |
} | |
}); | |
// Parsing | |
// --------------------------------------------------------------------------------------------------------------------- | |
SingleEventDef.allowRawProps({ // false = manually process | |
start: false, | |
date: false, // alias for 'start' | |
end: false, | |
allDay: false | |
}); | |
;; | |
var RecurringEventDef = EventDef.extend({ | |
startTime: null, // duration | |
endTime: null, // duration, or null | |
dowHash: null, // object hash, or null | |
isAllDay: function() { | |
return !this.startTime && !this.endTime; | |
}, | |
buildInstances: function(unzonedRange) { | |
var calendar = this.source.calendar; | |
var unzonedDate = unzonedRange.getStart(); | |
var unzonedEnd = unzonedRange.getEnd(); | |
var zonedDayStart; | |
var instanceStart, instanceEnd; | |
var instances = []; | |
while (unzonedDate.isBefore(unzonedEnd)) { | |
// if everyday, or this particular day-of-week | |
if (!this.dowHash || this.dowHash[unzonedDate.day()]) { | |
zonedDayStart = calendar.applyTimezone(unzonedDate); | |
instanceStart = zonedDayStart.clone(); | |
instanceEnd = null; | |
if (this.startTime) { | |
instanceStart.time(this.startTime); | |
} | |
else { | |
instanceStart.stripTime(); | |
} | |
if (this.endTime) { | |
instanceEnd = zonedDayStart.clone().time(this.endTime); | |
} | |
instances.push( | |
new EventInstance( | |
this, // definition | |
new EventDateProfile(instanceStart, instanceEnd, calendar) | |
) | |
); | |
} | |
unzonedDate.add(1, 'days'); | |
} | |
return instances; | |
}, | |
setDow: function(dowNumbers) { | |
if (!this.dowHash) { | |
this.dowHash = {}; | |
} | |
for (var i = 0; i < dowNumbers.length; i++) { | |
this.dowHash[dowNumbers[i]] = true; | |
} | |
}, | |
clone: function() { | |
var def = EventDef.prototype.clone.call(this); | |
if (def.startTime) { | |
def.startTime = moment.duration(this.startTime); | |
} | |
if (def.endTime) { | |
def.endTime = moment.duration(this.endTime); | |
} | |
if (this.dowHash) { | |
def.dowHash = $.extend({}, this.dowHash); | |
} | |
return def; | |
}, | |
/* | |
NOTE: if super-method fails, should still attempt to apply | |
*/ | |
applyRawProps: function(rawProps) { | |
var superSuccess = EventDef.prototype.applyRawProps.apply(this, arguments); | |
if (rawProps.start) { | |
this.startTime = moment.duration(rawProps.start); | |
} | |
if (rawProps.end) { | |
this.endTime = moment.duration(rawProps.end); | |
} | |
if (rawProps.dow) { | |
this.setDow(rawProps.dow); | |
} | |
return superSuccess; | |
} | |
}); | |
// Parsing | |
// --------------------------------------------------------------------------------------------------------------------- | |
RecurringEventDef.allowRawProps({ // false = manually process | |
start: false, | |
end: false, | |
dow: false | |
}); | |
;; | |
var EventInstance = Class.extend({ | |
def: null, // EventDef | |
dateProfile: null, // EventDateProfile | |
constructor: function(def, dateProfile) { | |
this.def = def; | |
this.dateProfile = dateProfile; | |
}, | |
toLegacy: function() { | |
var dateProfile = this.dateProfile; | |
var obj = this.def.toLegacy(); | |
obj.start = dateProfile.start.clone(); | |
obj.end = dateProfile.end ? dateProfile.end.clone() : null; | |
return obj; | |
} | |
}); | |
;; | |
/* | |
It's expected that there will be at least one EventInstance, | |
OR that an explicitEventDef is assigned. | |
*/ | |
var EventInstanceGroup = Class.extend({ | |
eventInstances: null, | |
explicitEventDef: null, // optional | |
constructor: function(eventInstances) { | |
this.eventInstances = eventInstances || []; | |
}, | |
getAllEventRanges: function() { | |
return eventInstancesToEventRanges(this.eventInstances); | |
}, | |
sliceRenderRanges: function(constraintRange) { | |
if (this.isInverse()) { | |
return this.sliceInverseRenderRanges(constraintRange); | |
} | |
else { | |
return this.sliceNormalRenderRanges(constraintRange); | |
} | |
}, | |
sliceNormalRenderRanges: function(constraintRange) { | |
var eventInstances = this.eventInstances; | |
var i, eventInstance; | |
var slicedRange; | |
var slicedEventRanges = []; | |
for (i = 0; i < eventInstances.length; i++) { | |
eventInstance = eventInstances[i]; | |
slicedRange = eventInstance.dateProfile.unzonedRange.intersect(constraintRange); | |
if (slicedRange) { | |
slicedEventRanges.push( | |
new EventRange( | |
slicedRange, | |
eventInstance.def, | |
eventInstance | |
) | |
); | |
} | |
} | |
return slicedEventRanges; | |
}, | |
sliceInverseRenderRanges: function(constraintRange) { | |
var unzonedRanges = eventInstancesToUnzonedRanges(this.eventInstances); | |
var ownerDef = this.getEventDef(); | |
unzonedRanges = invertUnzonedRanges(unzonedRanges, constraintRange); | |
return unzonedRanges.map(function(unzonedRange) { | |
return new EventRange(unzonedRange, ownerDef); // don't give an EventInstance | |
}); | |
}, | |
isInverse: function() { | |
return this.getEventDef().hasInverseRendering(); | |
}, | |
getEventDef: function() { | |
return this.explicitEventDef || this.eventInstances[0].def; | |
} | |
}); | |
;; | |
/* | |
Meant to be immutable | |
*/ | |
var EventDateProfile = Class.extend({ | |
start: null, | |
end: null, | |
unzonedRange: null, | |
constructor: function(start, end, calendar) { | |
this.start = start; | |
this.end = end || null; | |
this.unzonedRange = this.buildUnzonedRange(calendar); | |
}, | |
isAllDay: function() { | |
return !(this.start.hasTime() || (this.end && this.end.hasTime())); | |
}, | |
/* | |
Needs a Calendar object | |
*/ | |
buildUnzonedRange: function(calendar) { | |
var startMs = this.start.clone().stripZone().valueOf(); | |
var endMs = this.getEnd(calendar).stripZone().valueOf(); | |
return new UnzonedRange(startMs, endMs); | |
}, | |
/* | |
Needs a Calendar object | |
*/ | |
getEnd: function(calendar) { | |
return this.end ? | |
this.end.clone() : | |
// derive the end from the start and allDay. compute allDay if necessary | |
calendar.getDefaultEventEnd( | |
this.isAllDay(), | |
this.start | |
); | |
} | |
}); | |
/* | |
Needs an EventSource object | |
*/ | |
EventDateProfile.parse = function(rawProps, source) { | |
var startInput = rawProps.start || rawProps.date; | |
var endInput = rawProps.end; | |
if (!startInput) { | |
return false; | |
} | |
var calendar = source.calendar; | |
var start = calendar.moment(startInput); | |
var end = endInput ? calendar.moment(endInput) : null; | |
var forcedAllDay = rawProps.allDay; | |
var forceEventDuration = calendar.opt('forceEventDuration'); | |
if (!start.isValid()) { | |
return false; | |
} | |
if (end && (!end.isValid() || !end.isAfter(start))) { | |
end = null; | |
} | |
if (forcedAllDay == null) { | |
forcedAllDay = source.allDayDefault; | |
if (forcedAllDay == null) { | |
forcedAllDay = calendar.opt('allDayDefault'); | |
} | |
} | |
if (forcedAllDay === true) { | |
start.stripTime(); | |
if (end) { | |
end.stripTime(); | |
} | |
} | |
else if (forcedAllDay === false) { | |
if (!start.hasTime()) { | |
start.time(0); | |
} | |
if (end && !end.hasTime()) { | |
end.time(0); | |
} | |
} | |
if (!end && forceEventDuration) { | |
end = calendar.getDefaultEventEnd(!start.hasTime(), start); | |
} | |
return new EventDateProfile(start, end, calendar); | |
}; | |
;; | |
var EventRange = Class.extend({ | |
unzonedRange: null, | |
eventDef: null, | |
eventInstance: null, // optional | |
constructor: function(unzonedRange, eventDef, eventInstance) { | |
this.unzonedRange = unzonedRange; | |
this.eventDef = eventDef; | |
if (eventInstance) { | |
this.eventInstance = eventInstance; | |
} | |
} | |
}); | |
;; | |
var EventFootprint = FC.EventFootprint = Class.extend({ | |
componentFootprint: null, | |
eventDef: null, | |
eventInstance: null, // optional | |
constructor: function(componentFootprint, eventDef, eventInstance) { | |
this.componentFootprint = componentFootprint; | |
this.eventDef = eventDef; | |
if (eventInstance) { | |
this.eventInstance = eventInstance; | |
} | |
}, | |
getEventLegacy: function() { | |
return (this.eventInstance || this.eventDef).toLegacy(); | |
} | |
}); | |
;; | |
var EventDefMutation = FC.EventDefMutation = Class.extend({ | |
// won't ever be empty. will be null instead. | |
// callers should use setDateMutation for setting. | |
dateMutation: null, | |
// hack to get updateEvent/createFromRawProps to work. | |
// not undo-able and not considered in isEmpty. | |
rawProps: null, // raw (pre-parse-like) | |
/* | |
eventDef assumed to be a SingleEventDef. | |
returns an undo function. | |
*/ | |
mutateSingle: function(eventDef) { | |
var origDateProfile; | |
if (this.dateMutation) { | |
origDateProfile = eventDef.dateProfile; | |
eventDef.dateProfile = this.dateMutation.buildNewDateProfile( | |
origDateProfile, | |
eventDef.source.calendar | |
); | |
} | |
// can't undo | |
if (this.rawProps) { | |
eventDef.applyRawProps(this.rawProps); | |
} | |
if (origDateProfile) { | |
return function() { | |
eventDef.dateProfile = origDateProfile; | |
}; | |
} | |
else { | |
return function() { }; | |
} | |
}, | |
setDateMutation: function(dateMutation) { | |
if (dateMutation && !dateMutation.isEmpty()) { | |
this.dateMutation = dateMutation; | |
} | |
else { | |
this.dateMutation = null; | |
} | |
}, | |
isEmpty: function() { | |
return !this.dateMutation; | |
} | |
}); | |
EventDefMutation.createFromRawProps = function(eventInstance, newRawProps, largeUnit) { | |
var eventDef = eventInstance.def; | |
var applicableRawProps = {}; | |
var propName; | |
var newDateProfile; | |
var dateMutation; | |
var defMutation; | |
for (propName in newRawProps) { | |
if ( | |
// ignore object-type custom properties and any date-related properties, | |
// as well as any other internal property | |
typeof newRawProps[propName] !== 'object' && | |
propName !== 'start' && propName !== 'end' && propName !== 'allDay' && | |
propName !== 'source' && propName !== '_id' | |
) { | |
applicableRawProps[propName] = newRawProps[propName]; | |
} | |
} | |
newDateProfile = EventDateProfile.parse(newRawProps, eventDef.source); | |
if (newDateProfile) { // no failure? | |
dateMutation = EventDefDateMutation.createFromDiff( | |
eventInstance.dateProfile, | |
newDateProfile, | |
largeUnit | |
); | |
} | |
defMutation = new EventDefMutation(); | |
defMutation.rawProps = applicableRawProps; | |
if (dateMutation) { | |
defMutation.dateMutation = dateMutation; | |
} | |
return defMutation; | |
}; | |
;; | |
var EventDefDateMutation = Class.extend({ | |
clearEnd: false, | |
forceTimed: false, | |
forceAllDay: false, | |
// Durations. if 0-ms duration, will be null instead. | |
// Callers should not set this directly. | |
dateDelta: null, | |
startDelta: null, | |
endDelta: null, | |
/* | |
returns an undo function. | |
*/ | |
buildNewDateProfile: function(eventDateProfile, calendar) { | |
var start = eventDateProfile.start.clone(); | |
var end = null; | |
var shouldRezone = false; | |
if (!this.clearEnd && eventDateProfile.end) { | |
end = eventDateProfile.end.clone(); | |
} | |
if (this.forceTimed) { | |
shouldRezone = true; | |
if (!start.hasTime()) { | |
start.time(0); | |
} | |
if (end && !end.hasTime()) { | |
end.time(0); | |
} | |
} | |
else if (this.forceAllDay) { | |
if (start.hasTime()) { | |
start.stripTime(); | |
} | |
if (end && end.hasTime()) { | |
end.stripTime(); | |
} | |
} | |
if (this.dateDelta) { | |
shouldRezone = true; | |
start.add(this.dateDelta); | |
if (end) { | |
end.add(this.dateDelta); | |
} | |
} | |
// do this before adding startDelta to start, so we can work off of start | |
if (this.endDelta) { | |
shouldRezone = true; | |
if (!end) { | |
end = calendar.getDefaultEventEnd(eventDateProfile.isAllDay(), start); | |
} | |
end.add(this.endDelta); | |
} | |
if (this.startDelta) { | |
shouldRezone = true; | |
start.add(this.startDelta); | |
} | |
if (shouldRezone) { | |
start = calendar.applyTimezone(start); | |
if (end) { | |
end = calendar.applyTimezone(end); | |
} | |
} | |
// TODO: okay to access calendar option? | |
if (!end && calendar.opt('forceEventDuration')) { | |
end = calendar.getDefaultEventEnd(eventDateProfile.isAllDay(), start); | |
} | |
return new EventDateProfile(start, end, calendar); | |
}, | |
setDateDelta: function(dateDelta) { | |
if (dateDelta && dateDelta.valueOf()) { | |
this.dateDelta = dateDelta; | |
} | |
else { | |
this.dateDelta = null; | |
} | |
}, | |
setStartDelta: function(startDelta) { | |
if (startDelta && startDelta.valueOf()) { | |
this.startDelta = startDelta; | |
} | |
else { | |
this.startDelta = null; | |
} | |
}, | |
setEndDelta: function(endDelta) { | |
if (endDelta && endDelta.valueOf()) { | |
this.endDelta = endDelta; | |
} | |
else { | |
this.endDelta = null; | |
} | |
}, | |
isEmpty: function() { | |
return !this.clearEnd && !this.forceTimed && !this.forceAllDay && | |
!this.dateDelta && !this.startDelta && !this.endDelta; | |
} | |
}); | |
EventDefDateMutation.createFromDiff = function(dateProfile0, dateProfile1, largeUnit) { | |
var clearEnd = dateProfile0.end && !dateProfile1.end; | |
var forceTimed = dateProfile0.isAllDay() && !dateProfile1.isAllDay(); | |
var forceAllDay = !dateProfile0.isAllDay() && dateProfile1.isAllDay(); | |
var dateDelta; | |
var endDiff; | |
var endDelta; | |
var mutation; | |
// subtracts the dates in the appropriate way, returning a duration | |
function subtractDates(date1, date0) { // date1 - date0 | |
if (largeUnit) { | |
return diffByUnit(date1, date0, largeUnit); // poorly named | |
} | |
else if (dateProfile1.isAllDay()) { | |
return diffDay(date1, date0); // poorly named | |
} | |
else { | |
return diffDayTime(date1, date0); // poorly named | |
} | |
} | |
dateDelta = subtractDates(dateProfile1.start, dateProfile0.start); | |
if (dateProfile1.end) { | |
// use unzonedRanges because dateProfile0.end might be null | |
endDiff = subtractDates( | |
dateProfile1.unzonedRange.getEnd(), | |
dateProfile0.unzonedRange.getEnd() | |
); | |
endDelta = endDiff.subtract(dateDelta); | |
} | |
mutation = new EventDefDateMutation(); | |
mutation.clearEnd = clearEnd; | |
mutation.forceTimed = forceTimed; | |
mutation.forceAllDay = forceAllDay; | |
mutation.setDateDelta(dateDelta); | |
mutation.setEndDelta(endDelta); | |
return mutation; | |
}; | |
;; | |
function eventDefsToEventInstances(eventDefs, unzonedRange) { | |
var eventInstances = []; | |
var i; | |
for (i = 0; i < eventDefs.length; i++) { | |
eventInstances.push.apply(eventInstances, // append | |
eventDefs[i].buildInstances(unzonedRange) | |
); | |
} | |
return eventInstances; | |
} | |
function eventInstancesToEventRanges(eventInstances) { | |
return eventInstances.map(function(eventInstance) { | |
return new EventRange( | |
eventInstance.dateProfile.unzonedRange, | |
eventInstance.def, | |
eventInstance | |
); | |
}); | |
} | |
function eventInstancesToUnzonedRanges(eventInstances) { | |
return eventInstances.map(function(eventInstance) { | |
return eventInstance.dateProfile.unzonedRange; | |
}); | |
} | |
function eventFootprintsToComponentFootprints(eventFootprints) { | |
return eventFootprints.map(function(eventFootprint) { | |
return eventFootprint.componentFootprint; | |
}); | |
} | |
;; | |
var EventSource = Class.extend(ParsableModelMixin, { | |
calendar: null, | |
id: null, // can stay null | |
uid: null, | |
color: null, | |
backgroundColor: null, | |
borderColor: null, | |
textColor: null, | |
className: null, // array | |
editable: null, | |
startEditable: null, | |
durationEditable: null, | |
rendering: null, | |
overlap: null, | |
constraint: null, | |
allDayDefault: null, | |
eventDataTransform: null, // optional function | |
constructor: function(calendar) { | |
this.calendar = calendar; | |
this.className = []; | |
this.uid = String(EventSource.uuid++); | |
}, | |
fetch: function(start, end, timezone) { | |
// subclasses must implement. must return a promise. | |
}, | |
removeEventDefsById: function(eventDefId) { | |
// optional for subclasses to implement | |
}, | |
removeAllEventDefs: function() { | |
// optional for subclasses to implement | |
}, | |
/* | |
For compairing/matching | |
*/ | |
getPrimitive: function(otherSource) { | |
// subclasses must implement | |
}, | |
parseEventDefs: function(rawEventDefs) { | |
var i; | |
var eventDef; | |
var eventDefs = []; | |
for (i = 0; i < rawEventDefs.length; i++) { | |
eventDef = EventDefParser.parse( | |
rawEventDefs[i], | |
this // source | |
); | |
if (eventDef) { | |
eventDefs.push(eventDef); | |
} | |
} | |
return eventDefs; | |
}, | |
applyManualRawProps: function(rawProps) { | |
if (rawProps.id != null) { | |
this.id = EventSource.normalizeId(rawProps.id); | |
} | |
// TODO: converge with EventDef | |
if ($.isArray(rawProps.className)) { | |
this.className = rawProps.className; | |
} | |
else if (typeof rawProps.className === 'string') { | |
this.className = rawProps.className.split(/\s+/); | |
} | |
return true; | |
} | |
}); | |
// finish initializing the mixin | |
EventSource.allowRawProps = ParsableModelMixin_allowRawProps; | |
// IDs | |
// --------------------------------------------------------------------------------------------------------------------- | |
// TODO: converge with EventDef | |
EventSource.uuid = 0; | |
EventSource.normalizeId = function(id) { | |
if (id) { | |
return String(id); | |
} | |
return null; | |
}; | |
// Parsing | |
// --------------------------------------------------------------------------------------------------------------------- | |
EventSource.allowRawProps({ | |
// manually process... | |
id: false, | |
className: false, | |
// automatically transfer... | |
color: true, | |
backgroundColor: true, | |
borderColor: true, | |
textColor: true, | |
editable: true, | |
startEditable: true, | |
durationEditable: true, | |
rendering: true, | |
overlap: true, | |
constraint: true, | |
allDayDefault: true, | |
eventDataTransform: true | |
}); | |
/* | |
rawInput can be any data type! | |
*/ | |
EventSource.parse = function(rawInput, calendar) { | |
var source = new this(calendar); | |
if (typeof rawInput === 'object') { | |
if (source.applyRawProps(rawInput)) { | |
return source; | |
} | |
} | |
return false; | |
}; | |
FC.EventSource = EventSource; | |
;; | |
var EventSourceParser = { | |
sourceClasses: [], | |
registerClass: function(EventSourceClass) { | |
this.sourceClasses.unshift(EventSourceClass); // give highest priority | |
}, | |
parse: function(rawInput, calendar) { | |
var sourceClasses = this.sourceClasses; | |
var i; | |
var eventSource; | |
for (i = 0; i < sourceClasses.length; i++) { | |
eventSource = sourceClasses[i].parse(rawInput, calendar); | |
if (eventSource) { | |
return eventSource; | |
} | |
} | |
} | |
}; | |
FC.EventSourceParser = EventSourceParser; | |
;; | |
var ArrayEventSource = EventSource.extend({ | |
rawEventDefs: null, // unparsed | |
eventDefs: null, | |
currentTimezone: null, | |
constructor: function(calendar) { | |
EventSource.apply(this, arguments); // super-constructor | |
this.eventDefs = []; // for if setRawEventDefs is never called | |
}, | |
setRawEventDefs: function(rawEventDefs) { | |
this.rawEventDefs = rawEventDefs; | |
this.eventDefs = this.parseEventDefs(rawEventDefs); | |
}, | |
fetch: function(start, end, timezone) { | |
var eventDefs = this.eventDefs; | |
var i; | |
if ( | |
this.currentTimezone !== null && | |
this.currentTimezone !== timezone | |
) { | |
for (i = 0; i < eventDefs.length; i++) { | |
if (eventDefs[i] instanceof SingleEventDef) { | |
eventDefs[i].rezone(); | |
} | |
} | |
} | |
this.currentTimezone = timezone; | |
return Promise.resolve(eventDefs); | |
}, | |
addEventDef: function(eventDef) { | |
this.eventDefs.push(eventDef); | |
}, | |
/* | |
eventDefId already normalized to a string | |
*/ | |
removeEventDefsById: function(eventDefId) { | |
return removeMatching(this.eventDefs, function(eventDef) { | |
return eventDef.id === eventDefId; | |
}); | |
}, | |
removeAllEventDefs: function() { | |
this.eventDefs = []; | |
}, | |
getPrimitive: function() { | |
return this.rawEventDefs; | |
}, | |
applyManualRawProps: function(rawProps) { | |
var superSuccess = EventSource.prototype.applyManualRawProps.apply(this, arguments); | |
this.setRawEventDefs(rawProps.events); | |
return superSuccess; | |
} | |
}); | |
ArrayEventSource.allowRawProps({ | |
events: false // don't automatically transfer | |
}); | |
ArrayEventSource.parse = function(rawInput, calendar) { | |
var rawProps; | |
// normalize raw input | |
if ($.isArray(rawInput.events)) { // extended form | |
rawProps = rawInput; | |
} | |
else if ($.isArray(rawInput)) { // short form | |
rawProps = { events: rawInput }; | |
} | |
if (rawProps) { | |
return EventSource.parse.call(this, rawProps, calendar); | |
} | |
return false; | |
}; | |
EventSourceParser.registerClass(ArrayEventSource); | |
FC.ArrayEventSource = ArrayEventSource; | |
;; | |
var FuncEventSource = EventSource.extend({ | |
func: null, | |
fetch: function(start, end, timezone) { | |
var _this = this; | |
return Promise.construct(function(onResolve) { | |
_this.func.call( | |
this.calendar, | |
start.clone(), | |
end.clone(), | |
timezone, | |
function(rawEventDefs) { | |
onResolve(_this.parseEventDefs(rawEventDefs)); | |
} | |
); | |
}); | |
}, | |
getPrimitive: function() { | |
return this.func; | |
}, | |
applyManualRawProps: function(rawProps) { | |
var superSuccess = EventSource.prototype.applyManualRawProps.apply(this, arguments); | |
this.func = rawProps.events; | |
return superSuccess; | |
} | |
}); | |
FuncEventSource.allowRawProps({ | |
events: false // don't automatically transfer | |
}); | |
FuncEventSource.parse = function(rawInput, calendar) { | |
var rawProps; | |
// normalize raw input | |
if ($.isFunction(rawInput.events)) { // extended form | |
rawProps = rawInput; | |
} | |
else if ($.isFunction(rawInput)) { // short form | |
rawProps = { events: rawInput }; | |
} | |
if (rawProps) { | |
return EventSource.parse.call(this, rawProps, calendar); | |
} | |
return false; | |
}; | |
EventSourceParser.registerClass(FuncEventSource); | |
FC.FuncEventSource = FuncEventSource; | |
;; | |
var JsonFeedEventSource = EventSource.extend({ | |
// these props must all be manually set before calling fetch | |
startParam: null, | |
endParam: null, | |
timezoneParam: null, | |
ajaxSettings: null, | |
fetch: function(start, end, timezone) { | |
var _this = this; | |
var ajaxSettings = this.ajaxSettings; | |
var onSuccess = ajaxSettings.success; | |
var onError = ajaxSettings.error; | |
var requestParams = this.buildRequestParams(start, end, timezone); | |
// todo: eventually handle the promise's then, | |
// don't intercept success/error | |
// tho will be a breaking API change | |
return Promise.construct(function(onResolve, onReject) { | |
$.ajax($.extend( | |
{}, // avoid mutation | |
JsonFeedEventSource.AJAX_DEFAULTS, | |
ajaxSettings, // should have a `url` | |
{ | |
data: requestParams, | |
success: function(rawEventDefs) { | |
var callbackRes; | |
if (rawEventDefs) { | |
callbackRes = applyAll(onSuccess, this, arguments); // redirect `this` | |
if ($.isArray(callbackRes)) { | |
rawEventDefs = callbackRes; | |
} | |
onResolve(_this.parseEventDefs(rawEventDefs)); | |
} | |
else { | |
onReject(); | |
} | |
}, | |
error: function() { | |
applyAll(onError, this, arguments); // redirect `this` | |
onReject(); | |
} | |
} | |
)); | |
}); | |
}, | |
buildRequestParams: function(start, end, timezone) { | |
var calendar = this.calendar; | |
var ajaxSettings = this.ajaxSettings; | |
var startParam, endParam, timezoneParam; | |
var customRequestParams; | |
var params = {}; | |
startParam = this.startParam; | |
if (startParam == null) { | |
startParam = calendar.opt('startParam'); | |
} | |
endParam = this.endParam; | |
if (endParam == null) { | |
endParam = calendar.opt('endParam'); | |
} | |
timezoneParam = this.timezoneParam; | |
if (timezoneParam == null) { | |
timezoneParam = calendar.opt('timezoneParam'); | |
} | |
// retrieve any outbound GET/POST $.ajax data from the options | |
if ($.isFunction(ajaxSettings.data)) { | |
// supplied as a function that returns a key/value object | |
customRequestParams = ajaxSettings.data(); | |
} | |
else { | |
// probably supplied as a straight key/value object | |
customRequestParams = ajaxSettings.data || {}; | |
} | |
$.extend(params, customRequestParams); | |
params[startParam] = start.format(); | |
params[endParam] = end.format(); | |
if (timezone && timezone !== 'local') { | |
params[timezoneParam] = timezone; | |
} | |
return params; | |
}, | |
getPrimitive: function() { | |
return this.ajaxSettings.url; | |
}, | |
applyOtherRawProps: function(rawProps) { | |
EventSource.prototype.applyOtherRawProps.apply(this, arguments); | |
this.ajaxSettings = rawProps; | |
} | |
}); | |
JsonFeedEventSource.AJAX_DEFAULTS = { | |
dataType: 'json', | |
cache: false | |
}; | |
JsonFeedEventSource.allowRawProps({ | |
// automatically transfer (true)... | |
startParam: true, | |
endParam: true, | |
timezoneParam: true | |
}); | |
JsonFeedEventSource.parse = function(rawInput, calendar) { | |
var rawProps; | |
// normalize raw input | |
if (typeof rawInput.url === 'string') { // extended form | |
rawProps = rawInput; | |
} | |
else if (typeof rawInput === 'string') { // short form | |
rawProps = { url: rawInput }; // will end up in ajaxSettings | |
} | |
if (rawProps) { | |
return EventSource.parse.call(this, rawProps, calendar); | |
} | |
return false; | |
}; | |
EventSourceParser.registerClass(JsonFeedEventSource); | |
FC.JsonFeedEventSource = JsonFeedEventSource; | |
;; | |
var ThemeRegistry = FC.ThemeRegistry = { | |
themeClassHash: {}, | |
register: function(themeName, themeClass) { | |
this.themeClassHash[themeName] = themeClass; | |
}, | |
getThemeClass: function(themeSetting) { | |
if (!themeSetting) { | |
return StandardTheme; | |
} | |
else if (themeSetting === true) { | |
return JqueryUiTheme; | |
} | |
else { | |
return this.themeClassHash[themeSetting]; | |
} | |
} | |
}; | |
;; | |
var Theme = FC.Theme = Class.extend({ | |
classes: {}, | |
iconClasses: {}, | |
baseIconClass: '', | |
iconOverrideOption: null, | |
iconOverrideCustomButtonOption: null, | |
iconOverridePrefix: '', | |
constructor: function(optionsModel) { | |
this.optionsModel = optionsModel; | |
this.processIconOverride(); | |
}, | |
processIconOverride: function() { | |
if (this.iconOverrideOption) { | |
this.setIconOverride( | |
this.optionsModel.get(this.iconOverrideOption) | |
); | |
} | |
}, | |
setIconOverride: function(iconOverrideHash) { | |
var iconClassesCopy; | |
var buttonName; | |
if ($.isPlainObject(iconOverrideHash)) { | |
iconClassesCopy = $.extend({}, this.iconClasses); | |
for (buttonName in iconOverrideHash) { | |
iconClassesCopy[buttonName] = this.applyIconOverridePrefix( | |
iconOverrideHash[buttonName] | |
); | |
} | |
this.iconClasses = iconClassesCopy; | |
} | |
else if (iconOverrideHash === false) { | |
this.iconClasses = {}; | |
} | |
}, | |
applyIconOverridePrefix: function(className) { | |
var prefix = this.iconOverridePrefix; | |
if (prefix && className.indexOf(prefix) !== 0) { // if not already present | |
className = prefix + className; | |
} | |
return className; | |
}, | |
getClass: function(key) { | |
return this.classes[key] || ''; | |
}, | |
getIconClass: function(buttonName) { | |
var className = this.iconClasses[buttonName]; | |
if (className) { | |
return this.baseIconClass + ' ' + className; | |
} | |
return ''; | |
}, | |
getCustomButtonIconClass: function(customButtonProps) { | |
var className; | |
if (this.iconOverrideCustomButtonOption) { | |
className = customButtonProps[this.iconOverrideCustomButtonOption]; | |
if (className) { | |
return this.baseIconClass + ' ' + this.applyIconOverridePrefix(className); | |
} | |
} | |
return ''; | |
} | |
}); | |
;; | |
var StandardTheme = Theme.extend({ | |
classes: { | |
widget: 'fc-unthemed', | |
widgetHeader: 'fc-widget-header', | |
widgetContent: 'fc-widget-content', | |
buttonGroup: 'fc-button-group', | |
button: 'fc-button', | |
cornerLeft: 'fc-corner-left', | |
cornerRight: 'fc-corner-right', | |
stateDefault: 'fc-state-default', | |
stateActive: 'fc-state-active', | |
stateDisabled: 'fc-state-disabled', | |
stateHover: 'fc-state-hover', | |
stateDown: 'fc-state-down', | |
popoverHeader: 'fc-widget-header', | |
popoverContent: 'fc-widget-content', | |
// day grid | |
headerRow: 'fc-widget-header', | |
dayRow: 'fc-widget-content', | |
// list view | |
listView: 'fc-widget-content' | |
}, | |
baseIconClass: 'fc-icon', | |
iconClasses: { | |
close: 'fc-icon-x', | |
prev: 'fc-icon-left-single-arrow', | |
next: 'fc-icon-right-single-arrow', | |
prevYear: 'fc-icon-left-double-arrow', | |
nextYear: 'fc-icon-right-double-arrow' | |
}, | |
iconOverrideOption: 'buttonIcons', | |
iconOverrideCustomButtonOption: 'icon', | |
iconOverridePrefix: 'fc-icon-' | |
}); | |
ThemeRegistry.register('standard', StandardTheme); | |
;; | |
var JqueryUiTheme = Theme.extend({ | |
classes: { | |
widget: 'ui-widget', | |
widgetHeader: 'ui-widget-header', | |
widgetContent: 'ui-widget-content', | |
buttonGroup: 'fc-button-group', | |
button: 'ui-button', | |
cornerLeft: 'ui-corner-left', | |
cornerRight: 'ui-corner-right', | |
stateDefault: 'ui-state-default', | |
stateActive: 'ui-state-active', | |
stateDisabled: 'ui-state-disabled', | |
stateHover: 'ui-state-hover', | |
stateDown: 'ui-state-down', | |
today: 'ui-state-highlight', | |
popoverHeader: 'ui-widget-header', | |
popoverContent: 'ui-widget-content', | |
// day grid | |
headerRow: 'ui-widget-header', | |
dayRow: 'ui-widget-content', | |
// list view | |
listView: 'ui-widget-content' | |
}, | |
baseIconClass: 'ui-icon', | |
iconClasses: { | |
close: 'ui-icon-closethick', | |
prev: 'ui-icon-circle-triangle-w', | |
next: 'ui-icon-circle-triangle-e', | |
prevYear: 'ui-icon-seek-prev', | |
nextYear: 'ui-icon-seek-next' | |
}, | |
iconOverrideOption: 'themeButtonIcons', | |
iconOverrideCustomButtonOption: 'themeIcon', | |
iconOverridePrefix: 'ui-icon-' | |
}); | |
ThemeRegistry.register('jquery-ui', JqueryUiTheme); | |
;; | |
var BootstrapTheme = Theme.extend({ | |
classes: { | |
widget: 'fc-bootstrap3', | |
tableGrid: 'table-bordered', // avoid `table` class b/c don't want margins. only border color | |
tableList: 'table table-striped', // `table` class creates bottom margin but who cares | |
buttonGroup: 'btn-group', | |
button: 'btn btn-default', | |
stateActive: 'active', | |
stateDisabled: 'disabled', | |
today: 'alert alert-info', // the plain `info` class requires `.table`, too much to ask | |
popover: 'panel panel-default', | |
popoverHeader: 'panel-heading', | |
popoverContent: 'panel-body', | |
// day grid | |
headerRow: 'panel-default', // avoid `panel` class b/c don't want margins/radius. only border color | |
dayRow: 'panel-default', // " | |
// list view | |
listView: 'panel panel-default' | |
}, | |
baseIconClass: 'glyphicon', | |
iconClasses: { | |
close: 'glyphicon-remove', | |
prev: 'glyphicon-chevron-left', | |
next: 'glyphicon-chevron-right', | |
prevYear: 'glyphicon-backward', | |
nextYear: 'glyphicon-forward' | |
}, | |
iconOverrideOption: 'bootstrapGlyphicons', | |
iconOverrideCustomButtonOption: 'bootstrapGlyphicon', | |
iconOverridePrefix: 'glyphicon-' | |
}); | |
ThemeRegistry.register('bootstrap3', BootstrapTheme); | |
;; | |
var DayGridFillRenderer = FillRenderer.extend({ | |
fillSegTag: 'td', // override the default tag name | |
dayGrid: null, | |
constructor: function(dayGrid) { | |
FillRenderer.call(this, dayGrid); | |
this.dayGrid = dayGrid; | |
}, | |
attachSegEls: function(type, segs) { | |
var nodes = []; | |
var i, seg; | |
var skeletonEl; | |
for (i = 0; i < segs.length; i++) { | |
seg = segs[i]; | |
skeletonEl = this.renderFillRow(type, seg); | |
this.dayGrid.rowEls.eq(seg.row).append(skeletonEl); | |
nodes.push(skeletonEl[0]); | |
} | |
return nodes; | |
}, | |
// Generates the HTML needed for one row of a fill. Requires the seg's el to be rendered. | |
renderFillRow: function(type, seg) { | |
var colCnt = this.dayGrid.colCnt; | |
var startCol = seg.leftCol; | |
var endCol = seg.rightCol + 1; | |
var className; | |
var skeletonEl; | |
var trEl; | |
if (type === 'businessHours') { | |
className = 'bgevent'; | |
} | |
else { | |
className = type.toLowerCase(); | |
} | |
skeletonEl = $( | |
'<div class="fc-' + className + '-skeleton">' + | |
'<table><tr/></table>' + | |
'</div>' | |
); | |
trEl = skeletonEl.find('tr'); | |
if (startCol > 0) { | |
trEl.append('<td colspan="' + startCol + '"/>'); | |
} | |
trEl.append( | |
seg.el.attr('colspan', endCol - startCol) | |
); | |
if (endCol < colCnt) { | |
trEl.append('<td colspan="' + (colCnt - endCol) + '"/>'); | |
} | |
this.dayGrid.bookendCells(trEl); | |
return skeletonEl; | |
} | |
}); | |
;; | |
/* Event-rendering methods for the DayGrid class | |
----------------------------------------------------------------------------------------------------------------------*/ | |
var DayGridEventRenderer = EventRenderer.extend({ | |
dayGrid: null, | |
rowStructs: null, // an array of objects, each holding information about a row's foreground event-rendering | |
constructor: function(dayGrid) { | |
EventRenderer.apply(this, arguments); | |
this.dayGrid = dayGrid; | |
}, | |
// Renders the given foreground event segments onto the grid | |
renderFgSegs: function(segs) { | |
var rowStructs = this.rowStructs = this.renderSegRows(segs); | |
// append to each row's content skeleton | |
this.dayGrid.rowEls.each(function(i, rowNode) { | |
$(rowNode).find('.fc-content-skeleton > table').append( | |
rowStructs[i].tbodyEl | |
); | |
}); | |
}, | |
// Unrenders all currently rendered foreground event segments | |
unrenderFgSegs: function() { | |
var rowStructs = this.rowStructs || []; | |
var rowStruct; | |
while ((rowStruct = rowStructs.pop())) { | |
rowStruct.tbodyEl.remove(); | |
} | |
this.rowStructs = null; | |
}, | |
// Uses the given events array to generate <tbody> elements that should be appended to each row's content skeleton. | |
// Returns an array of rowStruct objects (see the bottom of `renderSegRow`). | |
// PRECONDITION: each segment shoud already have a rendered and assigned `.el` | |
renderSegRows: function(segs) { | |
var rowStructs = []; | |
var segRows; | |
var row; | |
segRows = this.groupSegRows(segs); // group into nested arrays | |
// iterate each row of segment groupings | |
for (row = 0; row < segRows.length; row++) { | |
rowStructs.push( | |
this.renderSegRow(row, segRows[row]) | |
); | |
} | |
return rowStructs; | |
}, | |
// Given a row # and an array of segments all in the same row, render a <tbody> element, a skeleton that contains | |
// the segments. Returns object with a bunch of internal data about how the render was calculated. | |
// NOTE: modifies rowSegs | |
renderSegRow: function(row, rowSegs) { | |
var colCnt = this.dayGrid.colCnt; | |
var segLevels = this.buildSegLevels(rowSegs); // group into sub-arrays of levels | |
var levelCnt = Math.max(1, segLevels.length); // ensure at least one level | |
var tbody = $('<tbody/>'); | |
var segMatrix = []; // lookup for which segments are rendered into which level+col cells | |
var cellMatrix = []; // lookup for all <td> elements of the level+col matrix | |
var loneCellMatrix = []; // lookup for <td> elements that only take up a single column | |
var i, levelSegs; | |
var col; | |
var tr; | |
var j, seg; | |
var td; | |
// populates empty cells from the current column (`col`) to `endCol` | |
function emptyCellsUntil(endCol) { | |
while (col < endCol) { | |
// try to grab a cell from the level above and extend its rowspan. otherwise, create a fresh cell | |
td = (loneCellMatrix[i - 1] || [])[col]; | |
if (td) { | |
td.attr( | |
'rowspan', | |
parseInt(td.attr('rowspan') || 1, 10) + 1 | |
); | |
} | |
else { | |
td = $('<td/>'); | |
tr.append(td); | |
} | |
cellMatrix[i][col] = td; | |
loneCellMatrix[i][col] = td; | |
col++; | |
} | |
} | |
for (i = 0; i < levelCnt; i++) { // iterate through all levels | |
levelSegs = segLevels[i]; | |
col = 0; | |
tr = $('<tr/>'); | |
segMatrix.push([]); | |
cellMatrix.push([]); | |
loneCellMatrix.push([]); | |
// levelCnt might be 1 even though there are no actual levels. protect against this. | |
// this single empty row is useful for styling. | |
if (levelSegs) { | |
for (j = 0; j < levelSegs.length; j++) { // iterate through segments in level | |
seg = levelSegs[j]; | |
emptyCellsUntil(seg.leftCol); | |
// create a container that occupies or more columns. append the event element. | |
td = $('<td class="fc-event-container"/>').append(seg.el); | |
if (seg.leftCol != seg.rightCol) { | |
td.attr('colspan', seg.rightCol - seg.leftCol + 1); | |
} | |
else { // a single-column segment | |
loneCellMatrix[i][col] = td; | |
} | |
while (col <= seg.rightCol) { | |
cellMatrix[i][col] = td; | |
segMatrix[i][col] = seg; | |
col++; | |
} | |
tr.append(td); | |
} | |
} | |
emptyCellsUntil(colCnt); // finish off the row | |
this.dayGrid.bookendCells(tr); | |
tbody.append(tr); | |
} | |
return { // a "rowStruct" | |
row: row, // the row number | |
tbodyEl: tbody, | |
cellMatrix: cellMatrix, | |
segMatrix: segMatrix, | |
segLevels: segLevels, | |
segs: rowSegs | |
}; | |
}, | |
// Stacks a flat array of segments, which are all assumed to be in the same row, into subarrays of vertical levels. | |
// NOTE: modifies segs | |
buildSegLevels: function(segs) { | |
var levels = []; | |
var i, seg; | |
var j; | |
// Give preference to elements with certain criteria, so they have | |
// a chance to be closer to the top. | |
this.sortEventSegs(segs); | |
for (i = 0; i < segs.length; i++) { | |
seg = segs[i]; | |
// loop through levels, starting with the topmost, until the segment doesn't collide with other segments | |
for (j = 0; j < levels.length; j++) { | |
if (!isDaySegCollision(seg, levels[j])) { | |
break; | |
} | |
} | |
// `j` now holds the desired subrow index | |
seg.level = j; | |
// create new level array if needed and append segment | |
(levels[j] || (levels[j] = [])).push(seg); | |
} | |
// order segments left-to-right. very important if calendar is RTL | |
for (j = 0; j < levels.length; j++) { | |
levels[j].sort(compareDaySegCols); | |
} | |
return levels; | |
}, | |
// Given a flat array of segments, return an array of sub-arrays, grouped by each segment's row | |
groupSegRows: function(segs) { | |
var segRows = []; | |
var i; | |
for (i = 0; i < this.dayGrid.rowCnt; i++) { | |
segRows.push([]); | |
} | |
for (i = 0; i < segs.length; i++) { | |
segRows[segs[i].row].push(segs[i]); | |
} | |
return segRows; | |
}, | |
// Computes a default event time formatting string if `timeFormat` is not explicitly defined | |
computeEventTimeFormat: function() { | |
return this.opt('extraSmallTimeFormat'); // like "6p" or "6:30p" | |
}, | |
// Computes a default `displayEventEnd` value if one is not expliclty defined | |
computeDisplayEventEnd: function() { | |
return this.dayGrid.colCnt === 1; // we'll likely have space if there's only one day | |
}, | |
// Builds the HTML to be used for the default element for an individual segment | |
fgSegHtml: function(seg, disableResizing) { | |
var view = this.view; | |
var eventDef = seg.footprint.eventDef; | |
var isAllDay = seg.footprint.componentFootprint.isAllDay; | |
var isDraggable = view.isEventDefDraggable(eventDef); | |
var isResizableFromStart = !disableResizing && isAllDay && | |
seg.isStart && view.isEventDefResizableFromStart(eventDef); | |
var isResizableFromEnd = !disableResizing && isAllDay && | |
seg.isEnd && view.isEventDefResizableFromEnd(eventDef); | |
var classes = this.getSegClasses(seg, isDraggable, isResizableFromStart || isResizableFromEnd); | |
var skinCss = cssToStr(this.getSkinCss(seg.footprint)); | |
var timeHtml = ''; | |
var timeText; | |
var titleHtml; | |
classes.unshift('fc-day-grid-event', 'fc-h-event'); | |
// Only display a timed events time if it is the starting segment | |
if (seg.isStart) { | |
timeText = this.getTimeText(seg.footprint); | |
if (timeText) { | |
timeHtml = '<span class="fc-time">' + htmlEscape(timeText) + '</span>'; | |
} | |
} | |
titleHtml = | |
'<span class="fc-title">' + | |
(htmlEscape(eventDef.title || '') || ' ') + // we always want one line of height | |
'</span>'; | |
return '<a class="' + classes.join(' ') + '"' + | |
(eventDef.url ? | |
' href="' + htmlEscape(eventDef.url) + '"' : | |
'' | |
) + | |
(skinCss ? | |
' style="' + skinCss + '"' : | |
'' | |
) + | |
'>' + | |
'<div class="fc-content">' + | |
(this.isRTL ? | |
titleHtml + ' ' + timeHtml : // put a natural space in between | |
timeHtml + ' ' + titleHtml // | |
) + | |
'</div>' + | |
(isResizableFromStart ? | |
'<div class="fc-resizer fc-start-resizer" />' : | |
'' | |
) + | |
(isResizableFromEnd ? | |
'<div class="fc-resizer fc-end-resizer" />' : | |
'' | |
) + | |
'</a>'; | |
} | |
}); | |
// Computes whether two segments' columns collide. They are assumed to be in the same row. | |
function isDaySegCollision(seg, otherSegs) { | |
var i, otherSeg; | |
for (i = 0; i < otherSegs.length; i++) { | |
otherSeg = otherSegs[i]; | |
if ( | |
otherSeg.leftCol <= seg.rightCol && | |
otherSeg.rightCol >= seg.leftCol | |
) { | |
return true; | |
} | |
} | |
return false; | |
} | |
// A cmp function for determining the leftmost event | |
function compareDaySegCols(a, b) { | |
return a.leftCol - b.leftCol; | |
} | |
;; | |
var DayGridHelperRenderer = HelperRenderer.extend({ | |
// Renders a mock "helper" event. `sourceSeg` is the associated internal segment object. It can be null. | |
renderSegs: function(segs, sourceSeg) { | |
var helperNodes = []; | |
var rowStructs; | |
// TODO: not good to call eventRenderer this way | |
rowStructs = this.eventRenderer.renderSegRows(segs); | |
// inject each new event skeleton into each associated row | |
this.component.rowEls.each(function(row, rowNode) { | |
var rowEl = $(rowNode); // the .fc-row | |
var skeletonEl = $('<div class="fc-helper-skeleton"><table/></div>'); // will be absolutely positioned | |
var skeletonTop; | |
// If there is an original segment, match the top position. Otherwise, put it at the row's top level | |
if (sourceSeg && sourceSeg.row === row) { | |
skeletonTop = sourceSeg.el.position().top; | |
} | |
else { | |
skeletonTop = rowEl.find('.fc-content-skeleton tbody').position().top; | |
} | |
skeletonEl.css('top', skeletonTop) | |
.find('table') | |
.append(rowStructs[row].tbodyEl); | |
rowEl.append(skeletonEl); | |
helperNodes.push(skeletonEl[0]); | |
}); | |
return $(helperNodes); // must return the elements rendered | |
} | |
}); | |
;; | |
/* A component that renders a grid of whole-days that runs horizontally. There can be multiple rows, one per week. | |
----------------------------------------------------------------------------------------------------------------------*/ | |
var DayGrid = FC.DayGrid = InteractiveDateComponent.extend(StandardInteractionsMixin, DayTableMixin, { | |
eventRendererClass: DayGridEventRenderer, | |
helperRendererClass: DayGridHelperRenderer, | |
fillRendererClass: DayGridFillRenderer, | |
view: null, // TODO: make more general and/or remove | |
helperRenderer: null, | |
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 | |
rowCoordCache: null, | |
colCoordCache: null, | |
// isRigid determines 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. | |
isRigid: false, | |
constructor: function(view) { | |
this.view = view; // do first, for opt calls during initialization | |
InteractiveDateComponent.call(this); | |
}, | |
// Slices up the given span (unzoned start/end with other misc data) into an array of segments | |
componentFootprintToSegs: function(componentFootprint) { | |
var segs = this.sliceRangeByRow(componentFootprint.unzonedRange); | |
var i, seg; | |
for (i = 0; i < segs.length; i++) { | |
seg = segs[i]; | |
if (this.isRTL) { | |
seg.leftCol = this.daysPerRow - 1 - seg.lastRowDayIndex; | |
seg.rightCol = this.daysPerRow - 1 - seg.firstRowDayIndex; | |
} | |
else { | |
seg.leftCol = seg.firstRowDayIndex; | |
seg.rightCol = seg.lastRowDayIndex; | |
} | |
} | |
return segs; | |
}, | |
handleDateProfileSet: function(dateProfile) { | |
InteractiveDateComponent.prototype.handleDateProfileSet.apply(this, arguments); | |
this.updateDayTable(); | |
// needs to go after updateDayTable because computeEventTimeFormat/computeDisplayEventEnd depends on colCnt. | |
// TODO: easy to forget. use listener. | |
this.eventRenderer.rangeUpdated(); | |
}, | |
opt: function(name) { | |
return this.view.opt(name); | |
}, | |
/* Date Rendering | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Renders the rows and columns into the component's `this.el`, which should already be assigned. | |
renderDates: function(dateProfile) { | |
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, this.isRigid); | |
} | |
this.el.html(html); | |
this.rowEls = this.el.find('.fc-row'); | |
this.cellEls = this.el.find('.fc-day, .fc-disabled-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++) { | |
this.publiclyTrigger('dayRender', { | |
context: view, | |
args: [ | |
this.getCellDate(row, col), | |
this.getCellEl(row, col), | |
view | |
] | |
}); | |
} | |
} | |
}, | |
unrenderDates: function() { | |
this.removeSegPopover(); | |
}, | |
// Generates the HTML for a single row, which is a div that wraps a table. | |
// `row` is the row number. | |
renderDayRowHtml: function(row, isRigid) { | |
var theme = this.view.calendar.theme; | |
var classes = [ 'fc-row', 'fc-week', theme.getClass('dayRow') ]; | |
if (isRigid) { | |
classes.push('fc-rigid'); | |
} | |
return '' + | |
'<div class="' + classes.join(' ') + '">' + | |
'<div class="fc-bg">' + | |
'<table class="' + theme.getClass('tableGrid') + '">' + | |
this.renderBgTrHtml(row) + | |
'</table>' + | |
'</div>' + | |
'<div class="fc-content-skeleton">' + | |
'<table>' + | |
(this.numbersVisible ? | |
'<thead>' + | |
this.renderNumberTrHtml(row) + | |
'</thead>' : | |
'' | |
) + | |
'</table>' + | |
'</div>' + | |
'</div>'; | |
}, | |
/* Grid Number Rendering | |
------------------------------------------------------------------------------------------------------------------*/ | |
renderNumberTrHtml: function(row) { | |
return '' + | |
'<tr>' + | |
(this.isRTL ? '' : this.renderNumberIntroHtml(row)) + | |
this.renderNumberCellsHtml(row) + | |
(this.isRTL ? this.renderNumberIntroHtml(row) : '') + | |
'</tr>'; | |
}, | |
renderNumberIntroHtml: function(row) { | |
return this.renderIntroHtml(); | |
}, | |
renderNumberCellsHtml: function(row) { | |
var htmls = []; | |
var col, date; | |
for (col = 0; col < this.colCnt; col++) { | |
date = this.getCellDate(row, col); | |
htmls.push(this.renderNumberCellHtml(date)); | |
} | |
return htmls.join(''); | |
}, | |
// Generates the HTML for the <td>s of the "number" row in the DayGrid's content skeleton. | |
// The number row will only exist if either day numbers or week numbers are turned on. | |
renderNumberCellHtml: function(date) { | |
var view = this.view; | |
var html = ''; | |
var isDateValid = this.get('dateProfile').activeUnzonedRange.containsDate(date); // TODO: called too frequently. cache somehow. | |
var isDayNumberVisible = view.dayNumbersVisible && isDateValid; | |
var classes; | |
var weekCalcFirstDoW; | |
if (!isDayNumberVisible && !view.cellWeekNumbersVisible) { | |
// no numbers in day cell (week number must be along the side) | |
return '<td/>'; // will create an empty space above events :( | |
} | |
classes = this.getDayClasses(date); | |
classes.unshift('fc-day-top'); | |
if (view.cellWeekNumbersVisible) { | |
// To determine the day of week number change under ISO, we cannot | |
// rely on moment.js methods such as firstDayOfWeek() or weekday(), | |
// because they rely on the locale's dow (possibly overridden by | |
// our firstDay option), which may not be Monday. We cannot change | |
// dow, because that would affect the calendar start day as well. | |
if (date._locale._fullCalendar_weekCalc === 'ISO') { | |
weekCalcFirstDoW = 1; // Monday by ISO 8601 definition | |
} | |
else { | |
weekCalcFirstDoW = date._locale.firstDayOfWeek(); | |
} | |
} | |
html += '<td class="' + classes.join(' ') + '"' + | |
(isDateValid ? | |
' data-date="' + date.format() + '"' : | |
'' | |
) + | |
'>'; | |
if (view.cellWeekNumbersVisible && (date.day() == weekCalcFirstDoW)) { | |
html += view.buildGotoAnchorHtml( | |
{ date: date, type: 'week' }, | |
{ 'class': 'fc-week-number' }, | |
date.format('w') // inner HTML | |
); | |
} | |
if (isDayNumberVisible) { | |
html += view.buildGotoAnchorHtml( | |
date, | |
{ 'class': 'fc-day-number' }, | |
date.date() // inner HTML | |
); | |
} | |
html += '</td>'; | |
return html; | |
}, | |
/* Hit System | |
------------------------------------------------------------------------------------------------------------------*/ | |
prepareHits: function() { | |
this.colCoordCache.build(); | |
this.rowCoordCache.build(); | |
this.rowCoordCache.bottoms[this.rowCnt - 1] += this.bottomCoordPadding; // hack | |
}, | |
releaseHits: function() { | |
this.colCoordCache.clear(); | |
this.rowCoordCache.clear(); | |
}, | |
queryHit: function(leftOffset, topOffset) { | |
if (this.colCoordCache.isLeftInBounds(leftOffset) && this.rowCoordCache.isTopInBounds(topOffset)) { | |
var col = this.colCoordCache.getHorizontalIndex(leftOffset); | |
var row = this.rowCoordCache.getVerticalIndex(topOffset); | |
if (row != null && col != null) { | |
return this.getCellHit(row, col); | |
} | |
} | |
}, | |
getHitFootprint: function(hit) { | |
var range = this.getCellRange(hit.row, hit.col); | |
return new ComponentFootprint( | |
new UnzonedRange(range.start, range.end), | |
true // all-day? | |
); | |
}, | |
getHitEl: function(hit) { | |
return this.getCellEl(hit.row, hit.col); | |
}, | |
/* Cell System | |
------------------------------------------------------------------------------------------------------------------*/ | |
// FYI: the first column is the leftmost column, regardless of date | |
getCellHit: function(row, col) { | |
return { | |
row: row, | |
col: col, | |
component: this, // needed unfortunately :( | |
left: this.colCoordCache.getLeftOffset(col), | |
right: this.colCoordCache.getRightOffset(col), | |
top: this.rowCoordCache.getTopOffset(row), | |
bottom: this.rowCoordCache.getBottomOffset(row) | |
}; | |
}, | |
getCellEl: function(row, col) { | |
return this.cellEls.eq(row * this.colCnt + col); | |
}, | |
/* Event Rendering | |
------------------------------------------------------------------------------------------------------------------*/ | |
renderBgEventFootprints: function(eventFootprints) { | |
// don't render timed background events | |
var allDayEventFootprints = $.grep(eventFootprints, function(eventFootprint) { | |
return eventFootprint.componentFootprint.isAllDay; | |
}); | |
return InteractiveDateComponent.prototype.renderBgEventFootprints.call(this, allDayEventFootprints); | |
}, | |
// Unrenders all events currently rendered on the grid | |
unrenderEvents: function() { | |
this.removeSegPopover(); // removes the "more.." events popover | |
InteractiveDateComponent.prototype.unrenderEvents.apply(this, arguments); | |
}, | |
// Retrieves all rendered segment objects currently rendered on the grid | |
getEventSegs: function() { | |
return InteractiveDateComponent.prototype.getEventSegs.call(this) // get the segments from the super-method | |
.concat(this.popoverSegs || []); // append the segments from the "more..." popover | |
}, | |
/* Event Drag Visualization | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Renders a visual indication of an event or external element being dragged. | |
// `eventLocation` has zoned start and end (optional) | |
renderDrag: function(eventFootprints, seg, isTouch) { | |
var i; | |
for (i = 0; i < eventFootprints.length; i++) { | |
this.renderHighlight(eventFootprints[i].componentFootprint); | |
} | |
// if a segment from the same calendar but another component is being dragged, render a helper event | |
if (seg && seg.component !== this) { | |
this.helperRenderer.renderEventDraggingFootprints(eventFootprints, seg, isTouch); | |
return true; // signal that a helper was rendered | |
} | |
}, | |
// Unrenders any visual indication of a hovering event | |
unrenderDrag: function() { | |
this.unrenderHighlight(); | |
this.helperRenderer.unrender(); | |
}, | |
/* Event Resize Visualization | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Renders a visual indication of an event being resized | |
renderEventResize: function(eventFootprints, seg, isTouch) { | |
var i; | |
for (i = 0; i < eventFootprints.length; i++) { | |
this.renderHighlight(eventFootprints[i].componentFootprint); | |
} | |
this.helperRenderer.renderEventResizingFootprints(eventFootprints, seg, isTouch); | |
}, | |
// Unrenders a visual indication of an event being resized | |
unrenderEventResize: function() { | |
this.unrenderHighlight(); | |
this.helperRenderer.unrender(); | |
}, | |
/* Business Hours | |
------------------------------------------------------------------------------------------------------------------*/ | |
businessHourRendererClass: BusinessHourRenderer.extend({ | |
isAllDay: true // TODO: config param on component? | |
}) | |
}); | |
;; | |
/* Methods relate to limiting the number events for a given day on a DayGrid | |
----------------------------------------------------------------------------------------------------------------------*/ | |
// NOTE: all the segs being passed around in here are foreground segs | |
DayGrid.mixin({ | |
segPopover: null, // the Popover that holds events that can't fit in a cell. null when not visible | |
popoverSegs: null, // an array of segment objects that the segPopover holds. null when not visible | |
removeSegPopover: function() { | |
if (this.segPopover) { | |
this.segPopover.hide(); // in handler, will call segPopover's removeElement | |
} | |
}, | |
// Limits the number of "levels" (vertically stacking layers of events) for each row of the grid. | |
// `levelLimit` can be false (don't limit), a number, or true (should be computed). | |
limitRows: function(levelLimit) { | |
var rowStructs = this.eventRenderer.rowStructs || []; | |
var row; // row # | |
var rowLevelLimit; | |
for (row = 0; row < rowStructs.length; row++) { | |
this.unlimitRow(row); | |
if (!levelLimit) { | |
rowLevelLimit = false; | |
} | |
else if (typeof levelLimit === 'number') { | |
rowLevelLimit = levelLimit; | |
} | |
else { | |
rowLevelLimit = this.computeRowLevelLimit(row); | |
} | |
if (rowLevelLimit !== false) { | |
this.limitRow(row, rowLevelLimit); | |
} | |
} | |
}, | |
// Computes the number of levels a row will accomodate without going outside its bounds. | |
// Assumes the row is "rigid" (maintains a constant height regardless of what is inside). | |
// `row` is the row number. | |
computeRowLevelLimit: function(row) { | |
var rowEl = this.rowEls.eq(row); // the containing "fake" row div | |
var rowHeight = rowEl.height(); // TODO: cache somehow? | |
var trEls = this.eventRenderer.rowStructs[row].tbodyEl.children(); | |
var i, trEl; | |
var trHeight; | |
function iterInnerHeights(i, childNode) { | |
trHeight = Math.max(trHeight, $(childNode).outerHeight()); | |
} | |
// Reveal one level <tr> at a time and stop when we find one out of bounds | |
for (i = 0; i < trEls.length; i++) { | |
trEl = trEls.eq(i).removeClass('fc-limited'); // reset to original state (reveal) | |
// with rowspans>1 and IE8, trEl.outerHeight() would return the height of the largest cell, | |
// so instead, find the tallest inner content element. | |
trHeight = 0; | |
trEl.find('> td > :first-child').each(iterInnerHeights); | |
if (trEl.position().top + trHeight > rowHeight) { | |
return i; | |
} | |
} | |
return false; // should not limit at all | |
}, | |
// Limits the given grid row to the maximum number of levels and injects "more" links if necessary. | |
// `row` is the row number. | |
// `levelLimit` is a number for the maximum (inclusive) number of levels allowed. | |
limitRow: function(row, levelLimit) { | |
var _this = this; | |
var rowStruct = this.eventRenderer.rowStructs[row]; | |
var moreNodes = []; // array of "more" <a> links and <td> DOM nodes | |
var col = 0; // col #, left-to-right (not chronologically) | |
var levelSegs; // array of segment objects in the last allowable level, ordered left-to-right | |
var cellMatrix; // a matrix (by level, then column) of all <td> jQuery elements in the row | |
var limitedNodes; // array of temporarily hidden level <tr> and segment <td> DOM nodes | |
var i, seg; | |
var segsBelow; // array of segment objects below `seg` in the current `col` | |
var totalSegsBelow; // total number of segments below `seg` in any of the columns `seg` occupies | |
var colSegsBelow; // array of segment arrays, below seg, one for each column (offset from segs's first column) | |
var td, rowspan; | |
var segMoreNodes; // array of "more" <td> cells that will stand-in for the current seg's cell | |
var j; | |
var moreTd, moreWrap, moreLink; | |
// Iterates through empty level cells and places "more" links inside if need be | |
function emptyCellsUntil(endCol) { // goes from current `col` to `endCol` | |
while (col < endCol) { | |
segsBelow = _this.getCellSegs(row, col, levelLimit); | |
if (segsBelow.length) { | |
td = cellMatrix[levelLimit - 1][col]; | |
moreLink = _this.renderMoreLink(row, col, segsBelow); | |
moreWrap = $('<div/>').append(moreLink); | |
td.append(moreWrap); | |
moreNodes.push(moreWrap[0]); | |
} | |
col++; | |
} | |
} | |
if (levelLimit && levelLimit < rowStruct.segLevels.length) { // is it actually over the limit? | |
levelSegs = rowStruct.segLevels[levelLimit - 1]; | |
cellMatrix = rowStruct.cellMatrix; | |
limitedNodes = rowStruct.tbodyEl.children().slice(levelLimit) // get level <tr> elements past the limit | |
.addClass('fc-limited').get(); // hide elements and get a simple DOM-nodes array | |
// iterate though segments in the last allowable level | |
for (i = 0; i < levelSegs.length; i++) { | |
seg = levelSegs[i]; | |
emptyCellsUntil(seg.leftCol); // process empty cells before the segment | |
// determine *all* segments below `seg` that occupy the same columns | |
colSegsBelow = []; | |
totalSegsBelow = 0; | |
while (col <= seg.rightCol) { | |
segsBelow = this.getCellSegs(row, col, levelLimit); | |
colSegsBelow.push(segsBelow); | |
totalSegsBelow += segsBelow.length; | |
col++; | |
} | |
if (totalSegsBelow) { // do we need to replace this segment with one or many "more" links? | |
td = cellMatrix[levelLimit - 1][seg.leftCol]; // the segment's parent cell | |
rowspan = td.attr('rowspan') || 1; | |
segMoreNodes = []; | |
// make a replacement <td> for each column the segment occupies. will be one for each colspan | |
for (j = 0; j < colSegsBelow.length; j++) { | |
moreTd = $('<td class="fc-more-cell"/>').attr('rowspan', rowspan); | |
segsBelow = colSegsBelow[j]; | |
moreLink = this.renderMoreLink( | |
row, | |
seg.leftCol + j, | |
[ seg ].concat(segsBelow) // count seg as hidden too | |
); | |
moreWrap = $('<div/>').append(moreLink); | |
moreTd.append(moreWrap); | |
segMoreNodes.push(moreTd[0]); | |
moreNodes.push(moreTd[0]); | |
} | |
td.addClass('fc-limited').after($(segMoreNodes)); // hide original <td> and inject replacements | |
limitedNodes.push(td[0]); | |
} | |
} | |
emptyCellsUntil(this.colCnt); // finish off the level | |
rowStruct.moreEls = $(moreNodes); // for easy undoing later | |
rowStruct.limitedEls = $(limitedNodes); // for easy undoing later | |
} | |
}, | |
// Reveals all levels and removes all "more"-related elements for a grid's row. | |
// `row` is a row number. | |
unlimitRow: function(row) { | |
var rowStruct = this.eventRenderer.rowStructs[row]; | |
if (rowStruct.moreEls) { | |
rowStruct.moreEls.remove(); | |
rowStruct.moreEls = null; | |
} | |
if (rowStruct.limitedEls) { | |
rowStruct.limitedEls.removeClass('fc-limited'); | |
rowStruct.limitedEls = null; | |
} | |
}, | |
// Renders an <a> element that represents hidden event element for a cell. | |
// Responsible for attaching click handler as well. | |
renderMoreLink: function(row, col, hiddenSegs) { | |
var _this = this; | |
var view = this.view; | |
return $('<a class="fc-more"/>') | |
.text( | |
this.getMoreLinkText(hiddenSegs.length) | |
) | |
.on('click', function(ev) { | |
var clickOption = _this.opt('eventLimitClick'); | |
var date = _this.getCellDate(row, col); | |
var moreEl = $(this); | |
var dayEl = _this.getCellEl(row, col); | |
var allSegs = _this.getCellSegs(row, col); | |
// rescope the segments to be within the cell's date | |
var reslicedAllSegs = _this.resliceDaySegs(allSegs, date); | |
var reslicedHiddenSegs = _this.resliceDaySegs(hiddenSegs, date); | |
if (typeof clickOption === 'function') { | |
// the returned value can be an atomic option | |
clickOption = _this.publiclyTrigger('eventLimitClick', { | |
context: view, | |
args: [ | |
{ | |
date: date.clone(), | |
dayEl: dayEl, | |
moreEl: moreEl, | |
segs: reslicedAllSegs, | |
hiddenSegs: reslicedHiddenSegs | |
}, | |
ev, | |
view | |
] | |
}); | |
} | |
if (clickOption === 'popover') { | |
_this.showSegPopover(row, col, moreEl, reslicedAllSegs); | |
} | |
else if (typeof clickOption === 'string') { // a view name | |
view.calendar.zoomTo(date, clickOption); | |
} | |
}); | |
}, | |
// Reveals the popover that displays all events within a cell | |
showSegPopover: function(row, col, moreLink, segs) { | |
var _this = this; | |
var view = this.view; | |
var moreWrap = moreLink.parent(); // the <div> wrapper around the <a> | |
var topEl; // the element we want to match the top coordinate of | |
var options; | |
if (this.rowCnt == 1) { | |
topEl = view.el; // will cause the popover to cover any sort of header | |
} | |
else { | |
topEl = this.rowEls.eq(row); // will align with top of row | |
} | |
options = { | |
className: 'fc-more-popover ' + view.calendar.theme.getClass('popover'), | |
content: this.renderSegPopoverContent(row, col, segs), | |
parentEl: view.el, // attach to root of view. guarantees outside of scrollbars. | |
top: topEl.offset().top, | |
autoHide: true, // when the user clicks elsewhere, hide the popover | |
viewportConstrain: this.opt('popoverViewportConstrain'), | |
hide: function() { | |
// kill everything when the popover is hidden | |
// notify events to be removed | |
if (_this.popoverSegs) { | |
var seg; | |
var legacy; | |
var i; | |
for (i = 0; i < _this.popoverSegs.length; ++i) { | |
seg = _this.popoverSegs[i]; | |
legacy = seg.footprint.getEventLegacy(); | |
_this.publiclyTrigger('eventDestroy', { | |
context: legacy, | |
args: [ legacy, seg.el, view ] | |
}); | |
} | |
} | |
_this.segPopover.removeElement(); | |
_this.segPopover = null; | |
_this.popoverSegs = null; | |
} | |
}; | |
// Determine horizontal coordinate. | |
// We use the moreWrap instead of the <td> to avoid border confusion. | |
if (this.isRTL) { | |
options.right = moreWrap.offset().left + moreWrap.outerWidth() + 1; // +1 to be over cell border | |
} | |
else { | |
options.left = moreWrap.offset().left - 1; // -1 to be over cell border | |
} | |
this.segPopover = new Popover(options); | |
this.segPopover.show(); | |
// the popover doesn't live within the grid's container element, and thus won't get the event | |
// delegated-handlers for free. attach event-related handlers to the popover. | |
this.bindAllSegHandlersToEl(this.segPopover.el); | |
}, | |
// Builds the inner DOM contents of the segment popover | |
renderSegPopoverContent: function(row, col, segs) { | |
var view = this.view; | |
var theme = view.calendar.theme; | |
var title = this.getCellDate(row, col).format(this.opt('dayPopoverFormat')); | |
var content = $( | |
'<div class="fc-header ' + theme.getClass('popoverHeader') + '">' + | |
'<span class="fc-close ' + theme.getIconClass('close') + '"></span>' + | |
'<span class="fc-title">' + | |
htmlEscape(title) + | |
'</span>' + | |
'<div class="fc-clear"/>' + | |
'</div>' + | |
'<div class="fc-body ' + theme.getClass('popoverContent') + '">' + | |
'<div class="fc-event-container"></div>' + | |
'</div>' | |
); | |
var segContainer = content.find('.fc-event-container'); | |
var i; | |
// render each seg's `el` and only return the visible segs | |
segs = this.eventRenderer.renderFgSegEls(segs, true); // disableResizing=true | |
this.popoverSegs = segs; | |
for (i = 0; i < segs.length; i++) { | |
// because segments in the popover are not part of a grid coordinate system, provide a hint to any | |
// grids that want to do drag-n-drop about which cell it came from | |
this.hitsNeeded(); | |
segs[i].hit = this.getCellHit(row, col); | |
this.hitsNotNeeded(); | |
segContainer.append(segs[i].el); | |
} | |
return content; | |
}, | |
// Given the events within an array of segment objects, reslice them to be in a single day | |
resliceDaySegs: function(segs, dayDate) { | |
var dayStart = dayDate.clone(); | |
var dayEnd = dayStart.clone().add(1, 'days'); | |
var dayRange = new UnzonedRange(dayStart, dayEnd); | |
var newSegs = []; | |
var i; | |
for (i = 0; i < segs.length; i++) { | |
newSegs.push.apply(newSegs, // append | |
this.eventFootprintToSegs(segs[i].footprint, dayRange) | |
); | |
} | |
// force an order because eventsToSegs doesn't guarantee one | |
// TODO: research if still needed | |
this.eventRenderer.sortEventSegs(newSegs); | |
return newSegs; | |
}, | |
// Generates the text that should be inside a "more" link, given the number of events it represents | |
getMoreLinkText: function(num) { | |
var opt = this.opt('eventLimitText'); | |
if (typeof opt === 'function') { | |
return opt(num); | |
} | |
else { | |
return '+' + num + ' ' + opt; | |
} | |
}, | |
// Returns segments within a given cell. | |
// If `startLevel` is specified, returns only events including and below that level. Otherwise returns all segs. | |
getCellSegs: function(row, col, startLevel) { | |
var segMatrix = this.eventRenderer.rowStructs[row].segMatrix; | |
var level = startLevel || 0; | |
var segs = []; | |
var seg; | |
while (level < segMatrix.length) { | |
seg = segMatrix[level][col]; | |
if (seg) { | |
segs.push(seg); | |
} | |
level++; | |
} | |
return segs; | |
} | |
}); | |
;; | |
/* An abstract class for the "basic" views, as well as month view. Renders one or more rows of day cells. | |
----------------------------------------------------------------------------------------------------------------------*/ | |
// It is a manager for a DayGrid subcomponent, which does most of the heavy lifting. | |
// It is responsible for managing width/height. | |
var BasicView = FC.BasicView = View.extend({ | |
scroller: null, | |
dayGridClass: DayGrid, // class the dayGrid will be instantiated from (overridable by subclasses) | |
dayGrid: null, // the main subcomponent that does most of the heavy lifting | |
dayNumbersVisible: false, // display day numbers on each day cell? | |
colWeekNumbersVisible: false, // display week numbers along the side? | |
cellWeekNumbersVisible: false, // display week numbers in day cell? | |
weekNumberWidth: null, // width of all the week-number cells running down the side | |
headContainerEl: null, // div that hold's the dayGrid's rendered date header | |
headRowEl: null, // the fake row element of the day-of-week header | |
constructor: function() { | |
View.apply(this, arguments); | |
this.dayGrid = this.instantiateDayGrid(); | |
this.addChild(this.dayGrid); | |
this.scroller = new Scroller({ | |
overflowX: 'hidden', | |
overflowY: 'auto' | |
}); | |
}, | |
// Generates the DayGrid object this view needs. Draws from this.dayGridClass | |
instantiateDayGrid: function() { | |
// generate a subclass on the fly with BasicView-specific behavior | |
// TODO: cache this subclass | |
var subclass = this.dayGridClass.extend(basicDayGridMethods); | |
return new subclass(this); | |
}, | |
// Computes the date range that will be rendered. | |
buildRenderRange: function(currentUnzonedRange, currentRangeUnit, isRangeAllDay) { | |
var renderUnzonedRange = View.prototype.buildRenderRange.apply(this, arguments); // an UnzonedRange | |
var start = this.calendar.msToUtcMoment(renderUnzonedRange.startMs, isRangeAllDay); | |
var end = this.calendar.msToUtcMoment(renderUnzonedRange.endMs, isRangeAllDay); | |
// year and month views should be aligned with weeks. this is already done for week | |
if (/^(year|month)$/.test(currentRangeUnit)) { | |
start.startOf('week'); | |
// make end-of-week if not already | |
if (end.weekday()) { | |
end.add(1, 'week').startOf('week'); // exclusively move backwards | |
} | |
} | |
return this.trimHiddenDays(new UnzonedRange(start, end)); | |
}, | |
handleDateProfileSet: function(dateProfile) { | |
this.dayGrid.breakOnWeeks = /year|month|week/.test(dateProfile.currentRangeUnit); | |
// needs breakOnWeeks. will populate dayGrid.rowCnt :( | |
View.prototype.handleDateProfileSet.apply(this, arguments); | |
this.dayNumbersVisible = this.dayGrid.rowCnt > 1; // TODO: make grid responsible | |
if (this.opt('weekNumbers')) { | |
if (this.opt('weekNumbersWithinDays')) { | |
this.cellWeekNumbersVisible = true; | |
this.colWeekNumbersVisible = false; | |
} | |
else { | |
this.cellWeekNumbersVisible = false; | |
this.colWeekNumbersVisible = true; | |
}; | |
} | |
this.dayGrid.numbersVisible = | |
this.dayNumbersVisible || | |
this.cellWeekNumbersVisible || | |
this.colWeekNumbersVisible; | |
this.dayGrid.isRigid = this.hasRigidRows(); | |
}, | |
renderSkeleton: function() { | |
var dayGridContainerEl; | |
var dayGridEl; | |
this.el.addClass('fc-basic-view').html(this.renderSkeletonHtml()); | |
this.scroller.render(); | |
dayGridContainerEl = this.scroller.el.addClass('fc-day-grid-container'); | |
dayGridEl = $('<div class="fc-day-grid" />').appendTo(dayGridContainerEl); | |
this.el.find('.fc-body > tr > td').append(dayGridContainerEl); | |
this.dayGrid.setElement(dayGridEl); | |
}, | |
unrenderSkeleton: function() { | |
this.dayGrid.removeElement(); | |
this.scroller.destroy(); | |
}, | |
// Renders the view into `this.el`, which should already be assigned | |
renderDates: function(dateProfile) { | |
this.renderHead(); | |
}, | |
// render the day-of-week headers | |
renderHead: function() { | |
this.headContainerEl = | |
this.el.find('.fc-head-container') | |
.html(this.dayGrid.renderHeadHtml()); | |
this.headRowEl = this.headContainerEl.find('.fc-row'); | |
}, | |
// Builds the HTML skeleton for the view. | |
// The day-grid component will render inside of a container defined by this HTML. | |
renderSkeletonHtml: function() { | |
var theme = this.calendar.theme; | |
return '' + | |
'<table class="' + theme.getClass('tableGrid') + '">' + | |
'<thead class="fc-head">' + | |
'<tr>' + | |
'<td class="fc-head-container ' + theme.getClass('widgetHeader') + '"></td>' + | |
'</tr>' + | |
'</thead>' + | |
'<tbody class="fc-body">' + | |
'<tr>' + | |
'<td class="' + theme.getClass('widgetContent') + '"></td>' + | |
'</tr>' + | |
'</tbody>' + | |
'</table>'; | |
}, | |
// Generates an HTML attribute string for setting the width of the week number column, if it is known | |
weekNumberStyleAttr: function() { | |
if (this.weekNumberWidth !== null) { | |
return 'style="width:' + this.weekNumberWidth + 'px"'; | |
} | |
return ''; | |
}, | |
// Determines whether each row should have a constant height | |
hasRigidRows: function() { | |
var eventLimit = this.opt('eventLimit'); | |
return eventLimit && typeof eventLimit !== 'number'; | |
}, | |
/* Dimensions | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Refreshes the horizontal dimensions of the view | |
updateSize: function(totalHeight, isAuto, isResize) { | |
View.prototype.updateSize.apply(this, arguments); | |
if (this.colWeekNumbersVisible) { | |
// Make sure all week number cells running down the side have the same width. | |
// Record the width for cells created later. | |
this.weekNumberWidth = matchCellWidths( | |
this.el.find('.fc-week-number') | |
); | |
} | |
var eventLimit = this.opt('eventLimit'); | |
var scrollerHeight; | |
var scrollbarWidths; | |
// reset all heights to be natural | |
this.scroller.clear(); | |
uncompensateScroll(this.headRowEl); | |
this.dayGrid.removeSegPopover(); // kill the "more" popover if displayed | |
// is the event limit a constant level number? | |
if (eventLimit && typeof eventLimit === 'number') { | |
this.dayGrid.limitRows(eventLimit); // limit the levels first so the height can redistribute after | |
} | |
// distribute the height to the rows | |
// (totalHeight is a "recommended" value if isAuto) | |
scrollerHeight = this.computeScrollerHeight(totalHeight); | |
this.setGridHeight(scrollerHeight, isAuto); | |
// is the event limit dynamically calculated? | |
if (eventLimit && typeof eventLimit !== 'number') { | |
this.dayGrid.limitRows(eventLimit); // limit the levels after the grid's row heights have been set | |
} | |
if (!isAuto) { // should we force dimensions of the scroll container? | |
this.scroller.setHeight(scrollerHeight); | |
scrollbarWidths = this.scroller.getScrollbarWidths(); | |
if (scrollbarWidths.left || scrollbarWidths.right) { // using scrollbars? | |
compensateScroll(this.headRowEl, scrollbarWidths); | |
// doing the scrollbar compensation might have created text overflow which created more height. redo | |
scrollerHeight = this.computeScrollerHeight(totalHeight); | |
this.scroller.setHeight(scrollerHeight); | |
} | |
// guarantees the same scrollbar widths | |
this.scroller.lockOverflow(scrollbarWidths); | |
} | |
}, | |
// given a desired total height of the view, returns what the height of the scroller should be | |
computeScrollerHeight: function(totalHeight) { | |
return totalHeight - | |
subtractInnerElHeight(this.el, this.scroller.el); // everything that's NOT the scroller | |
}, | |
// Sets the height of just the DayGrid component in this view | |
setGridHeight: function(height, isAuto) { | |
if (isAuto) { | |
undistributeHeight(this.dayGrid.rowEls); // let the rows be their natural height with no expanding | |
} | |
else { | |
distributeHeight(this.dayGrid.rowEls, height, true); // true = compensate for height-hogging rows | |
} | |
}, | |
/* Scroll | |
------------------------------------------------------------------------------------------------------------------*/ | |
computeInitialDateScroll: function() { | |
return { top: 0 }; | |
}, | |
queryDateScroll: function() { | |
return { top: this.scroller.getScrollTop() }; | |
}, | |
applyDateScroll: function(scroll) { | |
if (scroll.top !== undefined) { | |
this.scroller.setScrollTop(scroll.top); | |
} | |
} | |
}); | |
// Methods that will customize the rendering behavior of the BasicView's dayGrid | |
var basicDayGridMethods = { | |
// Generates the HTML that will go before the day-of week header cells | |
renderHeadIntroHtml: function() { | |
var view = this.view; | |
if (view.colWeekNumbersVisible) { | |
return '' + | |
'<th class="fc-week-number ' + view.calendar.theme.getClass('widgetHeader') + '" ' + view.weekNumberStyleAttr() + '>' + | |
'<span>' + // needed for matchCellWidths | |
htmlEscape(this.opt('weekNumberTitle')) + | |
'</span>' + | |
'</th>'; | |
} | |
return ''; | |
}, | |
// Generates the HTML that will go before content-skeleton cells that display the day/week numbers | |
renderNumberIntroHtml: function(row) { | |
var view = this.view; | |
var weekStart = this.getCellDate(row, 0); | |
if (view.colWeekNumbersVisible) { | |
return '' + | |
'<td class="fc-week-number" ' + view.weekNumberStyleAttr() + '>' + | |
view.buildGotoAnchorHtml( // aside from link, important for matchCellWidths | |
{ date: weekStart, type: 'week', forceOff: this.colCnt === 1 }, | |
weekStart.format('w') // inner HTML | |
) + | |
'</td>'; | |
} | |
return ''; | |
}, | |
// Generates the HTML that goes before the day bg cells for each day-row | |
renderBgIntroHtml: function() { | |
var view = this.view; | |
if (view.colWeekNumbersVisible) { | |
return '<td class="fc-week-number ' + view.calendar.theme.getClass('widgetContent') + '" ' + | |
view.weekNumberStyleAttr() + '></td>'; | |
} | |
return ''; | |
}, | |
// Generates the HTML that goes before every other type of row generated by DayGrid. | |
// Affects helper-skeleton and highlight-skeleton rows. | |
renderIntroHtml: function() { | |
var view = this.view; | |
if (view.colWeekNumbersVisible) { | |
return '<td class="fc-week-number" ' + view.weekNumberStyleAttr() + '></td>'; | |
} | |
return ''; | |
} | |
}; | |
;; | |
/* A month view with day cells running in rows (one-per-week) and columns | |
----------------------------------------------------------------------------------------------------------------------*/ | |
var MonthView = FC.MonthView = BasicView.extend({ | |
// Computes the date range that will be rendered. | |
buildRenderRange: function(currentUnzonedRange, currentRangeUnit, isRangeAllDay) { | |
var renderUnzonedRange = BasicView.prototype.buildRenderRange.apply(this, arguments); | |
var start = this.calendar.msToUtcMoment(renderUnzonedRange.startMs, isRangeAllDay); | |
var end = this.calendar.msToUtcMoment(renderUnzonedRange.endMs, isRangeAllDay); | |
var rowCnt; | |
// ensure 6 weeks | |
if (this.isFixedWeeks()) { | |
rowCnt = Math.ceil( // could be partial weeks due to hiddenDays | |
end.diff(start, 'weeks', true) // dontRound=true | |
); | |
end.add(6 - rowCnt, 'weeks'); | |
} | |
return new UnzonedRange(start, end); | |
}, | |
// Overrides the default BasicView behavior to have special multi-week auto-height logic | |
setGridHeight: function(height, isAuto) { | |
// if auto, make the height of each row the height that it would be if there were 6 weeks | |
if (isAuto) { | |
height *= this.rowCnt / 6; | |
} | |
distributeHeight(this.dayGrid.rowEls, height, !isAuto); // if auto, don't compensate for height-hogging rows | |
}, | |
isFixedWeeks: function() { | |
return this.opt('fixedWeekCount'); | |
}, | |
isDateInOtherMonth: function(date) { | |
var dateProfile = this.get('dateProfile'); | |
return date.month() !== moment.utc(dateProfile.currentUnzonedRange.startMs).month(); // TODO: optimize | |
} | |
}); | |
;; | |
fcViews.basic = { | |
'class': BasicView | |
}; | |
fcViews.basicDay = { | |
type: 'basic', | |
duration: { days: 1 } | |
}; | |
fcViews.basicWeek = { | |
type: 'basic', | |
duration: { weeks: 1 } | |
}; | |
fcViews.month = { | |
'class': MonthView, | |
duration: { months: 1 }, // important for prev/next | |
defaults: { | |
fixedWeekCount: true | |
} | |
}; | |
;; | |
var TimeGridFillRenderer = FillRenderer.extend({ | |
timeGrid: null, | |
constructor: function(timeGrid) { | |
FillRenderer.call(this); | |
this.timeGrid = timeGrid; | |
}, | |
attachSegEls: function(type, segs) { | |
var timeGrid = this.timeGrid; | |
var containerEls; | |
// TODO: more efficient lookup | |
if (type === 'bgEvents') { | |
containerEls = timeGrid.bgContainerEls; | |
} | |
else if (type === 'businessHours') { | |
containerEls = timeGrid.businessContainerEls; | |
} | |
else if (type === 'highlight') { | |
containerEls = timeGrid.highlightContainerEls; | |
} | |
timeGrid.updateSegVerticals(segs); | |
timeGrid.attachSegsByCol(timeGrid.groupSegsByCol(segs), containerEls); | |
return segs.map(function(seg) { | |
return seg.el[0]; | |
}); | |
} | |
}); | |
;; | |
/* | |
Only handles foreground segs. | |
Does not own rendering. Use for low-level util methods by TimeGrid. | |
*/ | |
var TimeGridEventRenderer = EventRenderer.extend({ | |
timeGrid: null, | |
constructor: function(timeGrid) { | |
EventRenderer.apply(this, arguments); | |
this.timeGrid = timeGrid; | |
}, | |
renderFgSegs: function(segs) { | |
this.renderFgSegsIntoContainers(segs, this.timeGrid.fgContainerEls); | |
}, | |
// Given an array of foreground segments, render a DOM element for each, computes position, | |
// and attaches to the column inner-container elements. | |
renderFgSegsIntoContainers: function(segs, containerEls) { | |
var segsByCol; | |
var col; | |
segsByCol = this.timeGrid.groupSegsByCol(segs); | |
for (col = 0; col < this.timeGrid.colCnt; col++) { | |
this.updateFgSegCoords(segsByCol[col]); | |
} | |
this.timeGrid.attachSegsByCol(segsByCol, containerEls); | |
}, | |
unrenderFgSegs: function() { | |
this.fgSegs.forEach(function(seg) { | |
seg.el.remove(); | |
}); | |
}, | |
// Computes a default event time formatting string if `timeFormat` is not explicitly defined | |
computeEventTimeFormat: function() { | |
return this.opt('noMeridiemTimeFormat'); // like "6:30" (no AM/PM) | |
}, | |
// Computes a default `displayEventEnd` value if one is not expliclty defined | |
computeDisplayEventEnd: function() { | |
return true; | |
}, | |
// Renders the HTML for a single event segment's default rendering | |
fgSegHtml: function(seg, disableResizing) { | |
var view = this.view; | |
var calendar = view.calendar; | |
var componentFootprint = seg.footprint.componentFootprint; | |
var isAllDay = componentFootprint.isAllDay; | |
var eventDef = seg.footprint.eventDef; | |
var isDraggable = view.isEventDefDraggable(eventDef); | |
var isResizableFromStart = !disableResizing && seg.isStart && view.isEventDefResizableFromStart(eventDef); | |
var isResizableFromEnd = !disableResizing && seg.isEnd && view.isEventDefResizableFromEnd(eventDef); | |
var classes = this.getSegClasses(seg, isDraggable, isResizableFromStart || isResizableFromEnd); | |
var skinCss = cssToStr(this.getSkinCss(seg.footprint)); | |
var timeText; | |
var fullTimeText; // more verbose time text. for the print stylesheet | |
var startTimeText; // just the start time text | |
classes.unshift('fc-time-grid-event', 'fc-v-event'); | |
// if the event appears to span more than one day... | |
if (view.isMultiDayRange(componentFootprint.unzonedRange)) { | |
// Don't display time text on segments that run entirely through a day. | |
// That would appear as midnight-midnight and would look dumb. | |
// Otherwise, display the time text for the *segment's* times (like 6pm-midnight or midnight-10am) | |
if (seg.isStart || seg.isEnd) { | |
var zonedStart = calendar.msToMoment(seg.startMs); | |
var zonedEnd = calendar.msToMoment(seg.endMs); | |
timeText = this._getTimeText(zonedStart, zonedEnd, isAllDay); | |
fullTimeText = this._getTimeText(zonedStart, zonedEnd, isAllDay, 'LT'); | |
startTimeText = this._getTimeText(zonedStart, zonedEnd, isAllDay, null, false); // displayEnd=false | |
} | |
} | |
else { | |
// Display the normal time text for the *event's* times | |
timeText = this.getTimeText(seg.footprint); | |
fullTimeText = this.getTimeText(seg.footprint, 'LT'); | |
startTimeText = this.getTimeText(seg.footprint, null, false); // displayEnd=false | |
} | |
return '<a class="' + classes.join(' ') + '"' + | |
(eventDef.url ? | |
' href="' + htmlEscape(eventDef.url) + '"' : | |
'' | |
) + | |
(skinCss ? | |
' style="' + skinCss + '"' : | |
'' | |
) + | |
'>' + | |
'<div class="fc-content">' + | |
(timeText ? | |
'<div class="fc-time"' + | |
' data-start="' + htmlEscape(startTimeText) + '"' + | |
' data-full="' + htmlEscape(fullTimeText) + '"' + | |
'>' + | |
'<span>' + htmlEscape(timeText) + '</span>' + | |
'</div>' : | |
'' | |
) + | |
(eventDef.title ? | |
'<div class="fc-title">' + | |
htmlEscape(eventDef.title) + | |
'</div>' : | |
'' | |
) + | |
'</div>' + | |
'<div class="fc-bg"/>' + | |
/* TODO: write CSS for this | |
(isResizableFromStart ? | |
'<div class="fc-resizer fc-start-resizer" />' : | |
'' | |
) + | |
*/ | |
(isResizableFromEnd ? | |
'<div class="fc-resizer fc-end-resizer" />' : | |
'' | |
) + | |
'</a>'; | |
}, | |
// Given segments that are assumed to all live in the *same column*, | |
// compute their verical/horizontal coordinates and assign to their elements. | |
updateFgSegCoords: function(segs) { | |
this.timeGrid.computeSegVerticals(segs); // horizontals relies on this | |
this.computeFgSegHorizontals(segs); // compute horizontal coordinates, z-index's, and reorder the array | |
this.timeGrid.assignSegVerticals(segs); | |
this.assignFgSegHorizontals(segs); | |
}, | |
// Given an array of segments that are all in the same column, sets the backwardCoord and forwardCoord on each. | |
// NOTE: Also reorders the given array by date! | |
computeFgSegHorizontals: function(segs) { | |
var levels; | |
var level0; | |
var i; | |
this.sortEventSegs(segs); // order by certain criteria | |
levels = buildSlotSegLevels(segs); | |
computeForwardSlotSegs(levels); | |
if ((level0 = levels[0])) { | |
for (i = 0; i < level0.length; i++) { | |
computeSlotSegPressures(level0[i]); | |
} | |
for (i = 0; i < level0.length; i++) { | |
this.computeFgSegForwardBack(level0[i], 0, 0); | |
} | |
} | |
}, | |
// Calculate seg.forwardCoord and seg.backwardCoord for the segment, where both values range | |
// from 0 to 1. If the calendar is left-to-right, the seg.backwardCoord maps to "left" and | |
// seg.forwardCoord maps to "right" (via percentage). Vice-versa if the calendar is right-to-left. | |
// | |
// The segment might be part of a "series", which means consecutive segments with the same pressure | |
// who's width is unknown until an edge has been hit. `seriesBackwardPressure` is the number of | |
// segments behind this one in the current series, and `seriesBackwardCoord` is the starting | |
// coordinate of the first segment in the series. | |
computeFgSegForwardBack: function(seg, seriesBackwardPressure, seriesBackwardCoord) { | |
var forwardSegs = seg.forwardSegs; | |
var i; | |
if (seg.forwardCoord === undefined) { // not already computed | |
if (!forwardSegs.length) { | |
// if there are no forward segments, this segment should butt up against the edge | |
seg.forwardCoord = 1; | |
} | |
else { | |
// sort highest pressure first | |
this.sortForwardSegs(forwardSegs); | |
// this segment's forwardCoord will be calculated from the backwardCoord of the | |
// highest-pressure forward segment. | |
this.computeFgSegForwardBack(forwardSegs[0], seriesBackwardPressure + 1, seriesBackwardCoord); | |
seg.forwardCoord = forwardSegs[0].backwardCoord; | |
} | |
// calculate the backwardCoord from the forwardCoord. consider the series | |
seg.backwardCoord = seg.forwardCoord - | |
(seg.forwardCoord - seriesBackwardCoord) / // available width for series | |
(seriesBackwardPressure + 1); // # of segments in the series | |
// use this segment's coordinates to computed the coordinates of the less-pressurized | |
// forward segments | |
for (i=0; i<forwardSegs.length; i++) { | |
this.computeFgSegForwardBack(forwardSegs[i], 0, seg.forwardCoord); | |
} | |
} | |
}, | |
sortForwardSegs: function(forwardSegs) { | |
forwardSegs.sort(proxy(this, 'compareForwardSegs')); | |
}, | |
// A cmp function for determining which forward segment to rely on more when computing coordinates. | |
compareForwardSegs: function(seg1, seg2) { | |
// put higher-pressure first | |
return seg2.forwardPressure - seg1.forwardPressure || | |
// put segments that are closer to initial edge first (and favor ones with no coords yet) | |
(seg1.backwardCoord || 0) - (seg2.backwardCoord || 0) || | |
// do normal sorting... | |
this.compareEventSegs(seg1, seg2); | |
}, | |
// Given foreground event segments that have already had their position coordinates computed, | |
// assigns position-related CSS values to their elements. | |
assignFgSegHorizontals: function(segs) { | |
var i, seg; | |
for (i = 0; i < segs.length; i++) { | |
seg = segs[i]; | |
seg.el.css(this.generateFgSegHorizontalCss(seg)); | |
// if the height is short, add a className for alternate styling | |
if (seg.bottom - seg.top < 30) { | |
seg.el.addClass('fc-short'); | |
} | |
} | |
}, | |
// Generates an object with CSS properties/values that should be applied to an event segment element. | |
// Contains important positioning-related properties that should be applied to any event element, customized or not. | |
generateFgSegHorizontalCss: function(seg) { | |
var shouldOverlap = this.opt('slotEventOverlap'); | |
var backwardCoord = seg.backwardCoord; // the left side if LTR. the right side if RTL. floating-point | |
var forwardCoord = seg.forwardCoord; // the right side if LTR. the left side if RTL. floating-point | |
var props = this.timeGrid.generateSegVerticalCss(seg); // get top/bottom first | |
var left; // amount of space from left edge, a fraction of the total width | |
var right; // amount of space from right edge, a fraction of the total width | |
if (shouldOverlap) { | |
// double the width, but don't go beyond the maximum forward coordinate (1.0) | |
forwardCoord = Math.min(1, backwardCoord + (forwardCoord - backwardCoord) * 2); | |
} | |
if (this.timeGrid.isRTL) { | |
left = 1 - forwardCoord; | |
right = backwardCoord; | |
} | |
else { | |
left = backwardCoord; | |
right = 1 - forwardCoord; | |
} | |
if(backwardCoord % 1 !== 0 || forwardCoord % 1 !== 0) { | |
} | |
props.minWidth = 'calc(' + (forwardCoord - backwardCoord) * 100 + '%' + ' - 2px)'; | |
props.zIndex = seg.level + 1; // convert from 0-base to 1-based | |
props.left = left * 100 + '%'; | |
props.right = right * 100 + '%'; | |
if (shouldOverlap && seg.forwardPressure) { | |
// add padding to the edge so that forward stacked events don't cover the resizer's icon | |
props[this.isRTL ? 'marginLeft' : 'marginRight'] = 10 * 2; // 10 is a guesstimate of the icon's width | |
} | |
return props; | |
} | |
}); | |
// Builds an array of segments "levels". The first level will be the leftmost tier of segments if the calendar is | |
// left-to-right, or the rightmost if the calendar is right-to-left. Assumes the segments are already ordered by date. | |
function buildSlotSegLevels(segs) { | |
var levels = []; | |
var i, seg; | |
var j; | |
for (i=0; i<segs.length; i++) { | |
seg = segs[i]; | |
// go through all the levels and stop on the first level where there are no collisions | |
for (j=0; j<levels.length; j++) { | |
if (!computeSlotSegCollisions(seg, levels[j]).length) { | |
break; | |
} | |
} | |
seg.level = j; | |
(levels[j] || (levels[j] = [])).push(seg); | |
} | |
return levels; | |
} | |
// For every segment, figure out the other segments that are in subsequent | |
// levels that also occupy the same vertical space. Accumulate in seg.forwardSegs | |
function computeForwardSlotSegs(levels) { | |
var i, level; | |
var j, seg; | |
var k; | |
for (i=0; i<levels.length; i++) { | |
level = levels[i]; | |
for (j=0; j<level.length; j++) { | |
seg = level[j]; | |
seg.forwardSegs = []; | |
for (k=i+1; k<levels.length; k++) { | |
computeSlotSegCollisions(seg, levels[k], seg.forwardSegs); | |
} | |
} | |
} | |
} | |
// Figure out which path forward (via seg.forwardSegs) results in the longest path until | |
// the furthest edge is reached. The number of segments in this path will be seg.forwardPressure | |
function computeSlotSegPressures(seg) { | |
var forwardSegs = seg.forwardSegs; | |
var forwardPressure = 0; | |
var i, forwardSeg; | |
if (seg.forwardPressure === undefined) { // not already computed | |
for (i=0; i<forwardSegs.length; i++) { | |
forwardSeg = forwardSegs[i]; | |
// figure out the child's maximum forward path | |
computeSlotSegPressures(forwardSeg); | |
// either use the existing maximum, or use the child's forward pressure | |
// plus one (for the forwardSeg itself) | |
forwardPressure = Math.max( | |
forwardPressure, | |
1 + forwardSeg.forwardPressure | |
); | |
} | |
seg.forwardPressure = forwardPressure; | |
} | |
} | |
// Find all the segments in `otherSegs` that vertically collide with `seg`. | |
// Append into an optionally-supplied `results` array and return. | |
function computeSlotSegCollisions(seg, otherSegs, results) { | |
results = results || []; | |
for (var i=0; i<otherSegs.length; i++) { | |
if (isSlotSegCollision(seg, otherSegs[i])) { | |
results.push(otherSegs[i]); | |
} | |
} | |
return results; | |
} | |
// Do these segments occupy the same vertical space? | |
function isSlotSegCollision(seg1, seg2) { | |
return seg1.bottom > seg2.top && seg1.top < seg2.bottom; | |
} | |
;; | |
var TimeGridHelperRenderer = HelperRenderer.extend({ | |
renderSegs: function(segs, sourceSeg) { | |
var helperNodes = []; | |
var i, seg; | |
var sourceEl; | |
// TODO: not good to call eventRenderer this way | |
this.eventRenderer.renderFgSegsIntoContainers( | |
segs, | |
this.component.helperContainerEls | |
); | |
// Try to make the segment that is in the same row as sourceSeg look the same | |
for (i = 0; i < segs.length; i++) { | |
seg = segs[i]; | |
if (sourceSeg && sourceSeg.col === seg.col) { | |
sourceEl = sourceSeg.el; | |
seg.el.css({ | |
left: sourceEl.css('left'), | |
right: sourceEl.css('right'), | |
'margin-left': sourceEl.css('margin-left'), | |
'margin-right': sourceEl.css('margin-right') | |
}); | |
} | |
helperNodes.push(seg.el[0]); | |
} | |
return $(helperNodes); // must return the elements rendered | |
} | |
}); | |
;; | |
/* A component that renders one or more columns of vertical time slots | |
----------------------------------------------------------------------------------------------------------------------*/ | |
// We mixin DayTable, even though there is only a single row of days | |
var TimeGrid = FC.TimeGrid = InteractiveDateComponent.extend(StandardInteractionsMixin, DayTableMixin, { | |
eventRendererClass: TimeGridEventRenderer, | |
businessHourRendererClass: BusinessHourRenderer, | |
helperRendererClass: TimeGridHelperRenderer, | |
fillRendererClass: TimeGridFillRenderer, | |
view: null, // TODO: make more general and/or remove | |
helperRenderer: null, | |
dayRanges: null, // UnzonedRange[], of start-end of each day | |
slotDuration: null, // duration of a "slot", a distinct time segment on given day, visualized by lines | |
snapDuration: null, // granularity of time for dragging and selecting | |
snapsPerSlot: null, | |
labelFormat: null, // formatting string for times running along vertical axis | |
labelInterval: null, // duration of how often a label should be displayed for a slot | |
colEls: null, // cells elements in the day-row background | |
slatContainerEl: null, // div that wraps all the slat rows | |
slatEls: null, // elements running horizontally across all columns | |
nowIndicatorEls: null, | |
colCoordCache: null, | |
slatCoordCache: null, | |
bottomRuleEl: null, // hidden by default | |
colContainerEls: null, // containers for each column | |
// inner-containers for each column where different types of segs live | |
fgContainerEls: null, | |
bgContainerEls: null, | |
helperContainerEls: null, | |
highlightContainerEls: null, | |
businessContainerEls: null, | |
// arrays of different types of displayed segments | |
helperSegs: null, | |
highlightSegs: null, | |
businessSegs: null, | |
constructor: function(view) { | |
this.view = view; // do first, for opt calls during initialization | |
InteractiveDateComponent.call(this); // call the super-constructor | |
this.processOptions(); | |
}, | |
// Slices up the given span (unzoned start/end with other misc data) into an array of segments | |
componentFootprintToSegs: function(componentFootprint) { | |
var segs = this.sliceRangeByTimes(componentFootprint.unzonedRange); | |
var i; | |
for (i = 0; i < segs.length; i++) { | |
if (this.isRTL) { | |
segs[i].col = this.daysPerRow - 1 - segs[i].dayIndex; | |
} | |
else { | |
segs[i].col = segs[i].dayIndex; | |
} | |
} | |
return segs; | |
}, | |
/* Date Handling | |
------------------------------------------------------------------------------------------------------------------*/ | |
handleDateProfileSet: function(dateProfile) { | |
InteractiveDateComponent.prototype.handleDateProfileSet.apply(this, arguments); | |
this.updateDayTable(); | |
// needs to go after updateDayTable because computeEventTimeFormat/computeDisplayEventEnd depends on colCnt. | |
// TODO: easy to forget. use listener. | |
this.eventRenderer.rangeUpdated(); | |
this.dayRanges = this.dayDates.map(function(dayDate) { | |
return new UnzonedRange( | |
dayDate.clone().add(dateProfile.minTime), | |
dayDate.clone().add(dateProfile.maxTime) | |
); | |
}); | |
}, | |
sliceRangeByTimes: function(unzonedRange) { | |
var segs = []; | |
var segRange; | |
var dayIndex; | |
for (dayIndex = 0; dayIndex < this.daysPerRow; dayIndex++) { | |
segRange = unzonedRange.intersect(this.dayRanges[dayIndex]); | |
if (segRange) { | |
segs.push({ | |
startMs: segRange.startMs, | |
endMs: segRange.endMs, | |
isStart: segRange.isStart, | |
isEnd: segRange.isEnd, | |
dayIndex: dayIndex | |
}); | |
} | |
} | |
return segs; | |
}, | |
/* Options | |
------------------------------------------------------------------------------------------------------------------*/ | |
opt: function(name) { | |
return this.view.opt(name); | |
}, | |
// Parses various options into properties of this object | |
processOptions: function() { | |
var slotDuration = this.opt('slotDuration'); | |
var snapDuration = this.opt('snapDuration'); | |
var input; | |
slotDuration = moment.duration(slotDuration); | |
snapDuration = snapDuration ? moment.duration(snapDuration) : slotDuration; | |
this.slotDuration = slotDuration; | |
this.snapDuration = snapDuration; | |
this.snapsPerSlot = slotDuration / snapDuration; // TODO: ensure an integer multiple? | |
// might be an array value (for TimelineView). | |
// if so, getting the most granular entry (the last one probably). | |
input = this.opt('slotLabelFormat'); | |
if ($.isArray(input)) { | |
input = input[input.length - 1]; | |
} | |
this.labelFormat = input || | |
this.opt('smallTimeFormat'); // the computed default | |
input = this.opt('slotLabelInterval'); | |
this.labelInterval = input ? | |
moment.duration(input) : | |
this.computeLabelInterval(slotDuration); | |
}, | |
// Computes an automatic value for slotLabelInterval | |
computeLabelInterval: function(slotDuration) { | |
var i; | |
var labelInterval; | |
var slotsPerLabel; | |
// find the smallest stock label interval that results in more than one slots-per-label | |
for (i = AGENDA_STOCK_SUB_DURATIONS.length - 1; i >= 0; i--) { | |
labelInterval = moment.duration(AGENDA_STOCK_SUB_DURATIONS[i]); | |
slotsPerLabel = divideDurationByDuration(labelInterval, slotDuration); | |
if (isInt(slotsPerLabel) && slotsPerLabel > 1) { | |
return labelInterval; | |
} | |
} | |
return moment.duration(slotDuration); // fall back. clone | |
}, | |
/* Date Rendering | |
------------------------------------------------------------------------------------------------------------------*/ | |
renderSkeleton: function() { | |
var theme = this.view.calendar.theme; | |
this.el.html( | |
'<div class="fc-bg"></div>' + | |
'<div class="fc-slats"></div>' + | |
'<hr class="fc-divider ' + theme.getClass('widgetHeader') + '" style="display:none" />' | |
); | |
this.bottomRuleEl = this.el.find('hr'); | |
}, | |
// Renders the time grid into `this.el`, which should already be assigned. | |
// Relies on the view's colCnt. In the future, this component should probably be self-sufficient. | |
renderDates: function(dateProfile) { | |
var theme = this.view.calendar.theme; | |
this.el.find('> .fc-bg').html( | |
'<table class="' + theme.getClass('tableGrid') + '">' + | |
this.renderBgTrHtml(0) + // row=0 | |
'</table>' | |
); | |
this.el.find('> .fc-slats').html( | |
'<table class="' + theme.getClass('tableGrid') + '">' + | |
this.renderSlatRowHtml() + | |
'</table>' | |
); | |
this.colEls = this.el.find('.fc-day, .fc-disabled-day'); | |
this.slatContainerEl = this.el.find('.fc-slats'); | |
this.slatEls = this.slatContainerEl.find('tr'); | |
this.colCoordCache = new CoordCache({ | |
els: this.colEls, | |
isHorizontal: true | |
}); | |
this.slatCoordCache = new CoordCache({ | |
els: this.slatEls, | |
isVertical: true | |
}); | |
this.renderContentSkeleton(); | |
}, | |
// Generates the HTML for the horizontal "slats" that run width-wise. Has a time axis on a side. Depends on RTL. | |
renderSlatRowHtml: function() { | |
var view = this.view; | |
var calendar = view.calendar; | |
var theme = calendar.theme; | |
var isRTL = this.isRTL; | |
var dateProfile = this.get('dateProfile'); | |
var html = ''; | |
var slotTime = moment.duration(+dateProfile.minTime); // wish there was .clone() for durations | |
var slotIterator = moment.duration(0); | |
var slotDate; // will be on the view's first day, but we only care about its time | |
var isLabeled; | |
var axisHtml; | |
// Calculate the time for each slot | |
while (slotTime < dateProfile.maxTime) { | |
slotDate = calendar.msToUtcMoment(dateProfile.renderUnzonedRange.startMs).time(slotTime); | |
isLabeled = isInt(divideDurationByDuration(slotIterator, this.labelInterval)); | |
axisHtml = | |
'<td class="fc-axis fc-time ' + theme.getClass('widgetContent') + '" ' + view.axisStyleAttr() + '>' + | |
(isLabeled ? | |
'<span>' + // for matchCellWidths | |
htmlEscape(slotDate.format(this.labelFormat)) + | |
'</span>' : | |
'' | |
) + | |
'</td>'; | |
html += | |
'<tr data-time="' + slotDate.format('HH:mm:ss') + '"' + | |
(isLabeled ? '' : ' class="fc-minor"') + | |
'>' + | |
(!isRTL ? axisHtml : '') + | |
'<td class="' + theme.getClass('widgetContent') + '"/>' + | |
(isRTL ? axisHtml : '') + | |
"</tr>"; | |
slotTime.add(this.slotDuration); | |
slotIterator.add(this.slotDuration); | |
} | |
return html; | |
}, | |
/* Content Skeleton | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Renders the DOM that the view's content will live in | |
renderContentSkeleton: function() { | |
var cellHtml = ''; | |
var i; | |
var skeletonEl; | |
for (i = 0; i < this.colCnt; i++) { | |
cellHtml += | |
'<td>' + | |
'<div class="fc-content-col">' + | |
'<div class="fc-event-container fc-helper-container"></div>' + | |
'<div class="fc-event-container"></div>' + | |
'<div class="fc-highlight-container"></div>' + | |
'<div class="fc-bgevent-container"></div>' + | |
'<div class="fc-business-container"></div>' + | |
'</div>' + | |
'</td>'; | |
} | |
skeletonEl = $( | |
'<div class="fc-content-skeleton">' + | |
'<table>' + | |
'<tr>' + cellHtml + '</tr>' + | |
'</table>' + | |
'</div>' | |
); | |
this.colContainerEls = skeletonEl.find('.fc-content-col'); | |
this.helperContainerEls = skeletonEl.find('.fc-helper-container'); | |
this.fgContainerEls = skeletonEl.find('.fc-event-container:not(.fc-helper-container)'); | |
this.bgContainerEls = skeletonEl.find('.fc-bgevent-container'); | |
this.highlightContainerEls = skeletonEl.find('.fc-highlight-container'); | |
this.businessContainerEls = skeletonEl.find('.fc-business-container'); | |
this.bookendCells(skeletonEl.find('tr')); // TODO: do this on string level | |
this.el.append(skeletonEl); | |
}, | |
// Given a flat array of segments, return an array of sub-arrays, grouped by each segment's col | |
groupSegsByCol: function(segs) { | |
var segsByCol = []; | |
var i; | |
for (i = 0; i < this.colCnt; i++) { | |
segsByCol.push([]); | |
} | |
for (i = 0; i < segs.length; i++) { | |
segsByCol[segs[i].col].push(segs[i]); | |
} | |
return segsByCol; | |
}, | |
// Given segments grouped by column, insert the segments' elements into a parallel array of container | |
// elements, each living within a column. | |
attachSegsByCol: function(segsByCol, containerEls) { | |
var col; | |
var segs; | |
var i; | |
for (col = 0; col < this.colCnt; col++) { // iterate each column grouping | |
segs = segsByCol[col]; | |
for (i = 0; i < segs.length; i++) { | |
containerEls.eq(col).append(segs[i].el); | |
} | |
} | |
}, | |
/* Now Indicator | |
------------------------------------------------------------------------------------------------------------------*/ | |
getNowIndicatorUnit: function() { | |
return 'minute'; // will refresh on the minute | |
}, | |
renderNowIndicator: function(date) { | |
// seg system might be overkill, but it handles scenario where line needs to be rendered | |
// more than once because of columns with the same date (resources columns for example) | |
var segs = this.componentFootprintToSegs( | |
new ComponentFootprint( | |
new UnzonedRange(date, date.valueOf() + 1), // protect against null range | |
false // all-day | |
) | |
); | |
var top = this.computeDateTop(date, date); | |
var nodes = []; | |
var i; | |
// render lines within the columns | |
for (i = 0; i < segs.length; i++) { | |
nodes.push($('<div class="fc-now-indicator fc-now-indicator-line"></div>') | |
.css('top', top) | |
.appendTo(this.colContainerEls.eq(segs[i].col))[0]); | |
} | |
// render an arrow over the axis | |
if (segs.length > 0) { // is the current time in view? | |
nodes.push($('<div class="fc-now-indicator fc-now-indicator-arrow"></div>') | |
.css('top', top) | |
.appendTo(this.el.find('.fc-content-skeleton'))[0]); | |
} | |
this.nowIndicatorEls = $(nodes); | |
}, | |
unrenderNowIndicator: function() { | |
if (this.nowIndicatorEls) { | |
this.nowIndicatorEls.remove(); | |
this.nowIndicatorEls = null; | |
} | |
}, | |
/* Coordinates | |
------------------------------------------------------------------------------------------------------------------*/ | |
updateSize: function(totalHeight, isAuto, isResize) { | |
InteractiveDateComponent.prototype.updateSize.apply(this, arguments); | |
this.slatCoordCache.build(); | |
if (isResize) { | |
this.updateSegVerticals( | |
[].concat(this.eventRenderer.getSegs(), this.businessSegs || []) | |
); | |
} | |
}, | |
getTotalSlatHeight: function() { | |
return this.slatContainerEl.outerHeight(); | |
}, | |
// Computes the top coordinate, relative to the bounds of the grid, of the given date. | |
// `ms` can be a millisecond UTC time OR a UTC moment. | |
// A `startOfDayDate` must be given for avoiding ambiguity over how to treat midnight. | |
computeDateTop: function(ms, startOfDayDate) { | |
return this.computeTimeTop( | |
moment.duration( | |
ms - startOfDayDate.clone().stripTime() | |
) | |
); | |
}, | |
// Computes the top coordinate, relative to the bounds of the grid, of the given time (a Duration). | |
computeTimeTop: function(time) { | |
var len = this.slatEls.length; | |
var dateProfile = this.get('dateProfile'); | |
var slatCoverage = (time - dateProfile.minTime) / this.slotDuration; // floating-point value of # of slots covered | |
var slatIndex; | |
var slatRemainder; | |
// compute a floating-point number for how many slats should be progressed through. | |
// from 0 to number of slats (inclusive) | |
// constrained because minTime/maxTime might be customized. | |
slatCoverage = Math.max(0, slatCoverage); | |
slatCoverage = Math.min(len, slatCoverage); | |
// an integer index of the furthest whole slat | |
// from 0 to number slats (*exclusive*, so len-1) | |
slatIndex = Math.floor(slatCoverage); | |
slatIndex = Math.min(slatIndex, len - 1); | |
// how much further through the slatIndex slat (from 0.0-1.0) must be covered in addition. | |
// could be 1.0 if slatCoverage is covering *all* the slots | |
slatRemainder = slatCoverage - slatIndex; | |
return this.slatCoordCache.getTopPosition(slatIndex) + | |
this.slatCoordCache.getHeight(slatIndex) * slatRemainder; | |
}, | |
// Refreshes the CSS top/bottom coordinates for each segment element. | |
// Works when called after initial render, after a window resize/zoom for example. | |
updateSegVerticals: function(segs) { | |
this.computeSegVerticals(segs); | |
this.assignSegVerticals(segs); | |
}, | |
// For each segment in an array, computes and assigns its top and bottom properties | |
computeSegVerticals: function(segs) { | |
var i, seg; | |
var dayDate; | |
for (i = 0; i < segs.length; i++) { | |
seg = segs[i]; | |
dayDate = this.dayDates[seg.dayIndex]; | |
seg.top = this.computeDateTop(seg.startMs, dayDate); | |
if(this.computeDateTop(seg.endMs, dayDate) - seg.top < this.view.opt('minSegmentHeight')) { | |
seg.bottom = seg.top + this.view.opt('minSegmentHeight'); | |
} | |
else { | |
seg.bottom = this.computeDateTop(seg.endMs, dayDate); | |
} | |
} | |
}, | |
// Given segments that already have their top/bottom properties computed, applies those values to | |
// the segments' elements. | |
assignSegVerticals: function(segs) { | |
var i, seg; | |
for (i = 0; i < segs.length; i++) { | |
seg = segs[i]; | |
seg.el.css(this.generateSegVerticalCss(seg)); | |
} | |
}, | |
// Generates an object with CSS properties for the top/bottom coordinates of a segment element | |
generateSegVerticalCss: function(seg) { | |
return { | |
top: seg.top, | |
bottom: -seg.bottom // flipped because needs to be space beyond bottom edge of event container | |
}; | |
}, | |
/* Hit System | |
------------------------------------------------------------------------------------------------------------------*/ | |
prepareHits: function() { | |
this.colCoordCache.build(); | |
this.slatCoordCache.build(); | |
}, | |
releaseHits: function() { | |
this.colCoordCache.clear(); | |
// NOTE: don't clear slatCoordCache because we rely on it for computeTimeTop | |
}, | |
queryHit: function(leftOffset, topOffset) { | |
var snapsPerSlot = this.snapsPerSlot; | |
var colCoordCache = this.colCoordCache; | |
var slatCoordCache = this.slatCoordCache; | |
if (colCoordCache.isLeftInBounds(leftOffset) && slatCoordCache.isTopInBounds(topOffset)) { | |
var colIndex = colCoordCache.getHorizontalIndex(leftOffset); | |
var slatIndex = slatCoordCache.getVerticalIndex(topOffset); | |
if (colIndex != null && slatIndex != null) { | |
var slatTop = slatCoordCache.getTopOffset(slatIndex); | |
var slatHeight = slatCoordCache.getHeight(slatIndex); | |
var partial = (topOffset - slatTop) / slatHeight; // floating point number between 0 and 1 | |
var localSnapIndex = Math.floor(partial * snapsPerSlot); // the snap # relative to start of slat | |
var snapIndex = slatIndex * snapsPerSlot + localSnapIndex; | |
var snapTop = slatTop + (localSnapIndex / snapsPerSlot) * slatHeight; | |
var snapBottom = slatTop + ((localSnapIndex + 1) / snapsPerSlot) * slatHeight; | |
return { | |
col: colIndex, | |
snap: snapIndex, | |
component: this, // needed unfortunately :( | |
left: colCoordCache.getLeftOffset(colIndex), | |
right: colCoordCache.getRightOffset(colIndex), | |
top: snapTop, | |
bottom: snapBottom | |
}; | |
} | |
} | |
}, | |
getHitFootprint: function(hit) { | |
var start = this.getCellDate(0, hit.col); // row=0 | |
var time = this.computeSnapTime(hit.snap); // pass in the snap-index | |
var end; | |
start.time(time); | |
end = start.clone().add(this.snapDuration); | |
return new ComponentFootprint( | |
new UnzonedRange(start, end), | |
false // all-day? | |
); | |
}, | |
// Given a row number of the grid, representing a "snap", returns a time (Duration) from its start-of-day | |
computeSnapTime: function(snapIndex) { | |
return moment.duration(this.get('dateProfile').minTime + this.snapDuration * snapIndex); | |
}, | |
getHitEl: function(hit) { | |
return this.colEls.eq(hit.col); | |
}, | |
/* Event Drag Visualization | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Renders a visual indication of an event being dragged over the specified date(s). | |
// A returned value of `true` signals that a mock "helper" event has been rendered. | |
renderDrag: function(eventFootprints, seg, isTouch) { | |
var i; | |
if (seg) { // if there is event information for this drag, render a helper event | |
this.helperRenderer.renderEventDraggingFootprints(eventFootprints, seg, isTouch); | |
// signal that a helper has been rendered | |
return true; | |
} | |
else { // otherwise, just render a highlight | |
for (i = 0; i < eventFootprints.length; i++) { | |
this.renderHighlight(eventFootprints[i].componentFootprint); | |
} | |
} | |
}, | |
// Unrenders any visual indication of an event being dragged | |
unrenderDrag: function() { | |
this.helperRenderer.unrender(); | |
this.unrenderHighlight(); | |
}, | |
/* Event Resize Visualization | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Renders a visual indication of an event being resized | |
renderEventResize: function(eventFootprints, seg, isTouch) { | |
this.helperRenderer.renderEventResizingFootprints(eventFootprints, seg, isTouch); | |
}, | |
// Unrenders any visual indication of an event being resized | |
unrenderEventResize: function() { | |
this.helperRenderer.unrender(); | |
}, | |
/* Selection | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Renders a visual indication of a selection. Overrides the default, which was to simply render a highlight. | |
renderSelectionFootprint: function(componentFootprint) { | |
if (this.opt('selectHelper')) { // this setting signals that a mock helper event should be rendered | |
this.helperRenderer.renderComponentFootprint(componentFootprint); | |
} | |
else { | |
this.renderHighlight(componentFootprint); | |
} | |
}, | |
// Unrenders any visual indication of a selection | |
unrenderSelection: function() { | |
this.helperRenderer.unrender(); | |
this.unrenderHighlight(); | |
} | |
}); | |
;; | |
/* An abstract class for all agenda-related views. Displays one more columns with time slots running vertically. | |
----------------------------------------------------------------------------------------------------------------------*/ | |
// Is a manager for the TimeGrid subcomponent and possibly the DayGrid subcomponent (if allDaySlot is on). | |
// Responsible for managing width/height. | |
var AgendaView = FC.AgendaView = View.extend({ | |
scroller: null, | |
timeGridClass: TimeGrid, // class used to instantiate the timeGrid. subclasses can override | |
timeGrid: null, // the main time-grid subcomponent of this view | |
dayGridClass: DayGrid, // class used to instantiate the dayGrid. subclasses can override | |
dayGrid: null, // the "all-day" subcomponent. if all-day is turned off, this will be null | |
axisWidth: null, // the width of the time axis running down the side | |
headContainerEl: null, // div that hold's the timeGrid's rendered date header | |
// indicates that minTime/maxTime affects rendering | |
usesMinMaxTime: true, | |
constructor: function() { | |
View.apply(this, arguments); | |
this.timeGrid = this.instantiateTimeGrid(); | |
this.addChild(this.timeGrid); | |
if (this.opt('allDaySlot')) { // should we display the "all-day" area? | |
this.dayGrid = this.instantiateDayGrid(); // the all-day subcomponent of this view | |
this.addChild(this.dayGrid); | |
} | |
this.scroller = new Scroller({ | |
overflowX: 'hidden', | |
overflowY: 'auto' | |
}); | |
}, | |
// Instantiates the TimeGrid object this view needs. Draws from this.timeGridClass | |
instantiateTimeGrid: function() { | |
var subclass = this.timeGridClass.extend(agendaTimeGridMethods); | |
return new subclass(this); | |
}, | |
// Instantiates the DayGrid object this view might need. Draws from this.dayGridClass | |
instantiateDayGrid: function() { | |
var subclass = this.dayGridClass.extend(agendaDayGridMethods); | |
return new subclass(this); | |
}, | |
/* Rendering | |
------------------------------------------------------------------------------------------------------------------*/ | |
renderSkeleton: function() { | |
var timeGridWrapEl; | |
var timeGridEl; | |
this.el.addClass('fc-agenda-view').html(this.renderSkeletonHtml()); | |
this.scroller.render(); | |
timeGridWrapEl = this.scroller.el.addClass('fc-time-grid-container'); | |
timeGridEl = $('<div class="fc-time-grid" />').appendTo(timeGridWrapEl); | |
this.el.find('.fc-body > tr > td').append(timeGridWrapEl); | |
this.timeGrid.setElement(timeGridEl); | |
if (this.dayGrid) { | |
this.dayGrid.setElement(this.el.find('.fc-day-grid')); | |
// have the day-grid extend it's coordinate area over the <hr> dividing the two grids | |
this.dayGrid.bottomCoordPadding = this.dayGrid.el.next('hr').outerHeight(); | |
} | |
}, | |
unrenderSkeleton: function() { | |
this.timeGrid.removeElement(); | |
if (this.dayGrid) { | |
this.dayGrid.removeElement(); | |
} | |
this.scroller.destroy(); | |
}, | |
// Renders the view into `this.el`, which has already been assigned | |
renderDates: function(dateProfile) { | |
this.renderHead(); | |
}, | |
// render the day-of-week headers | |
renderHead: function() { | |
this.headContainerEl = | |
this.el.find('.fc-head-container') | |
.html(this.timeGrid.renderHeadHtml()); | |
}, | |
// Builds the HTML skeleton for the view. | |
// The day-grid and time-grid components will render inside containers defined by this HTML. | |
renderSkeletonHtml: function() { | |
var theme = this.calendar.theme; | |
return '' + | |
'<table class="' + theme.getClass('tableGrid') + '">' + | |
'<thead class="fc-head">' + | |
'<tr>' + | |
'<td class="fc-head-container ' + theme.getClass('widgetHeader') + '"></td>' + | |
'</tr>' + | |
'</thead>' + | |
'<tbody class="fc-body">' + | |
'<tr>' + | |
'<td class="' + theme.getClass('widgetContent') + '">' + | |
(this.dayGrid ? | |
'<div class="fc-day-grid"/>' + | |
'<hr class="fc-divider ' + theme.getClass('widgetHeader') + '"/>' : | |
'' | |
) + | |
'</td>' + | |
'</tr>' + | |
'</tbody>' + | |
'</table>'; | |
}, | |
// Generates an HTML attribute string for setting the width of the axis, if it is known | |
axisStyleAttr: function() { | |
if (this.axisWidth !== null) { | |
return 'style="width:' + this.axisWidth + 'px"'; | |
} | |
return ''; | |
}, | |
/* Now Indicator | |
------------------------------------------------------------------------------------------------------------------*/ | |
getNowIndicatorUnit: function() { | |
return this.timeGrid.getNowIndicatorUnit(); | |
}, | |
/* Dimensions | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Adjusts the vertical dimensions of the view to the specified values | |
updateSize: function(totalHeight, isAuto, isResize) { | |
View.prototype.updateSize.apply(this, arguments); | |
// make all axis cells line up, and record the width so newly created axis cells will have it | |
this.axisWidth = matchCellWidths(this.el.find('.fc-axis')); | |
// set of fake row elements that must compensate when scroller has scrollbars | |
var noScrollRowEls = this.el.find('.fc-row:not(.fc-scroller *)'); | |
var eventLimit; | |
var scrollerHeight; | |
var scrollbarWidths; | |
// reset all dimensions back to the original state | |
this.timeGrid.bottomRuleEl.hide(); // .show() will be called later if this <hr> is necessary | |
this.scroller.clear(); // sets height to 'auto' and clears overflow | |
uncompensateScroll(noScrollRowEls); | |
// limit number of events in the all-day area | |
if (this.dayGrid) { | |
this.dayGrid.removeSegPopover(); // kill the "more" popover if displayed | |
eventLimit = this.opt('eventLimit'); | |
if (eventLimit && typeof eventLimit !== 'number') { | |
eventLimit = AGENDA_ALL_DAY_EVENT_LIMIT; // make sure "auto" goes to a real number | |
} | |
if (eventLimit) { | |
this.dayGrid.limitRows(eventLimit); | |
} | |
} | |
if (!isAuto) { // should we force dimensions of the scroll container? | |
scrollerHeight = this.computeScrollerHeight(totalHeight); | |
this.scroller.setHeight(scrollerHeight); | |
scrollbarWidths = this.scroller.getScrollbarWidths(); | |
if (scrollbarWidths.left || scrollbarWidths.right) { // using scrollbars? | |
// make the all-day and header rows lines up | |
compensateScroll(noScrollRowEls, scrollbarWidths); | |
// the scrollbar compensation might have changed text flow, which might affect height, so recalculate | |
// and reapply the desired height to the scroller. | |
scrollerHeight = this.computeScrollerHeight(totalHeight); | |
this.scroller.setHeight(scrollerHeight); | |
} | |
// guarantees the same scrollbar widths | |
this.scroller.lockOverflow(scrollbarWidths); | |
// if there's any space below the slats, show the horizontal rule. | |
// this won't cause any new overflow, because lockOverflow already called. | |
if (this.timeGrid.getTotalSlatHeight() < scrollerHeight) { | |
this.timeGrid.bottomRuleEl.show(); | |
} | |
} | |
}, | |
// given a desired total height of the view, returns what the height of the scroller should be | |
computeScrollerHeight: function(totalHeight) { | |
return totalHeight - | |
subtractInnerElHeight(this.el, this.scroller.el); // everything that's NOT the scroller | |
}, | |
/* Scroll | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Computes the initial pre-configured scroll state prior to allowing the user to change it | |
computeInitialDateScroll: function() { | |
var scrollTime = moment.duration(this.opt('scrollTime')); | |
var top = this.timeGrid.computeTimeTop(scrollTime); | |
// zoom can give weird floating-point values. rather scroll a little bit further | |
top = Math.ceil(top); | |
if (top) { | |
top++; // to overcome top border that slots beyond the first have. looks better | |
} | |
return { top: top }; | |
}, | |
queryDateScroll: function() { | |
return { top: this.scroller.getScrollTop() }; | |
}, | |
applyDateScroll: function(scroll) { | |
if (scroll.top !== undefined) { | |
this.scroller.setScrollTop(scroll.top); | |
} | |
}, | |
/* Hit Areas | |
------------------------------------------------------------------------------------------------------------------*/ | |
// forward all hit-related method calls to the grids (dayGrid might not be defined) | |
getHitFootprint: function(hit) { | |
// TODO: hit.component is set as a hack to identify where the hit came from | |
return hit.component.getHitFootprint(hit); | |
}, | |
getHitEl: function(hit) { | |
// TODO: hit.component is set as a hack to identify where the hit came from | |
return hit.component.getHitEl(hit); | |
}, | |
/* Events | |
------------------------------------------------------------------------------------------------------------------*/ | |
// routing | |
setEventsInChildren: function(eventsPayload) { | |
var allDayPayload = {}; | |
var timedPayload = {}; | |
var id, eventInstanceGroup; | |
for (id in eventsPayload) { | |
eventInstanceGroup = eventsPayload[id]; | |
if (eventInstanceGroup.getEventDef().isAllDay()) { | |
allDayPayload[id] = eventInstanceGroup; | |
} | |
else { | |
timedPayload[id] = eventInstanceGroup; | |
} | |
} | |
this.timeGrid.handleEventsSet(timedPayload); | |
if (this.dayGrid) { | |
this.dayGrid.handleEventsSet(allDayPayload); | |
} | |
}, | |
addOrUpdateEventInChildren: function(id, eventInstanceGroup) { | |
if (!eventInstanceGroup.getEventDef().isAllDay()) { | |
this.timeGrid.handleEventAddOrUpdate(id, eventInstanceGroup); | |
} | |
else if (this.dayGrid) { | |
this.dayGrid.handleEventAddOrUpdate(id, eventInstanceGroup); | |
} | |
}, | |
/* Dragging (for events and external elements) | |
------------------------------------------------------------------------------------------------------------------*/ | |
// A returned value of `true` signals that a mock "helper" event has been rendered. | |
renderDrag: function(eventFootprints, seg, isTouch) { | |
if (eventFootprints.length) { | |
if (!eventFootprints[0].componentFootprint.isAllDay) { | |
return this.timeGrid.renderDrag(eventFootprints, seg, isTouch); | |
} | |
else if (this.dayGrid) { | |
return this.dayGrid.renderDrag(eventFootprints, seg, isTouch); | |
} | |
} | |
}, | |
/* Selection | |
------------------------------------------------------------------------------------------------------------------*/ | |
// Renders a visual indication of a selection | |
renderSelectionFootprint: function(componentFootprint) { | |
if (!componentFootprint.isAllDay) { | |
this.timeGrid.renderSelectionFootprint(componentFootprint); | |
} | |
else if (this.dayGrid) { | |
this.dayGrid.renderSelectionFootprint(componentFootprint); | |
} | |
} | |
}); | |
// Methods that will customize the rendering behavior of the AgendaView's timeGrid | |
// TODO: move into TimeGrid | |
var agendaTimeGridMethods = { | |
// Generates the HTML that will go before the day-of week header cells | |
renderHeadIntroHtml: function() { | |
var view = this.view; | |
var calendar = view.calendar; | |
var dateProfile = this.get('dateProfile'); | |
var weekStart = calendar.msToUtcMoment(dateProfile.renderUnzonedRange.startMs, true); | |
var weekText; | |
if (this.opt('weekNumbers')) { | |
weekText = weekStart.format(this.opt('smallWeekFormat')); | |
return '' + | |
'<th class="fc-axis fc-week-number ' + calendar.theme.getClass('widgetHeader') + '" ' + view.axisStyleAttr() + '>' + | |
view.buildGotoAnchorHtml( // aside from link, important for matchCellWidths | |
{ date: weekStart, type: 'week', forceOff: this.colCnt > 1 }, | |
htmlEscape(weekText) // inner HTML | |
) + | |
'</th>'; | |
} | |
else { | |
return '<th class="fc-axis ' + calendar.theme.getClass('widgetHeader') + '" ' + view.axisStyleAttr() + '></th>'; | |
} | |
}, | |
// Generates the HTML that goes before the bg of the TimeGrid slot area. Long vertical column. | |
renderBgIntroHtml: function() { | |
var view = this.view; | |
return '<td class="fc-axis ' + view.calendar.theme.getClass('widgetContent') + '" ' + view.axisStyleAttr() + '></td>'; | |
}, | |
// Generates the HTML that goes before all other types of cells. | |
// Affects content-skeleton, helper-skeleton, highlight-skeleton for both the time-grid and day-grid. | |
renderIntroHtml: function() { | |
var view = this.view; | |
return '<td class="fc-axis" ' + view.axisStyleAttr() + '></td>'; | |
} | |
}; | |
// Methods that will customize the rendering behavior of the AgendaView's dayGrid | |
var agendaDayGridMethods = { | |
// Generates the HTML that goes before the all-day cells | |
renderBgIntroHtml: function() { | |
var view = this.view; | |
return '' + | |
'<td class="fc-axis ' + view.calendar.theme.getClass('widgetContent') + '" ' + view.axisStyleAttr() + '>' + | |
'<span>' + // needed for matchCellWidths | |
view.getAllDayHtml() + | |
'</span>' + | |
'</td>'; | |
}, | |
// Generates the HTML that goes before all other types of cells. | |
// Affects content-skeleton, helper-skeleton, highlight-skeleton for both the time-grid and day-grid. | |
renderIntroHtml: function() { | |
var view = this.view; | |
return '<td class="fc-axis" ' + view.axisStyleAttr() + '></td>'; | |
} | |
}; | |
;; | |
var AGENDA_ALL_DAY_EVENT_LIMIT = 5; | |
// potential nice values for the slot-duration and interval-duration | |
// from largest to smallest | |
var AGENDA_STOCK_SUB_DURATIONS = [ | |
{ hours: 1 }, | |
{ minutes: 30 }, | |
{ minutes: 15 }, | |
{ seconds: 30 }, | |
{ seconds: 15 } | |
]; | |
fcViews.agenda = { | |
'class': AgendaView, | |
defaults: { | |
allDaySlot: true, | |
slotDuration: '00:30:00', | |
slotEventOverlap: true // a bad name. confused with overlap/constraint system | |
} | |
}; | |
fcViews.agendaDay = { | |
type: 'agenda', | |
duration: { days: 1 } | |
}; | |
fcViews.agendaWeek = { | |
type: 'agenda', | |
duration: { weeks: 1 } | |
}; | |
;; | |
/* | |
Responsible for the scroller, and forwarding event-related actions into the "grid". | |
*/ | |
var ListView = View.extend({ | |
segSelector: '.fc-list-item', // which elements accept event actions | |
//eventRendererClass is below | |
//eventPointingClass is below | |
scroller: null, | |
contentEl: null, | |
dayDates: null, // localized ambig-time moment array | |
dayRanges: null, // UnzonedRange[], of start-end of each day | |
constructor: function() { | |
View.apply(this, arguments); | |
this.scroller = new Scroller({ | |
overflowX: 'hidden', | |
overflowY: 'auto' | |
}); | |
}, | |
renderSkeleton: function() { | |
this.el.addClass( | |
'fc-list-view ' + | |
this.calendar.theme.getClass('listView') | |
); | |
this.scroller.render(); | |
this.scroller.el.appendTo(this.el); | |
this.contentEl = this.scroller.scrollEl; // shortcut | |
}, | |
unrenderSkeleton: function() { | |
this.scroller.destroy(); // will remove the Grid too | |
}, | |
updateSize: function(totalHeight, isAuto, isResize) { | |
this.scroller.setHeight(this.computeScrollerHeight(totalHeight)); | |
}, | |
computeScrollerHeight: function(totalHeight) { | |
return totalHeight - | |
subtractInnerElHeight(this.el, this.scroller.el); // everything that's NOT the scroller | |
}, | |
handleDateProfileSet: function(dateProfile) { | |
View.prototype.handleDateProfileSet.apply(this, arguments); | |
var calendar = this.calendar; | |
var dayStart = calendar.msToUtcMoment(dateProfile.renderUnzonedRange.startMs, true); | |
var viewEnd = calendar.msToUtcMoment(dateProfile.renderUnzonedRange.endMs, true); | |
var dayDates = []; | |
var dayRanges = []; | |
while (dayStart < viewEnd) { | |
dayDates.push(dayStart.clone()); | |
dayRanges.push(new UnzonedRange( | |
dayStart, | |
dayStart.clone().add(1, 'day') | |
)); | |
dayStart.add(1, 'day'); | |
} | |
this.dayDates = dayDates; | |
this.dayRanges = dayRanges; | |
// TODO: easy to forget. use listener. | |
this.eventRenderer.rangeUpdated(); | |
}, | |
// slices by day | |
componentFootprintToSegs: function(footprint) { | |
var dayRanges = this.dayRanges; | |
var dayIndex; | |
var segRange; | |
var seg; | |
var segs = []; | |
for (dayIndex = 0; dayIndex < dayRanges.length; dayIndex++) { | |
segRange = footprint.unzonedRange.intersect(dayRanges[dayIndex]); | |
if (segRange) { | |
seg = { | |
startMs: segRange.startMs, | |
endMs: segRange.endMs, | |
isStart: segRange.isStart, | |
isEnd: segRange.isEnd, | |
dayIndex: dayIndex | |
}; | |
segs.push(seg); | |
// detect when footprint won't go fully into the next day, | |
// and mutate the latest seg to the be the end. | |
if ( | |
!seg.isEnd && !footprint.isAllDay && | |
footprint.unzonedRange.endMs < dayRanges[dayIndex + 1].startMs + this.nextDayThreshold | |
) { | |
seg.endMs = footprint.unzonedRange.endMs; | |
seg.isEnd = true; | |
break; | |
} | |
} | |
} | |
return segs; | |
}, | |
eventRendererClass: EventRenderer.extend({ | |
renderFgSegs: function(segs) { | |
if (!segs.length) { | |
this.component.renderEmptyMessage(); | |
} | |
else { | |
this.component.renderSegList(segs); | |
} | |
}, | |
// generates the HTML for a single event row | |
fgSegHtml: function(seg) { | |
var view = this.view; | |
var calendar = view.calendar; | |
var theme = calendar.theme; | |
var eventFootprint = seg.footprint; | |
var eventDef = eventFootprint.eventDef; | |
var componentFootprint = eventFootprint.componentFootprint; | |
var url = eventDef.url; | |
var classes = [ 'fc-list-item' ].concat(this.getClasses(seg.footprint)); | |
var bgColor = this.getBgColor(seg.footprint); | |
var timeHtml; | |
if (componentFootprint.isAllDay) { | |
timeHtml = view.getAllDayHtml(); | |
} | |
// if the event appears to span more than one day | |
else if (view.isMultiDayRange(componentFootprint.unzonedRange)) { | |
if (seg.isStart || seg.isEnd) { // outer segment that probably lasts part of the day | |
timeHtml = htmlEscape(this._getTimeText( | |
calendar.msToMoment(seg.startMs), | |
calendar.msToMoment(seg.endMs), | |
componentFootprint.isAllDay | |
)); | |
} | |
else { // inner segment that lasts the whole day | |
timeHtml = view.getAllDayHtml(); | |
} | |
} | |
else { | |
// Display the normal time text for the *event's* times | |
timeHtml = htmlEscape(this.getTimeText(eventFootprint)); | |
} | |
if (url) { | |
classes.push('fc-has-url'); | |
} | |
return '<tr class="' + classes.join(' ') + '">' + | |
(this.displayEventTime ? | |
'<td class="fc-list-item-time ' + theme.getClass('widgetContent') + '">' + | |
(timeHtml || '') + | |
'</td>' : | |
'') + | |
'<td class="fc-list-item-marker ' + theme.getClass('widgetContent') + '">' + | |
'<span class="fc-event-dot"' + | |
(bgColor ? | |
' style="background-color:' + bgColor + '"' : | |
'') + | |
'></span>' + | |
'</td>' + | |
'<td class="fc-list-item-title ' + theme.getClass('widgetContent') + '">' + | |
'<a' + (url ? ' href="' + htmlEscape(url) + '"' : '') + '>' + | |
htmlEscape(eventDef.title || '') + | |
'</a>' + | |
'</td>' + | |
'</tr>'; | |
}, | |
// like "4:00am" | |
computeEventTimeFormat: function() { | |
return this.opt('mediumTimeFormat'); | |
} | |
}), | |
eventPointingClass: EventPointing.extend({ | |
// for events with a url, the whole <tr> should be clickable, | |
// but it's impossible to wrap with an <a> tag. simulate this. | |
handleClick: function(seg, ev) { | |
var url; | |
EventPointing.prototype.handleClick.apply(this, arguments); // super. might prevent the default action | |
// not clicking on or within an <a> with an href | |
if (!$(ev.target).closest('a[href]').length) { | |
url = seg.footprint.eventDef.url; | |
if (url && !ev.isDefaultPrevented()) { // jsEvent not cancelled in handler | |
window.location.href = url; // simulate link click | |
} | |
} | |
} | |
}), | |
renderEmptyMessage: function() { | |
this.contentEl.html( | |
'<div class="fc-list-empty-wrap2">' + // TODO: try less wraps | |
'<div class="fc-list-empty-wrap1">' + | |
'<div class="fc-list-empty">' + | |
htmlEscape(this.opt('noEventsMessage')) + | |
'</div>' + | |
'</div>' + | |
'</div>' | |
); | |
}, | |
// render the event segments in the view | |
renderSegList: function(allSegs) { | |
var segsByDay = this.groupSegsByDay(allSegs); // sparse array | |
var dayIndex; | |
var daySegs; | |
var i; | |
var tableEl = $('<table class="fc-list-table ' + this.calendar.theme.getClass('tableList') + '"><tbody/></table>'); | |
var tbodyEl = tableEl.find('tbody'); | |
for (dayIndex = 0; dayIndex < segsByDay.length; dayIndex++) { | |
daySegs = segsByDay[dayIndex]; | |
if (daySegs) { // sparse array, so might be undefined | |
// append a day header | |
tbodyEl.append(this.dayHeaderHtml(this.dayDates[dayIndex])); | |
this.eventRenderer.sortEventSegs(daySegs); | |
for (i = 0; i < daySegs.length; i++) { | |
tbodyEl.append(daySegs[i].el); // append event row | |
} | |
} | |
} | |
this.contentEl.empty().append(tableEl); | |
}, | |
// Returns a sparse array of arrays, segs grouped by their dayIndex | |
groupSegsByDay: function(segs) { | |
var segsByDay = []; // sparse array | |
var i, seg; | |
for (i = 0; i < segs.length; i++) { | |
seg = segs[i]; | |
(segsByDay[seg.dayIndex] || (segsByDay[seg.dayIndex] = [])) | |
.push(seg); | |
} | |
return segsByDay; | |
}, | |
// generates the HTML for the day headers that live amongst the event rows | |
dayHeaderHtml: function(dayDate) { | |
var mainFormat = this.opt('listDayFormat'); | |
var altFormat = this.opt('listDayAltFormat'); | |
return '<tr class="fc-list-heading" data-date="' + dayDate.format('YYYY-MM-DD') + '">' + | |
'<td class="' + this.calendar.theme.getClass('widgetHeader') + '" colspan="3">' + | |
(mainFormat ? | |
this.buildGotoAnchorHtml( | |
dayDate, | |
{ 'class': 'fc-list-heading-main' }, | |
htmlEscape(dayDate.format(mainFormat)) // inner HTML | |
) : | |
'') + | |
(altFormat ? | |
this.buildGotoAnchorHtml( | |
dayDate, | |
{ 'class': 'fc-list-heading-alt' }, | |
htmlEscape(dayDate.format(altFormat)) // inner HTML | |
) : | |
'') + | |
'</td>' + | |
'</tr>'; | |
} | |
}); | |
;; | |
fcViews.list = { | |
'class': ListView, | |
buttonTextKey: 'list', // what to lookup in locale files | |
defaults: { | |
buttonText: 'list', // text to display for English | |
listDayFormat: 'LL', // like "January 1, 2016" | |
noEventsMessage: 'No events to display' | |
} | |
}; | |
fcViews.listDay = { | |
type: 'list', | |
duration: { days: 1 }, | |
defaults: { | |
listDayFormat: 'dddd' // day-of-week is all we need. full date is probably in header | |
} | |
}; | |
fcViews.listWeek = { | |
type: 'list', | |
duration: { weeks: 1 }, | |
defaults: { | |
listDayFormat: 'dddd', // day-of-week is more important | |
listDayAltFormat: 'LL' | |
} | |
}; | |
fcViews.listMonth = { | |
type: 'list', | |
duration: { month: 1 }, | |
defaults: { | |
listDayAltFormat: 'dddd' // day-of-week is nice-to-have | |
} | |
}; | |
fcViews.listYear = { | |
type: 'list', | |
duration: { year: 1 }, | |
defaults: { | |
listDayAltFormat: 'dddd' // day-of-week is nice-to-have | |
} | |
}; | |
;; | |
return FC; // export for Node/CommonJS | |
}); |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment