SplitContainer standard use case
SplitContainer maintains two NavContainers if running on tablet or desktop and one NavContainer - on phone. The display of master NavContainer depends on the portrait/landscape orientation of the device and the mode of SplitContainer.
- Class
z2ui5_cl_smpc_app_096- Repository
- abap2UI5/samples-controls
- Ports
sap.m.sample.SplitContainer- UI5 libraries
- sap.m, sap.ui.core
- Lowest UI5 release
- 1.71
- In the browser
- Runs in the playground
- Controls it builds
- sap.m.Button, sap.m.Input, sap.m.Label, sap.m.List, sap.m.Page, sap.m.RadioButton, sap.m.RadioButtonGroup, sap.m.SplitContainer, sap.m.StandardListItem, sap.m.Text, sap.m.VBox, sap.ui.core.mvc.View
The class
" @keywords splitcontainer split container sap.m master-detail navigation label button vbox text radiobuttongroup radiobutton
" @summary SplitContainer maintains two NavContainers if running on tablet or desktop and one NavContainer - on phone. The display of master NavContainer depends on the portrait/landscape orientation of the device and the mode of SplitContainer.
" @origin sap.m.sample.SplitContainer - https://sdk.openui5.org/entity/sap.m.SplitContainer/sample/sap.m.sample.SplitContainer (status: reviewed - read against the original, not run)
CLASS z2ui5_cl_smpc_app_096 DEFINITION PUBLIC.
PUBLIC SECTION.
INTERFACES z2ui5_if_app.
DATA mode_idx TYPE i.
DATA mode TYPE string VALUE `ShowHideMode`.
PROTECTED SECTION.
DATA client TYPE REF TO z2ui5_if_client.
METHODS view_display.
METHODS on_event.
PRIVATE SECTION.
ENDCLASS.
CLASS z2ui5_cl_smpc_app_096 IMPLEMENTATION.
METHOD z2ui5_if_app~main.
me->client = client.
IF 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( ).
view->ele( n = `View` ns = `mvc`
)->a( n = `xmlns` v = `sap.m`
)->a( n = `xmlns:mvc` v = `sap.ui.core.mvc`
)->a( n = `xmlns:custom` v = `http://schemas.sap.com/sapui5/extension/sap.ui.core.CustomData/1`
)->ele( `SplitContainer`
)->a( n = `id` v = `SplitContDemo`
)->a( n = `mode` v = client->_bind( mode )
)->a( n = `initialDetail` v = `detail`
)->a( n = `initialMaster` v = `master`
)->ele( `detailPages`
)->ele( `Page`
)->a( n = `id` v = `detail`
)->a( n = `title` v = `Detail 1`
)->a( n = `backgroundDesign` v = `Solid`
)->a( n = `showNavButton` v = `{= !${device>/system/desktop} }`
)->a( n = `navButtonPress` v = client->_event( `DETAIL_BACK` )
)->tag( `Label`
)->a( n = `text` v = `Detail page 1`
)->a( n = `class` v = `sapUiTinyMarginEnd`
)->tag( `Button`
)->a( n = `text` v = `Go to Detail page 2`
)->a( n = `press` v = client->_event( `NAV_TO_DETAIL` )
)->end(
)->ele( `Page`
)->a( n = `id` v = `detailDetail`
)->a( n = `title` v = `Detail Detail`
)->a( n = `backgroundDesign` v = `Solid`
)->a( n = `showNavButton` v = `true`
)->a( n = `navButtonPress` v = client->_event( `DETAIL_BACK` )
)->ele( `VBox`
)->a( n = `class` v = `sapUiSmallMargin`
)->tag( `Label`
)->a( n = `text` v = `This is Detail Page 2`
)->tag( `Text`
)->a( n = `text` v = `Here you could change the Split Application mode. After the mode change, resize the browser window to see the difference in the master form behaviour.`
)->ele( `RadioButtonGroup`
)->a( n = `columns` v = `1`
)->a( n = `width` v = `500px`
)->a( n = `class` v = `sapUiMediumMarginBottom`
)->a( n = `selectedIndex` v = client->_bind( mode_idx )
)->a( n = `select` v = client->_event( `MODE_BTN` )
)->ele( `buttons`
)->tag( `RadioButton`
)->a( n = `id` v = `RB1-1`
)->a( n = `text` v = `show/hide`
)->a( n = `selected` v = `true`
)->a( n = `custom:splitAppMode` v = `ShowHideMode`
)->tag( `RadioButton`
)->a( n = `id` v = `RB1-2`
)->a( n = `text` v = `stretch/compress`
)->a( n = `custom:splitAppMode` v = `StretchCompressMode`
)->tag( `RadioButton`
)->a( n = `id` v = `RB1-3`
)->a( n = `text` v = `hide`
)->a( n = `custom:splitAppMode` v = `HideMode`
)->tag( `RadioButton`
)->a( n = `id` v = `RB1-4`
)->a( n = `text` v = `popover`
)->a( n = `custom:splitAppMode` v = `PopoverMode`
)->end(
)->end(
)->end(
)->end(
)->ele( `Page`
)->a( n = `id` v = `detail2`
)->a( n = `title` v = `Detail 3 Page`
)->a( n = `backgroundDesign` v = `Solid`
)->a( n = `showNavButton` v = `true`
)->a( n = `navButtonPress` v = client->_event( `DETAIL_BACK` )
)->tag( `Label`
)->a( n = `text` v = `This is Detail Page 3`
)->tag( `Input`
)->tag( `Label`
)->a( n = `text` v = `Label 2`
)->tag( `Input`
)->tag( `Label`
)->a( n = `text` v = `Label 3`
)->tag( `Input`
)->tag( `Label`
)->a( n = `text` v = `Label 4`
)->tag( `Input`
)->tag( `Label`
)->a( n = `text` v = `Label 5`
)->tag( `Input`
)->end(
)->end(
)->ele( `masterPages`
)->ele( `Page`
)->a( n = `id` v = `master`
)->a( n = `title` v = `Master 1`
)->a( n = `backgroundDesign` v = `List`
)->ele( `List`
)->tag( `StandardListItem`
)->a( n = `title` v = `To Master2`
)->a( n = `type` v = `Navigation`
)->a( n = `press` v = client->_event( `GO_TO_MASTER` )
)->end(
)->end(
)->ele( `Page`
)->a( n = `id` v = `master2`
)->a( n = `title` v = `Master 2`
)->a( n = `backgroundDesign` v = `List`
)->a( n = `showNavButton` v = `true`
)->a( n = `navButtonPress` v = client->_event( `MASTER_BACK` )
)->ele( `List`
)->a( n = `itemPress` v = client->_event( val = `NAV_DETAIL` arg = `${$parameters>/listItem}.getCustomData()[0].getValue()` )
)->tag( `StandardListItem`
)->a( n = `title` v = `To Detail 1`
)->a( n = `type` v = `Active`
)->a( n = `custom:to` v = `detail`
)->tag( `StandardListItem`
)->a( n = `title` v = `To Detail 2`
)->a( n = `type` v = `Active`
)->a( n = `custom:to` v = `detailDetail`
)->tag( `StandardListItem`
)->a( n = `title` v = `To Detail 3`
)->a( n = `type` v = `Active`
)->a( n = `custom:to` v = `detail2` ).
client->view_display( view->stringify( ) ).
ENDMETHOD.
METHOD on_event.
CASE client->get_event( ).
WHEN `NAV_TO_DETAIL`.
client->follow_up_action( val = client->cs_event-control_by_id
t_arg = VALUE #( ( `SplitContDemo` ) ( `to` ) ( `detailDetail` ) ) ).
WHEN `DETAIL_BACK`.
client->follow_up_action( val = client->cs_event-control_by_id
t_arg = VALUE #( ( `SplitContDemo` ) ( `backDetail` ) ) ).
WHEN `MASTER_BACK`.
client->follow_up_action( val = client->cs_event-control_by_id
t_arg = VALUE #( ( `SplitContDemo` ) ( `backMaster` ) ) ).
WHEN `GO_TO_MASTER`.
client->follow_up_action( val = client->cs_event-control_by_id
t_arg = VALUE #( ( `SplitContDemo` ) ( `toMaster` ) ( `master2` ) ) ).
WHEN `NAV_DETAIL`.
client->follow_up_action( val = client->cs_event-control_by_id
t_arg = VALUE #( ( `SplitContDemo` ) ( `toDetail` ) ( client->get_event_arg( ) ) ) ).
WHEN `MODE_BTN`.
" the original calls setMode( ); mode is a bindable property, so it is
" bound two-way and only assigned here
mode = SWITCH string( mode_idx
WHEN 0 THEN `ShowHideMode`
WHEN 1 THEN `StretchCompressMode`
WHEN 2 THEN `HideMode`
WHEN 3 THEN `PopoverMode` ).
client->message_toast_display( text = |Split Container mode is changed to: { mode }| duration = `5000` ).
ENDCASE.
ENDMETHOD.
ENDCLASS.