View Source

h2. Overview
_Since 4.0_

The mobi:timeSpinner component is used for choosing a time of the day on touch devices.

h2. Getting Started

To start using the TimeSpinner component, place the mobi:timeSpinner tag in a form and bind its value to a property of type {{Date}} in a backing bean.
{code:xml}
<h:form>
<mobi:timeSpinner id="time" value="#{bean.time}" />
</h:form>
{code}

h2. Attributes

{tip:title=TagLib Documentation}This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available [here|http://res.icesoft.org/docs/v4_latest/mobi/tld/].{tip}

{panel}
The *value* stores the Date object that represents the time selected.
{panel}

{panel}
The *useNative* flag determines if the device's native time picker should be used.
{panel}

{panel}
The *timeZone* attribute specifies the the time zone used in conversions. The value can be a time zone ID string or an instance of java.util.TimeZone. The default value is TimeZone.getDefault().
{panel}

{panel}
The *pattern* specifies the pattern used to display the time, using java.text.SimpleDateFormat.
{panel}

h2. Event Listeners

None.

h2. Client Behavior Events

| change | Fired when a change is detected in the selected time. |

h2. JavaScript API

None.

h2. Keyboard Support

None.

h2. Known Issues

None.

h2. Additional Resources


h4. Sample Applications

This component appears in the following ICEfaces sample applications:

* *[ICEfaces Mobile Showcase|http://icefaces-showcase.icesoft.org/showcase-mobile.jsf]*

h4. Tutorials

This component appears in the following ICEfaces tutorials:

*None*