Progress

A macOS progress bar (NSProgressIndicator, bar style). Omit value (or pass null) for the indeterminate state — an accent comet ping-pongs across the track. The control is display-only, so there is no v-model. It labels itself Progress by default; pass label (or an aria-label) to override. With reduced motion enabled the comet is replaced by a static muted fill.

Usage

vue
<script setup lang="ts">
import { MacProgress } from 'macvue'
</script>

<template>
  <MacProgress
    :value="40"
    aria-label="Copying"
  />
</template>

Indeterminate

Sizes

Two sizes — regular (10px) and small (6px) — the only two in the reference kit.

API

Props

PropTypeDefault
valuenumber | nullnull (indeterminate)
maxnumber100
size'regular' | 'small''regular'
labelstring'Progress'