JavaScript API Reference for Oracle ADF Faces

oracle.adfinternal.view.js.agent.safari
Class AdfSafariMobileAgent

org.ecmascript.object.Object
   |
   +--oracle.adf.view.js.base.AdfObject
         |
         +--oracle.adf.view.js.agent.AdfAgent
               |
               +--oracle.adfinternal.view.js.agent.safari.AdfSafariAgent
                     |
                     +--oracle.adfinternal.view.js.agent.safari.AdfSafariMobileAgent

public class AdfSafariMobileAgent
extends AdfSafariAgent

_NATIVE_TO_COMPONENT_MAPPINGS

private static Object _NATIVE_TO_COMPONENT_MAPPINGS

Maps the native event touch events to component level events

Overrides:

AdfAgent._NATIVE_TO_COMPONENT_MAPPINGS

_REDISTRIBUTE_BUBBLE_EVENTS

private static Object _REDISTRIBUTE_BUBBLE_EVENTS

List of native "touch" event types to redistribute to the client components.

Overrides:

AdfSafariAgent._REDISTRIBUTE_BUBBLE_EVENTS

_TOOLTIP_HIDE_TIMEOUT

private static Object _TOOLTIP_HIDE_TIMEOUT

Constant number of milliseconds before a tooltip is auto-dismissed.

_TOOLTIP_PROPERTY_KEY

private static Object _TOOLTIP_PROPERTY_KEY

Page property key used to hold state info about the tooltip popup.

See also:

showTooltip(AdfComponentEvent)

AdfSafariMobileAgent

public AdfSafariMobileAgent(Object version,
                            Object domWindow)

AdfSafariMobileAgent capabilities.

Parameters:

version
domWindow

createContextMenuEventGenerator

public AdfTouchContextMenuManager createContextMenuEventGenerator()

Returns the AdfSafariTouchContextMenuManager that derives context menu events from native touch events.

Return:

AdfTouchContextMenuManager - returns a manager used by the AdfPage when redistributing native events into component events.

Overrides:

AdfAgent.createContextMenuEventGenerator()

createDraggableNode

public Object createDraggableNode(Object domNode)

Given a DOM Node in the document, returns a cloned draggable version of that DOM Node.

Parameters:

domNode

Return:

Object

Overrides:

AdfAgent.createDraggableNode(Node)

createTouchMoveManager

public Object createTouchMoveManager(Object element,
                                     Object handlerCallback,
                                     Object touchCount)

Constructs a manager for handling touch movements. This manager does nothing for user agents that do not support touch movements.

Parameters:

element
handlerCallback
touchCount

Return:

Object

Overrides:

AdfAgent.createTouchMoveManager(HTMLElement, Function, Number)

getBrowserViewportScrollLeft

public Number getBrowserViewportScrollLeft()

Return:

Number - returns the starting position on the canvas of the viewport

Overrides:

AdfAgent.getBrowserViewportScrollLeft()

getBrowserViewportScrollTop

public Number getBrowserViewportScrollTop()

Return:

Number - returns the top position on the canvas the viewport begins

Overrides:

AdfAgent.getBrowserViewportScrollTop()

getComponentEvent

public AdfComponentEvent getComponentEvent(AdfUIComponent component,
                                           Event nativeEvent,
                                           AdfUIComponent prevComponent)

Handles touch event types before delegating to the super class.

Parameters:

component	-	targeted for the component event
nativeEvent	-	dom event to be decorated by a component event
prevComponent	-	last to have been targeted for a component event

Return:

AdfComponentEvent - component event for a given native event

See also:

AdfComponentTouchEvent

Overrides:

AdfAgent.getComponentEvent(Object, Object, Object)

getEventTarget

public HTMLElement getEventTarget(Event event)

Override transparently handles touch events. It also searches for the nearest HTMLElement returning that as the event target if the actual target is a text node. On the Webkit mobile browsers the target may be a text node but we assume an HTMLElement throughout the framework.

Parameters:

event

-

native DOM event

Return:

HTMLElement - target established for the event

See also:

AdfDomUtils.getElement(Node)

Overrides:

AdfAgent.getEventTarget(Object)

getMousePosition

public Object getMousePosition(Event evt)

Returns events mouse coordinates relative to the document. Adds support for touch events.

Parameters:

evt

-

native event object

Return:

