# JavaScript API Reference for Oracle ADF Faces

Overview | Package | Class | Tree | Deprecated | Index | Help
| Oracle® Fusion Middleware Javascript API Reference for Oracle ADF Faces 12c (12.2.1.4.0) E81451-01
PREV NEXT | FRAMES NO FRAMES Warning: private items are visible |

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.AdfIEAgentLegacy
                         |
                         +--oracle.adfinternal.view.js.agent.ie.AdfIE8Agent

Direct Known Subclasses:
  AdfIE9Agent

    public class AdfIE8Agent
    extends AdfIEAgentLegacy

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, EDGE_PLATFORM, GECKO_PLATFORM, IE_PLATFORM, KEY_EVENTS, MAC_OS, OPERA_PLATFORM, REDISTRIBUTE_EVENTS, 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 version, 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 Object` | `getMaxConnectionsPerDomain()` Gets the maximum number of simultaneous connections allowed per domain by the client
`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 DOM sessionStorage 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.AdfIEAgentLegacy
`addBubbleEventListener, addEventBubbles, addKeyEventListener, addOption, allElementsRemoved, assertBrowserMode, autoCompleteForm, checkMouseOutEvent, clearSubtreeIds, cloneEvent, copyEvent, CreateNativeLogWriter, createStyle, CreateUIInputEvent, createXmlDocument, createXMLHttpRequest, disableUserSelect, dispatchEvent, elementFromPagePoint, enableUserSelect, endDocumentKeyEventCapture, execScript, __getAgentVersion, getBooleanAttribute, getBrowserViewportScrollLeft, getComponentEvent, getComputedStyle, GetCssToDomPropertyNameMap, getCursor, getDescendantComponentsForNode, getElementById, getElementPageBounds, getElementTop, getEventFromElement, getEventTarget, getEventToElement, getFormElement, getIntAttribute, getLocalName, getMousePosition, getNodeName, getNodeXml, getOverrideStyle, getPrefix, 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, toISOString`

### Methods inherited from oracle.adf.view.js.agent.AdfAgent
`addResizeListener, atLeast, beginDirtyStateTracking, CopyDragSize, copyStyle, createContextMenuEventGenerator, createDefaultLogWriter, createDraggableNode, createTouchMoveManager, disableBrowserContextMenu, disableSelectionToggleOnEditableCell, eatEvent, eatEventCallback, endDirtyStateTracking, forceCursorChange, getAgent, getAgentClassNameFromAgentString, getAttribute, getAttributeName, getBrowserViewportScrollTop, getCapabilities, getCSS2Cursor, getCSSLengthAsInt, getDomDocument, getDomForCSSPropertyName, getDomWindow, getElementsByName, getExpandoProperty, getKeyCode, getModifierDisplayName, getNodeType, getOrigin, getOS, getOuterHeight, getOuterWidth, getPlatform, getPreferredKeyEventForRepetition, getScrollLeft, GetTouchCapability, getVersion, guessOS, guessVersion, InitClass, installKeyboardBlocker, isAttributeSpecified, isClipped, isDirty, isDragPrepEvent, isElementHTML, isEventInElement, isInlineDialogRepositioningOnScroll, isKeyboardEvent, isLeftButtonClick, isMouseEvent, isSelectionToggle, isTouchFirstDevice, 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 version,
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:

    `version` |  |
    `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)`

### getMaxConnectionsPerDomain

`public Object getMaxConnectionsPerDomain()`
  Gets the maximum number of simultaneous connections allowed per domain by the client
  Return:
    `Object`
  Overrides:
    `AdfAgent.getMaxConnectionsPerDomain()`

### getSessionStorageProperty

`public String getSessionStorageProperty(String propKey)`
  This function returns the value for a given key stored in sessionStorage. sessionStorage can be used to save information pertaining to a 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 DOM sessionStorage is enabled; false otherwise. IE8+ has support for DOM sessionStorage.
  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

Overview | Package | Class | Tree | Deprecated | Index | Help
| Oracle® Fusion Middleware Javascript API Reference for Oracle ADF Faces 12c (12.2.1.4.0) E81451-01
PREV NEXT | FRAMES NO FRAMES Warning: private items are visible |

Copyright (c) 1998, 2018, Oracle and/or its affiliates. All rights reserved.