ICEfaces Tag Reference - Select Input Date

Documentation

Search

Contents

	1.	Introduction
	2.	Getting Started
	3.	ICEfaces Concepts
	4.	Code View Support
	5.	Design View Support
	6.	Tag Object Toolbars
	7.	Server Behaviors
	8.	Property Inspectors
	9.	ICEfaces Tag Reference

10. ICEfaces Tag Reference

Contents > ICEfaces Tag Reference > ice:selectInputDate

ice:selectInputDate

The ice:selectInputDate tag renders a localized dateSelect. Users may select a date by clicking on a date in the displayed month. The displayed month and year can be changed using the arrow buttons. Optionally, the selectInputDate component may be used in popup mode. In this mode an inputText component is rendered that displays the selected date. Users may enter a date directly into the inputText component, or optionally click a button beside the inputText component to display a popup dateSelect view. Selecting a date in the dateSelect closes the popup dateSelect view and updates the selected date.

The selectInputDate component can be used in cases where a date value must be displayed or entered.

In order to highlight a day, following three attributes need to be set with corresponding values:

* highlightClass

* highlightUnit

* highlightValue

(e.g.) ice:selectInputDate highlighClass="newyear" highlightUnit="DAY_OF_YEAR" highlightValue="1"

To highlighting days in more granular fashion, the attributes above can be set to define more then one rule by separating them with : colon.

(e.g.) ice:selectInputDate highlighClass="newyear: weekend" highlightUnit="DAY_OF_YEAR: DAY_OF_WEEK" highlightValue="1: 7"

A rule can be set to define more then one value using comma ",".

(e.g.) ice:selectInputDate highlighClass="newyear: weekend" highlightUnit="DAY_OF_YEAR: DAY_OF_WEEK" highlightValue="1: 1, 7"

Example

<ice:selectInputDate renderAsPopup="true"></ice:selectInputDate>

Rendered Output

Rendered ice:selectInputDate tag

Tag Attributes

autocomplete	Text

The autocomplete attribute is a boolean flag that when set to "true" passes through to the root element.

binding	Expression

The value-binding expression linking this component tag to a backing bean property.

converter	Text

The converter attribute sets the converter instance to be registered for this component. It must match the converter-id value of a converter element defined in your Faces configuration file.

dir	Enumerated

The dir attribute is a standard HTML attribute that overrides the default text directionality for this component. The values accepted for this component are "LTR" (left-to-right) and "RTL" (right-to-left).

disabled	Boolean

The disabled attribute is a boolean flag that when set to true indicates that this component should not receive focus or be included in a form submit.

enabledOnUserRole	Text

The enabledOnUserRole attribute is a boolean flag that when set to "true" and if a role has been configured for the user, then the component will be displayed and will function. If the user does not have a role, then the component will be disabled (will not function) and will be grayed out.

highlightClass	CSS Class

The highlightClass attribute sets class(s) for days to be highlighted. Note: In order to highlight a day, following three attributes need to be set with corresponding values: 1. highlightClass 2. highlightUnit 3. highlightValue

highlightUnit	Enumerated

The highlightUnit attribute sets the level where highlight needs to be applied. The valid values can be set using the following java.util.Calendar constants: * YEAR * MONTH * WEEK_OF_YEAR * WEEK_OF_MONTH * DATE * DAY_OF_YEAR * DAY_OF_WEEK * DAY_OF_WEEK_IN_MONTH The units above can be defined using a String representation or as constant as well (e.g.) *.jsp equivalent to bean public String getHighlightUnit() { return String.valueOf(Calendar.YEAR); } Note: In order to highlight a day, following three attributes need to be set with corresponding values: 1. highlightClass 2. highlightUnit 3. highlightValue

highlightValue	Text

The highlightValue attribute sets the value to be highlighted appropriate to the corresponding highlightUnit attribute. (e.g.) MONTH = 1 to 12 DAY_OF_WEEK = 1 to 7 Note: In order to highlight a day, following three attributes need to be set with corresponding values: 1. highlightClass 2. highlightUnit 3. highlightValue

id	Text

The unique identifier value for this component. The value must be unique within the closest naming container.

imageDir	Text

The imageDir attribute sets the directory location of the tree images. The default directory is /xmlhttp/css/xp/css-images/ which is include in the icefaces.jar.

immediate	Boolean

The immediate attribute is a boolean flag indicating that component events should be sent to registered event listeners immediately rather than after the validation phase of the JSF request processing lifecycle. The immediate flag allows you bypass JSF validation for a particular component.

lang	Text

The lang attribute is a standard HTML attribute that sets the code describing the language to be used in the markup generated by this component.

onclick	Text

The onclick attribute sets the JavaScript code to execute when the mouse pointer is clicked over this element.

ondblclick	Text

The ondblclick attribute sets the JavaScript code to execute when the mouse pointer is double-clicked over this element.

onkeydown	Text

The onkeydown attribute sets the JavaScript code to execute when a key is pressed down over this element.

onkeypress	Text

The onkeypress attribute sets the JavaScript code to execute when a key is pressed and released over this element.

onkeyup	Text

The onkeyup attribute sets the JavaScript code to execute when a key is released over this element.

onmousedown	Text

The onmousedown attribute sets the JavaScript code to execute when the mouse pointer is pressed down over this element.

onmousemove	Text

The onmousemove attribute sets the JavaScript code to execute when the mouse pointer is moved within this element.

onmouseout	Text

The onmouseout attribute sets the JavaScript code to execute when the mouse pointer is moved away from this element.

onmouseover	Text

The onmouseover attribute sets the JavaScript code to execute when the mouse pointer is moved onto this element.

onmouseup	Text

The onmouseup attribute sets the JavaScript code to execute when the mouse button is released over this element.

popupDateFormat	Text

The popupDateFormat attribute is not used.

renderAsPopup	Boolean

The renderAsPopup attribute displays the input-dateSelect as a java-script popup on client.

rendered	Boolean

A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.

renderedOnUserRole	Text

The renderedOnUserRole attribute is a boolean flag that when set to "true" and if a role has been configured for the user, then the component will be displayed. If the user does not have a role, then the component will not be displayed.

required	Boolean

The required attribute is a boolean flag that indicates whether or not the user is required to provide a value for this field before the form can be submitted to the server.

style	CSS Style

The style attribute sets the CSS style definition to be applied to this component when it is rendered.

styleClass	CSS Class

The styleClass attribute sets the CSS class to apply to this component when it is rendered.

validator	Text

The validator attribute accepts a method-binding expression representing a validator method that will be called when the JSF framework validates this component. A validator method must be a public method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.

value	Text

The value attribute sets the current value for this component.

valueChangeListener	Text

The valueChangeListener attribute accepts a method-binding expression representing a value change listener method to be notified when a new value has been set for this input component. A value change listener method must be a public method that takes a ValueChangeEvent parameter, with a return type of void.

visible	Boolean

The visible attribute is a boolean flag that when set to "true", displays the component. If this attribute is set to "false", then the CSS style is display:none.