VALUE
- is the generic type of the value
.public interface UiWidgetListBoxField<VALUE> extends UiWidgetListBase<VALUE>, UiWidgetField<List<VALUE>>, UiWidgetNative, AttributeWriteOptions<VALUE>, AttributeWriteHeightInRows
options field widget
that represents a
list box. Such widget is a simple list that allows to select one or multiple items out of a list
of options
. Its value
is therefore the
list of selected items
.UiWidgetOptionListTable
STYLE_FIELD, STYLE_LABEL, STYLE_MANDATORY, STYLE_VIEW
STYLE_HEADER
HTML_ATTRIBUTE_ID, ID_SEPARATOR, PROPERTY_ID
PROPERTY_STYLES, STYLE_PATTERN_MULTIPLE, STYLE_PATTERN_SINGLE
WAI_ARIA
PROPERTY_LABEL
ACCESS_KEY_NONE, HTML_ATTRIBUTE_ACCESS_KEY
Modifier and Type | Method and Description |
---|---|
RoleListbox |
getAriaRole()
This method gets the
Accessibility.WAI_ARIA role of this object. |
List<VALUE> |
getValue()
This method gets the value of this object.
|
asFeatureSelectedValue
getValueAndValidate, getValueDirect
addChangeHandler, removeChangeHandler
resetValue, setValue, setValue, setValueForUser
getOriginalValue, getValueOrException
addValidatorMandatory, isMandatory
addValidator, removeValidator
validate
addSelectionHandler, isSelected, removeSelectionHandler, setSelection
setSelectedValue, setSelectedValues
getSelectedValue, getSelectedValues, getSelectionCount, hasSelectedValue
setSelectionMode
getSelectionMode
getLabel, getLabelWidget, setLabel
getChild, getChild
getChildCount, getChildIndex
getContext, getParent, getSize
clearMessages
addEventHandler, removeEventHandler
setMode
getMode
setModeFixed
getModeFixed
setId
getId
setTooltip
getTooltip
getVisibleFlag, isVisible, setVisible, setVisible
isVisibleRecursive
setEnabled
isEnabled
addStyle, removeStyle
hasStyle
setStyles
getStyles
setPrimaryStyle
getPrimaryStyle
dispose
isDisposed
isModified
setValueAsString
getValueAsString
setValidationFailure
getValidationFailure
setTrimValue
isTrimValue
setAccessKey
getAccessKey
addFocusHandler, removeFocusHandler
isFocused
setFocused
setOptions
getOptions
setHeightInRows
getHeightInRows
RoleListbox getAriaRole()
Accessibility.WAI_ARIA
role
of this object. UiWidget
) is supposed to provide high-level
widgets and support setting the according Role
and their attributes automatically. Therefore
users should only use this for special situations e.g. for setting aria-hidden
intentionally for a visible object.getAriaRole
in interface AttributeReadAriaRole
Role
or null
if NOT set.Accessibility
List<VALUE> getValue()
null
instead. If you want to do validation and give feedback to the
user please use AttributeReadValueAdvanced.getValueOrException(Object)
instead. However, there are higher-level ways to do
this such as
getValueAndValidate
.
set values
and allow them to be modified in the UI
without side-effects on the original value. This is especially important for composite custom widgets
(e.g. editors
) to allow the
user to modify business entities and modifications can still be cancelled and changed will be reverted.
All objects that are (potentially) modified by the widgets will be copied. Therefore it is even safe to
modify the result of this method in most cases. However,
tree widgets
build an excuse and use
a copy on set/retrieve
strategy
.getValue
in interface AttributeReadValue<List<VALUE>>
getValue
in interface AttributeReadValueAdvanced<List<VALUE>>
getValue
in interface UiWidgetWithValue<List<VALUE>>
null
unless otherwise stated.Copyright © 2001–2016 mmm-Team. All rights reserved.