Skip to main content
Version: v3+

hmUI.createWidget(widgetId, option)

Create UI widgets.

Type

(widgetId: WIDGET_ID, option?: Option) => widget: WIDGET

Parameters

ParameterDescriptionRequiredType
widgetIdThe ID of the component to be created. (Reference WIDGET_ID)YES-
optionParameters.NO-
widgetThe instance of component.--

WIDGET_ID

ValueDescription
hmUI.widget.BUTTONButton widget ID.
IMG`Image widget ID.
...The rest of the values are not listed, refer to the widget directory.

WIDGET

DescriptionType
Widget objectobject

Code examples

Reference to a widget example.

Widget Display Level

The watch face has three states: screen off, normal display, and editable.

You can set the widget display level when creating widgets.

StateProperty
Normal DisplayhmUI.show_level.ONLY_NORMAL
Screen OffhmUI.show_level.ONAL_AOD
EdithmUI.show_level.ONLY_EDIT

Example Code

The display level must be passed when creating the widget to take effect

const widget = hmUI.createWidget(hmUI.widget.IMG, {
x: 158,
y: 218,
w: 112,
h: 136,
alpha: 100,
src: 'a.png',
// Only displayed in normal watchface and screen-off states, not created in editable state
show_level: hmUI.show_level.ONLY_NORMAL | hmUI.show_level.ONAL_AOD
})