Constructors
| Name | Type | Description |
|---|---|---|
title |
string |
Set the title of the dialog if the module is displayed in a modal dialog |
viewId |
string |
optional
The viewId of the gadget object (The viewId specifies the destination in the DOM. This destination must exist otherwise the gadget is not rendered.) |
- Since:
- Documents 5.0b
Example
//#import "Gadget_API_Controller"
function gadgetCalendar() {
this.execute = function() {
// Create the gadget and set the title for the dialog
var calendarGadget = new otris.gadget.gui.FullCalendar();
//
// Add sources
//
return calendarGadget.transfer();
}
}
Extends
Methods
-
inherited addClientFunction(clientFunction)
-
Adds a JavaScript Function to this Transferable Object. When the Object is transfered to the client the functions added to this Object will be available on the client side.
Name Type Description clientFunctionfunction The function to be added to the clientFunctions of this Object. (Can be a JavaScript Function or an Object returned by otris.gadget.util.FunctionUtils.getFunctionObject)
-
inherited addContainerButton(buttonConfig){object}
-
Adds a container button.
If the gadget is displayed in a dialog the container buttons are rendered as dialog buttons (bottom right corner of the dialog).
Otherwise the container buttons are ignoredName Type Description buttonConfigobject button config object
Name Type Default Description idstring button id
labelstring button label
clickFunctionstring name of the client function to execute on click
disabledboolean false optional - Since:
- Documents 5.0e
Returns:
Type Description object buttonConfig Example
// Alternative gadget action button gadgetForm.addContainerButton({ id: "myCustomSaveButton", label: "Speichern", clickFunction: "saveGadgetData" }); gadgetForm.addClientFunction(function saveGadgetData(event) { var gForm = documentsContext.getGadgetContext().getClientObject(); gForm.submitForm({ gadgetAction: "processForm" }, { showBusyPanel: true }); }); -
inherited addPdfButton(config)
-
Adds a button to download the displayed gadget as pdf. The button will show on hover in the left top corner of the gadget.
Name Type Description configobject optional config object
Name Type Default Description filenamestring content.pdf optional filename of the pdf for download
buttonStylestring left: 200px; optional style for the pdf button to be applied to
- Since:
- Documents 5.0d
Example
myGadget.addPdfButton({filename: "myCustomFilename.pdf", buttonStyle: "left: 200px; }); -
inherited addSettings(option)
-
Adds a setting (an option that can be defined by the user) to the gadget.
Name Type Description optionGadgetSetting | Array.<GadgetSetting> the setting(s) to add to the gadget.
- Since:
- Documents 5.0a
-
addSource(soure, eventLoader)
-
Add a event source to the calendar
Name Type Description soureFullCalendarSource A fullcalendar source definition
eventLoaderfunction optional eventLoader function for this source. See details
setEventLoader -
inherited onGadgetLoad(onloadHandler)
-
Sets an onLoad handler for the Gadget. The handler is executed when the gadget is displayed at the client.
Name Type Description onloadHandlerfunction | string the handler to be executed (must be either a javascript function or a string representing a function)
-
setConfig(calConfig)
-
Sets the calendar configuration. See fullcalendar documentation (http://fullcalendar.io) for details.
The calendar sources must be added with the addSource() functionName Type Description calConfigobject optional calendar config. See fullcalendar documentation for details
-
inherited setContainerButtons(containerButtonConfigs)
-
Set the container buttons.
Please note that existing default buttons are removed by this operation.Name Type Description containerButtonConfigsArray.<object> array of button config objects
Name Type Default Description idstring button id
labelstring button label
clickFunctionstring name of the client function to execute on click
disabledboolean false optional - Since:
- Documents 5.0e
-
inherited setContextData(contextData)
-
Set additional data which is serialized with
JSON.stringify()and then transferred to the client
On the client side the the context data is accessible with theGadgetContextName Type Description contextDataany the context data
- Since:
- Documents 5.0c
Example
var htmlGadget = new otris.gadget.gui.HTML("<h1>Only a simple example</h1>"); var myGadgetData = { mySpecialId: 44137, myIndexArray: [1,7,6,3,2], myTitle: "A special GadgetTitle" }; htmlGadget.setContextData(myGadgetData); -
setDoubleClickFunction(doubleClickFunction)
-
Set a double click function for the calendar. For example to create new entries on double click
Name Type Description doubleClickFunctionfunction The given function is executed if the caleandar is double clicked
function(Object event, String dateString, DocumentsContext documentsContext)doubleClickFunction(event, dateString, documentsContext)
Double click function
Name Type Description eventobject Event
dateStringstring The date as string of the clicked item
documentsContextdocuments.sdk.DocumentsContext The DocumentsContext instance
-
setEventLoader(Function)
-
Sets the global event loader function. The registered function is called
for every source with no custom event loader function. The function must
return the events for the given source in the specified time rangestart - end
The options object can contain a filter string (options.filter) if the search context is used (see setSearchContext)
Required return format:Array of FullCalendarEventsName Type Description Functionfunction with the following signature:
function eventLoader(FullCalendarSource eventLoaderFunction source, Date start, Date end,(String|Boolean) timezone, (Object) options) -
setLazyLoad(lazyLoad)
-
If set to false the events are all loaded on the first request. The eventLoader functions are called with empty time range params
Name Type Default Description lazyLoadboolean true optional Lazy load the events?
-
inherited setNavibarEntry(gadgetConfig, label)
-
Add a navibar entry. Define a gadgetConfig that reloads the gadget.
Only works if the gadget ist displayed in main list view area.Name Type Description gadgetConfigobject gadgetConfig
labelstring optional label for the navibar entry (defaults to the gadget title)
- Since:
- Documents 5.0e
-
setSearchContext(label, filterFunction)
-
Activates the search context for this calendar.
The parameterfilterFunctionis only necessary if lazyLoad is falseName Type Description labelstring Label for the search box
filterFunctionfunction optional Function with the following signature:
function filterFunction(FullCalendarSource source, String searchExpression)Expects the filtered event array as return value.source.eventsalways contains the initial array.- Since:
- Documents 5.0c
-
inherited setStyle(name, value)
-
Sets a style attribute of the html container
Name Type Description namestring the name of the style parameter (i.e. "height")
valuestring the value of the style parameter (i.e. "100px")
-
inherited setTitle(title)
-
Sets the Title of the Form
Name Type Description titlestring the title of the form (will be displayed as the window header on dashboards)
-
inherited store(key, value)
-
Stores data that can later be accessed on client side.
ATTENTION: The store used in this method is global.
UsesetContextDatato store data for this gadget instance.Name Type Description keystring the key to store the data
valueany the value, or object that should be stored
-
inherited transfer()
-
Creates the Transfer object to send to the client