Bound Filters - Filter Bar
This sample shows how bound filters work in a filter bar. As the user enters values, a toolbar with filter inputs instantly filters the customer table. It also demonstrates how to use the filter API to change the bound filters programmatically.
Z2UI5_CL_SMPC_APP_264
Controls
sap.ui.core
UI5 1.71
The facts
- Repository
- abap2UI5/samples-controls
- Class
Z2UI5_CL_SMPC_APP_264- Source file
z2ui5_cl_smpc_app_264.clas.abap↗- Library
- sap.ui.core
- UI5 entity
sap.ui.model.Filter- Demo kit sample
sap.ui.core.sample.BoundFilters.FilterBar- SAP's own sample
- running at sdk.openui5.org ↗
- Minimum UI5
- 1.71 — the floor abap2UI5 holds its samples to
- In the playground
- runs in the browser, with no system and nothing installed
Keywords: filter, sap.ui.model, boundfilters.filterbar, table, title, toolbar, label, input, toolbarspacer, button, column, text
Controls it builds
- sap.m.Button
- sap.m.Input
- sap.m.Label
- sap.m.Text
- sap.m.Title
- sap.m.Toolbar
- sap.m.ToolbarSpacer
- sap.ui.core.mvc.View
- sap.ui.table.Column
- sap.ui.table.Table
Read out of the builder chain by the abap2UI5 linter, not from the category this sample is filed under — which is what makes “which samples build one of these” a question the catalogue can answer at all.
Libraries
Run it here
The sample running, in this page — the app on its own, with no editor over it.
Switch to Playground with this code
Nothing is installed and nothing is sent anywhere: the ABAP is compiled to JavaScript in this browser and runs against abap2UI5 itself.
The ABAP
z2ui5_cl_smpc_app_264.clas.abap — 230 lines
Click a number to link to a line — shift-click for a range.
Read it on GitHub ↗
" @keywords filter sap.ui.model boundfilters.filterbar table title toolbar label input toolbarspacer button column text
" @summary This sample shows how bound filters work in a filter bar. As the user enters values, a toolbar with filter inputs instantly filters the customer table. It also demonstrates how to use the filter API to change the bound filters programmatically.
CLASS z2ui5_cl_smpc_app_264 DEFINITION PUBLIC.
PUBLIC SECTION.
INTERFACES z2ui5_if_app.
TYPES: BEGIN OF ty_s_teammember,
firstname TYPE string,
lastname TYPE string,
age TYPE i,
department TYPE string,
location TYPE string,
END OF ty_s_teammember.
DATA t_teammembers TYPE STANDARD TABLE OF ty_s_teammember WITH EMPTY KEY.
DATA departmentprefix TYPE string.
DATA locationprefix TYPE string.
DATA firstname TYPE string.
DATA lastname TYPE string.
DATA showorganizational TYPE abap_bool.
PROTECTED SECTION.
DATA client TYPE REF TO z2ui5_if_client.
METHODS view_display.
METHODS on_event.
METHODS model_init.
PRIVATE SECTION.
ENDCLASS.
CLASS z2ui5_cl_smpc_app_264 IMPLEMENTATION.
METHOD z2ui5_if_app~main.
me->client = client.
IF client->check_on_init( ).
model_init( ).
view_display( ).
ELSEIF client->check_on_navigated( ).
view_display( ).
ELSEIF client->check_on_event( ).
on_event( ).
ENDIF.
ENDMETHOD.
METHOD view_display.
DATA(view) = z2ui5_cl_ui5_view_builder=>factory( ).
" onToggleFilters replaces the binding's filter set with the other pair
" (organizational <-> personal). abap2UI5 bakes the binding info at render
" time, so the toggle event redraws the view with the other boundFilters
" list instead of calling ListBinding.filter (app 241 precedent). Only the
" fragment is composed here - every client->_bind( ) call stays inline.
DATA(lv_boundfilters) = COND string(
WHEN showorganizational = abap_true
THEN |\{ path: 'LOCATION', operator: 'StartsWith', value1: '{ client->_bind( locationprefix ) }' \}, | &&
|\{ path: 'DEPARTMENT', operator: 'StartsWith', value1: '{ client->_bind( departmentprefix ) }' \}|
ELSE |\{ path: 'FIRSTNAME', operator: 'StartsWith', value1: '{ client->_bind( firstname ) }' \}, | &&
|\{ path: 'LASTNAME', operator: 'StartsWith', value1: '{ client->_bind( lastname ) }' \}| ).
view->ele( n = `View` ns = `mvc`
)->a( n = `class` v = `sapUiSizeCompact`
)->a( n = `xmlns` v = `sap.m`
)->a( n = `xmlns:mvc` v = `sap.ui.core.mvc`
)->a( n = `xmlns:core` v = `sap.ui.core`
)->a( n = `xmlns:table` v = `sap.ui.table`
)->a( n = `xmlns:rm` v = `sap.ui.table.rowmodes`
" use odata types as they map empty input to null
)->a( n = `core:require` v = `{StringType: 'sap/ui/model/odata/type/String'}`
)->ele( n = `Table` ns = `table`
)->a( n = `id` v = `myTable`
)->a( n = `rows` v = |\{ path: '{ client->_bind_path( t_teammembers ) }', | &&
|boundFilters: [{ lv_boundfilters }] \}|
)->ele( n = `extension` ns = `table`
)->tag( `Title`
)->a( n = `id` v = `title`
)->a( n = `text` v = `Employees`
)->ele( `Toolbar`
)->tag( `Label`
)->a( n = `text` v = `Department prefix`
)->a( n = `labelFor` v = `departmentInput`
)->a( n = `visible` v = client->_bind( showorganizational )
)->tag( `Input`
)->a( n = `id` v = `departmentInput`
)->a( n = `width` v = `200px`
)->a( n = `value` v = |\{ path: '{ client->_bind_path( departmentprefix ) }', type: 'StringType' \}|
)->a( n = `visible` v = client->_bind( showorganizational )
)->tag( `Label`
)->a( n = `text` v = `Location prefix`
)->a( n = `labelFor` v = `locationInput`
)->a( n = `visible` v = client->_bind( showorganizational )
)->tag( `Input`
)->a( n = `id` v = `locationInput`
)->a( n = `width` v = `200px`
)->a( n = `value` v = |\{ path: '{ client->_bind_path( locationprefix ) }', type: 'StringType' \}|
)->a( n = `visible` v = client->_bind( showorganizational )
)->tag( `Label`
)->a( n = `text` v = `First name prefix`
)->a( n = `labelFor` v = `firstNameInput`
)->a( n = `visible` v = |\{= !%{ client->_bind( showorganizational ) }\}|
)->tag( `Input`
)->a( n = `id` v = `firstNameInput`
)->a( n = `width` v = `200px`
)->a( n = `value` v = |\{ path: '{ client->_bind_path( firstname ) }', type: 'StringType' \}|
)->a( n = `visible` v = |\{= !%{ client->_bind( showorganizational ) }\}|
)->tag( `Label`
)->a( n = `text` v = `Last name prefix`
)->a( n = `labelFor` v = `lastNameInput`
)->a( n = `visible` v = |\{= !%{ client->_bind( showorganizational ) }\}|
)->tag( `Input`
)->a( n = `id` v = `lastNameInput`
)->a( n = `width` v = `200px`
)->a( n = `value` v = |\{ path: '{ client->_bind_path( lastname ) }', type: 'StringType' \}|
)->a( n = `visible` v = |\{= !%{ client->_bind( showorganizational ) }\}|
)->tag( `ToolbarSpacer`
)->tag( `Button`
)->a( n = `id` v = `toggleFiltersButton`
)->a( n = `press` v = client->_event( `TOGGLE_FILTERS` )
)->a( n = `text` v = |\{= %{ client->_bind( showorganizational ) } ? 'Show Personal Filters' : 'Show Organizational Filters'\}|
)->end(
)->end(
)->ele( n = `columns` ns = `table`
)->ele( n = `Column` ns = `table`
)->tag( `Label`
)->a( n = `text` v = `Department`
)->ele( n = `template` ns = `table`
)->tag( `Text`
)->a( n = `text` v = `{DEPARTMENT}`
)->end(
)->end(
)->ele( n = `Column` ns = `table`
)->tag( `Label`
)->a( n = `text` v = `First Name`
)->ele( n = `template` ns = `table`
)->tag( `Text`
)->a( n = `text` v = `{FIRSTNAME}`
)->end(
)->end(
)->ele( n = `Column` ns = `table`
)->tag( `Label`
)->a( n = `text` v = `Last Name`
)->ele( n = `template` ns = `table`
)->tag( `Text`
)->a( n = `text` v = `{LASTNAME}`
)->end(
)->end(
)->ele( n = `Column` ns = `table`
)->tag( `Label`
)->a( n = `text` v = `Age`
)->ele( n = `template` ns = `table`
)->tag( `Text`
)->a( n = `text` v = `{AGE}`
)->end(
)->end(
)->ele( n = `Column` ns = `table`
)->tag( `Label`
)->a( n = `text` v = `Location`
)->ele( n = `template` ns = `table`
)->tag( `Text`
)->a( n = `text` v = `{LOCATION}`
).
client->view_display( view->stringify( ) ).
ENDMETHOD.
METHOD on_event.
IF client->get_event( ) = `TOGGLE_FILTERS`.
" onToggleFilters: flip ui>/showOrganizational and apply the other
" filter pair to the rows binding - here the flag flips and the view is
" redrawn, which re-bakes the boundFilters list into the binding info
showorganizational = xsdbool( showorganizational = abap_false ).
view_display( ).
ENDIF.
ENDMETHOD.
METHOD model_init.
" the four filter> fields start undefined in the original JSONModel
showorganizational = abap_true.
t_teammembers = VALUE #(
( firstname = `John` lastname = `Doe` age = 28 department = `Development` location = `Walldorf` )
( firstname = `Jane` lastname = `Smith` age = 34 department = `Consulting` location = `New York` )
( firstname = `Michael` lastname = `Johnson` age = 45 department = `Management` location = `Bangalore` )
( firstname = `Emily` lastname = `Davis` age = 29 department = `Development` location = `Sydney` )
( firstname = `Chris` lastname = `Brown` age = 38 department = `Consulting` location = `Berlin` )
( firstname = `Jessica` lastname = `Williams` age = 41 department = `Development` location = `Walldorf` )
( firstname = `David` lastname = `Jones` age = 52 department = `Management` location = `New York` )
( firstname = `Sarah` lastname = `Miller` age = 27 department = `Development` location = `Bangalore` )
( firstname = `Daniel` lastname = `Wilson` age = 33 department = `Consulting` location = `Sydney` )
( firstname = `Laura` lastname = `Moore` age = 24 department = `Development` location = `Berlin` )
( firstname = `James` lastname = `Taylor` age = 36 department = `Consulting` location = `Walldorf` )
( firstname = `Emma` lastname = `Anderson` age = 30 department = `Development` location = `New York` )
( firstname = `Robert` lastname = `Thomas` age = 50 department = `Consulting` location = `Bangalore` )
( firstname = `Olivia` lastname = `Jackson` age = 22 department = `Development` location = `Sydney` )
( firstname = `William` lastname = `White` age = 47 department = `Consulting` location = `Berlin` ) ).
ENDMETHOD.
ENDCLASS.
More in sap.ui.core
- Float Format — Formats and parses both integer and decimal digits.
- FileSize Type — This sample explains the formatting options of the FileSize type.
- Date Type - Source As String — This sample explains the formatting options of the Date type with the date being availabl…
- Time Type — This sample explains the formatting options of the Time type.
- DateTime Type — This sample explains the formatting options of the DateTime type.
- Commands — This example demonstrates how to define shortcuts using commands in your application
- Bound Filters - Filtered List in Table — This sample shows how bound filters work. It features a table of customers with a 'Select…
- Field Groups — A control's field group id can be used to define a virtual group of fields that should be…
- Date Type - Source As Date — This sample explains the formatting options of the Date type with the date being availabl…
- Theme-independent CSS-classes — Sample display of 'sapTheme'-prefixed CSS classes for theme-independent styling of custom…
- Negative Margins — Use standard negative margin classes 'sapUiTinyNegativeMarginBeginEnd', 'sapUiSmallNegati…
- Single-Sided Margins — Clear the space to the left, right, top or bottom of your control.
On this page