Pagination dan Search di Laravel Blade: Tutorial Lengkap

Menampilkan 10.000 data dalam satu halaman adalah cara tercepat membuat web lemot dan user kabur. Solusinya ada dua: pagination untuk membagi data per halaman, dan search supaya user bisa menemukan data yang dicari. Di Laravel, keduanya bisa dibuat dalam hitungan menit, tapi ada satu jebakan klasik yang hampir semua pemula kena: kata kunci search hilang begitu pindah halaman. Artikel ini membahas cara yang benar dari awal sampai selesai.

Persiapan: Data Contoh

Saya pakai contoh tabel products dengan kolom name, price, dan stock. Kalau kamu mengikuti tutorial ini dengan project sendiri, sesuaikan nama model dan kolomnya. Pastikan tabel sudah berisi minimal 30 data dummy supaya pagination terlihat bekerja. Factory bawaan Laravel bisa dipakai untuk ini, cukup panggil Product::factory(50)->create() di seeder.

Pagination Dasar dengan paginate()

Di controller, cukup satu baris:

public function index()
{
    $products = Product::orderBy('name')->paginate(10);

    return view('products.index', compact('products'));
}

Di Blade, tampilkan data lalu panggil links():

<table>
    @foreach ($products as $product)
        <tr>
            <td>{{ $product->name }}</td>
            <td>{{ $product->price }}</td>
        </tr>
    @endforeach
</table>

{{ $products->links() }}

links() otomatis merender tombol halaman dengan style Tailwind. Kalau project memakai Bootstrap, ubah di AppServiceProvider:

use Illuminate\Pagination\Paginator;

public function boot(): void
{
    Paginator::useBootstrapFive();
}

Satu hal penting: paginate() harus dipanggil langsung pada query builder atau Eloquent, bukan pada collection. Kode seperti Product::all()->paginate(10) akan error karena all() mengembalikan collection yang tidak punya method paginate. Ini kesalahan paling umum yang saya lihat di forum Laravel Indonesia.

Menambah Search dengan Form GET

Untuk search, pakai method GET supaya kata kunci muncul di URL. Ini penting: URL yang berisi kata kunci bisa di-bookmark, di-share ke orang lain, dan bekerja normal dengan tombol back browser.

<form method="GET" action="{{ route('products.index') }}">
    <input type="text" name="search" value="{{ request('search') }}"
           placeholder="Cari nama produk...">
    <button type="submit">Cari</button>
</form>

Di controller, tangkap inputnya:

public function index(Request $request)
{
    $search = $request->input('search');

    $products = Product::when($search, function ($query, $search) {
            $query->where('name', 'like', "%{$search}%");
        })
        ->orderBy('name')
        ->paginate(10);

    return view('products.index', compact('products'));
}

Method when() hanya menjalankan closure kalau $search tidak kosong, jadi satu method melayani dua kondisi: halaman biasa dan halaman hasil pencarian. Nilai value="{{ request('search') }}" membuat kata kunci tetap tampil di kotak input setelah form disubmit.

Catatan soal LIKE: di MySQL, LIKE tidak case sensitive secara default, jadi mencari "laptop" akan menemukan "Laptop" dan "LAPTOP". Di PostgreSQL, LIKE itu case sensitive, jadi pakai ILIKE kalau butuh pencarian yang tidak peduli huruf besar kecil.

Jebakan Klasik: Search Hilang Saat Pindah Halaman

Ini bagian yang paling sering bikin bingung. Kamu search "laptop", hasil muncul dengan benar, lalu klik halaman 2 dan hasilnya balik menampilkan semua produk seolah search tidak pernah dilakukan. Penyebabnya sederhana: link pagination yang dirender links() hanya berisi ?page=2, parameter search tidak ikut terbawa.

Solusinya, tambahkan withQueryString():

$products = Product::when($search, function ($query, $search) {
        $query->where('name', 'like', "%{$search}%");
    })
    ->orderBy('name')
    ->paginate(10)
    ->withQueryString();

Sekarang URL halaman 2 menjadi ?search=laptop&page=2 dan filter tetap berlaku di semua halaman. Alternatif lama yang masih sering dipakai adalah appends():

->paginate(10)->appends($request->query());

withQueryString() lebih praktis karena otomatis membawa semua query string yang ada, sementara appends() berguna kalau kamu mau memilih parameter tertentu saja, misalnya ->appends(['search' => $search]).

