{"slug":"progress","name":"Progress","category":"Feedback & Status","summary":"Shows how much of a task is complete.","status":"stable","since":"0.2.0","import":"import { Progress } from '@elluzion/iv-ui';","usage":["Set `max` when the scale is not 0–100; the percentage is derived.","`indeterminate` hides the value and animates the track.","`label` names the bar; `showValue` prints the percentage."],"props":[{"name":"value","type":"number","default":"0","description":"Current progress value.","required":false,"bindable":false},{"name":"max","type":"number","default":"100","description":"Value that represents completion.","required":false,"bindable":false},{"name":"indeterminate","type":"boolean","default":"false","description":"Renders an animated unknown-progress state.","required":false,"bindable":false},{"name":"label","type":"string","default":"''","description":"Visible label and accessible name.","required":false,"bindable":false},{"name":"showValue","type":"boolean","default":"false","description":"Shows the percentage at the end of the track.","required":false,"bindable":false},{"name":"size","type":"'sm' | 'md'","default":"'md'","description":"Track thickness.","required":false,"bindable":false},{"name":"className","type":"string","default":"''","description":"Extra classes merged onto the root element.","required":false,"bindable":false}],"events":[],"snippets":[],"types":[],"manual":[],"tokens":["--iv_cursor","--iv_ease-in-out","--iv_font-mono","--iv_font-ui","--iv_foreground","--iv_foreground-dim","--iv_progress-h-md","--iv_progress-h-sm","--iv_radius-sm","--iv_spacing-sm","--iv_surface-elevated","--iv_text-label","--iv_text-sm","--iv_transition-base","--iv_weight-medium"],"cssHooks":["iv-fill","iv-fill-wrap","iv-indeterminate","iv-label","iv-progress","iv-progress-header","iv-sm","iv-track","iv-value"],"accessibility":{"keyboard":[["Escape","Not applicable; the bar is read-only."]],"notes":["The bar uses `role=\"progressbar\"` with `aria-valuemin`, `aria-valuemax`, and `aria-valuenow`.","Indeterminate bars omit the value and use `aria-valuetext=\"Indeterminate\"`.","`label` becomes the accessible name through `aria-labelledby`."]},"related":[{"title":"LoadingSpinner","summary":"An indeterminate indicator for short waits.","url":"/components/loading-spinner","kind":"Component"},{"title":"Skeleton","summary":"A pulsing placeholder that holds the shape of loading content.","url":"/components/skeleton","kind":"Component"},{"title":"Slider","summary":"Selects a number, or a range, along a track.","url":"/components/slider","kind":"Component"},{"title":"Alert","summary":"An inline message for information, success, warning, or error.","url":"/components/alert","kind":"Component"}],"examples":[{"id":"basic","title":"Basic","description":"A bar bound to a value on a 0–100 scale.","code":"<script lang=\"ts\">\n\timport { Progress } from '@elluzion/iv-ui';\n</script>\n\n<div class=\"field-row\">\n\t<Progress value={42} label=\"Upload\" />\n</div>\n\n<style>\n\t.field-row {\n\t\twidth: 100%;\n\t\tmax-width: 380px;\n\t}\n</style>"},{"id":"labeled","title":"Labeled","description":"`label` and `showValue` add a header above the track.","code":"<script lang=\"ts\">\n\timport { Progress } from '@elluzion/iv-ui';\n\n\tlet completed = $state(68);\n</script>\n\n<div class=\"stack\">\n\t<Progress value={completed} label=\"Migration\" showValue />\n\t<div class=\"row\">\n\t\t<button class=\"step\" onclick={() => (completed = Math.max(0, completed - 10))}>−10</button>\n\t\t<button class=\"step\" onclick={() => (completed = Math.min(100, completed + 10))}>+10</button>\n\t</div>\n</div>\n\n<style>\n\t.stack {\n\t\tdisplay: flex;\n\t\tflex-direction: column;\n\t\tgap: var(--iv_spacing-md);\n\t\twidth: 100%;\n\t\tmax-width: 380px;\n\t}\n\n\t.row {\n\t\tdisplay: flex;\n\t\tgap: var(--iv_spacing-sm);\n\t}\n\n\t.step {\n\t\tpadding: var(--iv_spacing-2xs) var(--iv_spacing-sm);\n\t\tborder: 1px solid var(--iv_border);\n\t\tborder-radius: var(--iv_radius-sm);\n\t\tbackground: var(--iv_surface-raised);\n\t\tcolor: var(--iv_foreground);\n\t\tfont-family: var(--iv_font-mono);\n\t\tfont-size: var(--iv_text-sm);\n\t\tcursor: pointer;\n\t}\n</style>"},{"id":"indeterminate","title":"Indeterminate","description":"Use when progress is unknown but the work is running.","code":"<script lang=\"ts\">\n\timport { Progress } from '@elluzion/iv-ui';\n</script>\n\n<div class=\"field-row\">\n\t<Progress indeterminate label=\"Waiting for the runner\" />\n</div>\n\n<style>\n\t.field-row {\n\t\twidth: 100%;\n\t\tmax-width: 380px;\n\t}\n</style>"},{"id":"sizes","title":"Sizes","description":"`sm` for dense rows and `md` for page-level progress.","code":"<script lang=\"ts\">\n\timport { Progress } from '@elluzion/iv-ui';\n</script>\n\n<div class=\"stack\">\n\t<Progress value={30} size=\"sm\" label=\"Small\" showValue />\n\t<Progress value={30} label=\"Medium\" showValue />\n</div>\n\n<style>\n\t.stack {\n\t\tdisplay: flex;\n\t\tflex-direction: column;\n\t\tgap: var(--iv_spacing-lg);\n\t\twidth: 100%;\n\t\tmax-width: 380px;\n\t}\n</style>"}],"markdown":"/components/progress.md","page":"/components/progress"}