resources (as a function)

A custom function for programmatically generating raw Resources objects. This allows for any sort of asynchronous means of obtaining the resource list.

function( fetchInfo, successCallback, failureCallback ) { }

The function is given a successCallback argument that should be called with an array of raw Resource objects:

var calendar = new Calendar(calendarEl, {

  resources: function(fetchInfo, successCallback, failureCallback) {
    somethingAsynchonous(function(resources) {
      successCallback(resources);
    });
  }

});

If there is some sort of failure, for example, if an AJAX request should fail, then call the failureCallback instead. It accepts an argument with information about the failure.

Instead of calling successCallback and failureCallback, you may return a Promise-like object instead.

Fetching based on current date

If refetchResourcesOnNavigate is set to true, the resources function’s fetchInfo argument will be populated with some useful arguments. It will receive the start and end dates for the newly visible window of time as well as the calendar’s timezone:

var calendar = new Calendar(calendarEl, {

  refetchResourcesOnNavigate: true,

  resources: function(fetchInfo, successCallback, failureCallback) {
    somethingAsynchonous({
      start: fetchInfo.start,
      end: fetchInfo.end,
      timeZone: fetchInfo.timeZone
    }, function(resources) {
      successCallback(resources);
    });
  }

});

Complete list of properties in fetchInfo:

start	A Date for the beginning of the range the calendar needs events for.
end	A Date for the end of the range the calendar needs events for. Note: This value is exclusive. For example, an event with the `end` of `2018-09-03` will appear to span through `2018-09-02`, but end before the start of `2018-09-03`. See how events are are parsed from a plain object for further details.
startStr	An ISO8601 string representation of the start date. Will have a time zone offset according to the calendar’s timeZone like `2018-09-01T12:30:00-05:00`.
endStr	Just like `startStr`, but for the `end` date.
timeZone	The exact value of the calendar’s timeZone setting.

Methods

Callbacks

See Also

resources (as a function)

Fetching based on current date