Class sap.ui.ux3.FacetFilterListModule: sap/ui/ux3/FacetFilterList

extends Control

List to be used with the FacetFilter control. The control is not intended to be used stand alone.

Deprecated API:Since version 1.38. Instead, use the sap.m.FacetFilter control.

Constructor Summary
new sap.ui.ux3.FacetFilterList(sId?, mSettings?)Constructor for a new FacetFilterList.
Event Summary
select(oControlEvent)On Select event.
Events borrowed from class sap.ui.core.Control
validateFieldGroup
Events borrowed from class sap.ui.base.ManagedObject
formatError, modelContextChange, parseError, validationError, validationSuccess
Method Summary
sap.ui.ux3.FacetFilterList.extend(sClassName, oClassInfo?, FNMetaImpl?)Creates a new subclass of class sap.ui.ux3.FacetFilterList with name sClassName and enriches it with the information contained in oClassInfo.
sap.ui.ux3.FacetFilterList.getMetadata()Returns a metadata object for class sap.ui.ux3.FacetFilterList.
addItem(oItem)Adds some item to the aggregation items.
attachSelect(oData?, fnFunction, oListener?)Attaches event handler fnFunction to the select event of this sap.ui.ux3.FacetFilterList.
destroyItems()Destroys all the items in the aggregation items.
detachSelect(fnFunction, oListener)Detaches event handler fnFunction from the select event of this sap.ui.ux3.FacetFilterList.
fireSelect(mArguments?)Fires event select to attached listeners.
getDisplaySecondaryValues()Gets current value of property displaySecondaryValues.
getItems()Gets content of aggregation items.
getMultiSelect()Gets current value of property multiSelect.
getSelectedKeys()Gets current value of property selectedKeys.
getShowCounter()Gets current value of property showCounter.
getTitle()Gets current value of property title.
indexOfItem(oItem)Checks for the provided sap.ui.core.ListItem in the aggregation items.
insertItem(oItem, iIndex)Inserts a item into the aggregation items.
removeAllItems()Removes all the controls from the aggregation items.
removeItem(vItem)Removes a item from the aggregation items.
setDisplaySecondaryValues(bDisplaySecondaryValues)Sets a new value for property displaySecondaryValues.
setMultiSelect(bMultiSelect)Sets a new value for property multiSelect.
setSelectedKeys(sSelectedKeys)Sets a new value for property selectedKeys.
setShowCounter(bShowCounter)Sets a new value for property showCounter.
setTitle(sTitle)Sets a new value for property title.
Methods borrowed from class sap.ui.core.Control
addStyleClass, allowTextSelection, attachBrowserEvent, attachValidateFieldGroup, checkFieldGroupIds, clone, detachBrowserEvent, detachValidateFieldGroup, fireValidateFieldGroup, getAccessibilityInfo, getBusy, getBusyIndicatorDelay, getControlsByFieldGroupId, getFieldGroupIds, getIdForLabel, getRenderer, getVisible, hasStyleClass, invalidate, isBusy, onAfterRendering, placeAt, removeStyleClass, rerender, setBusy, setBusyIndicatorDelay, setFieldGroupIds, setVisible, toggleStyleClass, triggerValidateFieldGroup
Methods borrowed from class sap.ui.core.Element
$, addCustomData, addDependent, addEventDelegate, applyFocusInfo, bindElement, data, destroy, destroyCustomData, destroyDependents, destroyLayoutData, destroyTooltip, enhanceAccessibilityState, exit, findElements, fireEvent, focus, getCustomData, getDependents, getDomRef, getElementBinding, getFocusDomRef, getFocusInfo, getInterface, getLayoutData, getMetadata, getTooltip, getTooltip_AsString, getTooltip_Text, indexOfCustomData, indexOfDependent, insertCustomData, insertDependent, prop, removeAllCustomData, removeAllDependents, removeCustomData, removeDependent, removeEventDelegate, setLayoutData, setTooltip, toString, unbindElement
Methods borrowed from class sap.ui.base.ManagedObject
addAggregation, addAssociation, applySettings, attachFormatError, attachModelContextChange, attachParseError, attachValidationError, attachValidationSuccess, bindAggregation, bindContext, bindObject, bindProperty, destroyAggregation, detachFormatError, detachModelContextChange, detachParseError, detachValidationError, detachValidationSuccess, findAggregatedObjects, fireFormatError, fireModelContextChange, fireParseError, fireValidationError, fireValidationSuccess, getAggregation, getAssociation, getBinding, getBindingContext, getBindingInfo, getBindingPath, getEventingParent, getId, getModel, getObjectBinding, getOriginInfo, getParent, getProperty, hasModel, indexOfAggregation, insertAggregation, isBound, isInvalidateSuppressed, isTreeBinding, propagateMessages, removeAggregation, removeAllAggregation, removeAllAssociation, removeAssociation, setAggregation, setAssociation, setBindingContext, setModel, setProperty, unbindAggregation, unbindContext, unbindObject, unbindProperty, validateAggregation, validateProperty
Methods borrowed from class sap.ui.base.EventProvider
attachEvent, attachEventOnce, detachEvent, hasListeners
Constructor Detail
new sap.ui.ux3.FacetFilterList(sId?, mSettings?)
Constructor for a new FacetFilterList.

