FacetFilter Provides filtering functionality with multiple parameters. <h3>Overview</h3> The <code>FacetFilter</code> control is used to provide filtering functionality with multiple parameters and supports the users in finding the information they need from potentially very large data sets. Your app can have dependencies between facets where selection of filter items in one facet list limits the list of valid filters in another facet list. The <code>FacetFilter</code> uses {@link sap.m.FacetFilterList FacetFilterList} and {@link sap.m.FacetFilterItem FacetFilterItem} to model facets and their associated filters. <b>Note: </b>{@link sap.m.FacetFilterList FacetFilterList} is a subclass of {@link sap.m.List} and supports growing enablement feature via the property <code>growing</code>. When you use this feature, be aware that it only works with one-way data binding. Having growing feature enabled when the <code>items</code> aggregation is bound to a model with two-way data binding, may lead to unexpected and/or inconsistent behavior across browsers, such as unexpected closing of the list. <h3>Usage</h3> Use the <code>FacetFilter</code> if your app displays a large list of items that can be grouped by multiple parameters, for example products by category and supplier. With the <code>FacetFilter</code>, you allow the users to dynamically filter the list so it only displays products from the categories and suppliers they want to see. While the {@link sap.m.FacetFilterList} popup is opened (when the user selects a button corresponding to the list's name), any other activities leading to focus change will close it. For example, when the popup is opened and the app developer loads a {@link sap.m.BusyDialog} or any other dialog that obtains the focus, the popup will be closed. <h3>Responsive behavior</h3> The <code>FacetFilter</code> supports the following two types, which can be configured using the control's <code>type</code> property: <ul><li>Simple type (default) - only available for desktop and tablet screen sizes. The active facets are displayed as individually selectable buttons on the toolbar.</li> <li>Light type - automatically enabled on smart phone sized devices, but also available for desktop and tablets. The active facets and selected filter items are displayed in the summary bar. When the user selects the summary bar, a navigable dialog list of all facets is displayed. When the user selects a facet, the dialog scrolls to show the list of filters that are available for the selected facet.</li></ul> <h3>Additional Information</h3> For more information, go to <b>Developer Guide</b> section in the Demo Kit and navigate to <b>More&nbsp;About&nbsp;Controls</b>&nbsp;>&nbsp;<b>sap.m</b>&nbsp;>&nbsp;<b>Facet&nbsp;Filter</b> sap.ui.core/Control If set to <code>true</code> and the FacetFilter type is <code>Simple</code>, then the Add Facet icon will be displayed and each facet button will also have a Facet Remove icon displayed beside it, allowing the user to deactivate the facet. <b>Note:</b> Always set this property to <code>true</code> when your facet lists are not active, so that the user is able to select them and interact with them. Defines the default appearance of the FacetFilter on the device. Possible values are <code>Simple</code> (default) and <code>Light</code>. Enables/disables live search in the search field of all <code>sap.m.FacetFilterList</code> instances. Shows the summary bar instead of the FacetFilter buttons bar when set to <code>true</code>. Shows/hides the FacetFilter Reset button. If set to <code>true</code>, an OK button is displayed for every FacetFilterList popover. This button allows the user to close the popover from within the popover instead of having to click outside of it. Fired when the Reset button is pressed to inform that all FacetFilterLists need to be reset. Fired when the user confirms filter selection. Collection of FacetFilterList controls. Hidden aggregation of buttons that open each FacetFilterList popover. These buttons are displayed only when the FacetFilter is of type <code>Simple</code>. Hidden aggregation of icons for setting FacetFilterLists to inactive, thereby, removing the FacetFilter button from the display. The icon is displayed only if personalization is enabled. Hidden aggregation for the FacetFilterLists popover. Hidden aggregation for the Add Facet button. This button allows the user to open the facet dialog and add or configure facets. This is displayed only if personalization is enabled and the FacetFilter is of type <code>Simple</code>. Hidden aggregation for the dialog that displays the facet and filter items pages. Hidden aggregation for the summary bar. Hidden aggregation for the Reset button displayed for FacetFilter of type <code>Simple</code>. Hidden aggregation for the arrow that scrolls the facets to the left when the FacetFilter is set to type <code>Simple</code>. Hidden aggregation for the arrow that scrolls the facets to the right when the FacetFilter is set to type <code>Simple</code>. Opens the FacetFilter dialog.