ICEfaces ACE Components
Tag schedule


A calendar with month, week, and day views that displays events and information about them. There are multiple ways to configure the component for a more custom user experience including scrolling, side bar location, event details display mode, tooltip, twelve-hour clock, default duration, enhanced styling and others. The component uses instances of org.icefaces.ace.model.schedule.ScheduleEvent to represent events. The dates must be stored internally in UTC time. They are converted to the time zone specified by the 'timeZone' attribute to display to the user. The class org.icefaces.ace.component.schedule.ScheduleUtils contains utility functions to help with conversion.
Client Events
NameDescriptionSupported Classes for ArgumentDefault Event Scopes
eventClickFired when the user clicks on an event in the schedule. The listener method for this event can take an event object of the type org.icefaces.ace.event.ScheduleClickEvent.javax.faces.event.AjaxBehaviorEventexecute=@this render=@this
dayDblclickFired when the user does double click on a blank area of a day in the month view, which would trigger a dialog to add a new event on that day. The listener method for this event can take an event object of the type org.icefaces.ace.event.ScheduleClickEvent.javax.faces.event.AjaxBehaviorEventexecute=@this render=@this
timeDblclickFired when the user does double click on a blank area of a time cell in the grid of the week and day views, which would trigger a dialog to add a new event starting at that time on that day. The listener method for this event can take an event object of the type org.icefaces.ace.event.ScheduleClickEvent.javax.faces.event.AjaxBehaviorEventexecute=@this render=@this
addEventFired when the user clicks on the 'Add' button in the Event Details dialog to add a new event to the schedule. The listener method for this event can take an event object of the type org.icefaces.ace.event.ScheduleModifyEvent.javax.faces.event.AjaxBehaviorEventexecute=@this render=@this
editEventFired when the user clicks on the 'Save' button in the Event Details dialog to save the changes of an existing event in the schedule. The listener method for this event can take an event object of the type org.icefaces.ace.event.ScheduleModifyEvent.javax.faces.event.AjaxBehaviorEventexecute=@this render=@this
deleteEventFired when the user clicks on the 'Yes' button after having clicked on the 'Delete' button in the Event Details dialog to delete an existing event from the schedule. The listener method for this event can take an event object of the type org.icefaces.ace.event.ScheduleModifyEvent.javax.faces.event.AjaxBehaviorEventexecute=@this render=@this
navNextFired when the user clicks on the right arrow of the schedule viewer to navigate to the next month, week or day. The listener method for this event can take an event object of the type org.icefaces.ace.event.ScheduleNavigationEvent.javax.faces.event.AjaxBehaviorEventexecute=@this render=@this
navPreviousFired when the user clicks on the left arrow of the schedule viewer to navigate to the previous month, week or day. The listener method for this event can take an event object of the type org.icefaces.ace.event.ScheduleNavigationEvent.javax.faces.event.AjaxBehaviorEventexecute=@this render=@this
navSelectionFired when the user clicks on the header of the schedule viewer to select a specific date to navigate to. The listener method for this event can take an event object of the type org.icefaces.ace.event.ScheduleNavigationEvent.javax.faces.event.AjaxBehaviorEventexecute=@this render=@this
Client events can be used with Client Behaviors and the ace:ajax tag.