Menampilkan Info Halaman

Selain tombol navigasi, Laravel menyediakan method untuk info halaman yang membuat UI terasa lebih profesional:

<p>
    Menampilkan {{ $products->firstItem() }} sampai {{ $products->lastItem() }}
    dari {{ $products->total() }} produk
</p>

Hati-hati: kalau hasil pencarian kosong, firstItem() mengembalikan null dan tampilannya jadi aneh. Bungkus dengan pengecekan:

@if ($products->total() > 0)
    <p>Menampilkan {{ $products->firstItem() }} sampai {{ $products->lastItem() }}</p>
@else
    <p>Tidak ada produk yang cocok dengan pencarian kamu.</p>
@endif

simplePaginate untuk Tabel Besar

paginate() menjalankan satu query COUNT tambahan untuk menghitung total data. Untuk tabel dengan jutaan baris, COUNT bisa terasa lambat. Kalau kamu tidak butuh nomor halaman dan cukup dengan tombol "sebelum" dan "sesudah", pakai simplePaginate():

$products = Product::orderBy('name')->simplePaginate(10);

Di Blade tetap pakai {{ $products->links() }}. Perlu diingat, method seperti total(), firstItem(), dan lastItem() tidak tersedia di simple paginator, jadi sesuaikan bagian info halamannya. Untuk kebanyakan aplikasi CRUD biasa, paginate() sudah lebih dari cukup. Pakai simplePaginate() hanya kalau profiling menunjukkan query COUNT jadi masalah.

Custom Tampilan Pagination

Tampilan bawaan kadang tidak cocok dengan desain yang sudah dibuat. Publish view pagination ke project:

php artisan vendor:publish --tag=laravel-pagination

File Blade muncul di resources/views/vendor/pagination/. Edit tailwind.blade.php atau buat file sendiri dari nol, lalu panggil dengan nama view:

{{ $products->links('vendor.pagination.custom') }}

Cara ini jauh lebih rapi daripada menimpa CSS bawaan dengan !important di mana-mana. Kamu punya kontrol penuh atas markup tombolnya, termasuk menambahkan ikon atau mengubah struktur HTML-nya.

Kesalahan Umum dan Cara Menghindarinya

Pertama, memakai POST untuk form search. Selain URL tidak bisa dibagikan, link pagination yang memakai GET akan kehilangan konteks search. Selalu pakai GET untuk pencarian, simpan POST untuk aksi yang mengubah data.

Kedua, memanggil paginate() setelah get() atau all(). Ingat, paginate adalah method query builder, bukan collection. Urutan yang benar: bangun query dulu, paginate paling akhir sebelum dikirim ke view.

Ketiga, lupa withQueryString(). Gejalanya selalu sama: filter hilang di halaman 2 ke atas. Kalau kamu baru sadar setelah fitur jadi, cukup tambahkan satu method chain ini tanpa mengubah logika lain.

Keempat, search di kolom yang tidak di-index pada tabel besar. LIKE dengan wildcard di depan (%laptop) tidak bisa memakai index B-tree, jadi databasenya harus scan satu per satu. Untuk data di bawah ratusan ribu baris ini masih aman, tapi kalau sudah jutaan baris pertimbangkan full text index atau layanan seperti Meilisearch.

Kelima, tidak membatasi panjang input search. Tambahkan validasi ringan supaya query LIKE tidak menerima string raksasa:

$request->validate([
    'search' => 'nullable|string|max:100',
]);

Langkah Praktis yang Bisa Langsung Dicoba

1. Buat route dan controller index seperti contoh di atas pada project Laravel kamu.
2. Isi tabel dengan minimal 30 data lewat factory di seeder, lalu jalankan php artisan db:seed.
3. Buka halaman, search satu kata kunci, lalu klik halaman 2. Pastikan kata kunci tetap ada di URL dan hasil tetap terfilter.
4. Coba ganti paginate(10) dengan simplePaginate(10) dan perhatikan perbedaan tombol navigasinya.
5. Publish view pagination dan ubah satu class CSS untuk melihat seberapa mudah kustomisasinya.

Pagination dan search terlihat sepele, tapi implementasi yang benar membuat aplikasi terasa jauh lebih profesional. Kuncinya cuma tiga: paginate di level query, form search pakai GET, dan jangan lupa withQueryString(). Kuasai tiga ini dan kamu sudah selangkah lebih maju dari kebanyakan tutorial copy paste di luar sana.