JavaScript API Reference for Oracle ADF Faces

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

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

Direct Known Subclasses:

AdfDhtmlEditableValuePeer, AdfDhtmlOutputFormattedPeer, AdfDhtmlOutputLabelPeer, AdfDhtmlTextPeer

public class AdfDhtmlValuePeer
extends AdfRichUIPeer

AdfDhtmlValuePeer

public AdfDhtmlValuePeer()

Subclasses of this should implement - GetDisplayValue - return a value that is ready to be passed to the converter - SetDisplayValue - This method takes a value that has already been converted. For most subclasses this method is passed a string.

ComponentValueChanged

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

Parameters:

component
domElement
newValue
oldValue

Return:

Object

GetComponentValue

protected Object GetComponentValue(Object component,
                                   Object domElement)

Parameters:

component
domElement

Return:

Object

getConvertedObject

public Object getConvertedObject(Object component,
                                 Object value)

This usually gets the converter and calls getAsString. Not calling this getConvertedString since this may return a list of strings or any object that the peer understands, thus calling it getConvertedObject instead. Can return undefined if converter not successful

Parameters:

component
value

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

GetDisplayValue

protected Object GetDisplayValue(Object component,
                                 Object domElement,
                                 Object unconditional)

return a value that is ready to be passed to the converter

Parameters:

component
domElement
unconditional	-	says whether or not to always return the display value, or whether null can be returned if certain conditions are not met

Return:

Object

getFormatHint

public Object getFormatHint(Object component)

Returns the format hint for the used converter of a peer

Parameters:

component

-

the underlying component for the peer, to access the converter, if present.

Return:

Object - the format hint (see TrConverter.getFormatHint()) or null, if no converter is present.

GetNullDefault

protected Object GetNullDefault()

Return:

Object

InitSubclass

protected static Object InitSubclass()

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

-

the submitted value

Return:

Object - does the peer think it's empty

setDisplayValue

public Object setDisplayValue(Object component,
                              Object newValue)

start: The public ver which calls the protected one , also binds the component to the peer before calling the protected version, which is smart.

Parameters:

component
newValue

Return:

Object

SetDisplayValue

protected Object SetDisplayValue(Object component,
                                 Object domElement,
                                 Object newValue)

set the display string

Parameters:

component
domElement
newValue	-	new string to be displayed

Return:

Object