abap2UI5

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

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 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

Search every abap2UI5 sample · the full list on one page

On this page