事件处理

原生 ArkUI 事件会先进入 EventSink，再转成 Dioxus 事件按顺序派发。点击、变更这类离散事件不会悄悄丢掉；高频的 pointer move 可以在进 VirtualDom 前按节点合并。

事件与 Payload

snake_case alias 与紧凑名称语义相同，例如 on_change 等价于 onchange。

更新状态

let mut value = use_signal(String::new);

rsx! {
    textinput {
        value: value(),
        placeholder: "请输入",
        onchange: move |event| value.set(event.string_value.clone()),
    }
}

事件闭包通常捕获可复制的 Signal handle。回调应更新状态或派发领域命令，不直接保留 event 内部借用。

冒泡

浮层 panel 可阻止点击继续到 backdrop：

column {
    onclick: move |event| event.stop_propagation(),
    text { "弹层内容" }
}

只在组件确实拥有事件边界时停止传播；大面积容器无条件拦截会破坏上层手势和无障碍行为。

长按与默认行为

onlongpress 使用 ArkUI LongPress Gesture，默认单指保持约 500ms 后在 Accept 阶段派发一次。它不是延迟 click，普通点击不会触发长按 handler。

Native callback 边界

不在 Dioxus event dispatch 内触发的原生回调可能发生在 tree patch 中。此时用当前 root 的 RuntimeHandle 把状态更新排到下一 UI tick，避免重入 render：

let runtime = use_runtime_handle();
let mut title = use_signal(String::new);
let callback = move |next: String| {
    runtime.queue_ui(move || title.set(next));
};