Tag Information
Tag Classorg.icefaces.ace.component.schedule.ScheduleTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
addEventsnotruebooleanEnable or disable the built-in event addition controls. These controls appear in the popup and sidebar event details view when clicking on an empty area of a day square or an empty time slot. Adding new events this way is only supported if the component value is an instance of any of the following four types: Array, List, Collection, and org.icefaces.ace.model.schedule.LazyScheduleEventList. Default = 'true'.
autoDetectTimeZonenotruebooleanEnabling ignores the 'timeZone' attribute and detects the time zone used by the client and uses it to perform all event operations in the server for this component. Default = 'false'.
bindingnotruejavax.el.ValueExpressionUsing an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean.
defaultDurationnotruejava.lang.IntegerDefines the default duration (in minutes) of new events added by the user if an end date or time was not set. Default = '60'.
deleteEventsnotruebooleanEnable or disable the built-in event deletion controls. These controls appear in the popup and sidebar event details view. Deleting events this way is only supported if the component value is an instance of any of the following four types: Array, List, Collection, and org.icefaces.ace.model.schedule.LazyScheduleEventList. Default = 'true'.
editEventsnotruebooleanEnable or disable the built-in event editing controls. These controls appear in the popup and sidebar event details view. Modifying events this way is only supported if the component value is an instance of any of the following three types: Array, List, and org.icefaces.ace.model.schedule.LazyScheduleEventList. Default = 'true'.
enableViewModeControlsnotruebooleanEnabling renders three buttons to change the view mode to either month, week or day. These buttons are displayed when clicking on the schedule header. Default = 'true'.
enhancedStylingnotruebooleanEnabling applies an original styling to the day and time girds and to the events rendered on them in the month, week, and day views. This original styling makes it easier to read the information contained in the schedule by styling the contents in additional ways not covered by Themeroller themes. This styling is always the same, regardless of the theme being applied. Other parts of the schedule such as the title, sidebar and event details dialog are not affected by this styling. Setting this attribute to false prevents this original styling from being applied, leaving only the theme styling. Default = 'true'.
firstnotrueintZero-relative row number of the first row in the underlying data model to be displayed, or zero to start at the beginning of the data model. Default = '0'.
idnotruejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
renderednotruebooleanReturn true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'.
resizableSidebarnotruebooleanEnabling allows the sidebar to be resizable. Default = 'true'.
rowIndexnotrueintZero-relative index of the row currently being accessed in the underlying DataModel, or -1 for no current row. Default = '0'.
rowsnotrueintThe number of rows (starting with the one identified by the first property) to be displayed, or zero to display the entire set of available rows. Default = '0'.
scrollHeightnotruejava.lang.IntegerDefines a fixed height for the scrollable time grid in pixels. Default = '600'.
scrollablenotruebooleanEnabling renders the time grid of the week and day views in a container that overflows the fixed height and adds a scrollbar.
showEventDetailsnotruejava.lang.StringSpecifies where to display the event details after clicking on an event tag on the calendar. Possible values are 'sidebar', 'popup', and 'disabled'. Default = 'popup'.
showTooltipnotruebooleanSpecifies whether to display a tooltip next to an event, containing the event's detailed information. Default = 'false'.
sideBarnotruejava.lang.StringSpecifies the location of the sidebar or whether it should be hidden. Possible values are 'right', 'left', and 'hidden'. Default = 'right'.
stylenotruejava.lang.StringThe inline style of the component, rendered on the root div of the component.
styleClassnotruejava.lang.StringThe CSS style class of the component, rendered on the root div of the component.
tabindexnotrueintSpecifies the tabindex attribute for the navigation controls ('previous' and 'next' buttons). A value of '0' enables focusing these buttons by pressing the tab key. A value of '-1' disables this behaviour. A value greater than '0' determines a specific order. Default = '0'.
timeZonenotruejava.lang.ObjectA time zone ID String (matching an element of java.util.TimeZone.getAvailableIDs()) or a java.util.TimeZone instance to specify the time zone used for date conversion to and from UTC time. If not specified, the default value is TimeZone.getDefault(), which is the default time zone on the system.
twelveHourClocknotruebooleanEnabling renders the times in the 12-hour clock format. Default = 'false'.
valuenotruejava.lang.ObjectThe value should be a List, Array, DataModel or a type that can be adapted into a DataModel (java.sql.ResultSet, javax.servlet.jsp.jstl.sql.Result, and java.util.Collection). It must contain the org.icefaces.ace.model.schedule.ScheduleEvent objects to be displayed on the schedule. Alternatively, the value can be an implementation of org.icefaces.ace.model.schedule.LazyScheduleEventList to work in a lazy-loading mode.
varnotruejava.lang.StringThe request-scope attribute (if any) under which the data object for the current row will be exposed when iterating.
viewDatenotruejava.util.DateA Date object specifying the date that is currently displayed in the client. This attribute can be used to set an inital date to display or to programmatically set a date to display. This attribute will be automatically updated with the current date being displayed in the client as the user interacts with the component. If the current view mode is set to 'month', this Date object will be automatically changed to the first day of the given month. If the current view mode is set to 'week', this Date object will be automatically changed to the Sunday when the week starts. If the current view mode is set to 'day', this Date object will not change. The time values are irrelevant for this attribute. If this attribute is not specified, the current date is going to be used. This Date object is assumed to be in the time zone specified by the 'timeZone' attribute, unless the attribute 'autoDetectTimeZone' is set to true, in which case this Date object will be assumed to be in the time zone of the client.
viewModenotruejava.lang.StringSpecifies the range of days that should be displayed at a time in the calendar. Possible values are 'month', 'week', 'day'. Default = 'month'.

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.