---
title: "VectorPath 组件 — zenit Zig UI"
description: "矢量路径几何：描边、填充与命中。路径几何在 GPU 上渲染，命中测试与绘制共用同一几何。"
url: https://zenit.z.express/zh/components/vectorpath
language: zh-CN
alternate_en: https://zenit.z.express/components/vectorpath.md
alternate_es: https://zenit.z.express/es/components/vectorpath.md
alternate_ja: https://zenit.z.express/ja/components/vectorpath.md
alternate_ko: https://zenit.z.express/ko/components/vectorpath.md
alternate_fr: https://zenit.z.express/fr/components/vectorpath.md
alternate_de: https://zenit.z.express/de/components/vectorpath.md
project: zenit v0.1.0-alpha (Zig 0.15.2, macOS)
source: https://github.com/version-next/zenit
---

# VectorPath

`ui.path`

矢量路径几何：描边、填充与命中。

[Video](https://zenit.z.express/media/stories/vectorpath.mp4?v=b261110454)

**BEHAVIOR CONTRACT**

路径几何在 GPU 上渲染，命中测试与绘制共用同一几何。

**RECORDED INTERACTION**

录像扫过各类路径。

`examples/storybook/stories.zig:3272`

```zig
pub fn buildVectorPath(scope: *ui.Scope, cx: *ui.Cx) anyerror!*ui.Node {
    _ = scope;
    const a = cx.allocator;
    const c = try col(cx, 16);

    // 相邻多 path 节点：encoder 侧应合并为少数 draw（polygon 组 + triangles 组）
    try c.appendChild(a, try label(cx, "Batched fill_path — adjacent stars (polygon mode)"));
    const stars = try row(cx, 12);
    const star_colors = [_]ui.Color{
        ui.Color.rgb(235, 87, 87),
        ui.Color.rgb(242, 153, 74),
        ui.Color.rgb(39, 174, 96),
        ui.Color.rgb(45, 156, 219),
    };
    for (star_colors) |color| {
        const n = try ui.box(cx, .{
            .width = .{ .px = 64 },
            .height = .{ .px = 64 },
            .background = color,
        }, .{});
        try setStarGeometry(n, a, 64);
        try stars.appendChild(a, n);
    }
    try c.appendChild(a, stars);

    try c.appendChild(a, try label(cx, "Bursts 40-pt (earclip triangles mode)"));
    const bursts = try row(cx, 12);
    const burst_colors = [_]ui.Color{
        ui.Color.rgb(155, 81, 224),
        ui.Color.rgb(47, 128, 237),
        ui.Color.rgb(33, 150, 83),
    };
    for (burst_colors) |color| {
        const n = try ui.box(cx, .{
            .width = .{ .px = 64 },
            .height = .{ .px = 64 },
            .background = color,
        }, .{});
        try setBurstGeometry(n, a, 64);
        try bursts.appendChild(a, n);
    }
    try c.appendChild(a, bursts);

    return c;
}
```

[在 GitHub 查看源码examples/storybook/stories.zig:3272](https://github.com/version-next/zenit/blob/HEAD/examples/storybook/stories.zig#L3272)

这是 Storybook 中该 story 的原样代码（zenit 5f9add5+wip 2026-09-30）。其中 `W` 即 `ui.widgets`，`col` / `row` / `label` 是 Storybook 内的布局小工具。