Accepts an object literal mSettings that defines initial property values, aggregated and associated objects as well as event handlers. See sap.ui.base.ManagedObject for a general description of the syntax of the settings object.

The supported settings are:

In addition, all settings applicable to the base type sap.ui.core.Control can be used as well.

Parameters:
{string}sId? id for the new control, generated automatically if no id is given
{object}mSettings? initial settings for the new control
Deprecated:
Since version 1.38. Instead, use the sap.m.FacetFilter control.
Event Detail
select(oControlEvent)
On Select event.
Parameters:
{sap.ui.base.Event}oControlEvent
{sap.ui.base.EventProvider}oControlEvent.getSource
{object}oControlEvent.getParameters
{string}oControlEvent.getParameters.id Id of the FacetFilterList taht fires the event.
{int[]}oControlEvent.getParameters.selectedIndices Array of selected Indices.
{sap.ui.core.ListItem[]}oControlEvent.getParameters.selectedItems Array of selected Items.
{boolean}oControlEvent.getParameters.all If it is true, then Item All is selected. That means all items in the list are selected - no filter is set.
Method Detail
sap.ui.ux3.FacetFilterList.extend(sClassName, oClassInfo?, FNMetaImpl?): function
Creates a new subclass of class sap.ui.ux3.FacetFilterList with name sClassName and enriches it with the information contained in oClassInfo.

oClassInfo might contain the same kind of information as described in sap.ui.core.Control.extend.

Parameters:
{string}sClassName Name of the class being created
{object}oClassInfo? Object literal with information about the class
{function}FNMetaImpl? Constructor function for the metadata object; if not given, it defaults to sap.ui.core.ElementMetadata
Returns:
{function} Created class / constructor function
sap.ui.ux3.FacetFilterList.getMetadata(): sap.ui.base.Metadata
Returns a metadata object for class sap.ui.ux3.FacetFilterList.
Returns:
{sap.ui.base.Metadata} Metadata object describing this class
addItem(oItem): sap.ui.ux3.FacetFilterList
Adds some item to the aggregation items.
Parameters:
{sap.ui.core.ListItem}oItem the item to add; if empty, nothing is inserted
Returns:
{sap.ui.ux3.FacetFilterList} Reference to this in order to allow method chaining
attachSelect(oData?, fnFunction, oListener?): sap.ui.ux3.FacetFilterList
Attaches event handler fnFunction to the select event of this sap.ui.ux3.FacetFilterList.

When called, the context of the event handler (its this) will be bound to oListener if specified, otherwise it will be bound to this sap.ui.ux3.FacetFilterList itself.

On Select event.

Parameters:
{object}oData? An application-specific payload object that will be passed to the event handler along with the event object when firing the event
{function}fnFunction The function to be called when the event occurs
{object}oListener? Context object to call the event handler with. Defaults to this sap.ui.ux3.FacetFilterList itself
Returns:
{sap.ui.ux3.FacetFilterList} Reference to this in order to allow method chaining
destroyItems(): sap.ui.ux3.FacetFilterList
Destroys all the items in the aggregation items.
Returns:
{sap.ui.ux3.FacetFilterList} Reference to this in order to allow method chaining
detachSelect(fnFunction, oListener): sap.ui.ux3.FacetFilterList
Detaches event handler fnFunction from the select event of this sap.ui.ux3.FacetFilterList.

The passed function and listener object must match the ones used for event registration.

Parameters:
{function}fnFunction The function to be called, when the event occurs
{object}oListener Context object on which the given function had to be called
Returns:
{sap.ui.ux3.FacetFilterList} Reference to this in order to allow method chaining
fireSelect(mArguments?): sap.ui.ux3.FacetFilterList
Fires event select to attached listeners.

