Skip to content

Circular Progress API Reference

Props

PropTypeDefaultDescription
modelValueNumber0v-model binding value for progress (0-100)
bgColorString'#ddd'Background color of the progress circle
colorString'#000'Color of the progress indicator
indeterminateBooleanfalseWhether to show indeterminate loading animation
rotateNumber0Rotation angle of the progress indicator in degrees
sizeNumber100Size of the circular progress in pixels
widthNumber4Width of the progress circle stroke in pixels
showValueBooleanfalseWhether to display the current progress percentage
roundBooleanfalseWhether to use rounded stroke caps for the progress circle

Events

The component doesn't emit any events.

Slots

The component doesn't provide any slots.

Methods

The component doesn't expose any methods via template refs.

Example Usage

Basic Usage

vue
<template>
  <OCircularProgress v-model="progress" color="#4a90e2" :size="100" />
</template>

<script setup>
import { ref } from "vue";
import { OCircularProgress } from "your-component-library";

const progress = ref(75);
</script>

Indeterminate Loading

vue
<template>
  <OCircularProgress indeterminate color="#4a90e2" :size="100" />
</template>

<script setup>
import { OCircularProgress } from "your-component-library";
</script>

With Custom Colors and Size

vue
<template>
  <OCircularProgress
    v-model="progress"
    color="#4a90e2"
    bg-color="#e0e0e0"
    :size="150"
    :width="8"
    show-value
    round
  />
</template>

<script setup>
import { ref } from "vue";
import { OCircularProgress } from "your-component-library";

const progress = ref(60);
</script>

Different Sizes

vue
<template>
  <div class="progress-group">
    <OCircularProgress v-model="progress" :size="50" />
    <OCircularProgress v-model="progress" :size="100" />
    <OCircularProgress v-model="progress" :size="150" />
  </div>
</template>

<script setup>
import { ref } from "vue";
import { OCircularProgress } from "your-component-library";

const progress = ref(75);
</script>

With Custom Rotation

vue
<template>
  <OCircularProgress
    v-model="progress"
    :rotate="45"
    color="#4a90e2"
    show-value
  />
</template>

<script setup>
import { ref } from "vue";
import { OCircularProgress } from "your-component-library";

const progress = ref(75);
</script>