# 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.laf.dhtml.rich
Class AdfDhtmlSelectOneChoicePeer

## 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.adfinternal.view.js.laf.dhtml.rich.subids.AdfDhtmlSelectOnePeer
             |
             +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlSelectOneListbasePeer
                   |
                   +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlSelectOneChoicePeer

    public class AdfDhtmlSelectOneChoicePeer
    extends AdfDhtmlSelectOneListbasePeer

Renders a selectOneChoice for DHTML

## Field Summary
`private Object` | `_adjustWidth`
`private static Object` | `_COMPACT`
`private static Object` | `_CONTENT_ID`
`private static Object` | `_DROPDOWN_ID`
`private static Object` | `_HIGHLIGHTED_STYLE_CLASS`
`private static Object` | `_KEYBOARD_TYPE_DELAY`
`private static Object` | `_POPUP_ID`
`private static Object` | `_POPUP_PANEL_ID`
`private static Object` | `_POPUP_WRAPPER_ID`
`private static Object` | `_SCROLL_STYLE`
`private static Object` | `_SELECTED_STYLE_CLASS`
`private static Object` | `_SPACER_ID`
`protected Object` | `StashOldValue`
`private static Object` | `_TEMP_OPTION_KEY`

### Fields inherited from org.ecmascript.object.Object
`constructor, prototype`

## Constructor Summary
`public` | `AdfDhtmlSelectOneChoicePeer()` Renders a selectOneChoice for DHTML

## Method Summary
`private Object` | `_adjustWidth(Object component, Object domElement)` To maintain parity in width for applications that are migrating from native select element based implementation to custom input based element if contentStyle attribute is set.
`private static Object` | `_clearKeyboardValue(Object component)`
`protected Object` | `ComponentDisabledChanged(Object component, Object domElement, Object newValue, Object oldValue)`
`protected Object` | `ComponentValueChanged(Object component, Object domElement, Object newValue, Object oldValue)`
`protected Object` | `FindItemElementWithValue(Object component, Object itemValue)` This method is also invoked by OATS.
`protected Object` | `GetComponentMode(Object component)` Protected property getter for mode property.
`protected Object` | `GetComponentSelectItems(Object component, Object domElement)`
`private static Object` | `_getComputedWidth(Object element)`
`private Object` | `_getFocusElement(Object component)`
`protected Object` | `GetInlineEditor(Event event)` Override to return an inline editor that edits the component's label property
`protected Object` | `GetItemElements(Object component)`
`protected Object` | `GetItemElementsParent(Object component)` Returns the parent of the item elements so that the item elements can be traversed
`private static Object` | `_getLabelElementInCompactMode(Object component)`
`protected Object` | `GetNoteWindowAlignmentNode(Object component, Object rootNode)` Returns the node for which to align the note help window
`protected Object` | `GetSubmittedValue(Object component, Object domElement)`
`protected Object` | `HandleComponentBlur(Object componentEvent)`
`protected Object` | `HandleComponentClick(Object componentEvent)` component mouse click event handler.
`protected Object` | `HandleComponentKeyDown(Object componentEvent)`
`protected Object` | `HandleComponentKeyPress(Object componentEvent)` Component keyboard key press event handler
`protected Object` | `HandleComponentKeyUp(Object componentEvent)`
`protected Object` | `HandleComponentMouseDown(Object componentEvent)` component mouse down event handler to popup the option list.
`protected Object` | `HandleDomChange(Object component, Object domEvent)` DOM change event event handler
`protected Object` | `InitDomElement(Object component, Object domElement)`
`protected static Object` | `InitSubclass()`
`private Object` | `_isCompact(Object component)` This method is also invoked by OATS.
`private Object` | `_isCompactOrCustomModeSupported(Object component)` This to check whether compact mode or custom render mode supported.
`protected Object` | `IsItemEnabled(Object element)` Check to see if an element is enabled
`private Object` | `_isNativeSelectNotSupported(Object domElement)` This is to check native select is not supported or supported.
`protected Object` | `LazyInitialize(Object component, Object domElement)`
`private static Object` | `_matcher(Object itemLabel, Object matchText)`
`public Object` | `needsFocusTargetStyleClass()`
`protected Object` | `PopupClosed(Object component, Object contentDom, Object popupId)` Call back method called when the popup option list is closed.
`private Object` | `_removeComponentRenderedNoSelectItem(Object component, Object newValue)`
`private Object` | `_returnToDropDown(Object component)`
`private Object` | `_selectedItemIndex(Object selectItems)`
`private Object` | `_selectItemOnTyping(Object component, Object keyboardValue)` Update the UI to roll to a spin item whose text matches the keyboard value passed
`private Object` | `_selectMatchingItem(Object selectItems, Object startIndex, Object endIndex, Object matchText)`
`protected Object` | `SetBusy(Object isBusy)` Disable the component when the component is busy
`protected Object` | `SetDisplayValue(Object component, Object domElement, Object newValue)` This method is also invoked by OATS
`private Object` | `_showPopupPanel(Object component)`
`protected Object` | `VetoShowNoteWindow(Object component)`

