Widgets

Widgets provide easy access to frequently used tasks or content and are useful when users are engaged in other activities or unable to provide precise control for their watch. Users can access any app’s key features without launching the app.

Make sure you understand how different types of widgets work and the widget designs that are best suited to your app. You can also design widgets in web-native languages. See Creating your first Tizen wearable native widget application for more details on native apps and Creating your first Tizen wearable web widget application for web apps.

Basics

  • Design widgets to fit on one page
    Widgets occupy the whole screen. Design a widget to occupy a single page without scrolling.
  • Widgets only take a single tap
    Tapping is the only gesture widgets use to perform a task or open an app.
  • One app can have multiple widgets for different purposes
  • Widgets refresh automatically
  • Permissions
    User permission may be required to display widget information. Users can modify permission settings in Settings >Apps > Permissions. If a user does not agree to grant permission, you must provide an additional notification screen that states permission is required in order to view widget information. The screen needs to provide the app name (if the app has two or more types of widgets, provide widget names) and a link to the Permission pop-up.

User can Tap to move to Permission pop-up

Tips
  • Users can add up to 15 favorite widgets on the Widget Board, located to the right of the watch face.
  • Users can manage widgets by touching and holding on any widget screen. They can rearrange the order by dragging widgets to the desired position, and add or remove them by tapping the corresponding buttons.

    Users can manage widgets by touching and holding any widget screen.

  • You can provide a link to the widget’s Edit screen using the Edit button embedded in the screen. In this case, Edit screen must be provided independently.
    The edit function is currently only provided for native widgets. See Configuring the Application Manifest for more details on configuring the Edit screen.
  • If an app is uninstalled, all related widgets will also removed.

Types of widgets

Three widget types are available for the watch:

  • Informative widgets that deliver information from the parent app
  • Interactive widgets that both deliver information and receive user input
  • Shortcut widgets that provide a link without exchanging any data with the app

Choose the right widget type for the content you want to offer.

Three types of widgets are available to use: informative, interactive, and shortcut.

  • Informative widgets

    Informative widgets provide information in a scannable way. Design your widgets to display key information on a single screen without scrolling and provide users with a direct route to more detailed information within the related app. Providing an appropriate image can enhance readability.

    Weather widgets can show the weather for a chosen city and provide a direct route to more detailed info within the app.

  • Interactive widgets

    Interactive widgets perform simple tasks that can be completed with one tap. Ensure that your components are designed intuitively so that users notice they are tappable. Widgets should immediately reflect any user input in real time and make it clear that user input has been recognized.

    Samsung Health widgets let users input the number of cups of water/coffee consumed and see the changes immediately.

  • Shortcut widgets

    Shortcut widgets provide quick access to frequently used menus or tasks. Shortcuts should use appropriate icons and text to communicate where they lead. When providing multiple shortcuts on one screen, ensure each one is visible and has a sufficient touchable area.

    Widgets for a contact app can provide shortcuts to call or send a message to favorite contacts.

Types of actions

A single tap, the only gesture allowed for widgets, is used for two types of actions: links and direct actions. Links connect users to an app's menu, and direct actions perform a task on the widget.

  • Link action

    Links can connect users directly to the first screen or a particular menu of an app. The link can make up the whole screen or be shown through a button.

  • Direct action

    Direct actions perform simple tasks without opening the app. You can use direct actions for tasks such as measuring data or toggling an alarm.

    Tapping an icon on an alarm widget toggles the alarm on/off without opening the app.

Common use cases

Here are some common use cases that will help you design your widgets.

  • Filling empty widgets

    Some widgets need to be filled with content by users. When creating widgets like these, include an “Add” button instead of leaving the screen empty.

    An add button helps users initiate the add flow.

  • Multiview widgets

    Each widget should present just one piece of information on each screen, but you can break the information up across several views that users can browse through. In these cases, dim and turn off the browsing button when there are no more views in a particular direction.

    #

    User can browse many views of a widget with the buttons.

  • Check your phone

    Widgets can redirect users to another device, such as a phone. If your widgets support this feature, use the phrase "Check your phone" to indicate.

Design your widgets

Keep the visual principles for colors, layout, and typography in mind when you’re designing your widgets.

  • Make your widgets readable with a dark background

    A dark background works best for widgets. It increases screen readability when outdoors and smoothly integrates the widget with the black bezel. We recommend using a transparent background, but if you are using a colorful image, add a tinted black layer on top (at least 60% opacity) to ensure the text is legible.

    Dark-colored backgrounds enhance screen readability.

  • Maintain visual identity with an identity color

    Applying the primary color of your app to the main text can communicate a strong visual identity. Consider readability when you choose your app identity color.

    Widgets for the World Clock app use blue as an identity color.

  • Use Breeze Sans.

    Use the system font Breeze Sans to optimize readability on the watch and make your app consistent with others. Breeze Sans comes in condensed, regular, and medium fonts. Determine the weight of the font according to the relative level of importance of the text. See Visual design for more details on Breeze Sans.