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 |
Links to javadoc and tlddoc
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 <<DateTime(2006-10-31T11:40:00Z)>>