| |||||||
FRAMES NO FRAMES |
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:
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" />
Tag Information | |
Tag Class | com.icesoft.faces.component.selectinputdate.SelectInputDateTag |
TagExtraInfo Class | None |
Body Content | JSP |
Display Name | None |
Attributes | ||||
Name | Required | Request-time | Type | Description |
action | false | false | java.lang.String | MethodBinding 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. |
actionListener | false | false | java.lang.String | MethodBinding 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. |
autocomplete | false | false | java.lang.String | Passed through to root element. |
binding | false | false | java.lang.String | The value binding expression linking this component to a property in a backing bean |
converter | false | false | java.lang.String | Converter 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. |
converterMessage | false | false | java.lang.String | A ValueExpression enabled attribute that, if present, will be used as the text of the converter message, replacing any message that comes from the converter. |
dir | false | false | java.lang.String | Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left). |
disabled | false | false | java.lang.String | Flag indicating that this element must never receive focus or be included in a subsequent submit. |
enabledOnUserRole | false | false | java.lang.String | If user is in given role, this component will be rendered normally. If not, the component will be in disabled state. |
highlightClass | false | false | java.lang.String | This attribute defines class(s) for days to be highlighted.
|
highlightUnit | false | false | java.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:
*.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:
|
highlightValue | false | false | java.lang.String | This attribute defines the value to be highlighted appropriate to the corresponding highlightUnit attribute. (e.g.)
|
id | false | false | java.lang.String | The component identifier for this component. This value must be unique within the closest parent component that is a naming container. |
imageDir | false | false | java.lang.String | Set 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. |
immediate | false | false | java.lang.String | Flag 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. |
inputTitle | false | false | java.lang.String | Tooltip for the text input field. |
lang | false | false | java.lang.String | Code describing the language used in the generated markup for this component. |
maxlength | false | false | java.lang.String | The maximum number of characters that may be entered in this field. |
onclick | false | false | java.lang.String | No Description |
ondblclick | false | false | java.lang.String | No Description |
onkeydown | false | false | java.lang.String | No Description |
onkeypress | false | false | java.lang.String | No Description |
onkeyup | false | false | java.lang.String | No Description |
onmousedown | false | false | java.lang.String | No Description |
onmousemove | false | false | java.lang.String | No Description |
onmouseout | false | false | java.lang.String | No Description |
onmouseover | false | false | java.lang.String | No Description |
onmouseup | false | false | java.lang.String | No Description |
partialSubmit | false | false | java.lang.String | Enable component to perform partial submit. Default value is true. |
popupDateFormat | false | false | java.lang.String | DEPRECATED 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 |
readonly | false | false | java.lang.String | Flag 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". |
renderAsPopup | false | false | java.lang.String | If 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. |
renderMonthAsDropdown | false | false | java.lang.String | If 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. |
renderWeekNumbers | false | false | java.lang.String | Whether to render the week numbers of the year. Default is false. |
renderYearAsDropdown | false | false | java.lang.String | If 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. |
rendered | false | false | java.lang.String | Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. |
renderedOnUserRole | false | false | java.lang.String | If 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. |
required | false | false | java.lang.String | Flag indicating that the user is required to provide a submitted value for this input component. |
requiredMessage | false | false | java.lang.String | A 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. |
style | false | false | java.lang.String | CSS style(s) to be applied when this component is rendered. |
styleClass | false | false | java.lang.String | Defines the base class name for all style classes. Default value is iceSelInpDate if enabled
|
tabindex | false | false | java.lang.String | Position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767. |
title | false | false | java.lang.String | Advisory title information about markup elements generated for this component. |
validator | false | false | java.lang.String | MethodBinding 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. |
validatorMessage | false | false | java.lang.String | A ValueExpression enabled attribute that, if present, will be used as the text of the validator message, replacing any message that comes from the validator. |
value | false | false | java.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. |
valueChangeListener | false | false | java.lang.String | MethodBinding 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. |
visible | false | false | java.lang.String | Set the visibility of this component. When false CSS style is set to display:none |
Variables | No Variables Defined. |
| |||||||
FRAMES NO FRAMES |