Updated: September 11, 2018

Tile

sap.m.GenericTile

Intro

A tile is a container that represents an app on the SAP Fiori launchpad home page. All apps have at least one corresponding tile. The only exception is the factsheet, although users also have the option of saving factsheets as tiles.

Tiles are used to display and launch apps on the launchpad. Therefore, do not use them on an overview page or anywhere else.

Tiles can display different types of content. They can contain an icon, a title, an informative text, numbers, and charts. The information shown is based on data supplied by the app, such as key performance indicators (KPIs).

A link is a special representation of a tile. Links are displayed in a separate area below the tiles area and comprise a title and an optional subtitle. Most tile types can be converted to links, and links can be converted to tiles at any time.

Users can personalize their home page by selecting the tiles for the apps they want to use from the app finder. The apps available in the app finder depend on the user’s role.

The number of visible tiles on the launchpad home page depends on the screen resolution. If the tiles in a group do not fit in one row, they are wrapped to the next row.

Tiles - Launchpad
Tiles - Launchpad

Responsiveness

By default, the standard tile size is responsive. The tile size is independent of the device: small screens get smaller tiles (even on a desktop device), and all larger screens (including some smartphone screens) get larger tiles.

The examples below show how the tiles render for different screen sizes.

Tiles – Size S
Tiles – Size S
Tiles – Size M
Tiles – Size M

Alternative Configuration – Small Tiles for All Screen Sizes

To fit more tiles onto the screen, customers can opt to use the smaller tile size for all screen sizes. In this case, there is no special tile size for small screens.

Key users or administrators can change the tile size for all tiles on the launchpad centrally (property: sizeBehavior, value: Small).

Large tiles
Large tiles
Small tiles
Small tiles
Warning
Do not use this option for single tiles. Because all tiles on the launchpad need to be consistent (all responsive, or all small), the tile size should not be defined at app level.

Layout

Warning
Please note that while the header mode is available on SAPUI5 for this version, it is not yet available in the SAP Fiori launchpad.

The generic tile control currently supports two tile sizes (one for size S, and one for larger screens) and two tile dimensions (1 x 1 and 2 x 1).  The layout of the generic tile is fixed, with designated areas for the header, content area, and footer. The control supports two modes: header mode and content mode. When header mode is chosen, the tile gains two lines of header text to describe the application or navigation target more precisely.

Header mode = 4 lines headline, 1 line subtitle, no content area, footer area
Content mode = 2 lines headline, 1 line subtitle, content area, footer area

Information
Header mode for 2×1 tiles: To avoid complications caused by long app names, we recommend using only two lines of headline for 2×1 tiles.

Header Area

The header area is mandatory, and contains the header and an (optional) subtitle. The header is always in the upper left corner of the tile, except on feed tiles.

Texts in the Header Area

  • Mandatory header
    The header can have up to two lines of text before it is truncated.
  • Optional subtitle
    The subtitle can have one line of text before it is truncated.
  • Condition
    A total of three lines is available for the title and subtitle (two for the header and one for the subtitle).

Content Area

The content area is not mandatory. The content itself is defined by the apps and can comprise KPIs, charts, texts, or icons. Only show content types that are described on this page. Do not use custom icons.

Tip: If you are not showing a KPI or a chart, try to show an icon instead to help users to distinguish the tiles.

Footer Area

The status area is an optional, text-only area, and cannot display any other content.

Tile Anatomy Content Mode
Tile Anatomy Content Mode
Tile anatomy - header mode
Tile anatomy - header mode

Visual Representation

Apps can be visualized as tiles or links. While there are many types of tiles, links share a similar look: they comprise a title an optional subtitle.

Find more information on links and the conversion between tiles and links in the Homepage chapter.

Tiles and links
Tiles and links

Types

KPI Tile

Key performance indicators (KPIs) are used to measure and monitor a company’s performance at a strategic and operational level.

The tile displays the KPI values as large, easy-to-recognize digits. In addition, you can show deviation arrows, negative values, and scaling factors. You can also use semantic colors to emphasize the content. The number of digits is limited by the size of the tiles.

You can use the 2 x 1 tile to combine the content of two tiles into one. For example, you can show a KPI next to a comparison chart (as shown on the right), or use any other combination such as KPI/KPI, chart/chart, and so on. You can show different information in both the content and status areas. However, in all other respects, the 2 x 1 tile behaves as one tile – with one headline, subtitle, clickable area, and target.

Tiles with KPI
Tiles with KPI

You can use bar charts to show detailed comparisons with semantic coloring for entries in a “Top N” list. You can choose between two different layouts:

  • 1 x 1 tile with two or three entries
  • 2 x 1 tile with up to four entries
