docs

Split App

You can use the sap.m.SplitApp control to ensure that your UI automatically adapts to the size available on the respective device.

As tablets such as iPad or Google Nexus7 provide more space compared to smartphones, porting existing mobile apps to tablets leads to a lot of unused space.

A common pattern to address this is called list-detail, and is often used in native iOS and Android development. Good examples are the native Settings and E-Mail applications of iOS and Android tablets. This pattern can be used with the SplitApp control.

The figure shows the basic idea of the pattern. The app is divided into two views, the list and the detail view. The list view presents a list of items and is used as the main navigation within the application. The detail view shows detail information for the selected item.

SAPUI5 Mobile SplitApp Pattern

Whereas the selection of an item on a mobile devices navigates the user to the detail page, the user can see the list of items and the detail view at the same time on a tablet device.

If the tablet device is used in portrait mode it has less available width space. For this, the SplitApp control provides three different modes for displaying the list and detail view in portrait mode:

In landscape mode, all three modes described above display the list view.

If you run a SplitApp on a mobile device, it automatically behaves like a standard mobile application. The following figure shows the difference:

SAPUI5 Mobile Splitt App Mobile

As only one page per screen can be displayed, the list and detail view are automatically displayed on separate pages and the standard page navigation is applied.