### Methods inherited from oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlSelectOneListbasePeer
`GetFirstEnabledItem, GetNextEnabledItem, GetPreviousEnabledItem, SelectItemElement`

### Methods inherited from oracle.adfinternal.view.js.laf.dhtml.rich.subids.AdfDhtmlSelectOnePeer
`GetSubIdDomElement`

## Field Detail

### _adjustWidth

`private Object _adjustWidth`

### _COMPACT

`private static Object _COMPACT`

### _CONTENT_ID

`private static Object _CONTENT_ID`

### _DROPDOWN_ID

`private static Object _DROPDOWN_ID`

### _HIGHLIGHTED_STYLE_CLASS

`private static Object _HIGHLIGHTED_STYLE_CLASS`

### _KEYBOARD_TYPE_DELAY

`private static Object _KEYBOARD_TYPE_DELAY`

### _POPUP_ID

`private static Object _POPUP_ID`

### _POPUP_PANEL_ID

`private static Object _POPUP_PANEL_ID`

### _POPUP_WRAPPER_ID

`private static Object _POPUP_WRAPPER_ID`

### _SCROLL_STYLE

`private static Object _SCROLL_STYLE`

### _SELECTED_STYLE_CLASS

`private static Object _SELECTED_STYLE_CLASS`
  Overrides:
    `AdfDhtmlSelectOneListbasePeer._SELECTED_STYLE_CLASS`

### _SPACER_ID

`private static Object _SPACER_ID`

### StashOldValue

`protected Object StashOldValue`

### _TEMP_OPTION_KEY

`private static Object _TEMP_OPTION_KEY`

## Constructor Detail

### AdfDhtmlSelectOneChoicePeer

`public AdfDhtmlSelectOneChoicePeer()`
  Renders a selectOneChoice for DHTML

## Method Detail

### _adjustWidth

`private Object _adjustWidth(Object component,
Object domElement)`
  To maintain parity in width for applications that are migrating from native select element based implementation to custom input based element if contentStyle attribute is set. This is also need since the component renders as
  Parameters:

    `component` |  |
    `domElement` |  |

  Return:
    `Object`

### _clearKeyboardValue

`private static Object _clearKeyboardValue(Object component)`
  Parameters:

    `component` |  |

  Return:
    `Object`

### ComponentDisabledChanged

`protected Object ComponentDisabledChanged(Object component,
Object domElement,
Object newValue,
Object oldValue)`
  Parameters:

    `component` |  |
    `domElement` |  |
    `newValue` |  |
    `oldValue` |  |

  Return:
    `Object`

### ComponentValueChanged

`protected Object ComponentValueChanged(Object component,
Object domElement,
Object newValue,
Object oldValue)`
  Parameters:

    `component` |  |
    `domElement` |  |
    `newValue` |  |
    `oldValue` |  |

  Return:
    `Object`