Tiles with comparison micro chart
Tiles with comparison micro chart

A bullet chart is a variation of a bar chart. It compares a single, primary value to one or more target values. The primary value is shown in the context of qualitative ranges (thresholds) such as poor, satisfactory, and good.

See the image on the right for examples of different bullet charts:

  • The chart on the left focuses on the actual value in relation to the target value and the forecast.
  • The chart in the middle shows the same combination, but without the forecast.
  • The chart on the right focuses on the delta between the actual value and the target value. Note that the delta visualization never shows the forecast.

All the charts show certain thresholds to give the user a sense of orientation.

Tile with bullet micro chart
Tile with bullet micro chart

You can use trend charts (also known as area charts) to show cumulated totals over time, based on amounts or percentages. In this example, you can see a stacked trend chart. You can also use trend charts to depict trends for related attributes.

The trend chart is similar to the plot chart, except that the area below the plotted line is colored to indicate the volume.

Tile with area micro chart
Tile with area micro chart

You can use column charts (bar charts) to compare categories using vertical bars. One axis of the chart shows the specific categories, while the other axis represents a discrete value. You can also cluster multiple bars into groups within the column chart.

Tile with column micro chart
Tile with column micro chart

Basic Launch Tile

The most basic type of launch tile contains a title and an icon.

Basic launch tile
Basic launch tile

Monitoring Tile

Use the monitoring tile when you want to display status updates or an object count.

You can also apply semantic colors to the status bar to indicate a positive, negative, or critical status.

Monitoring tile
Monitoring tile

SAP Jam Tile

If an organization uses SAP Jam, users can also add SAP Jam tiles to the launchpad. The SAP Jam tile shows the content of new notifications in 10-second intervals. It can scroll through up to 10 new notifications. Tile content is updated every five minutes. If there are no new notifications, the tile displays the most recent notification. If the 2 x 1 tile does not contain an icon, the headline uses the full length of the container. For more information, see collaboration.

SAP Jam tile (2 x 1)
SAP Jam tile (2 x 1)

Feed Tile

The feed tile is a special tile that shows a news feed. It refreshes every three to five seconds and is twice the size of a standard tile. In addition to the news headline, it comes with a background image, the news source, and a time stamp. The feed tile flips through news messages, which are configured for the tile. For accessibility reasons, the tile contains a start and pause button which can be found by hovering the mouse over the tile on desktop devices. On touch devices, the buttons are always displayed. Additionally, the number of slides contained the tile is visualized as dots on on the bottom of the tile.

Feed/news tile (2 x 1)
Feed/news tile (2 x 1)

Behavior and Interaction

All tiles on the SAP Fiori launchpad support one click event and one navigation target.

Open App

All tiles have one click/tap area that opens the corresponding app.

Tile - Interaction
Tile - Interaction

Styles

Tile Loading

When a tile is loading, the standard loading indicator appears in the center of the tile. The tile itself is overlayed in white.

If a tile cannot be loaded, a warning icon and text appear at the bottom of the tile. Error messages should not be displayed in the status area. For each tile, the error text can be defined individually by the system administrator when preparing the tile.

Tile loading (right) and failing to load (left)
Tile loading (right) and failing to load (left)

The darker shade of gray and the dotted line indicate the pressed state. The dotted line also indicates the focused state.

Default, Hover, Pressed State

The default state is without any overlay.

Tiles - Default state
Tiles - Default state

The gray overlay indicates that the tile is in hover state.

Tiles - Hover state
Tiles - Hover state

The darker shade of gray and the dotted line indicate the pressed state. The dotted line also indicates the focused state.

Tiles - Hover state
Tiles - Hover state

Guidelines

Do’s

  • Use only this control.
  • In the content area, only show content described in this guideline. (For example, do not play videos or animations or gifs in the tiles)

Don’ts

  • Do not use the standard tile (sap.m.StandardTile) or custom tile (sap.m.CustomTile). These are deprecated.
  • Do not use the status area for error messages.
  • Do not use the tile subtitle for explanations. Use the subtitle only if you need a differentiator (such as a specific view on the data).
  • Do not use icons on KPI tiles; only use icons on basic launch tiles or monitoring tiles.
  • Do not show icons next to an counter when you expect 5 digits or more.

Icons

  • We have decided to stop unique launch icons being created for individual apps. Creating a unique icon for every app was and is not scalable in terms of iconography and production (hinting and PNG exportation).
  • Projects without a SAP Fiori ID do not get an individual icon.
  • Do not develop your own icons or use custom icons.

Resources

Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

Elements and Controls

Implementation