rust_widgets 0.9.6

Pure Rust cross-platform native GUI library with hardware-adaptive rendering, 60+ widgets, touch/gesture support, i18n, and SVG-pipeline-accurate output
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

# Harmony NAPI Bridge Flow

Use this guide to wire ArkUI/NAPI callbacks into `rust_widgets` with a predictable event flow.

## Step 1: Initialize and Create Widgets

Run this sequence in your app startup:

1. `rust_widgets_init()`
2. Create window and controls with `rust_widgets_create_*`
3. Store returned `widget_id` values in your native layer

## Step 2: Bind ArkUI Node Handles

When a UI node is created and mapped to a `widget_id`, register it once:

- `rust_widgets_harmony_bind_node(node_handle, widget_id)`

When a node is destroyed:

- `rust_widgets_harmony_unbind_node(node_handle)`

During app teardown:

- `rust_widgets_harmony_clear_node_bindings()`

## Step 3: Forward ArkUI/NAPI Callbacks

Forward native callbacks into `rust_widgets`:

- Click: `rust_widgets_harmony_on_node_click(node_handle)`
- Value change: `rust_widgets_harmony_on_node_value_changed(node_handle)`
- Menu item: `rust_widgets_harmony_on_node_menu_item(node_handle)`
- Generic: `rust_widgets_harmony_on_node_widget_event(node_handle, kind_code)`

If you already have a `widget_id`, use direct APIs:

- `rust_widgets_harmony_on_click(widget_id)`
- `rust_widgets_harmony_on_value_changed(widget_id)`
- `rust_widgets_harmony_on_menu_item(menu_item_id)`
- `rust_widgets_harmony_on_widget_event(widget_id, kind_code)`

## Step 4: Poll and Dispatch in the App Loop

Consume queued events on each runtime tick:

- `rust_widgets_poll_menu_triggered()`
- `rust_widgets_poll_widget_trigger_event(widget_id_out)`

Trigger kind mapping:

- `1` = clicked
- `2` = value-changed
- `0` = no event

## Step 5: Minimal Callback Pseudo-Flow

```text
onNodeReady(node, widgetId):
  rust_widgets_harmony_bind_node(node, widgetId)

onTap(node):
  rust_widgets_harmony_on_node_click(node)

onTextChange(node):
  rust_widgets_harmony_on_node_value_changed(node)

appTick():
  menuId = rust_widgets_poll_menu_triggered()
  kind = rust_widgets_poll_widget_trigger_event(&widgetId)
  dispatch(menuId, widgetId, kind)

onNodeDispose(node):
  rust_widgets_harmony_unbind_node(node)
```

## Related Files

- Header: `examples/rust_widgets.h`
- C bridge sample: `examples/harmony_napi_bridge_sample.c`
- Bridge overview: `docs/HARMONY_NATIVE_BRIDGE.md`