### FindItemElementWithValue

`protected Object FindItemElementWithValue(Object component,
Object itemValue)`
  This method is also invoked by OATS.
  Parameters:

    `component` |  |
    `itemValue` |  |

  Return:
    `Object`
  Overrides:
    `AdfDhtmlSelectOneListbasePeer.FindItemElementWithValue(Object, Object)`

### GetComponentMode

`protected Object GetComponentMode(Object component)`
  Protected property getter for mode property. It is implemented to avoid subclass unable to get mode property issue.
  Parameters:

    `component` |  |

  Return:
    `Object`

### GetComponentSelectItems

`protected Object GetComponentSelectItems(Object component,
Object domElement)`
  Parameters:

    `component` |  |
    `domElement` |  |

  Return:
    `Object`
  Overrides:
    `AdfDhtmlSelectOneListbasePeer.GetComponentSelectItems(Object, Object)`

### _getComputedWidth

`private static Object _getComputedWidth(Object element)`
  Parameters:

    `element` |  |

  Return:
    `Object`

### _getFocusElement

`private Object _getFocusElement(Object component)`
  Parameters:

    `component` |  |

  Return:
    `Object` - the DOM element of the drop down icon in compact mode TODO This will change once we have skinning/icons on the client, since with skinning we can't guarantee this is an img element.

### GetInlineEditor

`protected Object GetInlineEditor(Event event)`
  Override to return an inline editor that edits the component's label property
  Parameters:

    `event` | - | DOM Event that triggered the inline edit

  Return:
    `Object`

### GetItemElements

`protected Object GetItemElements(Object component)`
  Parameters:

    `component` |  |

  Return:
    `Object`
  Overrides:
    `AdfDhtmlSelectOneListbasePeer.GetItemElements(Object)`

### GetItemElementsParent

`protected Object GetItemElementsParent(Object component)`
  Returns the parent of the item elements so that the item elements can be traversed
  Parameters:

    `component` |  |

  Return:
    `Object`
  Overrides:
    `AdfDhtmlSelectOneListbasePeer.GetItemElementsParent(Object)`

### _getLabelElementInCompactMode

