WordNav
ui.widgets.Textarea跨文字系统的按词移动光标。
BEHAVIOR CONTRACT
按词跳转遵循 Unicode 词边界,跨越希腊文、西里尔文与 emoji。
RECORDED INTERACTION
Harness 在文本框内按 ⌥← 逐词移动。
pub fn buildWordNav(scope: *ui.Scope, cx: *ui.Cx) anyerror!*ui.Node {
const a = cx.allocator;
const c = try col(cx, 12);
try c.appendChild(a, try label(cx, "Word navigation — Alt+←/→ jumps whole Greek/Cyrillic words; double-click selects the word; family emoji is one cluster"));
const ta = try W.Textarea(.{
.label_text = "Mixed-script sample",
.value = WORDNAV_TEXT,
.rows = 3,
.width = 560,
}).mount(scope, cx);
ta.meta.ownership.meta.test_id = "story.wordnav.ta";
try c.appendChild(a, ta);
try c.appendChild(a, try label(cx, "Expected Alt+Right stops (byte offsets): 7 14 27 34 40 46 72 75"));
return c;
}这是 Storybook 中该 story 的原样代码(zenit 5f9add5+wip 2026-09-30)。其中 W 即 ui.widgets,col / row / label 是 Storybook 内的布局小工具。
TextareaProps
ui.widgets.Textareafn Textarea(props: TextareaProps) TextareaBuilder字段
类型
默认值
说明
value?[]const u8null—
placeholder?[]const u8null—
label_text?[]const u8null—
helper?[]const u8null—
error_msg?[]const u8null—
rowsu324—
disabledboolfalse—
requiredboolfalse—
readonlyboolfalse—
width?f32null—
on_change?core_ui.HandlerRefnull—
context?*anyopaquenull—
*Node
ui.widgets.Textareamount 直接返回 *Node,把它 append 到父节点即可。