JavaScript API Reference for Oracle ADF Faces

oracle.adfinternal.view.js.laf.dhtml.rich
Class AdfDhtmlInputFilePeer

org.ecmascript.object.Object
   |
   +--oracle.adf.view.js.base.AdfObject
         |
         +--oracle.adf.view.js.base.AdfUIPeer
               |
               +--oracle.adf.view.js.laf.rich.AdfRichUIPeer
                     |
                     +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlValuePeer
                           |
                           +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlEditableValuePeer
                                 |
                                 +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlInputBasePeer
                                       |
                                       +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlInputTextPeer
                                             |
                                             +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlInputFilePeer

public class AdfDhtmlInputFilePeer
extends AdfDhtmlInputTextPeer

_APPLET_ID

private static Object _APPLET_ID

_AUTO_HEIGHT_ROWS

private static Object _AUTO_HEIGHT_ROWS

_BUTTON_EXPANDO

private static Object _BUTTON_EXPANDO

_CANCEL_BUTTON_ID

private static Object _CANCEL_BUTTON_ID

_clone

private static Object _clone

_CSS_PROPERTY_DISPLAY

private static Object _CSS_PROPERTY_DISPLAY

_CSS_PROPERTY_OVERFLOWY

private static Object _CSS_PROPERTY_OVERFLOWY

_CSS_PROPERTY_VISIBILITY

private static Object _CSS_PROPERTY_VISIBILITY

_DELAYED_UPLOAD_CONTENT_ID

private static Object _DELAYED_UPLOAD_CONTENT_ID

_DELAYED_UPLOAD_FORM_ID

private static Object _DELAYED_UPLOAD_FORM_ID

_DELETE_BUTTON_ID

private static Object _DELETE_BUTTON_ID

_DISPLAY_MODE

private static Object _DISPLAY_MODE

_DISPLAY_MODE_DROP_AREA

private static Object _DISPLAY_MODE_DROP_AREA

_DISPLAY_MODE_NONE

private static Object _DISPLAY_MODE_NONE

_DLG_ADD_BUTTON_BTN

private static Object _DLG_ADD_BUTTON_BTN

_DLG_DELETE_BUTTON_BTN

private static Object _DLG_DELETE_BUTTON_BTN

_DLG_UPDATE_BUTTON_BTN

private static Object _DLG_UPDATE_BUTTON_BTN

_dlgContentOkHandlerSetuped

private Object _dlgContentOkHandlerSetuped

_DROP_AREA_ID

private static Object _DROP_AREA_ID

_FALLBACK_ID

private static Object _FALLBACK_ID

_FILE_DONE_ID

private static Object _FILE_DONE_ID

_FILE_FAILED_ID

private static Object _FILE_FAILED_ID

_FILENAME_ID

private static Object _FILENAME_ID

_FILESIZE_ID

private static Object _FILESIZE_ID

_HIDDENDATA_ADD

private static Object _HIDDENDATA_ADD

_HIDDENDATA_DELETE

private static Object _HIDDENDATA_DELETE

_HIDDENDATA_UPDATE

private static Object _HIDDENDATA_UPDATE

_ICON_HOVER_ID

private static Object _ICON_HOVER_ID

_ICON_ID

private static Object _ICON_ID

_INPUT_ID

private static Object _INPUT_ID

_ITEM_ID_ATTR

private static Object _ITEM_ID_ATTR

_MAX_DISK_SPACE

private static Object _MAX_DISK_SPACE

_MAX_FILE_SIZE

private static Object _MAX_FILE_SIZE

_MAXIMUM_FILES

private static Object _MAXIMUM_FILES

_PANEL_ID

private static Object _PANEL_ID

_PROGRESS_INDICATOR_DTM_ID

private static Object _PROGRESS_INDICATOR_DTM_ID

_PROGRESS_INDICATOR_INDTM_ID

private static Object _PROGRESS_INDICATOR_INDTM_ID

_RETRY_BUTTON_ID

private static Object _RETRY_BUTTON_ID

_ROW_DELETED_ATTR

private static Object _ROW_DELETED_ATTR

_ROW_FILENAME_ATTR

private static Object _ROW_FILENAME_ATTR

_ROW_FILESIZE_ATTR

private static Object _ROW_FILESIZE_ATTR

_ROW_ID