`private static Object _getLabelElementInCompactMode(Object component)`
  Parameters:

    `component` |  |

  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`

### GetSubmittedValue

`protected Object GetSubmittedValue(Object component,
Object domElement)`
  Parameters:

    `component` |  |
    `domElement` |  |

  Return:
    `Object`
  Overrides:
    `AdfDhtmlSelectOneListbasePeer.GetSubmittedValue(Object, Object)`

### HandleComponentBlur

`protected Object HandleComponentBlur(Object componentEvent)`
  Parameters:

    `componentEvent` |  |

  Return:
    `Object`

### HandleComponentClick

`protected Object HandleComponentClick(Object componentEvent)`
  component mouse click event handler.
  Parameters:

    `componentEvent` | - | the component event invoked by mouse click

  Return:
    `Object`

### HandleComponentKeyDown

`protected Object HandleComponentKeyDown(Object componentEvent)`
  Parameters:

    `componentEvent` | - | Key Press event - Implement keyboard support for selectOneChoice

  Return:
    `Object`

### HandleComponentKeyPress

`protected Object HandleComponentKeyPress(Object componentEvent)`
  Component keyboard key press event handler
  Parameters:

    `componentEvent` | - | the component event invoked by key press

  Return:
    `Object`

### HandleComponentKeyUp

`protected Object HandleComponentKeyUp(Object componentEvent)`
  Parameters:

    `componentEvent` | - | Key up event

  Return:
    `Object`

### HandleComponentMouseDown

`protected Object HandleComponentMouseDown(Object componentEvent)`
  component mouse down event handler to popup the option list.
  Parameters:

    `componentEvent` | - | the component event invoked by mouse down

  Return:
    `Object`

### HandleDomChange

`protected Object HandleDomChange(Object component,
Object domEvent)`
  DOM change event event handler
  Parameters:

    `component` |  |
    `domEvent` |  |

  Return:
    `Object`

### InitDomElement

`protected Object InitDomElement(Object component,
Object domElement)`
  Parameters:

    `component` |  |
    `domElement` |  |

  Return:
    `Object`

### InitSubclass

`protected static Object InitSubclass()`
  Return:
    `Object`
  Overrides:
    `AdfDhtmlSelectOneListbasePeer.InitSubclass()`

### _isCompact

`private Object _isCompact(Object component)`
  This method is also invoked by OATS.
  Parameters:

    `component` |  |

  Return:
    `Object` - whether the compact property is set to true.

### _isCompactOrCustomModeSupported

`private Object _isCompactOrCustomModeSupported(Object component)`
  This to check whether compact mode or custom render mode supported.
  Parameters:

    `component` |  |

  Return:
    `Object`

### IsItemEnabled

`protected Object IsItemEnabled(Object element)`
  Check to see if an element is enabled
  Parameters:

    `element` |  |

  Return:
    `Object`
  Overrides:
    `AdfDhtmlSelectOneListbasePeer.IsItemEnabled(Object)`

### _isNativeSelectNotSupported

`private Object _isNativeSelectNotSupported(Object domElement)`
  This is to check native select is not supported or supported. This method is also invoked by OATS.
  Parameters:

    `domElement` |  |

  Return:
    `Object`

### LazyInitialize

`protected Object LazyInitialize(Object component,
Object domElement)`
  Parameters:

    `component` |  |
    `domElement` |  |

  Return:
    `Object`

### _matcher

`private static Object _matcher(Object itemLabel,
Object matchText)`
  Parameters:

    `itemLabel` |  |
    `matchText` |  |

  Return:
    `Object`

### needsFocusTargetStyleClass

`public Object needsFocusTargetStyleClass()`
  Return:
    `Object`

### PopupClosed

`protected Object PopupClosed(Object component,
Object contentDom,
Object popupId)`
  Call back method called when the popup option list is closed. This is used to do clean up after close
  Parameters:

    `component` |  |
    `contentDom` |  |
    `popupId` |  |

  Return:
    `Object`

### _removeComponentRenderedNoSelectItem

`private Object _removeComponentRenderedNoSelectItem(Object component,
Object newValue)`
  Parameters:

    `component` |  |
    `newValue` |  |

  Return:
    `Object`

### _returnToDropDown

`private Object _returnToDropDown(Object component)`
  Parameters:

    `component` |  |

  Return:
    `Object`

### _selectedItemIndex

`private Object _selectedItemIndex(Object selectItems)`
  Parameters:

    `selectItems` |  |

  Return:
    `Object`

### _selectItemOnTyping

`private Object _selectItemOnTyping(Object component,
Object keyboardValue)`
  Update the UI to roll to a spin item whose text matches the keyboard value passed
  Parameters:

    `component` |  |
    `keyboardValue` |  |

  Return:
    `Object`

### _selectMatchingItem

`private Object _selectMatchingItem(Object selectItems,
Object startIndex,
Object endIndex,
Object matchText)`
  Parameters:

    `selectItems` |  |
    `startIndex` |  |
    `endIndex` |  |
    `matchText` |  |

  Return:
    `Object`

### SetBusy

`protected Object SetBusy(Object isBusy)`
  Disable the component when the component is busy
  Parameters:

    `isBusy` |  |

  Return:
    `Object`

### SetDisplayValue

`protected Object SetDisplayValue(Object component,
Object domElement,
Object newValue)`
  This method is also invoked by OATS
  Parameters:

    `component` |  |
    `domElement` |  |
    `newValue` |  |

  Return:
    `Object`

### _showPopupPanel

`private Object _showPopupPanel(Object component)`
  Parameters:

    `component` |  |

  Return:
    `Object`

### VetoShowNoteWindow

`protected Object VetoShowNoteWindow(Object component)`
  Parameters:

    `component` |  |

  Return:
    `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.