ICE Components
Tag selectInputDate


The selectInputDate component 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 arrow buttons or dropdown lists. 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:

  1. highlightClass
  2. highlightUnit
  3. highlightValue
(e.g.) <ice:selectInputDate highlighClass="newyear" highlightUnit="DAY_OF_YEAR" highlightValue="1" />

To highlighting days in more granular fashion, above attributes can be set to defining more then one rules 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 defining more then one values using comma "," (e.g.)
<ice:selectInputDate highlighClass="newyear: weekend" highlightUnit="DAY_OF_YEAR: DAY_OF_WEEK" highlightValue="1: 1, 7" />

NOTE: all 3 highlight attributes should have a corresponding values.
The action and actionListener will only be fired, when "enter" being pressed on a input text in a popup mode.

Time Entry: When the f:convertDateTime is configured to show time, the calendar will include a time editing UI.


Tag Information
Tag Classcom.icesoft.faces.component.selectinputdate.SelectInputDateTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
actionfalsefalsejava.lang.StringMethodBinding representing the application action to invoke when this component is activated by the user. The expression must evaluate to a either a String or a public method that takes no parameters, and returns a String (the logical outcome) which is passed to the NavigationHandler for this application.
actionListenerfalsefalsejava.lang.StringMethodBinding representing an action listener method that will be notified when this component is activated by the user. The expression must evaluate to a public method that takes an ActionEvent parameter, with a return type of void.
autocompletefalsefalsejava.lang.StringPassed through to root element.
bindingfalsefalsejava.lang.StringThe value binding expression linking this component to a property in a backing bean
converterfalsefalsejava.lang.StringConverter instance registered with this component. Converter must be a javax.faces.convert.DateTimeConverter instance, or subclass, which can be accomplished by using the f:convertDateTime tag. Note: DateTimeConverter's default timeZone, if none is specified, is GMT.
converterMessagefalsefalsejava.lang.StringA ValueExpression enabled attribute that, if present, will be used as the text of the converter message, replacing any message that comes from the converter.
dirfalsefalsejava.lang.StringDirection indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
disabledfalsefalsejava.lang.StringFlag indicating that this element must never receive focus or be included in a subsequent submit.
enabledOnUserRolefalsefalsejava.lang.StringIf user is in given role, this component will be rendered normally. If not, the component will be in disabled state.
highlightClassfalsefalsejava.lang.String

This attribute defines 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

highlightUnitfalsefalsejava.lang.String

This attribute defines the level where highlight need 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
Above units can be defined using String representation or as constant as well (e.g.)
*.jsp
<ice:selectInputDate highlightUnit="YEAR".. />
equivalent to
<ice:selectInputDate highlightUnit="1".. />
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

highlightValuefalsefalsejava.lang.String

This attribute defines 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

idfalsefalsejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
imageDirfalsefalsejava.lang.StringSet directory for location of the button images. Deprecated. Use styleClass instead. The style class name for a button is made up of the styleClass name plus a predefined name. For example: with a styleClass name of "myCalendar", the button class names would be: myCalendarMovePrev, myCalendarMoveNext, myCalendarOpenPopup, myCalendarClosePopup. Override the images with the background-image property.
immediatefalsefalsejava.lang.StringFlag indicating that this component's value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until Process Validations phase.
inputTitlefalsefalsejava.lang.StringTooltip for the text input field.
langfalsefalsejava.lang.StringCode describing the language used in the generated markup for this component.
maxlengthfalsefalsejava.lang.StringThe maximum number of characters that may be entered in this field.
onclickfalsefalsejava.lang.StringNo Description
ondblclickfalsefalsejava.lang.StringNo Description
onkeydownfalsefalsejava.lang.StringNo Description
onkeypressfalsefalsejava.lang.StringNo Description
onkeyupfalsefalsejava.lang.StringNo Description
onmousedownfalsefalsejava.lang.StringNo Description
onmousemovefalsefalsejava.lang.StringNo Description
onmouseoutfalsefalsejava.lang.StringNo Description
onmouseoverfalsefalsejava.lang.StringNo Description
onmouseupfalsefalsejava.lang.StringNo Description
partialSubmitfalsefalsejava.lang.StringEnable component to perform partial submit. Default value is true.
popupDateFormatfalsefalsejava.lang.StringDEPRECATED Now one should instead use an f:convertDateTime tag with its pattern attribute. This is the pattern of the simple date format used in the text input, when renderAsPopup = true Also, if the title attribute is not specified, then popupDateFormat will be used to describe the date format, in the title attribute rendered on the text input field, when renderAsPopup = true
readonlyfalsefalsejava.lang.StringFlag indicating that this component will prohibit changes by the user. The element may receive focus unless it has also been disabled. This attribute is valid for input types "text" and "password" only. It is non-functional for other input types like "radio" or "checkbox".
renderAsPopupfalsefalsejava.lang.StringIf true, render the selectInputDate as an inputText field with a button, which when pressed, displays a popup calendar. Else if false, only render the calendar, in-place.
renderMonthAsDropdownfalsefalsejava.lang.StringIf true, the list of months is rendered in a dropdown list. If false (the default), only the specified month is rendered, with left and right arrow buttons to navigate to other months.
renderWeekNumbersfalsefalsejava.lang.StringWhether to render the week numbers of the year. Default is false.
renderYearAsDropdownfalsefalsejava.lang.StringIf true, a list of 11 years is rendered in a dropdown list, with the specified year in the middle, plus a "previous" item and a "next" item to navigate to other years. If false (the default), only the specified year is rendered, with left and right arrow buttons to navigate to other years.
renderedfalsefalsejava.lang.StringFlag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
renderedOnUserRolefalsefalsejava.lang.StringIf user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped.
requiredfalsefalsejava.lang.StringFlag indicating that the user is required to provide a submitted value for this input component.
requiredMessagefalsefalsejava.lang.StringA ValueExpression enabled attribute that, if present, will be used as the text of the validation message for the "required" facility, if the "required" facility is used.
stylefalsefalsejava.lang.StringCSS style(s) to be applied when this component is rendered.
styleClassfalsefalsejava.lang.String

Defines the base class name for all style classes. Default value is iceSelInpDate

if enabled
  • iceSelInpDate
  • iceSelInpDateInput
  • iceSelInpDateMonthYear
  • iceSelInpDateMoYrDropdown
  • iceSelInpDateWeek
  • iceSelInpDateDay
  • iceSelInpDateCur
  • iceSelInpDatePopup
  • iceSelInpDateOpenPopup
  • iceSelInpDateClosePopup
if disabled
  • iceSelInpDate-dis
  • iceSelInpDateInput-dis
  • iceSelInpDateMonthYear-dis
  • iceSelInpDateMovePrev-dis
  • iceSelInpDateMoveNext-dis
  • iceSelInpDateWeek-dis
  • iceSelInpDateDay-dis
  • iceSelInpDatePopup-dis
  • iceSelInpDateOpenPopup-dis
tabindexfalsefalsejava.lang.StringPosition of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767.
titlefalsefalsejava.lang.StringAdvisory title information about markup elements generated for this component.
validatorfalsefalsejava.lang.StringMethodBinding representing a validator method that will be called during Process Validations to perform correctness checks on the value of this component. The expression must evaluate to a public method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.
validatorMessagefalsefalsejava.lang.StringA ValueExpression enabled attribute that, if present, will be used as the text of the validator message, replacing any message that comes from the validator.
valuefalsefalsejava.lang.String

The current value of this component.

All UIInput derived UIComponents, that are placed within a UIData container, such as a dataTable or panelSeries, should have their value attribute bound to a bean property via a ValueBinding/ValueExpression, since otherwise the UIData container will not keep their successfully validated state, which can cause the component to fail to function properly.

valueChangeListenerfalsefalsejava.lang.StringMethodBinding representing a value change listener method that will be notified when a new value has been set for this input component. The expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.
visiblefalsefalsejava.lang.StringSet the visibility of this component. When false CSS style is set to display:none

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.