Expects the following event parameters:

  • id of type stringId of the FacetFilterList taht fires the event.
  • selectedIndices of type int[]Array of selected Indices.
  • selectedItems of type sap.ui.core.ListItem[]Array of selected Items.
  • all of type booleanIf it is true, then Item All is selected. That means all items in the list are selected - no filter is set.
Parameters:
{Map}mArguments? The arguments to pass along with the event
Returns:
{sap.ui.ux3.FacetFilterList} Reference to this in order to allow method chaining
getDisplaySecondaryValues(): boolean
Gets current value of property displaySecondaryValues.

Specifies whether the text values from the additionalText property (see sap.ui.core.ListItems) shall be displayed.

Default value is false.

Since:
1.9.0
Returns:
{boolean} Value of property displaySecondaryValues
getItems(): sap.ui.core.ListItem[]
Gets content of aggregation items.

The filter values that are presented as a list.

Returns:
{sap.ui.core.ListItem[]}
getMultiSelect(): boolean
Gets current value of property multiSelect.

Specifies whether multiple or single selection is used.

Default value is true.

Returns:
{boolean} Value of property multiSelect
getSelectedKeys(): string[]
Gets current value of property selectedKeys.

Array of type string containing the selected keys.

Returns:
{string[]} Value of property selectedKeys
getShowCounter(): boolean
Gets current value of property showCounter.

Specifies whether the counter for all entries is shown.

Default value is true.

Returns:
{boolean} Value of property showCounter
getTitle(): string
Gets current value of property title.

The title of this list.

Returns:
{string} Value of property title
indexOfItem(oItem): int
Checks for the provided sap.ui.core.ListItem in the aggregation items. and returns its index if found or -1 otherwise.
Parameters:
{sap.ui.core.ListItem}oItem The item whose index is looked for
Returns:
{int} The index of the provided control in the aggregation if found, or -1 otherwise
insertItem(oItem, iIndex): sap.ui.ux3.FacetFilterList
Inserts a item into the aggregation items.
Parameters:
{sap.ui.core.ListItem}oItem the item to insert; if empty, nothing is inserted
{int}iIndex the 0-based index the item should be inserted at; for a negative value of iIndex, the item is inserted at position 0; for a value greater than the current size of the aggregation, the item is inserted at the last position
Returns:
{sap.ui.ux3.FacetFilterList} Reference to this in order to allow method chaining
removeAllItems(): sap.ui.core.ListItem[]
Removes all the controls from the aggregation items.

Additionally, it unregisters them from the hosting UIArea.

Returns:
{sap.ui.core.ListItem[]} An array of the removed elements (might be empty)
removeItem(vItem): sap.ui.core.ListItem
Removes a item from the aggregation items.
Parameters:
{int|string|sap.ui.core.ListItem}vItem The itemto remove or its index or id
Returns:
{sap.ui.core.ListItem} The removed item or null
setDisplaySecondaryValues(bDisplaySecondaryValues): sap.ui.ux3.FacetFilterList
Sets a new value for property displaySecondaryValues.

Specifies whether the text values from the additionalText property (see sap.ui.core.ListItems) shall be displayed.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is false.

Parameters:
{boolean}bDisplaySecondaryValues New value for property displaySecondaryValues
Since:
1.9.0
Returns:
{sap.ui.ux3.FacetFilterList} Reference to this in order to allow method chaining
setMultiSelect(bMultiSelect): sap.ui.ux3.FacetFilterList
Sets a new value for property multiSelect.

Specifies whether multiple or single selection is used.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is true.

Parameters:
{boolean}bMultiSelect New value for property multiSelect
Returns:
{sap.ui.ux3.FacetFilterList} Reference to this in order to allow method chaining
setSelectedKeys(sSelectedKeys): sap.ui.ux3.FacetFilterList
Sets a new value for property selectedKeys.

Array of type string containing the selected keys.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{string[]}sSelectedKeys New value for property selectedKeys
Returns:
{sap.ui.ux3.FacetFilterList} Reference to this in order to allow method chaining
setShowCounter(bShowCounter): sap.ui.ux3.FacetFilterList
Sets a new value for property showCounter.

Specifies whether the counter for all entries is shown.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is true.

Parameters:
{boolean}bShowCounter New value for property showCounter
Returns:
{sap.ui.ux3.FacetFilterList} Reference to this in order to allow method chaining
setTitle(sTitle): sap.ui.ux3.FacetFilterList
Sets a new value for property title.

The title of this list.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{string}sTitle New value for property title
Returns:
{sap.ui.ux3.FacetFilterList} Reference to this in order to allow method chaining