private static Object _ROW_ID

_ROW_UPLOADED_ATTR

private static Object _ROW_UPLOADED_ATTR

_ROWS

private static Object _ROWS

_STOP_BUTTON_ID

private static Object _STOP_BUTTON_ID

_STYLE_DISPLAY_INLINE

private static Object _STYLE_DISPLAY_INLINE

_STYLE_DISPLAY_NONE

private static Object _STYLE_DISPLAY_NONE

_STYLE_INPUT_FILE_MULTIPLE_UPLOAD_DROPZONE_CLASS

private static Object _STYLE_INPUT_FILE_MULTIPLE_UPLOAD_DROPZONE_CLASS

_STYLE_INPUT_FILE_MULTIPLE_UPLOAD_FILELIST_CLASS

private static Object _STYLE_INPUT_FILE_MULTIPLE_UPLOAD_FILELIST_CLASS

_STYLE_INPUT_FILE_MULTIPLE_UPLOAD_PANEL_DRAG_CLASS

private static Object _STYLE_INPUT_FILE_MULTIPLE_UPLOAD_PANEL_DRAG_CLASS

_STYLE_VISIBILITY_HIDDEN

private static Object _STYLE_VISIBILITY_HIDDEN

_STYLE_VISIBILITY_VISIBLE

private static Object _STYLE_VISIBILITY_VISIBLE

_TABLE_ID

private static Object _TABLE_ID

_TOOLBAR_ID

private static Object _TOOLBAR_ID

_UPDATE_BUTTON_ID

private static Object _UPDATE_BUTTON_ID

_UPDATE_DLG_CONTAINER_ID

private static Object _UPDATE_DLG_CONTAINER_ID

_UPDATE_DLG_CONTENT_ID

private static Object _UPDATE_DLG_CONTENT_ID

_UPDATE_VALUE_ID

private static Object _UPDATE_VALUE_ID

_UPLOAD_BUTTON_ID

private static Object _UPLOAD_BUTTON_ID

_UPLOAD_TYPE

private static Object _UPLOAD_TYPE

_UPLOAD_TYPE_AUTO

private static Object _UPLOAD_TYPE_AUTO

_UPLOAD_TYPE_AUTO_IF_MULTIPLE

private static Object _UPLOAD_TYPE_AUTO_IF_MULTIPLE

_UPLOAD_TYPE_MANUAL

private static Object _UPLOAD_TYPE_MANUAL

_UPLOAD_TYPE_SUBMIT

private static Object _UPLOAD_TYPE_SUBMIT

_usesUnifiedButtons

private static Object _usesUnifiedButtons

AdfDhtmlInputFilePeer

public AdfDhtmlInputFilePeer()

Renders an input file field for DHTML

_addFileItemToUploadResultList

private static Object _addFileItemToUploadResultList(Object component,
                                                     Object fileItem)

Parameters:

component
fileItem

Return:

Object

_addFileToUploadQueueUI

private static Object _addFileToUploadQueueUI(Object component,
                                              Object filename,
                                              Object filesize,
                                              Object itemId)

Parameters:

component
filename
filesize
itemId

Return:

Object

ComponentValueChanged

protected Object ComponentValueChanged(Object component,
                                       Object domElement,
                                       Object newValue,
                                       Object oldValue)

Parameters:

component
domElement
newValue
oldValue

Return:

Object

Overrides:

AdfDhtmlValuePeer.ComponentValueChanged(Object, Object, Object, Object)

_createNewRow

private static Object _createNewRow(Object component,
                                    Object itemId)

Parameters:

component
itemId

Return:

Object

Focus

protected Object Focus()

Override of AdfDhtmlEditableValuePeer.prototype.Focus. In update mode, the note window alignment node doesn't have any child elements that are tab stops, so we need to explicitly focus on the update button.

Return:

Object

Overrides:

AdfUIPeer.focus(Object)

_getConvertedNumber

private static Object _getConvertedNumber(Object bytes)

Parameters:

bytes

Return:

Object

getConvertedValue

public Object getConvertedValue(Object component,
                                Object submittedValue)

akin to javax.faces.render.Renderer.getConvertedValue() can return undefined if converter was not successful

Parameters:

component
submittedValue

Return:

Object

Overrides:

AdfDhtmlValuePeer.getConvertedValue(Object, Object)

