Membangun layout admin responsif dengan Bootstrap 5, serta tabel data berpaginasi, pencarian, dan hapus data lewat AJAX (server-side processing).
Pendahuluan
Hampir setiap aplikasi Laravel butuh panel admin: daftar produk, pesanan, pengguna, dan sebagainya. Dua alat yang saling melengkapi untuk kebutuhan ini adalah Bootstrap 5 untuk tata letak dan DataTables untuk tabel interaktif.
Untuk data yang besar, jangan memuat semua baris ke browser. Pakai server-side processing: browser meminta data per halaman lewat AJAX, dan server hanya mengirim baris yang dibutuhkan. Di Laravel, paket yajra/laravel-datatables memudahkan hal ini.
Yang akan kita bangun:
- Layout admin dengan sidebar dan navbar.
- Halaman daftar produk dengan DataTables AJAX (cari, urut, paginasi).
- Tombol aksi edit dan hapus (hapus lewat AJAX dengan konfirmasi).
- Beberapa praktik keamanan dan performa.
1. Persiapan Proyek
composer create-project laravel/laravel admin-dashboard
cd admin-dashboard
composer require yajra/laravel-datatables-oracle
Pastikan memilih versi paket yang kompatibel dengan versi Laravel Anda (composer akan memilihkannya secara otomatis). Atur koneksi database di .env, lalu buat model beserta migrasi dan factory.
php artisan make:model Product -mf
// database/migrations/xxxx_create_products_table.php
Schema::create('products', function (Blueprint $table) {
$table->id();
$table->string('name');
$table->string('sku')->unique();
$table->unsignedBigInteger('price'); // simpan rupiah sebagai integer
$table->unsignedInteger('stock')->default(0);
$table->boolean('is_active')->default(true);
$table->timestamps();
});
// app/Models/Product.php
protected $fillable = ['name', 'sku', 'price', 'stock', 'is_active'];
// database/factories/ProductFactory.php
public function definition(): array
{
return [
'name' => fake()->words(3, true),
'sku' => strtoupper(fake()->unique()->bothify('SKU-####??')),
'price' => fake()->numberBetween(25, 900) * 1000,
'stock' => fake()->numberBetween(0, 200),
'is_active' => fake()->boolean(85),
];
}
Isi 500 data contoh untuk menguji performa:
php artisan migrate
php artisan tinker --execute="App\Models\Product::factory()->count(500)->create();"
2. Layout Admin dengan Bootstrap 5
Untuk kesederhanaan, Bootstrap, jQuery, dan DataTables dimuat dari CDN. Pada proyek produksi, lebih baik dibundel lewat Vite agar tidak bergantung pada pihak ketiga.
{{-- resources/views/layouts/admin.blade.php --}}
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="csrf-token" content="{{ csrf_token() }}">
<title>@yield('title', 'Dashboard') - Admin</title>
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet">
<link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.css" rel="stylesheet">
<link href="https://cdn.datatables.net/2.1.8/css/dataTables.bootstrap5.min.css" rel="stylesheet">
<style>
.sidebar { width: 250px; min-height: 100vh; }
@media (max-width: 991.98px) { .sidebar { width: 100%; min-height: auto; } }
</style>
@stack('styles')
</head>
<body class="bg-body-tertiary">
<div class="d-lg-flex">
<aside class="sidebar bg-dark text-white p-3">
<a href="{{ route('admin.dashboard') }}" class="d-block mb-4 fs-5 fw-semibold text-white text-decoration-none">
<i class="bi bi-speedometer2 me-2"></i>Admin Panel
</a>
<ul class="nav nav-pills flex-column gap-1">
<li class="nav-item">
<a href="{{ route('admin.dashboard') }}"
class="nav-link text-white {{ request()->routeIs('admin.dashboard') ? 'active' : '' }}">
<i class="bi bi-house me-2"></i>Dashboard
</a>
</li>
<li class="nav-item">
<a href="{{ route('admin.products.index') }}"
class="nav-link text-white {{ request()->routeIs('admin.products.*') ? 'active' : '' }}">
<i class="bi bi-box-seam me-2"></i>Produk
</a>
</li>
</ul>
</aside>
<div class="flex-grow-1">
<nav class="navbar bg-white border-bottom px-4">
<span class="navbar-brand mb-0 h1 fs-6">@yield('title', 'Dashboard')</span>
<span class="text-muted small">{{ auth()->user()->name ?? 'Administrator' }}</span>
</nav>
<main class="p-4">
@yield('content')
</main>
</div>
</div>
<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>
<script src="https://cdn.datatables.net/2.1.8/js/dataTables.min.js"></script>
<script src="https://cdn.datatables.net/2.1.8/js/dataTables.bootstrap5.min.js"></script>
<script>
// semua request AJAX jQuery otomatis menyertakan CSRF token
$.ajaxSetup({ headers: { 'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content') } });
</script>
@stack('scripts')
</body>
</html>
3. Route dan Controller
// routes/web.php
use App\Http\Controllers\Admin\{DashboardController, ProductController};
Route::middleware(['auth'])->prefix('admin')->name('admin.')->group(function () {
Route::get('/', [DashboardController::class, 'index'])->name('dashboard');
Route::resource('products', ProductController::class)->except(['show']);
});
Untuk contoh ini, endpoint data DataTables kita buat sebagai method index yang merespons AJAX. Dengan begitu satu URL melayani halaman HTML dan data JSON.
php artisan make:controller Admin/DashboardController
php artisan make:controller Admin/ProductController --resource
// app/Http/Controllers/Admin/ProductController.php
namespace App\Http\Controllers\Admin;
use App\Http\Controllers\Controller;
use App\Models\Product;
use Illuminate\Http\Request;
use Yajra\DataTables\Facades\DataTables;
class ProductController extends Controller
{
public function index(Request $request)
{
if ($request->ajax()) {
$query = Product::query()->select(['id', 'name', 'sku', 'price', 'stock', 'is_active', 'created_at']);
return DataTables::of($query)
->addIndexColumn()
->editColumn('price', fn ($p) => 'Rp '.number_format($p->price, 0, ',', '.'))
->editColumn('is_active', fn ($p) => $p->is_active
? '<span class="badge text-bg-success">Aktif</span>'
: '<span class="badge text-bg-secondary">Nonaktif</span>')
->editColumn('created_at', fn ($p) => $p->created_at->format('d M Y'))
->addColumn('action', fn ($p) => view('admin.products._actions', ['product' => $p])->render())
->rawColumns(['is_active', 'action'])
->make(true);
}
return view('admin.products.index');
}
public function destroy(Product $product)
{
$product->delete();
return response()->json(['message' => 'Produk berhasil dihapus.']);
}
// create, store, edit, update: isi sesuai kebutuhan (Form Request + validasi)
}
Perhatikan rawColumns: hanya kolom yang sengaja berisi HTML (badge dan tombol) yang dikecualikan dari escaping. Kolom lain, seperti name, tetap di-escape otomatis sehingga aman dari XSS.
4. Tampilan Tabel dengan DataTables AJAX
Partial untuk tombol aksi:
{{-- resources/views/admin/products/_actions.blade.php --}}
<div class="btn-group btn-group-sm">
<a href="{{ route('admin.products.edit', $product) }}" class="btn btn-outline-primary">
<i class="bi bi-pencil"></i>
</a>
<button type="button" class="btn btn-outline-danger btn-delete"
data-url="{{ route('admin.products.destroy', $product) }}"
data-name="{{ $product->name }}">
<i class="bi bi-trash"></i>
</button>
</div>
Halaman daftar:
{{-- resources/views/admin/products/index.blade.php --}}
@extends('layouts.admin')
@section('title', 'Produk')
@section('content')
<div class="card shadow-sm">
<div class="card-header d-flex justify-content-between align-items-center">
<span class="fw-semibold">Daftar Produk</span>
<a href="{{ route('admin.products.create') }}" class="btn btn-primary btn-sm">
<i class="bi bi-plus-lg"></i> Tambah
</a>
</div>
<div class="card-body">
<table id="products-table" class="table table-striped table-hover w-100">
<thead>
<tr>
<th>#</th>
<th>Nama</th>
<th>SKU</th>
<th>Harga</th>
<th>Stok</th>
<th>Status</th>
<th>Dibuat</th>
<th style="width:90px">Aksi</th>
</tr>
</thead>
</table>
</div>
</div>
{{-- modal konfirmasi hapus --}}
<div class="modal fade" id="deleteModal" tabindex="-1">
<div class="modal-dialog modal-dialog-centered">
<div class="modal-content">
<div class="modal-header"><h5 class="modal-title">Hapus produk?</h5></div>
<div class="modal-body">Produk <strong id="delete-name"></strong> akan dihapus.</div>
<div class="modal-footer">
<button class="btn btn-secondary" data-bs-dismiss="modal">Batal</button>
<button class="btn btn-danger" id="confirm-delete">Hapus</button>
</div>
</div>
</div>
</div>
@endsection
@push('scripts')
<script>
$(function () {
const table = new DataTable('#products-table', {
processing: true,
serverSide: true,
ajax: "{{ route('admin.products.index') }}",
columns: [
{ data: 'DT_RowIndex', name: 'DT_RowIndex', orderable: false, searchable: false },
{ data: 'name', name: 'name' },
{ data: 'sku', name: 'sku' },
{ data: 'price', name: 'price' },
{ data: 'stock', name: 'stock' },
{ data: 'is_active', name: 'is_active', orderable: false },
{ data: 'created_at', name: 'created_at' },
{ data: 'action', name: 'action', orderable: false, searchable: false },
],
order: [[6, 'desc']],
pageLength: 10,
language: { url: 'https://cdn.datatables.net/plug-ins/2.1.8/i18n/id.json' },
});
// hapus lewat AJAX
let deleteUrl = null;
const modal = new bootstrap.Modal('#deleteModal');
$('#products-table').on('click', '.btn-delete', function () {
deleteUrl = $(this).data('url');
$('#delete-name').text($(this).data('name')); // .text() mencegah XSS
modal.show();
});
$('#confirm-delete').on('click', function () {
$.ajax({ url: deleteUrl, type: 'DELETE' })
.done(() => { modal.hide(); table.ajax.reload(null, false); })
.fail(() => alert('Gagal menghapus data.'));
});
});
</script>
@endpush
Opsi ajax.reload(null, false) memuat ulang data tanpa kembali ke halaman pertama.
5. Cara Kerja Server-Side Processing
Setiap kali pengguna mengetik di kolom pencarian, mengganti halaman, atau mengurutkan kolom, DataTables mengirim request seperti ini:
GET /admin/products?draw=3&start=10&length=10
&search[value]=gamis
&order[0][column]=6&order[0][dir]=desc
Yajra membaca parameter tersebut, menjalankan query dengan WHERE, ORDER BY, dan LIMIT, lalu mengembalikan JSON:
{
"draw": 3,
"recordsTotal": 500,
"recordsFiltered": 12,
"data": [ { "DT_RowIndex": 11, "name": "...", "price": "Rp 125.000" } ]
}
Dengan 500 atau 500.000 baris, browser tetap hanya menerima 10 baris per request.
6. Menambah Fitur Filter
Kirim parameter tambahan ke server dan tangani di controller.
<select id="filter-status" class="form-select form-select-sm w-auto mb-3">
<option value="">Semua status</option>
<option value="1">Aktif</option>
<option value="0">Nonaktif</option>
</select>
ajax: {
url: "{{ route('admin.products.index') }}",
data: d => { d.status = $('#filter-status').val(); }
},
// ...
$('#filter-status').on('change', () => table.ajax.reload());
$query = Product::query()
->select(['id', 'name', 'sku', 'price', 'stock', 'is_active', 'created_at'])
->when($request->filled('status'), fn ($q) => $q->where('is_active', $request->boolean('status')));
7. Keamanan dan Performa
Keamanan
- Lindungi route admin dengan
authdan pembatasan role (misalnya Spatie Permission, lihat artikel terkait). - Gunakan Form Request untuk validasi
storedanupdate. - Hapus data dengan method
DELETEdan CSRF token, bukan linkGET. - Jangan masukkan input pengguna ke kolom yang ditandai
rawColumnstanpae().
Performa
- Pilih kolom dengan
select()seperti pada contoh, janganselect *. - Tambahkan index pada kolom yang sering dicari atau diurutkan (
name,sku,created_at). - Hindari N+1 di kolom relasi: gunakan
with()pada query yang diberikan keDataTables::of(). - Pencarian
LIKE '%kata%'tidak memakai index biasa. Untuk jutaan baris, pertimbangkan FULLTEXT index.
Schema::table('products', function (Blueprint $table) {
$table->index('created_at');
});
Checklist
- ☐ Layout admin responsif di desktop dan mobile.
- ☐
serverSide: trueaktif, dan controller mengembalikan JSON dari query (bukan->get()). - ☐ CSRF token terpasang pada semua request AJAX.
- ☐ Kolom HTML dibatasi lewat
rawColumns. - ☐ Route admin dilindungi middleware autentikasi dan otorisasi.
- ☐ Index database untuk kolom pencarian dan pengurutan.
Penutup
Kombinasi Bootstrap 5, DataTables, dan Yajra memberi dasar yang cepat dibangun dan mudah dikembangkan. Dari sini, Anda bisa menambahkan modul lain dengan pola yang sama: satu controller, satu partial aksi, dan satu konfigurasi DataTables per halaman. Fitur lanjutan seperti ekspor Excel, tombol bulk action, atau filter rentang tanggal dapat ditambahkan tanpa mengubah arsitektur dasarnya.