Skip to content

Progress

Show how much of a task has completed.

Demos

Size
State
Value

Usage

vue
<script setup lang="ts">
import { Accordion } from '~/components/ui/accordion'

const items = [
  { value: 'source', label: 'Do I own the source?', content: 'Yes. Copy and adapt the files.' },
]
</script>

<template>
  <Accordion :items="items" />
</template>

Values and orientation

Bind the value with v-model. Set it to null for indeterminate progress. The preview exposes a value control and orientation under Options and states.

vue
import type { UiConfig } from './ui.types'

const uiConfig: UiConfig = {
  defaults: { size: 'md' },
  components: {
    button: { color: 'primary', variant: 'solid' },
    input: { variant: 'outline' },
  },
}

export default uiConfig

Vertical progress fills from the bottom and keeps the selected thickness. Width and height changes transition over 200ms; reduced motion disables the transition and indeterminate pulse.

Installation

Complete the shared installation. Copy Progress.vue and index.ts into app/components/ui/progress/.

API

Variants and defaults

PropValuesDefault
sizexs, sm, md, lg, xlsm

Props

PropTypeDefaultDescription
modelValuenumber | nullnullCurrent progress value. null = indeterminate.
minnumber0Minimum value.
maxnumber100Maximum value.
orientation"horizontal" | "vertical""horizontal"Orientation of the progress bar.
ariaLabelstring—Accessible label when no visible label is present.
getValueLabel(value: number | null, max: number) => string—Custom function to generate the aria-valuetext.
uiProgressUi—CSS class overrides.

Slots

SlotScoped propsDescription
indicator{ value, percentage, max, min, state }The filled indicator element. state is "indeterminate" when value is null.