JavaScript API Reference for Oracle ADF Faces

SUMMARY: FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

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

Warning:

• This is an unsupported, internal implementation class.
• Use an API class that might provide equivalent functionality instead.
• This class will change without notice.
• It is not recommended that you use anything in this class.

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

Direct Known Subclasses:

AdfIE9Agent

public class AdfIE8Agent
extends AdfIEAgent

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

Field Summary

Fields inherited from oracle.adf.view.js.agent.AdfAgent

ANDROID_OS, CAP_TOUCH_SCREEN, CAP_TOUCH_SCREEN_MULTIPLE, CAP_TOUCH_SCREEN_NONE, CAP_TOUCH_SCREEN_SINGLE, DRAG_GHOST_STYLECLASS, GECKO_PLATFORM, IE_PLATFORM, KEY_EVENTS, MAC_OS, OPERA_PLATFORM, SOLARIS_OS, UNKNOWN_OS, UNKNOWN_PLATFORM, WEBKIT_PLATFORM, WINDOWS_OS

Fields inherited from oracle.adf.view.js.base.AdfObject

constructor, superclass

Fields inherited from org.ecmascript.object.Object

prototype

Constructor Summary

public

AdfIE8Agent(Object domWindow) IE8 AdfAgent AdfAgent capabilities.

Method Summary

public Object	addEventCaptures(Object node, Object listener) IE 8 no longer supports style expressions.
public Node	cloneNode(Node domNode) Clones a DOM node with default deep clone behavior for IE8.
protected Object	CreateDefaultLogWriter(Object nativeLogWriter) Creates and returns the default AdfLogWriter to use for this AdfPage.
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).
public Object	elementsRemoved(Object node) Updates any id->element cache by removing the elements in the specified subtree.
public String	getBoxSizing(HTMLElement element, CSSStyleDeclaration currentStyle) Returns the box model associated with an element (http://www.w3.org/TR/css3-ui/#box-sizing)
public Object	getElementLeft(Object element) Returns the element's left side in Window coordinates.
public Object	getElementPosition(Object element) Returns HTML element's coordinates relative to the document's body
public String	getSessionStorageProperty(String propKey) This function returns the value for a given key stored in sessionStorage.
public Object	getTableRow(Object tableElement, Object rowIndex) Cover to workaround IE8 table.rows bug
public Object	getTableRowCells(Object tableRow) Cover to workaround IE8 row.cells bug
public Object	getTableRows(Object tableElement) Cover to workaround IE8 table.rows bug
public Boolean	hasAttribute(Element element, Attr attribute) Checks if an attribute is explicitly set on the node.
public Boolean	isSessionStorageEnabled() This function returns true if userData persistence is enabled; false otherwise.
public Object	removeEventCaptures(Object node, Object listener) IE 8 no longer supports style expressions.
public Object	removeSessionStorageProperty(String propKey) This function removes the key/value pair stored in the DOM sessionStorage.
public Object	setOpacity(Object element, Object opacityPercent) Override the IEAgent's version since it is no longer necessary and breaks in IE8.
public Object	setSessionStorageProperty(String propKey, String propValue) This function stores the key/value pair into the DOM sessionStorage.
public Object	setTableRowHeight(Object row, Object height) Override the IEAgent's version since it is no longer necessary and breaks in IE8.

Methods inherited from oracle.adfinternal.view.js.agent.ie.AdfIEAgent

addBubbleEventListener, addEventBubbles, addKeyEventListener, addOption, allElementsRemoved, assertBrowserMode, autoCompleteForm, beginDirtyStateTracking, checkMouseOutEvent, clearSubtreeIds, cloneEvent, copyEvent, CreateNativeLogWriter, createStyle, CreateUIInputEvent, createXmlDocument, createXMLHttpRequest, disableUserSelect, dispatchEvent, elementFromPagePoint, enableUserSelect, endDirtyStateTracking, endDocumentKeyEventCapture, execScript, __getAgentVersion, getBooleanAttribute, getBrowserViewportScrollLeft, getComponentEvent, getComputedStyle, GetCssToDomPropertyNameMap, getCursor, getDescendantComponentsForNode, getElementById, getElementPageBounds, getElementTop, getEventFromElement, getEventTarget, getEventToElement, getFormElement, getIntAttribute, getLocalName, getMousePosition, getNodeName, getNodeXml, getOverrideStyle, getPrefix, GetResizeEvents, getStyleProperty, getTextContent, getWindowClientHeight, getWindowClientWidth, getWindowHeight, getWindowScrollHeight, getWindowScrollWidth, getWindowWidth, Init, isChromeEvent, IsComputedWidthAuto, isDefaultPrevented, isDisabledOptionSupported, isEqualIcon, isFunctionKey, isLeftButton, parseXML, pointInElementBounds, pointInElementChrome, preventDefault, removeBubbleEventListener, removeEventBubbles, removeIdsFromDomSubTree, removeKeyEventListener, removeStyleProperty, setCssFloat, setCursor, setEventTarget, setImageSource, setTextContent, slice, startDocumentKeyEventCapture, startMouseEventCapture, stopMouseEventCapture, stopPropagation, supportsTransientStyleClasses

Methods inherited from oracle.adf.view.js.agent.AdfAgent

addResizeListener, atLeast, CopyDragSize, copyStyle, createContextMenuEventGenerator, createDefaultLogWriter, createDraggableNode, createTouchMoveManager, disableBrowserContextMenu, disableSelectionToggleOnEditableCell, eatEvent, eatEventCallback, forceCursorChange, getAgent, getAttribute, getAttributeName, getBrowserViewportScrollTop, getCapabilities, getCSS2Cursor, getCSSLengthAsInt, getDomDocument, getDomForCSSPropertyName, getDomWindow, getElementsByName, getExpandoProperty, getKeyCode, getModifierDisplayName, getNodeType, getOS, getOuterHeight, getOuterWidth, getPlatform, getPreferredKeyEventForRepetition, getScrollLeft, getVersion, guessOS, guessVersion, InitClass, installKeyboardBlocker, isAttributeSpecified, isClipped, isDirty, isDragPrepEvent, isElementHTML, isEventInElement, isInlineDialogRepositioningOnScroll, isLeftButtonClick, isMouseEvent, isSelectionToggle, mapNativeToComponentEventType, modifyIdsInDomSubTree, pointInElementOrChildBounds, prepareStretchedChild, preventDefaultCallback, removeResizeListener, replaceNode, repositionStretchedElement, resizeStretchedChild, resizeStretchedElement, scrollToPos, setAttribute, setButtonTextContent, setDirty, setExpandoProperty, setImageTooltip, setInstance, setOuterHeight, setOuterMaxHeight, setOuterMaxWidth, setOuterWidth, setScrollLeft, showBusyCursor, showTooltip

Methods inherited from oracle.adf.view.js.base.AdfObject

adopt, clone, createCallback, createInitializedObject, createSubclass, ensureClassInitialization, equals, exportPrototypeSymbol, getClass, GetLazyArrayProperty, GetLazyMapProperty, getTypeName, toDebugString, toString

Field Detail

Constructor Detail

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

Method Detail

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)

SUMMARY: FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD