Differences between revisions 6 and 7
Revision 6 as of 2007-03-13 11:17:02
Size: 2964
Comment:
Revision 7 as of 2009-09-20 23:00:42
Size: 2966
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 18: Line 18:
[http://myfaces.apache.org/tomahawk/calendar.html] [[http://myfaces.apache.org/tomahawk/calendar.html]]
Line 88: Line 88:
-- ArashRajaeeyan [[DateTime(2006-10-31T11:40:00Z)]] -- ArashRajaeeyan <<DateTime(2006-10-31T11:40:00Z)>>

Description

Renders a calendar component allowing to choose a date from a month view. Change the month by navigating in the header bar. The calendar component is automatically rendered using the week-names, the month-names and the start of the week of the current locale, so localisation support is given (for an example, see {calendar.jsp} in myfaces examples and change the current locale under options).

Calendar can be rendered as a pop-up, displaying week numbers in addition to the month view described above.

Screen Shot

API

component-family

javax.faces.Data

renderer-type

org.apache.myfaces.Buffer

component-class

org.apache.myfaces.custom.buffer.Buffer

renderer-class

org.apache.myfaces.custom.buffer.BufferRenderer

tag-class

org.apache.myfaces.custom.buffer.BufferTag

http://myfaces.apache.org/tomahawk/calendar.html

Usage

<t:inputCalendar
   [ HTML universal attributes ]
   [ HTML event handler attributes ]
   [ UIInput standard attributes (i.e. valueChangeListener) ]
   [monthYearRowClass="month-and-year-header-row-css-class"]
   [weekRowClass="week-header-row-css-class"]
   [dayCellClass="empty-or-date-cell-css-class"]
   [currentDayCellClass="currently-selected-day-cell-css-class"]
   [helpText="MM/DD/YYYY"]
   [renderAsPopup="_false_"|"true"]
   [popupButtonStyleClass="css-class"]
   [popupDateFormat="MM/dd/yyyy"]
   [popupTodayString="Today is :"]
   [popupWeekString="Wk"]
   [renderPopupButtonAsImage="_false_"|"true"]
>
</t:inputCalendar>

Syntax

<t:inputCalendar
   [ ui_input_attributes ]
   [ html_event_handler_attributes ]
   [ html_universal_attributes ]
   [ html_input_attributes ]
   [ user_role_attributes ]
   [ ext_forceId_attribute ]
   tomahawk_input_calendar_attributes
   [ alt_location_attributes ]
   [ display_value_only_attributes ]
</t:inputCalendar>

Instructions

Standard core tags (i.e. a new Converter can be set for value-bindings to values other than java.util.Date).

Attributes

name

required

description

Configuration

Don't need any extra configuration.

Notes and Known issues

Some known issues like incompatibility to other frameworks/component libs

When the component is used within a div which has the position set absolute, the popup calendar will be displayed way off from the button. No known solution at the moment.

Example:

<div style="position: absolute; top: 150.0em; left: 27.0em; right: 35px; ">
  <t:inputCalendar renderPopupButtonAsImage="true" renderAsPopup="true">
  </t:inputCalendar>                                                    
</div>

Examples

Link to irian and additional notes.

FAQ

Post your (or potential) questions here.

Additional Information

-- ArashRajaeeyan 2006-10-31 11:40:00

InputCalendar (last edited 2009-09-20 23:00:42 by localhost)