Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Progress

    Bilah kemajuan berbasis elemen progress native dengan label, persentase, dan mode tak tentu.

    60%
    60%
    60%
    60%
    75%
    60%
    75%

    Progress

    <x-markas.progress label="Uploading" :value="60" />
    import { Progress } from "@/components/markas/Progress";
    
    <Progress label="Uploading" value={60} />
    import Progress from "@/components/markas/Progress.vue";
    
    <Progress label="Uploading" :value="60" />
    <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>
    import { Component } from "@angular/core";
    import { Progress } from "./markas/progress.component";
    
    @Component({
      selector: "markas-example",
      imports: [Progress],
      template: `
        <div class="grid gap-5">
          <markas-progress label="Uploading file" [value]="60"></markas-progress>
          <markas-progress
            label="Storage used"
            [value]="3"
            [max]="4"
          ></markas-progress>
          <markas-progress label="Preparing report"></markas-progress>
        </div>
      `,
    })
    export default class ProgressExample {}

    Contoh

    Nilai

    0%
    25%
    75%
    100%
    0%
    25%
    75%
    100%
    0%
    25%
    75%
    100%
    0%
    25%
    75%
    100%
    0%
    25%
    75%
    100%

    Nilai maksimum khusus

    60%
    58%
    60%
    58%
    60%
    58%
    60%
    58%
    60%
    58%

    Tanpa 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

    Dalam 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.

    Instalasi

    npx markasui@latest add progress

    Pemakaian

    <x-markas.progress label="Mengunggah berkas" :value="60" />
    <x-markas.progress label="Penyimpanan terpakai" :value="3" :max="4" />
    <x-markas.progress label="Menyiapkan laporan" />
    import { Progress } from "@/components/markas/Progress";
    
    <Progress label="Mengunggah berkas" value={60} />
    <Progress label="Penyimpanan terpakai" value={3} max={4} />
    <Progress label="Menyiapkan laporan" />
    <script setup lang="ts">
    import Progress from "@/components/markas/Progress.vue";
    </script>
    
    <template>
      <Progress label="Mengunggah berkas" :value="60" />
      <Progress label="Penyimpanan terpakai" :value="3" :max="4" />
      <Progress label="Menyiapkan laporan" />
    </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 {}
    • Tanpa value, progress menjadi tak tentu dan berdenyut. Animasi mati saat prefers-reduced-motion.
    • Tanpa label, isi aria-label supaya progress punya nama.
    • Persentase dibulatkan dan dibatasi 0 sampai 100.

    Props

    NamaTipeDefaultKeterangan
    valuenumber | nullnullNilai saat ini. null membuat progress tak tentu (indeterminate) dengan animasi denyut.
    maxnumber100Nilai maksimum.
    labelstring-Label di atas bilah, dihubungkan lewat label for. Persentase tampil di kanan bila value terisi.
    idstringautoId elemen progress.

    Aksesibilitas

    • Memakai elemen progress native, jadi role progressbar dan nilainya terbaca otomatis.
    • Label terhubung lewat label for. Tanpa label, isi aria-label.
    • Animasi mode tak tentu dimatikan saat prefers-reduced-motion.

    Komponen terkait

    Komponen feedback lain dengan class yang sama di setiap framework.