1 | <!--
|
---|
2 | Copyright (c) 2007 Stretch Media Group
|
---|
3 |
|
---|
4 | Permission is hereby granted, free of charge, to any person
|
---|
5 | obtaining a copy of this software and associated documentation
|
---|
6 | files (the "Software"), to deal in the Software without
|
---|
7 | restriction, including without limitation the rights to use,
|
---|
8 | copy, modify, merge, publish, distribute, sublicense, and/or sell
|
---|
9 | copies of the Software, and to permit persons to whom the
|
---|
10 | Software is furnished to do so, subject to the following
|
---|
11 | conditions:
|
---|
12 |
|
---|
13 | The above copyright notice and this permission notice shall be
|
---|
14 | included in all copies or substantial portions of the Software.
|
---|
15 |
|
---|
16 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
---|
17 | EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
|
---|
18 | OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
---|
19 | NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
|
---|
20 | HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
---|
21 | WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
---|
22 | FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
|
---|
23 | OTHER DEALINGS IN THE SOFTWARE.
|
---|
24 |
|
---|
25 | Features:
|
---|
26 |
|
---|
27 | - Provides time entry for hours, minutes and seconds in 24 and 12 hour format
|
---|
28 | - Resizable to fit various text sizes, and also allows for styling of stepper buttons, border, and background
|
---|
29 | - Can use numeric stepper to increase/decrease hour, minute, second, am/pm entries
|
---|
30 | - Can use keyboard up/down, left/right to increase/decrease hour, minute, second, am/pm entries
|
---|
31 | - Hour, minute, second, am/pm entries wrap if reaching max/min values
|
---|
32 | - Can tab through fields
|
---|
33 | - Can enable/disable component
|
---|
34 | - Easily provide hour/minute/text values for preset/updatable time
|
---|
35 |
|
---|
36 | Properties:
|
---|
37 |
|
---|
38 | hour : the numeric value of the selected hour (if provided, overrides the defaultHour value)
|
---|
39 | minute : the numeric value of the selected minute (if provided, overrides the defaultMinute value)
|
---|
40 | second : the numeric value of the selected second (if provided, overrides the defaultSecond value)
|
---|
41 | am_pm : the string value of the selected am/pm entry ("am", "pm")
|
---|
42 | defaultHour : the hour which you want the selector to default to (is overriden if hour argument is provided)
|
---|
43 | defaultMinute : the minute which you want the selector to default to (is overriden if minute argument is provided)
|
---|
44 | defaultSecond : the second which you want the selector to default to (is overriden if second argument is provided)
|
---|
45 | showSeconds : show seconds entry in selector
|
---|
46 | is24Hour : if false hour selector allows range of 1-12 and am/pm entry is enabled
|
---|
47 | if true hour selector allows range of 0-23 and am/pm entry is disabled
|
---|
48 |
|
---|
49 | Revisions:
|
---|
50 |
|
---|
51 | * 2008.3.3 - added accessibility functionality for hours, minutes, and seconds so that it can be read by JAWS reader.
|
---|
52 |
|
---|
53 | -->
|
---|
54 |
|
---|
55 | <mx:Canvas xmlns:mx="http://www.adobe.com/2006/mxml"
|
---|
56 | creationComplete="createComplete();" tabChildren="true">
|
---|
57 |
|
---|
58 | <mx:NumberValidator id="hourValidator" source="{hourText}" exceedsMaxError="" lowerThanMinError="" integerError=""
|
---|
59 | property="text" maxValue="{maxHour}" minValue="{minHour}"
|
---|
60 | trigger="{hourText}" triggerEvent="change" invalid="hourText.text = String(maxHour); hourText.errorString = '';" />
|
---|
61 | <mx:NumberValidator id="minuteValidator" source="{minuteText}" exceedsMaxError="" lowerThanMinError="" integerError=""
|
---|
62 | property="text" maxValue="59" minValue="0"
|
---|
63 | trigger="{minuteText}" triggerEvent="change" invalid="minuteText.text = '59'" allowNegative="false" />
|
---|
64 | <mx:NumberValidator id="secondValidator" source="{secondText}" exceedsMaxError="" lowerThanMinError="" integerError=""
|
---|
65 | property="text" maxValue="59" minValue="0"
|
---|
66 | trigger="{secondText}" triggerEvent="change" invalid="secondText.text = '59'" allowNegative="false" />
|
---|
67 |
|
---|
68 | <mx:NumericStepper id="timeStepper" x="0" y="0" height="80%" width="100" fontSize="0" textAlign="right" paddingLeft="100"
|
---|
69 | focusAlpha="0" borderThickness="0" borderStyle="none" maximum="99" minimum="-99"
|
---|
70 | change="changeStepValue(event)" backgroundAlpha="0" color="{this.getStyle('backgroundColor')}"
|
---|
71 | click="_focusArea.setFocus();" focusEnabled="false"/>
|
---|
72 |
|
---|
73 | <mx:HBox id="timeBox"
|
---|
74 | horizontalGap="0"
|
---|
75 | verticalAlign="center"
|
---|
76 | height="100%"
|
---|
77 | horizontalScrollPolicy="off"
|
---|
78 | verticalScrollPolicy="off"
|
---|
79 | backgroundAlpha="0"
|
---|
80 | creationComplete="setTimeStepperPosition();">
|
---|
81 |
|
---|
82 |
|
---|
83 | <mx:TextInput id="hourText"
|
---|
84 | initialize="{AccessibilityTools.accessComponentName(hourText,'Enter Hours')}"
|
---|
85 | height="100%"
|
---|
86 | borderThickness="0"
|
---|
87 | borderStyle="none"
|
---|
88 | backgroundAlpha="0"
|
---|
89 | textAlign="center"
|
---|
90 | maxChars="2"
|
---|
91 | editable="false"
|
---|
92 | text="{formatText(String(hour), 'hourText')}"
|
---|
93 | keyDown="keyHandler(event)"
|
---|
94 | mouseUp="setTextFocus(event)"
|
---|
95 | mouseDown="setTextFocus(event)"
|
---|
96 | focusOut="fixText(event)"
|
---|
97 | tabIndex="{_tabIndexBase}"
|
---|
98 | focusIn="setTextFocus(event)"
|
---|
99 | change="setValues(event)"
|
---|
100 | focusAlpha="0"
|
---|
101 | errorString=""/>
|
---|
102 |
|
---|
103 | <mx:Spacer width="-8" /><mx:Label text=":" /><mx:Spacer width="-16" />
|
---|
104 |
|
---|
105 | <mx:TextInput id="minuteText"
|
---|
106 | initialize="{AccessibilityTools.accessComponentName(minuteText,'Enter Minutes')}"
|
---|
107 | height="100%"
|
---|
108 | borderThickness="0"
|
---|
109 | borderStyle="none"
|
---|
110 | backgroundAlpha="0"
|
---|
111 | textAlign="center"
|
---|
112 | maxChars="2"
|
---|
113 | editable="false"
|
---|
114 | text="{formatText(String(minute), 'minuteText')}"
|
---|
115 | keyDown="keyHandler(event)"
|
---|
116 | mouseUp="setTextFocus(event)"
|
---|
117 | mouseDown="setTextFocus(event)"
|
---|
118 | focusOut="fixText(event)"
|
---|
119 | focusIn="setTextFocus(event)"
|
---|
120 | tabIndex="{_tabIndexBase + 1}"
|
---|
121 | change="setValues(event)"
|
---|
122 | focusAlpha="0" />
|
---|
123 |
|
---|
124 | <mx:Spacer width="-8" includeInLayout="{showSeconds}" visible="{showSeconds}" />
|
---|
125 | <mx:Label text=":" includeInLayout="{showSeconds}" visible="{showSeconds}" />
|
---|
126 | <mx:Spacer width="-16" includeInLayout="{showSeconds}" visible="{showSeconds}" />
|
---|
127 |
|
---|
128 | <mx:TextInput id="secondText"
|
---|
129 | initialize="{AccessibilityTools.accessComponentName(secondText,'Enter Seconds')}"
|
---|
130 | height="100%"
|
---|
131 | borderThickness="0"
|
---|
132 | borderStyle="none"
|
---|
133 | backgroundAlpha="0"
|
---|
134 | textAlign="center"
|
---|
135 | maxChars="2"
|
---|
136 | text="{formatText(String(second), 'secondText')}"
|
---|
137 | keyDown="keyHandler(event)"
|
---|
138 | mouseUp="setTextFocus(event)"
|
---|
139 | mouseDown="setTextFocus(event)"
|
---|
140 | focusOut="fixText(event)"
|
---|
141 | focusIn="setTextFocus(event)"
|
---|
142 | change="setValues(event)"
|
---|
143 | focusAlpha="0"
|
---|
144 | includeInLayout="{showSeconds}"
|
---|
145 | visible="{showSeconds}" />
|
---|
146 |
|
---|
147 | <mx:Spacer width="-8" includeInLayout="{!is24Hour}" visible="{!is24Hour}" />
|
---|
148 |
|
---|
149 |
|
---|
150 | <mx:TextInput id="amPMText"
|
---|
151 | height="100%"
|
---|
152 | borderThickness="0"
|
---|
153 | borderStyle="none"
|
---|
154 | backgroundAlpha="0"
|
---|
155 | textAlign="center"
|
---|
156 | maxChars="2"
|
---|
157 | text="{this.am_pm}"
|
---|
158 | keyDown="amPMKeyHandler(event)"
|
---|
159 | mouseUp="setTextFocus(event)"
|
---|
160 | mouseDown="setTextFocus(event)"
|
---|
161 | focusAlpha="0"
|
---|
162 | focusIn="setTextFocus(event)"
|
---|
163 | editable="false"
|
---|
164 | includeInLayout="{!is24Hour}"
|
---|
165 | visible="{!is24Hour}" />
|
---|
166 |
|
---|
167 | <mx:Spacer width="-5" includeInLayout="{!is24Hour}" visible="{!is24Hour}" />
|
---|
168 |
|
---|
169 | </mx:HBox>
|
---|
170 |
|
---|
171 |
|
---|
172 | <mx:Script>
|
---|
173 | <![CDATA[
|
---|
174 | import mx.events.DateChooserEvent;
|
---|
175 | import mx.controls.NumericStepper;
|
---|
176 | import mx.events.NumericStepperEvent;
|
---|
177 | import mx.core.UITextField;
|
---|
178 | import flash.events.MouseEvent;
|
---|
179 | import gov.va.med.edp.util.AccessibilityTools;
|
---|
180 |
|
---|
181 |
|
---|
182 | private var _timeValue:Object;
|
---|
183 | private var _focusArea:TextInput;
|
---|
184 | private var _focusText:TextField;
|
---|
185 | private var _currentStepValue:Number;
|
---|
186 | [Bindable] private var maxHour:Number;
|
---|
187 | [Bindable] private var minHour:Number;
|
---|
188 |
|
---|
189 |
|
---|
190 | [Bindable] public var hour:Number = 0;
|
---|
191 | [Bindable] public var minute:Number = 0;
|
---|
192 | [Bindable] public var second:Number = 0;
|
---|
193 | [Bindable] public var am_pm:String = 'am';
|
---|
194 | [Bindable] public var showSeconds:Boolean;
|
---|
195 | [Bindable] public var is24Hour:Boolean;
|
---|
196 | public var defaultHour:Number;
|
---|
197 | public var defaultMinute:Number = 0;
|
---|
198 | public var defaultSecond:Number = 0;
|
---|
199 |
|
---|
200 | /* [Bindable]
|
---|
201 | public function get totalSeconds(): int
|
---|
202 | {
|
---|
203 | return ((this.hour * 3600) + (this.minute * 60) + this.second);
|
---|
204 | }
|
---|
205 |
|
---|
206 | public function set totalSeconds(value: int): void
|
---|
207 | {
|
---|
208 | this.hour = int(value / 3600);
|
---|
209 | this.minute = int((value % 3600) / 60);
|
---|
210 | this.second = int(value % 60);
|
---|
211 | } */
|
---|
212 |
|
---|
213 | [Bindable]
|
---|
214 | private var _tabIndexBase:int = -1;
|
---|
215 |
|
---|
216 | public function set tabIndexBase(value:int):void {
|
---|
217 | _tabIndexBase = value;
|
---|
218 | }
|
---|
219 |
|
---|
220 | public function get tabIndexBase():int {
|
---|
221 | return _tabIndexBase;
|
---|
222 | }
|
---|
223 |
|
---|
224 | public function get timeValue():Object
|
---|
225 | {
|
---|
226 | var tmpTime:Object = new Object();
|
---|
227 | tmpTime.hour = this.hour;
|
---|
228 | tmpTime.minute = this.minute;
|
---|
229 | tmpTime.second = this.second;
|
---|
230 | return tmpTime;
|
---|
231 | }
|
---|
232 |
|
---|
233 | public function set timeValue(value:Object):void
|
---|
234 | {
|
---|
235 | this._timeValue = value;
|
---|
236 | }
|
---|
237 |
|
---|
238 | override public function setFocus():void
|
---|
239 | {
|
---|
240 | _focusArea.setFocus();
|
---|
241 | }
|
---|
242 |
|
---|
243 | private function createComplete():void
|
---|
244 | {
|
---|
245 | this.focusEnabled = true;
|
---|
246 | this.tabEnabled = true;
|
---|
247 | this.mouseFocusEnabled = true;
|
---|
248 |
|
---|
249 | if(!this.hour)
|
---|
250 | {
|
---|
251 | String(this.hour);
|
---|
252 | this.hour = Number(hourText.text);
|
---|
253 | }
|
---|
254 | else
|
---|
255 | {
|
---|
256 | if(defaultHour)
|
---|
257 | {
|
---|
258 | hourText.text = String(defaultHour);
|
---|
259 | }
|
---|
260 | else
|
---|
261 | {
|
---|
262 | (is24Hour) ? hourText.text = "12" : hourText.text = "1";
|
---|
263 | }
|
---|
264 | }
|
---|
265 | if(!this.minute)
|
---|
266 | {
|
---|
267 | minuteText.text = (defaultMinute < 10) ? "0" + String(defaultMinute) : String(defaultMinute);
|
---|
268 | this.minute = Number(minuteText.text);
|
---|
269 | }
|
---|
270 | if(!this.second)
|
---|
271 | {
|
---|
272 | secondText.text = (defaultSecond < 10) ? "0" + String(defaultSecond) : String(defaultSecond);
|
---|
273 | this.second = Number(secondText.text);
|
---|
274 | }
|
---|
275 |
|
---|
276 | if(!this.am_pm)
|
---|
277 | {
|
---|
278 | this.am_pm = (is24Hour) ? 'pm' : "am";;
|
---|
279 | }
|
---|
280 |
|
---|
281 | (is24Hour) ? maxHour = 23 : maxHour = 12;
|
---|
282 | (is24Hour) ? minHour = 0 : minHour = 1;
|
---|
283 |
|
---|
284 | if(!_focusArea)
|
---|
285 | {
|
---|
286 | _focusArea = hourText;
|
---|
287 | _currentStepValue = Number(_focusArea.text);
|
---|
288 | timeStepper.value = _currentStepValue;
|
---|
289 | }
|
---|
290 |
|
---|
291 | }
|
---|
292 | private function setTextFocus(event:Event):void
|
---|
293 | {
|
---|
294 | _focusArea = event.currentTarget as TextInput;
|
---|
295 | _focusText = event.target as TextField;
|
---|
296 | TextField(event.target).setSelection(0, 2);
|
---|
297 | if(event.currentTarget != amPMText)
|
---|
298 | {
|
---|
299 | _currentStepValue = Number(_focusArea.text);
|
---|
300 | timeStepper.value = _currentStepValue;
|
---|
301 | }
|
---|
302 | setStepValue();
|
---|
303 |
|
---|
304 | }
|
---|
305 |
|
---|
306 | private function setTimeStepperPosition():void
|
---|
307 | {
|
---|
308 | if(timeBox) timeStepper.x = (!is24Hour) ? (timeBox.width - (timeStepper.width * 0.72)) : timeBox.width - (timeStepper.width * 0.8);
|
---|
309 | }
|
---|
310 |
|
---|
311 | private function setStepValue():void
|
---|
312 | {
|
---|
313 | if(_focusArea == amPMText)
|
---|
314 | {
|
---|
315 | timeStepper.minimum = -99;
|
---|
316 | timeStepper.maximum = 99;
|
---|
317 | }
|
---|
318 | }
|
---|
319 |
|
---|
320 | private function changeStepValue(event:Event):void
|
---|
321 | {
|
---|
322 | if(_focusArea != amPMText)
|
---|
323 | {
|
---|
324 | if(_focusArea == hourText)
|
---|
325 | {
|
---|
326 | var tmpMinValue:Number = (is24Hour) ? 0 : 1;
|
---|
327 | if(NumericStepper(event.target).value > maxHour)
|
---|
328 | {
|
---|
329 | NumericStepper(event.target).value = (is24Hour) ? 0 : 1;
|
---|
330 | }
|
---|
331 | else if(NumericStepper(event.target).value < tmpMinValue)
|
---|
332 | {
|
---|
333 | NumericStepper(event.target).value = (is24Hour) ? 23 : 12;
|
---|
334 | }
|
---|
335 | }
|
---|
336 | if(_focusArea == minuteText || _focusArea == secondText)
|
---|
337 | {
|
---|
338 | if(NumericStepper(event.target).value > 59)
|
---|
339 | {
|
---|
340 | NumericStepper(event.target).value = 0;
|
---|
341 | }
|
---|
342 | else if(NumericStepper(event.target).value < 0)
|
---|
343 | {
|
---|
344 | NumericStepper(event.target).value = 59;
|
---|
345 | }
|
---|
346 | }
|
---|
347 |
|
---|
348 | _focusArea.setFocus();
|
---|
349 | if(_focusArea == hourText) this.hour = NumericStepper(event.target).value;
|
---|
350 | if(_focusArea == minuteText) this.minute = NumericStepper(event.target).value;
|
---|
351 | if(_focusArea == secondText) this.second = NumericStepper(event.target).value;
|
---|
352 | }
|
---|
353 | else
|
---|
354 | {
|
---|
355 | amPMText.text = (amPMText.text == "am") ? "pm" : "am";
|
---|
356 | this.am_pm = amPMText.text;
|
---|
357 | }
|
---|
358 | }
|
---|
359 |
|
---|
360 | private function fixText(event:Event):void
|
---|
361 | {
|
---|
362 | if(!(event.currentTarget == hourText && !is24Hour))
|
---|
363 | {
|
---|
364 | _focusArea.text = (_focusArea.text.length < 2) ? "0" + _focusArea.text : _focusArea.text;
|
---|
365 | }
|
---|
366 | _focusArea.setSelection(0, 2);
|
---|
367 | if(event.currentTarget == hourText) this.hour = Number(event.currentTarget.text);
|
---|
368 | if(event.currentTarget == minuteText) this.minute = Number(timeStepper.value);
|
---|
369 | if(event.currentTarget == secondText) this.second = Number(timeStepper.value);
|
---|
370 | }
|
---|
371 |
|
---|
372 | private function setValues(event:Event):void
|
---|
373 | {
|
---|
374 | if(event.currentTarget == hourText)
|
---|
375 | {
|
---|
376 | if(hourValidator.validate(Number(event.currentTarget.text))){
|
---|
377 | timeStepper.value = Number(event.currentTarget.text);
|
---|
378 | this.hour = Number(event.currentTarget.text);
|
---|
379 | }
|
---|
380 | }
|
---|
381 | if(event.currentTarget == minuteText)
|
---|
382 | {
|
---|
383 | if(minuteValidator.validate(Number(event.currentTarget.text))) {
|
---|
384 | timeStepper.value = Number(event.currentTarget.text);
|
---|
385 | this.minute = Number(event.currentTarget.text);
|
---|
386 | }
|
---|
387 | }
|
---|
388 | if(event.currentTarget == secondText)
|
---|
389 | {
|
---|
390 | if(secondValidator.validate(Number(event.currentTarget.text))) timeStepper.value = Number(event.currentTarget.text);
|
---|
391 | }
|
---|
392 |
|
---|
393 | }
|
---|
394 |
|
---|
395 | private function formatText(value:String, theField:String):String
|
---|
396 | {
|
---|
397 | if(_focusArea) _focusArea.setSelection(0, 2);
|
---|
398 | if(Number(value) > 12 && !is24Hour && theField == 'hourText')
|
---|
399 | {
|
---|
400 | value = String(Number(value) % 12);
|
---|
401 | }
|
---|
402 | if(theField == 'hourText' && !is24Hour)
|
---|
403 | {
|
---|
404 | return value;
|
---|
405 | }
|
---|
406 | else
|
---|
407 | {
|
---|
408 | return (value.length < 2) ? ("0" + value) : value;
|
---|
409 | }
|
---|
410 | }
|
---|
411 |
|
---|
412 | private function keyHandler(event:KeyboardEvent):void
|
---|
413 | {
|
---|
414 | if(event.keyCode == 39 || event.keyCode == 38)
|
---|
415 | {
|
---|
416 | if(_focusArea == hourText)
|
---|
417 | {
|
---|
418 | _currentStepValue++;
|
---|
419 | var tmpMaxValue:Number = (is24Hour) ? (maxHour) : maxHour;
|
---|
420 | if(_currentStepValue > tmpMaxValue)
|
---|
421 | {
|
---|
422 | _currentStepValue = (is24Hour) ? 0 : 1;
|
---|
423 | }
|
---|
424 |
|
---|
425 | }
|
---|
426 | else if(_focusArea == minuteText || _focusArea == secondText )
|
---|
427 | {
|
---|
428 | _currentStepValue++;
|
---|
429 | if(_currentStepValue > 59)
|
---|
430 | {
|
---|
431 | _currentStepValue = 0;
|
---|
432 | }
|
---|
433 |
|
---|
434 | }
|
---|
435 | timeStepper.value = _currentStepValue;
|
---|
436 | timeStepper.dispatchEvent(new NumericStepperEvent('change'));
|
---|
437 | _focusArea.setSelection(0, 2);
|
---|
438 | }
|
---|
439 | if(event.keyCode == 37 || event.keyCode == 40)
|
---|
440 | {
|
---|
441 | if(_focusArea == hourText)
|
---|
442 | {
|
---|
443 | _currentStepValue--;
|
---|
444 | var tmpMinValue:Number = (is24Hour) ? 0 : 1;
|
---|
445 | if(_currentStepValue < tmpMinValue)
|
---|
446 | {
|
---|
447 | _currentStepValue = (is24Hour) ? 23 : 12;
|
---|
448 | }
|
---|
449 | }
|
---|
450 | else if(_focusArea == minuteText || _focusArea == secondText )
|
---|
451 | {
|
---|
452 | _currentStepValue--;
|
---|
453 | if(_currentStepValue < 0)
|
---|
454 | {
|
---|
455 | _currentStepValue = 59;
|
---|
456 | }
|
---|
457 | }
|
---|
458 | timeStepper.value = _currentStepValue;
|
---|
459 | timeStepper.dispatchEvent(new NumericStepperEvent('change'));
|
---|
460 |
|
---|
461 | _focusArea.setSelection(0, 2);
|
---|
462 | }
|
---|
463 | }
|
---|
464 |
|
---|
465 | private function amPMKeyHandler(event:KeyboardEvent):void
|
---|
466 | {
|
---|
467 | if(event.keyCode == 38 || event.keyCode == 40 || event.keyCode == 37 || event.keyCode == 39)
|
---|
468 | {
|
---|
469 | amPMText.text = (amPMText.text == "am") ? "pm" : "am";
|
---|
470 | this.am_pm = amPMText.text;
|
---|
471 | _focusArea.setSelection(0, 2);
|
---|
472 | }
|
---|
473 |
|
---|
474 | }
|
---|
475 | ]]>
|
---|
476 | </mx:Script>
|
---|
477 |
|
---|
478 | </mx:Canvas> |
---|