JavaScript API Reference for Oracle ADF Faces

oracle.adfinternal.view.js.agent.ie
Class AdfIE9Agent

org.ecmascript.object.Object
   |
   +--oracle.adf.view.js.base.AdfObject
         |
         +--oracle.adf.view.js.agent.AdfAgent
               |
               +--oracle.adfinternal.view.js.agent.ie.AdfIEAgentLegacy
                     |
                     +--oracle.adfinternal.view.js.agent.ie.AdfIE8Agent
                           |
                           +--oracle.adfinternal.view.js.agent.ie.AdfIE9Agent

public class AdfIE9Agent
extends AdfIE8Agent

AdfIE9Agent

public AdfIE9Agent(Object version,
                   Object domWindow)

IE9 agent capabilities. Eventually, we should probably refactor IEAgent into an base IEAgent and an IE7Agent and IE8Agent. IE9Agent would then extend IEAgent Fixes for running on IE9.

Parameters:

version
domWindow

addBubbleEventListener

public Object addBubbleEventListener(Object nodeOrWindow,
                                     Object eventType,
                                     Object listener)

Adds an event listener that fires in the non-Capture phases for the specified eventType. There is no ordering guaranteee, nor is there a guarantee regarding the number of times that an event listener will be called if it is added to the same element multiple times.

Parameters:

nodeOrWindow
eventType
listener

Return:

Object

Overrides:

AdfAgent.addBubbleEventListener(Object, Object, Object)

addEventCaptures

public Object addEventCaptures(Object node,
                               Object listener)

Adds event captures for all of the events that the Rich client framework is interested in to the relevant element using the specified listener. Note that addEventCaptures() implementations may choose to suppress certain mouse events for performance reasons. In particular, capturing mousemove, mouseover and mouseout events may be expensive on some platforms (particularly those platforms which do not implement DOM Level 2 Events). In such cases, these events may not be delivered to the provided listener.

Parameters:

node
listener

Return:

Object

Overrides:

AdfAgent.addEventCaptures(Node, Function)

addKeyEventListener

public Object addKeyEventListener(Object element,
                                  Object listener)

Adds key event listener to the specified element.

Parameters:

element
listener

Return:

Object

Overrides:

AdfAgent.addKeyEventListener(Object, Object)

cloneEvent

public Object cloneEvent(Object event,
                         Object newTarget)

Clones an event from an existing event for a new target element. This API designed for code that needs to remember the original event object and does not support creating events for dispatch. For creating events for dispatch, use #copyEvent

Parameters:

event
newTarget

Return:

Object

Overrides:

AdfAgent.cloneEvent(Event, HTMLElement)

copyEvent

public Object copyEvent(Object event)

Returns a Copy of an event from an existing event. The newly created event can be dispatched to a new target.

Parameters:

event

Return:

Object

Overrides:

AdfAgent.copyEvent(Event)

_copyMouseEvent

private Object _copyMouseEvent(Object event,
                               Object eventType,
                               Object newTarget)

Parameters:

event
eventType
newTarget

Return:

Object

Overrides:

AdfAgent._copyMouseEvent(Object, Object, Object)

CreateUIInputEvent

protected Object CreateUIInputEvent(Object component,
                                    Object type,
                                    Object nativeEvent)

Parameters:

component
type
nativeEvent

Return:

Object

Overrides:

AdfAgent.CreateUIInputEvent(Object, Object, Object)

dispatchEvent

public Object dispatchEvent(Object targetElement,
                            Object event)

Dispatches the specified event to the target, returning whether the dispatch was successful

Parameters:

targetElement
event

Return:

Object

Overrides:

AdfAgent.dispatchEvent(Object, Object)

_getBoxObjectFor

private static Object _getBoxObjectFor(Object elem)

Parameters:

elem

Return:

Object

getComponentEvent

public Object getComponentEvent(Object component,
                                Object nativeEvent,
                                Object prevComponent)

Since the button value returns okay for IE9 onwards, use the base function of AdfAgent.js to make the code clear.

Parameters:

component
nativeEvent
prevComponent

Return:

Object

Overrides:

AdfAgent.getComponentEvent(Object, Object, Object)

getEventTarget

public HTMLElement getEventTarget(Object evt)

Abstracts how the native dom event stores the associated target established in the capture phase. IE9 now supports the more common "target" attribute for most events. Events such as "deactivate" needs to fallback on the prior "srcElement" property.

Parameters:

evt

Return:

HTMLElement - events target

Overrides:

AdfAgent.getEventTarget(Object)

getTextContent

public Object getTextContent(Object node)

Returns the text content of a Node, as per DOM-level 3 spec

Parameters:

node

Return:

Object

Overrides:

AdfAgent.getTextContent(Object)

isDefaultPrevented

public boolean isDefaultPrevented(Event evt)

Checks to see if AdfAgent.preventDefault(Event) was called on the target event.

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)

isLeftButton

public boolean isLeftButton(Event evt)

This override is to use the W3C's button attribute which IE conforms to.

Parameters:

evt

-

native dom event

Return:

boolean - whether the mouse event is of left button

Overrides:

AdfAgent.isLeftButton(Event)

preventDefault

public void preventDefault(Event evt)

Cancels the event if it is cancelable, without stopping further propagation of the event.

Parameters:

evt

-

native dom event to cancel

Return:

void - null

Overrides:

AdfAgent.preventDefault(Event)

removeBubbleEventListener

public Object removeBubbleEventListener(Object nodeOrWindow,
                                        Object eventType,
                                        Object listener)

Removes an event listener that fired in the non-Capture phases for the specified eventType

Parameters:

nodeOrWindow
eventType
listener

Return:

Object

Overrides:

AdfAgent.removeBubbleEventListener(Object, Object, Object)

removeKeyEventListener

public Object removeKeyEventListener(Object element,
                                     Object listener)

Removes the key event listener from the specified element.

Parameters:

element
listener

Return:

Object

Overrides:

AdfAgent.removeKeyEventListener(Object, Object)

setEventTarget

public Object setEventTarget(Object event,
                             Object eventTarget)

Parameters:

event
eventTarget

Return:

Object

Overrides:

AdfIEAgentLegacy.setEventTarget(Object, Object)

setOpacity

public void setOpacity(HTMLElement element,
                       int opacityPercent)

Sets opacity of a DOM element. IE9 uses the standard opacity in addition to the non-standard filter method; therefore, the agent needs to handle both non-standard and standard opacity.

Parameters:

element	-	the element to set opacity for
opacityPercent	-	opacity percentage

Return:

void - null

Overrides:

AdfAgent.setOpacity(Object, Object)

stopPropagation

public Object stopPropagation(Object evt)

Parameters:

evt

Return:

Object

Overrides:

AdfAgent.stopPropagation(Object)

supportsTransientStyleClasses

public Boolean supportsTransientStyleClasses()

Overridden to not support transient style classes like 'hover-target' style class in IE9 if the document is scroll vertically because of the following bug: Bug 13691104 - ie9: af:table vertical scrollbar reset at the top position

Return:

Boolean - false if the document root is scrolled else true

Overrides:

AdfAgent.supportsTransientStyleClasses()