Skip to content

Latest commit

 

History

History
70 lines (47 loc) · 4.19 KB

Facet_Filter_c6c3821.md

File metadata and controls

70 lines (47 loc) · 4.19 KB
loio
c6c38217a4a64001a22ad76cdfa97fae

view on: demo kit nightly build | demo kit latest release

Facet Filter

Facet filters (sap.m.FacetFilter) support users in finding the information they need from potentially very large data sets.

With the facet filter, users can explore a data collection by applying multiple filters along certain discrete attributes or facets of the overall data collection.

The following figure shows the structure of the facet filter.

Example

Your application displays a large list of products that can be grouped by category and supplier. With the facet filter, you allow users to dynamically filter the list so it only displays products from the categories and suppliers they want to see. In the following figure, the FacetFilter control is outlined in red and will be referred to as the 'toolbar' for the user. In the example, the user has set the following filters:

  • Category: Printer

  • Supplier: Red Point Stores

The facet filter supports the following two typeswhich can be configures using the control's type property:

  • Simple type

    The simple type is the default type and available for desktop and tablets.

  • Light type

    The light type is automatically enabled on smart phone sized devices, but is also available for desktop and tablets.

  • Facet Filter: Simple Type
    The simple type of the FacetFilter control is only available for desktop and tablets.

  • Facet Filter: Light Type
    The light type of the FacetFilter control is automatically enabled on smart phone devices and is also available for desktop and tablets.

  • Facet Filter List and Facet Filter Item
    The sap.m.FacetFilter control uses the FacetFilterList and the FacetFilterItem controls to model facets and their associated filters.

  • Events for Facet Filters
    Facet filters support several events, such as reset and list open.

  • Data Binding for Facet Filters
    FacetFilter fully supports the OpenUI5 data binding concept.

  • Filter Search
    The popover and dialog displayed by FacetFilter contain an sap.m.SearchField control. This enables the user to search for specific items in the list.

  • Facet Filter Selection
    The FacetFilterList.getSelectedItems() method returns a copy of each selected facet filter item. You use the method to get the selected filter items when filtering the target data set.

  • Dependent Facets
    Applications can have dependencies between facets where selection of filter items in one facet list limits the list of valid filters in another facet list.