---
title: Progress
url: "https://native-sdk.dev/docs/components/progress"
docs_index: /llms.txt
lastUpdated: 2026-10-16
---

> For an index of all documentation, see [/llms.txt](/llms.txt).

Use `progress` to display a fraction from 0 to 1. The renderer clamps values outside that range. Set `width` or `grow` to size the track. The control has no input events. Use [slider](/docs/components/slider) for an adjustable value or [spinner](/docs/components/spinner) for an indeterminate wait.

## Markup

```html
<progress value="{upload_fraction}" width="280" />
```

## Programmatic construction (Zig)

In a Zig view, the `canvas.Ui` builder constructs the same tree programmatically:

```zig
ui.el(.progress, .{ .value = model.upload_fraction, .width = 280 }, .{})
```

## Attributes

| Attribute | Description                                                                                                                                      |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `value`   | Value for slider/progress/text entry; a literal or one \{binding}.                                                                               |
| `width`   | Definite width (plain number): the element is exactly this wide; content neither shrinks nor overflows it. On resizable it is the initial width. |

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)