Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Pagination

    Navigasi antar halaman berbasis link dengan tombol Sebelumnya, Berikutnya, dan elipsis untuk halaman yang dilewati.

    Pagination

    <x-markas.pagination :page="5" :total="10" href="?page={page}" />
    import { Pagination } from "@/components/markas/Pagination";
    
    <Pagination page={5} total={10} href="?page={page}" />
    import Pagination from "@/components/markas/Pagination.vue";
    
    <Pagination :page="5" :total="10" href="?page={page}" />
    <script lang="ts">
      import Pagination from "$lib/components/markas/Pagination.svelte";
    </script>
    
    <Pagination page={5} total={10} href={"?p={page}"} />
    ---
    import Pagination from "@/components/markas/Pagination.astro";
    ---
    
    <Pagination page={5} total={10} href="?p={page}" />
    import { Component } from "@angular/core";
    import { Pagination } from "./markas/pagination.component";
    
    @Component({
      selector: "markas-example",
      imports: [Pagination],
      template: `<nav markas-pagination page="5" total="10" [href]="href"></nav>`,
    })
    export default class PaginationExample {
      protected readonly href = "?p={page}";
    }

    Contoh

    Halaman pertama

    Halaman terakhir

    Sedikit halaman

    Kaki tabel

    Showing 21 to 30 of 97 results

    Showing 21 to 30 of 97 results

    Showing 21 to 30 of 97 results

    Showing 21 to 30 of 97 results

    Showing 21 to 30 of 97 results

    Instalasi

    npx markasui@latest add pagination

    Pemakaian

    <x-markas.pagination
        :page="$users->currentPage()"
        :total="$users->lastPage()"
        href="?page={page}"
        nav-label="Navigasi halaman"
        previous-label="Sebelumnya"
        next-label="Berikutnya"
    />

    Tidak butuh Alpine.js.

    import { Pagination } from "@/components/markas/Pagination";
    
    <Pagination
      page={5}
      total={10}
      href="?page={page}"
      navLabel="Navigasi halaman"
      previousLabel="Sebelumnya"
      nextLabel="Berikutnya"
    />;
    <template>
      <Pagination
        :page="5"
        :total="10"
        href="?page={page}"
        nav-label="Navigasi halaman"
        previous-label="Sebelumnya"
        next-label="Berikutnya"
      />
    </template>
    <script lang="ts">
      import Pagination from "$lib/components/markas/Pagination.svelte";
    </script>
    
    <Pagination
      page={5}
      total={10}
      href={"?page={page}"}
      navLabel="Navigasi halaman"
      previousLabel="Sebelumnya"
      nextLabel="Berikutnya"
    />

    Tulis pola di dalam {"..."}, karena {page} di atribut Svelte yang dikutip dianggap ekspresi.

    ---
    import Pagination from "@/components/markas/Pagination.astro";
    ---
    
    <Pagination
      page={5}
      total={10}
      href="?page={page}"
      navLabel="Navigasi halaman"
      previousLabel="Sebelumnya"
      nextLabel="Berikutnya"
    />

    Tanpa script klien: semua link berupa anchor biasa.

    import { Component } from "@angular/core";
    import { Pagination } from "./markas/pagination.component";
    
    @Component({
      selector: "app-hasil",
      imports: [Pagination],
      template: `
        <nav
          markas-pagination
          [page]="page"
          total="10"
          [href]="href"
          navLabel="Navigasi halaman"
          previousLabel="Sebelumnya"
          nextLabel="Berikutnya"
        ></nav>
      `,
    })
    export class Hasil {
      readonly page = 5;
      readonly href = "?page={page}";
    }

    Angular memakai attribute selector pada nav native, jadi id, class, dan atribut lain tetap di nav. Isi href lewat properti karena {page} bentrok dengan sintaks template.

    • Jumlah tombol angka tetap siblings * 2 + 5 (7 untuk default), contoh halaman 5 dari 10: 1 … 4 5 6 … 10.
    • Fungsi pageRange(page, total, siblings) diekspor dari versi React, Vue, Svelte (module script), dan Angular bila ingin membuat tampilan sendiri.
    • Teks bawaan dalam bahasa Inggris (“Pagination”, “Previous”, “Next”). Isi navLabel, previousLabel, dan nextLabel (Blade: nav-label, previous-label, next-label) untuk situs berbahasa Indonesia.

    Props

    NamaTipeDefaultKeterangan
    pagenumber1Halaman saat ini. Dibatasi ke rentang 1 sampai total.
    totalnumber1Jumlah halaman.
    hrefstring'?page={page}'Pola URL. {page} diganti nomor halaman.
    siblingsnumber1Jumlah halaman yang tampil di kiri dan kanan halaman saat ini.
    navLabelstringPaginationLabel aksesibel elemen nav. Isi "Navigasi halaman" untuk situs berbahasa Indonesia.
    previousLabelstringPreviousTeks link halaman sebelumnya. Isi "Sebelumnya" untuk situs berbahasa Indonesia.
    nextLabelstringNextTeks link halaman berikutnya. Isi "Berikutnya" untuk situs berbahasa Indonesia.

    Aksesibilitas

    • Dibungkus nav dengan label dari navLabel (default Pagination).
    • Halaman aktif memakai aria-current=page.
    • Link sebelumnya dan berikutnya memakai rel prev dan next, dan menjadi span aria-disabled di halaman pertama atau terakhir.
    • Elipsis diberi aria-hidden.
    • Di container sempit teks previousLabel dan nextLabel hanya disembunyikan secara visual (sr-only), nama aksesibelnya tetap ada.

    Komponen terkait

    Komponen navigasi lain dengan class yang sama di setiap framework.