TimeSpinner

compared with
Key
These lines were removed. This word was removed.
These lines were added. This word was added.

View page history


There are 4 changes. View first change.

 h3. TimeSpinner
  
 The TimeSpinner component uses a mobility-designed time selection component and may be rendered depending on whether the mobile operating system is using iOS5 or not and it is enabled by using the useNative attribute. If the device is running iOS5, then the option to choose the inherent date selection component is used (so for iPhone, iPad running iOS5) the native timeSelection may be used (html5 input tag with type="time"). If iOS5 is not detected, then the <mobi:dateSpinner/> component renders a mobility designed non-browser solution which with popup selector, styled with <mobi:deviceStyleSheet/>. This component has mobi:ajax support.
  The TimeSpinner component uses a mobility-designed time selection component and may be rendered depending on whether the mobile operating system is using iOS5 or Blackberry and it is enabled by using the useNative attribute. If the device is running iOS5/Blackberry, then the option to choose the inherent date selection component is used (so for iPhone, iPad running iOS5 or Blackberry 6 or greater) the native timeSelection may be used (html5 input tag with type="time"). If iOS5/Blackberry is not detected, then the <mobi:dateSpinner/> component renders a mobility designed non-browser solution which with popup selector, styled with <mobi:deviceStyleSheet/>. This component has mobi:ajax support.
  
 {note}
  
Each device will popup the correct entry spinner that is styled as per the device; Jsf validation and conversion is supported. The non-iOS5 version will actually have built-in conversion for date, so as long as the default pattern of 'yyyy-MM-dd' is used, then no <f:convertDateTime pattern="yyyy-MM-dd" /> tag is required.
 The developer will have to know what platforms they are creating applications for in that some of these options are not applicable to the iOS5 supported inherent selection.
  Each device will popup the correct entry spinner that is styled as per the device; Jsf validation and conversion is supported. The non-iOS5/Blackberry version will actually have built-in conversion for date, so as long as the default pattern of 'yyyy-MM-dd' is used, then no <f:convertDateTime pattern="yyyy-MM-dd" /> tag is required.
 The developer will have to know what platforms they are creating applications for in that some of these options are not applicable to the iOS5/Blackberry supported inherent selection. At this time Chrome as well as stock browser with container may have some support on the Android devices, but it is not yet completely supported, so useNative is not yet supported for Android devices.
  
  
 {note}
  
  
 h3. Usage
  
 h4. How to use.
If want iOS5 timeSpinner enabled if available and using singleSubmit="true"
  If want native html5 timeSpinner enabled if available and using singleSubmit="true"
 {code}
 <mobi:timeSpinner id="timeIOS5" useNative="true" value="#{date.time2}" title="date ios5 cap"
  <mobi:timeSpinner useNative="true" value="#{date.time2}" title="date ios5 cap"
  singleSubmit="#{date.singleSubmit}">
  </mobi:timeSpinner>
 {code}
  
 {panel}
 *readonly* *disabled
 {panel}
 *singleSubmit* if true, submits itself (element) and triggers a full page response using the ICEfaces dom-diff algorithm (in other words, only what has changed on the view page). If false, then the field is not submitted until the form is. ** Note that with the various popup widgets, this isn't necessarily working for all browsers/devices. It is unclear as to whether it is even desirable at this time. Will see what users/developers want first before complete implementation.
 {panel}
  
 h4. for this component
  
 {panel}
 {panel}{*}pattern* currently only supports "hh:mm a"
 {panel}
 {panel}{*}timeZone* for built in conversion so convertDateTime tag not required for this component
 {panel}
 {panel}{*}locale* for built in conversion so convertDateTime tag not required for this component
 {panel}
  
 {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/icemobile/v1_latest/tld/mobi/timeSpinner.html].{tip}
  

© Copyright 2017 ICEsoft Technologies Canada Corp.