JavaScript API Reference for Oracle ADF Faces

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

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

Direct Known Subclasses:

AdfIE9Agent

public class AdfIE8Agent
extends AdfIEAgentLegacy

AdfIE8Agent

public AdfIE8Agent(Object domWindow)

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

Parameters:

domWindow

addEventCaptures

public Object addEventCaptures(Object node,
                               Object listener)

IE 8 no longer supports style expressions. Instead, just leverage the standard event captures.

Parameters:

node
listener

Return:

Object

Overrides:

AdfAgent.addEventCaptures(Node, Function)

cloneNode

public Node cloneNode(Node domNode)

Clones a DOM node with default deep clone behavior for IE8. We have to override this method since IE8 is currently derived from IE7. This method can be removed after code refactory to let IE7 derive from IE8.

Parameters:

domNode

-

the DOM ndoe to clone the new node from

Return:

Node - the cloned DOM node.

Overrides:

AdfAgent.cloneNode(Node)

CreateDefaultLogWriter

protected Object CreateDefaultLogWriter(Object nativeLogWriter)

Creates and returns the default AdfLogWriter to use for this AdfPage. Subclassers should override CreateDefaultLogWriter instead

Parameters:

nativeLogWriter

Return:

Object

Overrides:

AdfAgent.createDefaultLogWriter()

elementsAdded

public Object elementsAdded(Object node)

Updates any id->element cache by adding the elements in the specified subtree IE7 has a bug with the getAttribute("id") fix, so this fix is moved to the AdfIE8Agent and a different approach is used for IE7 (in AdfIEAgent).

Parameters:

node

-

Either element or document node that is being added

Return:

Object

See also:

AdfAgent.getElementById(Object)

elementsRemoved(Object)

Overrides:

AdfAgent.elementsAdded(Object)

elementsRemoved

public Object elementsRemoved(Object node)

Updates any id->element cache by removing the elements in the specified subtree. IE7 has a bug with the getAttribute("id") fix, so this fix is moved to the AdfIE8Agent and a different approach is used for IE7 (in AdfIEAgent).

Parameters:

node

-

Either element or document node that is being removed

Return:

Object

See also:

AdfAgent.getElementById(Object)

elementsAdded(Object)

Overrides:

AdfAgent.elementsRemoved(Object)

getBoxSizing

public String getBoxSizing(HTMLElement element,
                           CSSStyleDeclaration currentStyle)

Returns the box model associated with an element (http://www.w3.org/TR/css3-ui/#box-sizing)

Parameters:

element	-	The element to check
currentStyle	-	the current style that can be optionally passed in Default value = null

Return:

String - the box sizing, either "content-box" or "border-box"

Overrides:

AdfAgent.getBoxSizing(HTMLElement, CSSStyleDeclaration)

getElementLeft

public Object getElementLeft(Object element)

Returns the element's left side in Window coordinates. This reproduce the code from the getElementPosition method.

Parameters:

element

Return:

Object

Overrides:

AdfAgent.getElementLeft(Object)

getElementPosition

public Object getElementPosition(Object element)

Returns HTML element's coordinates relative to the document's body

Parameters:

element

-

HTML element

Return:

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

Overrides:

AdfAgent.getElementPosition(Object)

getSessionStorageProperty

public String getSessionStorageProperty(String propKey)

This function returns the value for a given key stored in sessionStorage. sessionStorage is an instance to save information in client session. This is based on DOM Storage mechanism, a means through which string key/value pairs can be securely stored and later retrieved for use.

Parameters:

propKey

-

key used to retrieve the value in storage

Return:

String - value of the property stored with key propKey

Throws:

Error if unable to set property to session storage

See also:

isSessionStorageEnabled()

Overrides:

AdfAgent.getSessionStorageProperty(String)

getTableRow

public Object getTableRow(Object tableElement,
                          Object rowIndex)

Cover to workaround IE8 table.rows bug

Parameters:

tableElement
rowIndex

Return:

Object

Overrides:

AdfAgent.getTableRow(Object, Object)

getTableRowCells

public Object getTableRowCells(Object tableRow)

Cover to workaround IE8 row.cells bug

Parameters:

tableRow

Return:

Object

Overrides:

AdfAgent.getTableRowCells(Object)

getTableRows

public Object getTableRows(Object tableElement)

Cover to workaround IE8 table.rows bug

Parameters:

tableElement

Return:

Object

Overrides:

AdfAgent.getTableRows(Object)

hasAttribute

public Boolean hasAttribute(Element element,
                            Attr attribute)

Checks if an attribute is explicitly set on the node.

Parameters:

element	-	The element
attribute	-	The attribute to be tested

Return:

Boolean - null true if the attribute value is explicitly set.

Overrides:

AdfAgent.hasAttribute(Element, Attr)

isSessionStorageEnabled

public Boolean isSessionStorageEnabled()

This function returns true if userData persistence is enabled; false otherwise.

Return:

Boolean - false if userData persistence is disabled or if access to userData store is denied for security reasons or otherwise.

Overrides:

AdfAgent.isSessionStorageEnabled(Object)

removeEventCaptures

public Object removeEventCaptures(Object node,
                                  Object listener)

IE 8 no longer supports style expressions. Instead, just leverage the standard event captures.

Parameters:

node
listener

Return:

Object

Overrides:

AdfAgent.removeEventCaptures(Node, Object)

removeSessionStorageProperty

public Object removeSessionStorageProperty(String propKey)

This function removes the key/value pair stored in the DOM sessionStorage.

Parameters:

propKey

-

key used to remove the value from storage

Return:

Object

Throws:

Error when sessionStorage cannot be accessed

See also:

isSessionStorageEnabled()

Overrides:

AdfAgent.removeSessionStorageProperty(String)

setOpacity

public Object setOpacity(Object element,
                         Object opacityPercent)

Override the IEAgent's version since it is no longer necessary and breaks in IE8. Presumably the IEAgent version should be moved into an IE7Agent however, this method should be preserved since it is actually required for IE8.

Parameters:

element
opacityPercent

Return:

Object

Overrides:

AdfAgent.setOpacity(Object, Object)

setSessionStorageProperty

public Object setSessionStorageProperty(String propKey,
                                        String propValue)

This function stores the key/value pair into the DOM sessionStorage.

Parameters:

propKey	-	this key will be used to store the key/value in storage
propValue	-	value to be stored.

Return:

Object

Throws:

Error when sessionStorage cannot be accessed or if the operation would exceed storage limits etc.

See also:

isSessionStorageEnabled()

Overrides:

AdfAgent.setSessionStorageProperty(String, String)

setTableRowHeight

public Object setTableRowHeight(Object row,
                                Object height)

Override the IEAgent's version since it is no longer necessary and breaks in IE8. Presumably the IEAgent version should be moved into an IE7Agent and then this method can be removed.

Parameters:

row
height

Return:

Object

Overrides:

AdfAgent.setTableRowHeight(Object, Object)