_getDialogSubId

private Object _getDialogSubId()

Return:

Object

_getDomRow

private Object _getDomRow(Object filename)

Parameters:

filename

Return:

Object

getFileUploadManager

public Object getFileUploadManager()

Return:

Object

getFileUploadUtils

public Object getFileUploadUtils()

Return:

Object

_getHiddenField

private Object _getHiddenField(Object component)

private helper function to get the hidden field, which stores the update operation.

Parameters:

component

Return:

Object

_getListElement

private static Object _getListElement(Object component,
                                      Object typeId,
                                      Object itemId)

Parameters:

component
typeId
itemId

Return:

Object

_getListElementId

private static Object _getListElementId(Object component,
                                        Object typeId,
                                        Object itemId)

Parameters:

component
typeId
itemId

Return:

Object

GetNoteWindowAlignmentNode

protected Object GetNoteWindowAlignmentNode(Object component,
                                            Object rootNode)

Returns the node for which to align the note help window

Parameters:

component
rootNode

Return:

Object

Overrides:

AdfDhtmlEditableValuePeer.GetNoteWindowAlignmentNode(Object, Object)

_getSubmitType

private static Object _getSubmitType(Object component)

Parameters:

component

Return:

Object

_getUpdateButton

private Object _getUpdateButton()

Return:

Object

_getUploadPanel

private static Object _getUploadPanel(Object clientId)

Parameters:

clientId

Return:

Object

_getUploadQueueRowId

private static Object _getUploadQueueRowId(Object clientId,
                                           Object itemId)

Parameters:

clientId
itemId

Return:

Object

_getUploadResultItem

private Object _getUploadResultItem(Object itemId)

Parameters:

itemId

Return:

Object

HandleComponentClick

protected Object HandleComponentClick(Object componentEvent)

Handle button clicks

Parameters:

componentEvent

Return:

Object

Overrides:

AdfDhtmlEditableValuePeer.HandleComponentClick(Object)

HandleComponentDialog

protected Object HandleComponentDialog(Object componentEvent)

Handles the upload dialog This happens even before PopupClosed and is to set component value and hide custom popup and then set the focus to input field if exist.

Parameters:

componentEvent

-

the component event invoked as users close upload popup.

Return:

Object

HandleComponentKeyPress

protected Object HandleComponentKeyPress(Object componentEvent)

Handles component-level key-press events. We check for this when inputText's rows > 1 and we need to check the maximumLength. Also used for doing autoTab.

Parameters:

componentEvent

Return:

Object

Overrides:

AdfDhtmlInputTextPeer.HandleComponentKeyPress(Object)

_handleDeleteComplete

private Object _handleDeleteComplete(Object filename,
                                     Object success)

Parameters:

filename
success

Return:

Object

HandleDomChange

protected Object HandleDomChange(Object component,
                                 Object domEvent)

DOM change event event handler. This gets called when the file is changed. and it will validate the value.

Parameters:

component	-	Component that this peer will be associated with
domEvent	-	event on the dom

Return:

Object

HandleDomDrop

protected Object HandleDomDrop(Object component,
                               Object domEvent)

Handle the file drop event

Parameters:

component
domEvent

Return:

Object

_handleDragEnter

private Object _handleDragEnter(Object event)

Parameters:

event

Return:

Object

_handleDragLeave

private Object _handleDragLeave(Object event)

Parameters:

event

Return:

Object

_handleDragOver

private Object _handleDragOver(Object event)

Parameters:

event

Return:

Object

_handleFileChange

private Object _handleFileChange(Object component,
                                 Object file)

Parameters:

component
file

Return:

Object

_handlePopupClosed

private Object _handlePopupClosed(Object componentEvent)

Parameters:

componentEvent

Return:

Object

_handlePopupOpened

private Object _handlePopupOpened(Object componentEvent)

Parameters:

componentEvent

Return:

Object

_handleUploadCancel

private Object _handleUploadCancel(Object filename,
                                   Object removeItem)

Parameters:

filename
removeItem

Return:

Object

_handleUploadComplete

private Object _handleUploadComplete(Object filename,
                                     Object success)

Parameters:

filename
success

Return:

Object

_hideListElement

private static Object _hideListElement(Object component,
                                       Object typeId,
                                       Object itemId)

Parameters:

