Progress bar built on the native progress element, with a label, percentage, and indeterminate mode.
25%
60%
100%
60%
60%
60%
75%
60%
75%
<x-markas.progress label="Uploading" :value="25" /><x-markas.progress label="Uploading" :value="60" /><x-markas.progress label="Uploading" :value="100" /><x-markas.progress label="Uploading" />import { Progress } from "@/components/markas/Progress";
<Progress label="Uploading" value={25} />import { Progress } from "@/components/markas/Progress";
<Progress label="Uploading" value={60} />import { Progress } from "@/components/markas/Progress";
<Progress label="Uploading" value={100} />import { Progress } from "@/components/markas/Progress";
<Progress label="Uploading" />import Progress from "@/components/markas/Progress.vue";
<Progress label="Uploading" :value="25" />import Progress from "@/components/markas/Progress.vue";
<Progress label="Uploading" :value="60" />import Progress from "@/components/markas/Progress.vue";
<Progress label="Uploading" :value="100" />import Progress from "@/components/markas/Progress.vue";
<Progress label="Uploading" /><script lang="ts">
import Progress from "$lib/components/markas/Progress.svelte";
</script>
<div class="grid gap-5">
<Progress label="Uploading file" value={60} />
<Progress label="Storage used" value={3} max={4} />
<Progress label="Preparing report" />
</div>---
import Progress from "@/components/markas/Progress.astro";
---
<div class="grid gap-5">
<Progress label="Uploading file" value={60} />
<Progress label="Storage used" value={3} max={4} />
<Progress label="Preparing report" />
</div>Examples
Values
0%
25%
75%
100%
0%
25%
75%
100%
0%
25%
75%
100%
0%
25%
75%
100%
0%
25%
75%
100%
<div class="grid gap-5">
<x-markas.progress label="Not started" :value="0" />
<x-markas.progress label="Profile setup" :value="25" />
<x-markas.progress label="Course progress" :value="75" />
<x-markas.progress label="Backup complete" :value="100" />
</div>import { Progress } from "@/components/markas/Progress";
export default function Example() {
return (
<div className="grid gap-5">
<Progress label="Not started" value={0} />
<Progress label="Profile setup" value={25} />
<Progress label="Course progress" value={75} />
<Progress label="Backup complete" value={100} />
</div>
);
}<script setup lang="ts">
import Progress from "@/components/markas/Progress.vue";
</script>
<template>
<div class="grid gap-5">
<Progress label="Not started" :value="0" />
<Progress label="Profile setup" :value="25" />
<Progress label="Course progress" :value="75" />
<Progress label="Backup complete" :value="100" />
</div>
</template><script lang="ts">
import Progress from "$lib/components/markas/Progress.svelte";
</script>
<div class="grid gap-5">
<Progress label="Not started" value={0} />
<Progress label="Profile setup" value={25} />
<Progress label="Course progress" value={75} />
<Progress label="Backup complete" value={100} />
</div>---
import Progress from "@/components/markas/Progress.astro";
---
<div class="grid gap-5">
<Progress label="Not started" value={0} />
<Progress label="Profile setup" value={25} />
<Progress label="Course progress" value={75} />
<Progress label="Backup complete" value={100} />
</div>Custom max
60%
58%
60%
58%
60%
58%
60%
58%
60%
58%
<div class="grid gap-5">
<x-markas.progress label="Onboarding tasks" :value="3" :max="5" />
<x-markas.progress label="Lessons watched" :value="7" :max="12" />
</div>import { Progress } from "@/components/markas/Progress";
export default function Example() {
return (
<div className="grid gap-5">
<Progress label="Onboarding tasks" value={3} max={5} />
<Progress label="Lessons watched" value={7} max={12} />
</div>
);
}<script setup lang="ts">
import Progress from "@/components/markas/Progress.vue";
</script>
<template>
<div class="grid gap-5">
<Progress label="Onboarding tasks" :value="3" :max="5" />
<Progress label="Lessons watched" :value="7" :max="12" />
</div>
</template><script lang="ts">
import Progress from "$lib/components/markas/Progress.svelte";
</script>
<div class="grid gap-5">
<Progress label="Onboarding tasks" value={3} max={5} />
<Progress label="Lessons watched" value={7} max={12} />
</div>---
import Progress from "@/components/markas/Progress.astro";
---
<div class="grid gap-5">
<Progress label="Onboarding tasks" value={3} max={5} />
<Progress label="Lessons watched" value={7} max={12} />
</div>Without label
Step 2 of 5: Shipping address
9 GB of 10 GB used
Step 2 of 5: Shipping address
9 GB of 10 GB used
Step 2 of 5: Shipping address
9 GB of 10 GB used
Step 2 of 5: Shipping address
9 GB of 10 GB used
Step 2 of 5: Shipping address
9 GB of 10 GB used
<div class="grid gap-4">
<div class="grid gap-2">
<x-markas.progress :value="40" aria-label="Checkout progress" />
<p class="text-sm text-muted">Step 2 of 5: Shipping address</p>
</div>
<div class="grid gap-2">
<x-markas.progress :value="90" aria-label="Storage used" />
<p class="text-sm text-muted">9 GB of 10 GB used</p>
</div>
</div>In a card
quarterly-report.pdf
2.4 MB of 4 MB
Preparing export
This can take a few minutes.
quarterly-report.pdf2.4 MB of 4 MB
Preparing exportThis can take a few minutes.
quarterly-report.pdf2.4 MB of 4 MB
Preparing exportThis can take a few minutes.
quarterly-report.pdf 2.4 MB of 4 MB
Preparing export This can take a few minutes.
quarterly-report.pdf2.4 MB of 4 MB
Preparing exportThis can take a few minutes.
Installation
npx markasui@latest add progresspnpm dlx markasui@latest add progressyarn dlx markasui@latest add progressbunx --bun markasui@latest add progress- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Copy the component source below to
resources/views/components/markas/progress.blade.php.
resources/views/components/markas/progress.blade.php
- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Copy the component source below to
src/components/markas/Progress.tsx.
src/components/markas/Progress.tsx
- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Copy the component source below to
src/components/markas/Progress.vue.
src/components/markas/Progress.vue
- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Copy the component source below to
src/lib/components/markas/Progress.svelte.
src/lib/components/markas/Progress.svelte
- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Copy the component source below to
src/components/markas/Progress.astro.
src/components/markas/Progress.astro
- Make sure Tailwind CSS v4 and markas.css are installed. See Installation.
- Copy the component source below to
src/app/markas/progress.component.ts.
src/app/markas/progress.component.ts
Usage
<x-markas.progress label="Uploading file" :value="60" />
<x-markas.progress label="Storage used" :value="3" :max="4" />
<x-markas.progress label="Preparing report" />import { Progress } from "@/components/markas/Progress";
<Progress label="Uploading file" value={60} />
<Progress label="Storage used" value={3} max={4} />
<Progress label="Preparing report" /><script setup lang="ts">
import Progress from "@/components/markas/Progress.vue";
</script>
<template>
<Progress label="Uploading file" :value="60" />
<Progress label="Storage used" :value="3" :max="4" />
<Progress label="Preparing report" />
</template><script lang="ts">
import Progress from "$lib/components/markas/Progress.svelte";
</script>
<Progress label="Uploading file" value={60} />
<Progress aria-label="Preparing export" />---
import Progress from "@/components/markas/Progress.astro";
---
<Progress label="Uploading file" value={60} />
<Progress aria-label="Preparing export" />import { Component } from "@angular/core";
import { Progress } from "./markas/progress.component";
@Component({
selector: "app-upload",
imports: [Progress],
template: `
<markas-progress label="Uploading file" [value]="60" />
<markas-progress aria-label="Preparing export" />
`,
})
export class Upload {}- Without
value, the progress is indeterminate and pulses. The animation stops underprefers-reduced-motion. - Without
label, setaria-labelso the progress has a name. - The percentage is rounded and clamped between 0 and 100.
Props
| Name | Type | Default | Description |
|---|---|---|---|
value | number | null | null | Current value. null makes the progress indeterminate with a pulse animation. |
max | number | 100 | Maximum value. |
label | string | - | Label above the bar, linked with label for. The percentage shows on the right when value is set. |
id | string | auto | Id of the progress element. |
Accessibility
- Uses the native progress element, so the progressbar role and its value are exposed automatically.
- The label is linked with label for. Without a label, set aria-label.
- The indeterminate animation is turned off under prefers-reduced-motion.
Related components
More feedback components with the same classes in every framework.
- AlertIn-page message for important information, with info, success, warning, and danger variants.
- BadgeSmall pill-shaped status label with a colored dot for neutral, primary, success, warning, and danger.
- SkeletonPulsing placeholder for content that is loading, sized through classes.
- ToastShort notification in the bottom right corner that dismisses itself, triggered with the toast() function or an event.