Android widgets provide a quick overview of key information across the user’s home screens. They retain simplicity by showing only the most valuable information and functionality from the application first, guiding users to access more complex data and actions within the app. While the widget’s content focuses on one subject, users can still adjust the amount of content displayed by resizing the widget, if supported.
Widgets on an Android device
- Display curated and dynamic information for a single idea that relates to the most valuable application information and functionality.
- Keep the information concise, and if more is needed, the user can navigate to additional details.
- Offer widgets in multiple sizes when it adds direct value to the user.
- Offer specific functionality without the user needing to launch the application.
- Include multiple touch targets if the user can perform different actions on the widget.
- Ensure the interaction opens the application at the right location.
- Inform the user when authentication adds value, prompting them to continue in-app.
- Return an error state for unauthorized users if authorized users permit the application to show data in widgets.
While the header, the body, and the footer are optional to have, we recommend including at least one of the sections.
Across each section, the text fields display the device’s system font in place of the 72 font style, as they are not supported yet for Android widgets. The only exception to using the 72 font style is if the application is drawing directly onto a canvas rather than implementing the widget using a text view.
The header provides the user context for the widget’s single subject. It is recommended to only use SAP icons in the header area unless the application creates its own content.
The body is comprised of one or multiple SAP BTP SDK for Android components of a single type.
For example, widgets built using Glance support checkboxes, radio buttons, and switches in the body area.
In the footer area, users can access and perform select actions. We recommend a maximum of two actions, in the form of icon or text buttons.
Widgets can come in multiple sizes as they adapt to fit the available screen size. Create additional sizes only if they add direct value to the user, such as introducing an additional set of information that can be used to inform the user’s actions.
Users can place widgets on their Android home screen’s available grid space. This grid can vary by device. To determine the widget’s size, view this Android Developer article for more information.
Examples of widgets in a small (left), medium (center), and large (right) size
Information widgets track and display crucial data over time. Some common use cases include:
- Monitoring sales performance
- Checking in on daily fitness goals
Collection widgets display multiple of the same element, often in the form of a list. If building widgets with Glance, the collection widget can have vertical scroll. Some common use cases include:
- Browsing news articles
- Scrolling through a list of pending approvals
Control widgets display frequently used functions. Some common use cases include:
- Marking a to-do item as complete
- Checking off a pre-meeting reminder