Object - an object with two properties (x for the left coordinate and y for the top coordinate)

Overrides:

AdfAgent.getMousePosition(Object)

GetRedistributeBubbleEvents

protected Array GetRedistributeBubbleEvents()

Adds touch events supported by mobile devices that need to be redistributed as component events.

Return:

Array - list of bubble events as literal strings

Overrides:

AdfSafariAgent.GetRedistributeBubbleEvents()

_getTitle

private static String _getTitle(HTMLElement node)

Walks up the ancestor starting at the target node returning the first assigned title attribute.

Parameters:

node

-

touch event target

Return:

String - element title within the target node's heritage; otherwise, returns null;

_hideTooltip

private static void _hideTooltip()

Cancels a pending tooltip timeoout and hides the tooltip popup.

Return:

void - null

Init

protected Object Init(Object version,
                      Object domWindow)

Initializes the instance. Subclasses of AdfObject must call their superclass' Init

Parameters:

version
domWindow

Return:

Object

Overrides:

AdfObject.Init()

isDefaultPrevented

public boolean isDefaultPrevented(Event evt)

Checks to see if AdfAgent.preventDefault(Event) was called on the event or if the a AdfComponentTouchEvent.TOUCH_START_EVENT_TYPE or AdfComponentTouchEvent.TOUCH_END_EVENT_TYPE has been canceled within a touch sequence.

Parameters:

evt

-

native dom event to check if it has been canceled

Return:

boolean - returns true if the event was canceled

Overrides:

AdfAgent.isDefaultPrevented(Event)

isDragPrepEvent

public Object isDragPrepEvent(Object componentEvent)

Checks if a component event is the correct event type on the current agent to prepare a drag operation. This is called from AdfDragRecognizer.prepDrag(Object, Object, Object) to determine if the event is one that must occur before a drag starts. For example, on the desktop, the mouse down event must happen before a mouse move to start the drag.

Parameters:

componentEvent

Return:

Object

Overrides:

AdfAgent.isDragPrepEvent(AdfComponentEvent)

isInlineDialogRepositioningOnScroll

public Boolean isInlineDialogRepositioningOnScroll()

Disables inline dialog auto repositioning on scroll. The zoom gesture invokes the scroll. The inline dialog position manager will not try to reposition an open dialog so that it is always visible in the viewport for this mobile agent.

Return:

Boolean - does this agent support auto positioning of inline dialogs on scroll.

Overrides:

AdfAgent.isInlineDialogRepositioningOnScroll()

isLeftButton

public Object isLeftButton(Object evt)

Parameters:

evt

Return:

Object

Overrides:

AdfAgent.isLeftButton(Object)

isSelectionToggle

public Boolean isSelectionToggle(Object evt)

Due to the fact there are no ctrl+tap, shift+tab or other keyboard functions on the touch devices, treat taps as selection toggle events always.

Parameters:

evt

Return:

Boolean - true always for mobile agent

Overrides:

AdfAgent.isSelectionToggle(Event)

mapNativeToComponentEventType

public String mapNativeToComponentEventType(String eventType)

Maps a native event type to a component event type. Adds support for touch event types.

Parameters:

eventType

-

native DOM event type

Return:

String - component event type for the native event type

Overrides:

AdfAgent.mapNativeToComponentEventType(Object)

preventDefault

public void preventDefault(Event evt)

Agent call to prevent the default behavior of the native event. This override captures if a touchstart or touchend event is prevented. It uses that indicator to filter out rogue simulated native events that follow out of sequence.

Parameters:

evt

-

native event

Return:

void - null

Overrides:

AdfAgent.preventDefault(Event)

showTooltip

public void showTooltip(AdfComponentEvent componentEvent)

Mobile Safari on the tablet does not automatically show tooltips for elements that have title attributes on mouseover. The framework simulates this on the same gesture as the context menu (tap+hold) or (tap+hold+finger-up) conflict resolution with drag-and-drop.

Parameters:

componentEvent

-

that might result in displaying a tooltip

Return:

void - null

Overrides:

AdfAgent.showTooltip(AdfComponentEvent)

_showTooltip

private static void _showTooltip(AdfComponentEvent componentEvent)

Shows a tooltip popup if there is cached state and schedules a auto-dismissal timeout timer.

Parameters:

componentEvent

-

that will result in showing a tooltip popup

Return:

void - null