Element: <oj-c-input-time-mask>

CORE PACK

Oracle® JavaScript Extension Toolkit (JET)
19.0.0

G25386-01

DOM Interface: CInputTimeMaskElement

Touch Information

Target Gesture Action
Field (Not a Segment) Tap Sets focus to first segment. Show user assistance text.
Segment Tap Sets focus to segment. Show user assistance text.
Segment Double Tap If the time is complete, selects the entire time. Hitting backspace clears it.
Day Period Segment Tap Sets focus to the day period segment. Type the first letter of the desired day period to select it. The 'AM'/'PM' string is localized to the user's locale. For example, in locale 'en-US', 'A' sets the day period segment to 'AM' and 'P' sets the day period segment to 'PM'. If the localized 'AM'/'PM' strings start with the same letter, then typing the first letter will toggle between them.

Keyboard Information

Target Key Action
Field Tab In Sets focus to first segment. Show user assistance text.
Field Ctrl + A or Command + A If the time is complete, selects the entire time. Double clicking on the field also selects the time.
Field with time selected Backspace/Delete Backspace or delete key clears the time. The mask placeholders will be shown again and focus will be on the first segment.
Time Segment Backspace/Delete Clears the time segment. Focus remains on the time segment.
Time Segment RightArrow Moves focus to the segment on the right. If focus is on the rightmost segment, the focus does not move.
Time Segment LeftArrow Moves focus to the segment on the left. If focus is on the leftmost segment, the focus does not move.
Hour Segment UpArrow/DownArrow

Increments or decrements the number by one in the segment. The value wraps around when it reaches the minimum or maximum allowed for the segment.

If there is no number in the segment, and the time is a 12-hour clock, it initializes the hour segment to 12, and auto-fills any empty segments; minute, second and millisecond to 0, and the dayPeriod segment to AM (the string will be localized to the user's locale).

If there is no number in the segment, and the time is a 24-hour clock, it initializes the hour segment to 0, and auto-fills any empty segments to 0.

Minute, Second, or Millisecond Segment UpArrow/DownArrow Increments or decrements the number by one in the segment. The value wraps around when it reaches the minimum or maximum allowed for the segment. If there is no number in the segment, it initializes the segment to 0.
Day Period Segment UpArrow/DownArrow Toggles the day period. If the day period is empty, it initializes it to AM (the 'AM'/'PM' string is localized to the user's locale).
Hour Segment End

Sets the segment to the maximum number for the segment, and auto-fills the rest of the empty segments; sets minute, second and millisecond segments to 0, and the dayPeriod segment to AM (the 'AM'/'PM' string is localized to the user's locale).

For example, if on the hour segment for a 12-hour clock with granularity="minute", and all segments are empty, this will set the hour to 12, and minute to 0, and day period to AM. If on the hour segment for a 24-hour clock with granularity="minute", and all segments are empty, this will set the hour to 23 and minute to 0.

Minute, Second, or Millisecond Segment End Sets the segment to the maximum number for the segment.
Day Period Segment End Sets the segment to the maximum value for the segment which is PM for the day period segment (the 'AM'/'PM' string is localized to the user's locale).
Hour Segment Home

Sets the segment to the minimum number for the segment, and auto-fills the rest of the empty segments; minute, second and millisecond segments to 0, and the dayPeriod segment to AM (the 'AM'/'PM' string is localized to the user's locale).

For example, if on the hour segment for a 12-hour clock with granularity="minute", and all segments are empty, this will set the hour to 1, and minute to 0, and day period to AM. If on the hour segment for a 24-hour clock with granularity="minute", and all segments are empty, this will set the hour to 0 and minute to 0.

Minute, Second, or Millisecond Segment Home Sets the segment to the minimum number for the segment which is 0 for the minute, second, and millisecond segments.
Day Period Segment Home Sets the segment to the minimum value for the segment which is AM for the day period segment (the 'AM'/'PM' string is localized to the user's locale).
Hour Segment Page Up/Page Down

Increments or decrements the number by two in the hour segment, and auto-fills the rest of the empty segments; minute, second and millisecond segments to 0, and the dayPeriod segment to AM (the 'AM'/'PM' string is localized to the user's locale). The value wraps around when it reaches the minimum or maximum allowed for the segment.

If there is no number in the segment, and the time is a 12-hour clock, it initializes the hour segment to 12, and auto-fills any empty segments; minute, second and millisecond to 0, and the dayPeriod segment to AM (the string will be localized to the user's locale).

If there is no number in the segment, and the time is a 24-hour clock, it initializes the hour segment to 0, and auto-fills any empty segments to 0.

Minute, Second, or Millisecond Segment Page Up/Page Down Increments or decrements the number by 10 in the minute and second segments, or by 100 in the millisecond segment. The value wraps around when it reaches the minimum or maximum allowed for the segment.
Day Period Segment Page Up/Page Down Toggles the day period segment between AM and PM (the 'AM'/'PM' string is localized to the user's locale).