component
typeId
itemId

Return:

Object

_hideListRow

private static Object _hideListRow(Object component,
                                   Object itemId)

Parameters:

component
itemId

Return:

Object

_hideRow

private static Object _hideRow(Object component,
                               Object itemId)

Parameters:

component
itemId

Return:

Object

InitDomElement

protected Object InitDomElement(AdfUIComponent component,
                                Object domElement)

Initialize the associated domElement when the peer is created. Stateless peers are not bound at the time that this method is called.

Parameters:

component	-	Component that this peer will be associated with
domElement	-	Root DOM element of this peer

Return:

Object

Overrides:

AdfRichUIPeer.InitDomElement(AdfUIComponent, Object)

_initDropArea

private Object _initDropArea(Object dropAreaId,
                             Object width,
                             Object height)

Parameters:

dropAreaId
width
height

Return:

Object

_initMultipleUpload

private Object _initMultipleUpload(Object component,
                                   Object domElement)

Parameters:

component
domElement

Return:

Object

_initMultipleUploadDomElement

private Object _initMultipleUploadDomElement(Object component,
                                             Object domElement)

Parameters:

component
domElement

Return:

Object

_initPanelSize

private Object _initPanelSize(Object component)

Parameters:

component

Return:

Object

InitSubclass

protected static Object InitSubclass()

Return:

Object

Overrides:

AdfDhtmlValuePeer.InitSubclass()

_isApiMode

private static Object _isApiMode(Object component)

Parameters:

component

Return:

Object

isDataDirty

public Object isDataDirty()

Return:

Object

isEmpty

public Object isEmpty(Object submittedValue)

This is needed in the case where the client converter return undefined. Required validation works on the converted value. When the converter can't convert this will be called to determine if the field is empty. If this isn't doing the correct thing then a client converter is required.

Parameters:

submittedValue

Return:

Object

Overrides:

AdfDhtmlValuePeer.isEmpty(Object)

isMultipleUpload

public Object isMultipleUpload()

Return:

Object

_isMultipleUpload

private static Object _isMultipleUpload(Object component)

Parameters:

component

Return:

Object

isUploadQueueEmpty

public Object isUploadQueueEmpty()

Return:

Object

isUploadResultFailed

public Object isUploadResultFailed()

Return:

Object

LazyInitialize

protected Object LazyInitialize(Object component,
                                Object domElement)

We need to initialize the 'value' property before the user makes any changes so that we're not going to the peer for the 'value' property in the component.setProperty method. See explanation below. Background: 1. In component.setProperty if the old and new value of a property are equal the setProperty method returns without setting anything. This is to avoid unnecessary propertyChangeEvents. 2. We do not send down the 'value' property from the server, so the 'value' property starts out undefined. If a property is undefined then calls to get the current value will go to the peer. So initally calls to getValue() go to the peer's GetComponentValue() Issue: - Mostly component.setProperty will only be called after the user makes a change, and if the property is currently undefined the peer's property getter will be called for the 'old' value. The peer will then return the current value, which is the new changed value. - That means the 'old' value is the same as the new value, and so the property is not set (see point 1 above). - Therefore we need to initialize the 'value' property before the user makes any changes so that we're not going to the peer for the 'value' property in the component.setProperty method.

Parameters:

component
domElement

Return:

Object

Overrides:

AdfDhtmlEditableValuePeer.LazyInitialize(Object, Object)

_loadSettings

private Object _loadSettings(Object component,
                             Object itemId,
                             Object appletWidth,
                             Object appletHeight)

Parameters:

component
itemId
appletWidth
appletHeight

Return:

Object

_maskListElement

private static Object _maskListElement(Object component,
                                       Object typeId,
                                       Object itemId)

Parameters:

component
typeId
itemId

Return:

Object

_maskListRow

private static Object _maskListRow(Object component,
                                   Object itemId)

Parameters:

component
itemId

Return:

Object

_maskPanelElement

private static Object _maskPanelElement(Object component,
                                        Object typeId)

Parameters:

component
typeId

Return:

Object

needsResizeNotify

public Object needsResizeNotify(Object component)

Tests whether the peer requires resize notification. Peers which perform geometry management should override this to return true. When true, resizeNotify() will be called when browser window is resized.

Parameters:

component

Return:

Object

Overrides:

