Facelet

Menu

Facelets

A Facelet is a single part of the face and renders a gauge, bar, hand, clock, text, etc.

Display Modes

A Facelet has two display modes: interactive and ambient mode.
Ambient mode is activated, when the device enters a sleep mode to save energy. Most devices switch off the screen entirely, so it’s mainly a feature of watch devices.

Interactive Mode

This mode is used when the user is interacting with the device.
This is the normal mode for widgets. If a watch is in ambient mode, this mode may be activated by a wrist gesture, tapping on the watch etc.

Ambient Mode

Typically watch faces switch to a simplified display when in ambient mode, if the watch face displays seconds or other fast changing information, it should hide them in ambient mode.
Unnecessary information should be avoided and darker pixel colors should be used.

Important

Ambient mode is only available on a watch device, if something like "Always-On Screen" in activated in the watch "Display" settings. This depends on the watch model.

Note	In ambient mode the watch face will be rendered once per minute.

Available Facelets

The Background Facelet renders a solid background of the given color.

The Badge Facelet renders a badge.

The Bar Gauge Facelet renders a horizontal or vertical bar gauge.

The Button Facelet renders a push or toggle button.

The Circular Gauge Facelet renders a circular gauge bar (ring).

Marker - Circular

The Circular Marker Facelet renders a marker long a circle.

The Clock Facelet renders a round clock with hands, tickmarks and a dial.

The Complication Facelet renders a complication on a watchface.

The Dial Facelet renders a circular dial.

The Digital Clock Facelet renders a digital clock with hours, minutes and seconds.

The Gauge Facelet renders a circular gauge with a value text.

The Graphic Facelet renders a SVG or graphic path.

The Hand Facelet renders a hand which can be used a part of a clock or gauge.

The Icon Facelet renders an icon.

The Image Facelet renders an image or a video stream.

The Launcher Facelet starts apps or system actions upon face taps. Available only on a watch device.

Marker - Linear

The Linear Marker Facelet renders a marker along a horizontal or vertical line.

The Map Tile Facelet renders a map tile from a given GPS location.

The Notification Facelet generates a toast, system or audio notification when triggered by a condition.

The Pie Facelet renders pie segments.

The QR Code Facelet generates a QR code out of given data.

The Round Text Facelet renders text along a circle.

The Signal Gauge Facelet renders a cellular or WiFi like gauge.

The Speedo Gauge Facelet renders a circular gauge with ticks, dial and a hand.

The Square Gauge Facelet renders a square gauge.

Status Indicator

The Status Indicator Facelet renders an status indicator in form of a dot, rectangle or text.

The Switch Facelet renders a toggle switch.

The Table Facelet renders a text table.

The Text Facelet renders text.

The Ticker Facelet renders a scrolling text ticker to show longer text on limited screen space.

The Ticks Facelet renders ticks.

The Time Series Facelet renders a graph out of values.