jsUI-Calendar
var mycalendar = new Object();
mycalendar = calendarNew("mycalendar", "default", document.getElementById("calendarCell"), null);
var currentDate = new Date();
mycalendar.setDate(currentDate);
mycalendar.createEvent = doNewEvent;
mycalendar.addEvent("event1", objStartDate, objEndDate, null, "event summary", "blue", "calendar1");
A calendar control that can be used as read-only, read/write, or as a selection control. It is compatible with Internet Explorer 5.0 and FireFox 1.0 or better.
jsUI-Global/common.js
jsUI-Global/uiCommon.js
jsUI-Calendar/component.js
index.htm
Gets date the calendar is using as the current, or today's, date. Read only.
alert(mycalendar.calendarDate);
Gets date of the currently selected day on the calendar. Read only.
alert(mycalendar.selectedDate);
The collection of event objects the calendar has in memory. Read only.
alert(mycalendar.events.length);
The DOM object to which the calendar is attached. Frequently a DIV or TD.
alert (mycalendar.calendarParent.id);
DOM Object. This property is assigned on instantiation and is read only.
Gets or sets a pointer to an optional instance of a jsUI-Textbox object. Used to validate input.
mycalendar.textChecker = mytextChecker;
Javascript Pointer. This value only needs to be set if a jsUI-Textbox object is available to the calendar.
Providing a jsUI-Textbox for the calendar provides error handling and improves functionality.
Gets or sets the string value representing the path to the root of the jsObjects directory. Used for calculating style and graphics file paths. Initially set during instantiation.
mycalendar.rootDir = "http://localhost/libraries/jsobjects";
http://<server>/jsObjects
String. This value only needs to be set if jsObjects is installed in a custom location.
Instantiates the calendar through assignment into a Javascript object.
Required. The name for the new calendar. Must match the name of an empty Javascript object to contain the calendar.
Optional. The name of the CSS (excluding the extension and path) file to use for the calendar. If left blank, "default" will be used.
Optional. The DOM object that the calendar is to be attached to. If no value is passed, the calendar will be appended to document.body
Optional. The path to the root of the jsObjects directory. If left blank, the default path will be used.
var mycalendar = new Object();
mycalendar = calendarNew("mycalendar", "default", document.getElementById("calendarCell"), null);
The calendar object.
This is the only method that does not appear to be a member of the object -- because the object can't have members until it's instantiated. A blank object is created and will be filled with the jsUI-Calendar members.
Sets the current date of the calendar. This must be done before the user can interact with the calendar.
Required. A javascript Date object containing the date to use as "today".
Nothing
Modifies the status area to provide feedback for, or interaction with, the user.
Required. The type of information to be displayed in the status area. Valid types are:
WORKING - Displays a spinning graphic to indicate the application is processing data, as well as any message passed in the text parameter.
DATE - Default state. Displays the calendar's current month and year.
CHANGE - Provides an interface to allow the user to change to a specific month and year.
Optional. The text to display in the status area (if applicable).
Nothing
Used to add an event to the calendar.
Required. A unique ID for the new event.
Required. An object containing the start date and time for the event.
Optional. An object containing the end date and time for the event.
Optional. The duration, in hours, for the event.
Required. The title (tooltip) text for the event.
Optional. The description or name of the event.
Optional. The colour the event text should appear in. Defaults to skin value.
Optional. The name of the calendar the event exists in -- in case multiple calendars are being represented in the same interface.
Nothing
Used to remove all events, or a single specific event from the calendar. Causes a redraw.
Optional. The unique event ID to remove. If null, all events will be removed.
Nothing
Used to redraw the calendar when the page resizes.
<body onresize="mycalendar.redraw()">
Nothing
Fires whenever the user nagivates to a new month or year.
mycalendar.dateChanged = handler;
The handler should accept one date parameter which will contain the new calendar date.
Fires when the user double-clicks a date cell on the calendar, allowing the external code to provide an interface for creating a date.
mycalendar.beforeCreateEvent = handler;
The handler should accept one date parameter which will contain the date the user selected.
Fires when the user double-clicks the calendar title, allowing the external code to provide an interface for choosing a new date. If null the default date selector will be presented.
mycalendar.dateSelector = handler;
The handler is responsible for setting the new date.