AdfUIPeer.needsResizeNotify(Object)

PopupClosed

protected Object PopupClosed(Object component,
                             Object contentDom,
                             Object popupId)

Hook for notifying a peer that a popup of its was just closed.

Parameters:

component
contentDom
popupId

Return:

Object

Overrides:

AdfRichUIPeer.PopupClosed(AdfUIComponent, HTMLElement, String)

_removeFileFromUploadQueue

private Object _removeFileFromUploadQueue(Object itemId)

Parameters:

itemId

Return:

Object

_removeFileFromUploadQueueUI

private static Object _removeFileFromUploadQueueUI(Object component,
                                                   Object row)

Parameters:

component
row

Return:

Object

resizeNotify

public Object resizeNotify(Object component,
                           Object oldWidth,
                           Object oldHeight,
                           Object newWidth,
                           Object newHeight)

Called to notify the peer of resize activity. Only called if peer overrides needsResizeNotify() to return true.

Parameters:

component
oldWidth
oldHeight
newWidth
newHeight

Return:

Object

Overrides:

AdfUIPeer.resizeNotify(Object, Object, Object, Object, Object)

_setCSSStyle

private static Object _setCSSStyle(Object elementId,
                                   Object property,
                                   Object style)

Parameters:

elementId
property
style

Return:

Object

_setCSSStyleText

private static Object _setCSSStyleText(Object element,
                                       Object cssText)

Parameters:

element
cssText

Return:

Object

_setListElementCSSStyle

private static Object _setListElementCSSStyle(Object component,
                                              Object typeId,
                                              Object itemId,
                                              Object property,
                                              Object style)

Parameters:

component
typeId
itemId
property
style

Return:

Object

_setListRowCSSStyle

private static Object _setListRowCSSStyle(Object component,
                                          Object itemId,
                                          Object property,
                                          Object style)

Parameters:

component
itemId
property
style

Return:

Object

_setPanelCSSStyle

private static Object _setPanelCSSStyle(Object component,
                                        Object typeId,
                                        Object property,
                                        Object style)

Parameters:

component
typeId
property
style

Return:

Object

_showListElement

private static Object _showListElement(Object component,
                                       Object typeId,
                                       Object itemId)

Parameters:

component
typeId
itemId

Return:

Object

_showListRow

private static Object _showListRow(Object component,
                                   Object itemId)

Parameters:

component
itemId

Return:

Object

_showProgressIndicator

private Object _showProgressIndicator(Object itemId)

Parameters:

itemId

Return:

Object

_unmaskListElement

private static Object _unmaskListElement(Object component,
                                         Object typeId,
                                         Object itemId)

Parameters:

component
typeId
itemId

Return:

Object

_unmaskListRow

private static Object _unmaskListRow(Object component,
                                     Object itemId)

Parameters:

component
itemId

Return:

Object

_unmaskPanelElement

private static Object _unmaskPanelElement(Object component,
                                          Object typeId)

Parameters:

component
typeId

Return:

Object

_updateProgress

private Object _updateProgress(Object filename,
                               Object percentComplete)

Parameters:

filename
percentComplete

Return:

Object

_uploadFileInQueue

private static Object _uploadFileInQueue(Object component,
                                         Object filename)

Parameters:

component
filename

Return:

Object

_uploadFilesInQueue

private Object _uploadFilesInQueue(Object component,
                                   Object filename)

Parameters:

component
filename

Return:

Object

_uploadNextFileInQueue

private static Object _uploadNextFileInQueue(Object component)

Parameters:

component

Return:

Object

_validateSingleInputFileSizeMaxDiskSpace

private Object _validateSingleInputFileSizeMaxDiskSpace(Object element)

Parameters:

element

Return:

Object

VetoBlurValidation

protected Object VetoBlurValidation()

For input file peers, we want to use onchange for validation, instead of the focus/blur combi. There are two main reasons for this: - There is no browser built-in autocomplete for input file elements. - Safari does not trigger focus/blur on input file elements.

Return:

Object

Overrides:

AdfDhtmlInputBasePeer.VetoBlurValidation()

VetoShowNoteWindow

protected Object VetoShowNoteWindow(Object component)

Parameters:

component

Return:

Object

Overrides:

AdfDhtmlEditableValuePeer.VetoShowNoteWindow(Object)