Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Dashboard Admin, CRUD & Frontend / Cara Membuat Admin Dashboard L...
Dashboard Admin, CRUD & Frontend

Cara Membuat Admin Dashboard Laravel dengan Bootstrap 5 dan DataTables AJAX

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
20 min read
14 views

Membangun panel admin dari nol dengan Bootstrap 5.3 dan DataTables 2 lewat Vite: layout sidebar responsif, kartu ringkasan, tabel data yang dimuat lewat AJAX, aksi edit dan hapus tanpa reload, notifikasi toast, dan rendering yang aman dari XSS.

Overview

Banyak aplikasi bisnis tidak membutuhkan SPA. Yang dibutuhkan adalah panel admin yang cepat dibuat, mudah dipahami tim, dan nyaman dipakai: sidebar, kartu ringkasan, tabel yang bisa dicari dan diurutkan, serta aksi yang tidak memuat ulang seluruh halaman.

Kombinasi Blade + Bootstrap 5 + DataTables masih menjadi pilihan praktis untuk kebutuhan ini. Masalah yang sering muncul saat membangunnya:

  • Bootstrap dan DataTables dimuat dari CDN berbeda versi sehingga tampilan rusak,
  • data dimasukkan langsung ke HTML untuk ribuan baris dan halaman menjadi berat,
  • tombol hapus memakai GET atau lupa token CSRF,
  • kolom tabel dirender tanpa escaping sehingga membuka celah XSS,
  • setelah menyimpan, seluruh halaman di-reload dan posisi tabel hilang.

Hasil akhir: panel admin aplikasi RW dengan:

  • layout sidebar responsif (offcanvas di layar kecil),
  • kartu ringkasan di halaman dasbor,
  • halaman Data Warga dengan DataTables yang mengambil data lewat AJAX,
  • modal tambah/ubah dan konfirmasi hapus yang memanggil API dengan CSRF,
  • toast notifikasi dan reload tabel tanpa kehilangan posisi halaman.

Artikel ini memakai mode client-side DataTables (data dikirim sekaligus, cocok hingga beberapa ribu baris). Untuk puluhan ribu baris ke atas, lanjutkan ke artikel Panduan Membuat Server-Side Processing DataTables.

Prerequisites

Komponen Versi
PHP 8.3+ (disarankan 8.4)
Laravel 13.x
Node.js 22 LTS
Bootstrap 5.3.x
DataTables 2.3.x (datatables.net-bs5)
Bootstrap Icons 1.11+
Sass 1.x (sass)

Sudah ada autentikasi dan otorisasi (lihat seri keamanan: Login dan Logout, Role dan Permission).

Step-by-step Tutorial

Langkah 1: Pasang Paket Frontend lewat npm

Proyek Laravel 13 baru sudah memakai Vite dan Tailwind CSS. Untuk panel admin berbasis Bootstrap, buat entry terpisah agar CSS Bootstrap dan Tailwind tidak saling bertabrakan.

npm install bootstrap @popperjs/core bootstrap-icons
npm install jquery datatables.net-bs5 datatables.net-responsive-bs5
npm install --save-dev sass

DataTables 2 bisa dipakai dengan API new DataTable(...) tanpa menulis kode jQuery, tetapi jQuery tetap menjadi dependensinya.

Tambahkan entry baru di vite.config.js:

// vite.config.js
import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';
import tailwindcss from '@tailwindcss/vite';

export default defineConfig({
    plugins: [
        laravel({
            input: [
                'resources/css/app.css',          // halaman publik (Tailwind)
                'resources/js/app.js',
                'resources/scss/admin.scss',      // panel admin (Bootstrap)
                'resources/js/admin.js',
            ],
            refresh: true,
        }),
        tailwindcss(),
    ],
});

Langkah 2: Stylesheet dan JavaScript Admin

// resources/scss/admin.scss
$primary: #1f6f5c;          // warna identitas aplikasi
$font-family-sans-serif: "Inter", system-ui, -apple-system, "Segoe UI", sans-serif;
$enable-shadows: false;

@import "bootstrap/scss/bootstrap";
@import "bootstrap-icons/font/bootstrap-icons.css";
@import "datatables.net-bs5/css/dataTables.bootstrap5.css";
@import "datatables.net-responsive-bs5/css/responsive.bootstrap5.css";

// Layout
.admin-sidebar {
    width: 260px;
    min-height: 100vh;
}

@include media-breakpoint-up(lg) {
    .admin-main { margin-left: 260px; }
}

.admin-sidebar .nav-link.active {
    background-color: rgba($primary, .12);
    color: $primary;
    font-weight: 600;
}

Sass terbaru menampilkan peringatan deprecation untuk @import. Peringatan ini berasal dari cara Bootstrap 5 disusun dan tidak memengaruhi hasil. Bila mengganggu, matikan lewat opsi silenceDeprecations di konfigurasi Vite.

// resources/js/admin.js
import * as bootstrap from 'bootstrap';
import DataTable from 'datatables.net-bs5';
import 'datatables.net-responsive-bs5';

window.bootstrap = bootstrap;
window.DataTable = DataTable;

// Bahasa Indonesia untuk semua DataTable
Object.assign(DataTable.defaults, {
    language: {
        search: 'Cari:',
        lengthMenu: 'Tampilkan _MENU_ data',
        info: 'Menampilkan _START_–_END_ dari _TOTAL_ data',
        infoEmpty: 'Tidak ada data',
        infoFiltered: '(disaring dari _MAX_ data)',
        zeroRecords: 'Data tidak ditemukan',
        emptyTable: 'Belum ada data',
        loadingRecords: 'Memuat...',
        paginate: { first: '«', last: '»', next: '›', previous: '‹' },
    },
    pageLength: 25,
    responsive: true,
});

// Helper fetch dengan CSRF dan JSON
window.api = async (url, { method = 'GET', body } = {}) => {
    const res = await fetch(url, {
        method,
        headers: {
            'Accept': 'application/json',
            'Content-Type': 'application/json',
            'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content,
        },
        body: body ? JSON.stringify(body) : undefined,
        credentials: 'same-origin',
    });

    const data = res.status === 204 ? null : await res.json().catch(() => null);
    if (!res.ok) throw { status: res.status, data };
    return data;
};

// Toast sederhana
window.toast = (message, variant = 'success') => {
    const wrap = document.getElementById('toast-area');
    const el = document.createElement('div');
    el.className = `toast align-items-center text-bg-${variant} border-0`;
    el.setAttribute('role', 'status');
    el.innerHTML = `<div class="d-flex"><div class="toast-body"></div>
        <button type="button" class="btn-close btn-close-white me-2 m-auto" data-bs-dismiss="toast"></button></div>`;
    el.querySelector('.toast-body').textContent = message;   // textContent: aman dari XSS
    wrap.appendChild(el);
    const t = new bootstrap.Toast(el, { delay: 4000 });
    el.addEventListener('hidden.bs.toast', () => el.remove());
    t.show();
};

Langkah 3: Layout Admin

{{-- 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', 'Dasbor') · {{ config('app.name') }}</title>
    @vite(['resources/scss/admin.scss', 'resources/js/admin.js'])
    @stack('head')
</head>
<body class="bg-body-tertiary">

    {{-- Sidebar: offcanvas di layar kecil, tetap di layar besar --}}
    <aside class="admin-sidebar offcanvas-lg offcanvas-start bg-white border-end position-fixed top-0 start-0"
           tabindex="-1" id="sidebar" aria-labelledby="sidebarLabel">
        <div class="offcanvas-header border-bottom">
            <h5 class="offcanvas-title fw-bold" id="sidebarLabel">{{ config('app.name') }}</h5>
            <button type="button" class="btn-close d-lg-none" data-bs-dismiss="offcanvas" data-bs-target="#sidebar"></button>
        </div>
        <div class="offcanvas-body d-flex flex-column p-3">
            <nav class="nav nav-pills flex-column gap-1">
                @foreach ($menu as $item)
                    <a href="{{ route($item['route']) }}"
                       @class(['nav-link d-flex align-items-center gap-2', 'active' => request()->routeIs($item['route'].'*')])>
                        <i class="bi bi-{{ $item['icon'] }}"></i> {{ $item['label'] }}
                    </a>
                @endforeach
            </nav>
        </div>
    </aside>

    <div class="admin-main">
        <header class="navbar bg-white border-bottom sticky-top px-3">
            <button class="btn btn-outline-secondary d-lg-none" data-bs-toggle="offcanvas" data-bs-target="#sidebar"
                    aria-label="Buka menu"><i class="bi bi-list"></i></button>
            <span class="navbar-text fw-semibold">@yield('title')</span>
            <div class="dropdown">
                <button class="btn btn-light dropdown-toggle" data-bs-toggle="dropdown">{{ auth()->user()->name }}</button>
                <ul class="dropdown-menu dropdown-menu-end">
                    <li><a class="dropdown-item" href="{{ route('profile.edit') }}">Profil</a></li>
                    <li><hr class="dropdown-divider"></li>
                    <li>
                        <form method="POST" action="{{ route('logout') }}">@csrf
                            <button class="dropdown-item text-danger">Keluar</button>
                        </form>
                    </li>
                </ul>
            </div>
        </header>

        <main class="container-fluid py-4">
            @yield('content')
        </main>
    </div>

    <div id="toast-area" class="toast-container position-fixed bottom-0 end-0 p-3"></div>

    @if (session('status'))
        <script nonce="{{ Vite::cspNonce() }}">
            document.addEventListener('DOMContentLoaded', () => toast(@js(session('status'))));
        </script>
    @endif

    @stack('scripts')
</body>
</html>

Variabel $menu disuplai oleh view composer yang menyaring menu berdasarkan izin pengguna (lihat artikel Role-Based Access Control di Laravel).

Langkah 4: Halaman Dasbor dengan Kartu Ringkasan

// app/Http/Controllers/Admin/DashboardController.php
namespace App\Http\Controllers\Admin;

use App\Http\Controllers\Controller;
use App\Models\{Iuran, Keluarga, TransaksiKas};
use Illuminate\Support\Facades\Cache;

class DashboardController extends Controller
{
    public function __invoke()
    {
        $ringkasan = Cache::remember('dasbor.ringkasan', now()->addMinutes(5), fn () => [
            'keluarga'  => Keluarga::count(),
            'saldo'     => TransaksiKas::where('status', 'disetujui')
                ->selectRaw("SUM(CASE WHEN jenis = 'masuk' THEN jumlah ELSE -jumlah END) as saldo")
                ->value('saldo') ?? 0,
            'tunggakan' => Iuran::whereNull('dibayar_pada')->where('periode', '<', now()->format('Y-m'))->count(),
            'menunggu'  => TransaksiKas::where('status', 'menunggu')->count(),
        ]);

        return view('admin.dashboard', compact('ringkasan'));
    }
}
{{-- resources/views/admin/dashboard.blade.php --}}
@extends('layouts.admin')
@section('title', 'Dasbor')

@section('content')
<div class="row g-3">
    @foreach ([
        ['label' => 'Jumlah Keluarga',      'value' => number_format($ringkasan['keluarga'], 0, ',', '.'), 'icon' => 'house', 'color' => 'primary'],
        ['label' => 'Saldo Kas',            'value' => 'Rp '.number_format($ringkasan['saldo'], 0, ',', '.'), 'icon' => 'wallet2', 'color' => 'success'],
        ['label' => 'Iuran Tertunggak',     'value' => $ringkasan['tunggakan'], 'icon' => 'exclamation-triangle', 'color' => 'warning'],
        ['label' => 'Menunggu Persetujuan', 'value' => $ringkasan['menunggu'], 'icon' => 'hourglass-split', 'color' => 'info'],
    ] as $kartu)
        <div class="col-sm-6 col-xl-3">
            <div class="card border-0 shadow-sm h-100">
                <div class="card-body d-flex align-items-center gap-3">
                    <span class="rounded-3 p-3 bg-{{ $kartu['color'] }}-subtle text-{{ $kartu['color'] }}-emphasis">
                        <i class="bi bi-{{ $kartu['icon'] }} fs-4"></i>
                    </span>
                    <div>
                        <div class="text-body-secondary small">{{ $kartu['label'] }}</div>
                        <div class="fs-4 fw-bold">{{ $kartu['value'] }}</div>
                    </div>
                </div>
            </div>
        </div>
    @endforeach
</div>
@endsection

Dasbor statistik dengan grafik dibahas di artikel Panduan Membuat Dashboard Statistik Laravel.

Langkah 5: Endpoint JSON untuk DataTables

DataTables dalam mode client-side meminta data sekali, lalu mencari, mengurutkan, dan memaginasi di browser. Endpoint cukup mengembalikan {"data": [...]}.

// app/Http/Controllers/Admin/KeluargaController.php
namespace App\Http\Controllers\Admin;

use App\Http\Controllers\Controller;
use App\Http\Requests\{StoreKeluargaRequest, UpdateKeluargaRequest};
use App\Http\Resources\KeluargaRowResource;
use App\Models\{Keluarga, RukunTetangga};
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Gate;

class KeluargaController extends Controller
{
    public function index(Request $request)
    {
        Gate::authorize('viewAny', Keluarga::class);

        $daftarRt = RukunTetangga::visibleTo($request->user())->orderBy('nomor')->get(['id', 'nomor']);

        return view('admin.keluarga.index', compact('daftarRt'));
    }

    public function data(Request $request)
    {
        Gate::authorize('viewAny', Keluarga::class);

        $rows = Keluarga::query()
            ->visibleTo($request->user())
            ->with('rukunTetangga:id,nomor')
            ->withCount('anggota')
            ->orderBy('nomor_kk')
            ->get(['id', 'nomor_kk', 'kepala_keluarga', 'alamat', 'rukun_tetangga_id', 'updated_at']);

        return KeluargaRowResource::collection($rows);
    }

    public function show(Keluarga $keluarga)
    {
        Gate::authorize('view', $keluarga);

        return new KeluargaRowResource($keluarga->loadCount('anggota')->load('rukunTetangga:id,nomor'));
    }

    public function store(StoreKeluargaRequest $request)
    {
        $keluarga = Keluarga::create($request->validated());

        return (new KeluargaRowResource($keluarga))->response()->setStatusCode(201);
    }

    public function update(UpdateKeluargaRequest $request, Keluarga $keluarga)
    {
        $keluarga->update($request->validated());

        return new KeluargaRowResource($keluarga);
    }

    public function destroy(Keluarga $keluarga)
    {
        Gate::authorize('delete', $keluarga);

        $keluarga->delete();

        return response()->noContent();
    }
}
// app/Http/Resources/KeluargaRowResource.php
public function toArray(Request $request): array
{
    return [
        'id'              => $this->id,
        'nomor_kk'        => $this->nomor_kk,
        'kepala_keluarga' => $this->kepala_keluarga,
        'alamat'          => $this->alamat,
        'rt'              => $this->whenLoaded('rukunTetangga', fn () => $this->rukunTetangga->nomor),
        'rukun_tetangga_id' => $this->rukun_tetangga_id,
        'anggota_count'   => $this->whenCounted('anggota'),
        'diubah'          => $this->updated_at?->timezone('Asia/Jakarta')->format('d/m/Y H:i'),
        'can'             => [
            'update' => $request->user()->can('update', $this->resource),
            'delete' => $request->user()->can('delete', $this->resource),
        ],
    ];
}

Field can memberi tahu frontend tombol mana yang perlu ditampilkan per baris. Ini hanya untuk tampilan; server tetap memeriksa izin pada setiap aksi.

// routes/web.php
Route::middleware(['auth', 'active'])->prefix('admin')->name('admin.')->group(function () {
    Route::get('/', \App\Http\Controllers\Admin\DashboardController::class)->name('dashboard');

    Route::get('keluarga/data', [KeluargaController::class, 'data'])->name('keluarga.data');
    Route::resource('keluarga', KeluargaController::class)->except(['create', 'edit']);
});

Route keluarga/data didaftarkan sebelum Route::resource agar data tidak dianggap sebagai ID keluarga.

Langkah 6: Halaman Tabel dengan DataTables AJAX

{{-- resources/views/admin/keluarga/index.blade.php --}}
@extends('layouts.admin')
@section('title', 'Data Keluarga')

@section('content')
<div class="card border-0 shadow-sm">
    <div class="card-header bg-white d-flex justify-content-between align-items-center py-3">
        <h2 class="h5 mb-0">Data Keluarga</h2>
        @can('create', App\Models\Keluarga::class)
            <button class="btn btn-primary" id="btn-tambah"><i class="bi bi-plus-lg"></i> Tambah</button>
        @endcan
    </div>
    <div class="card-body">
        <table id="tabel-keluarga" class="table table-hover align-middle w-100">
            <thead>
                <tr>
                    <th>No. KK</th>
                    <th>Kepala Keluarga</th>
                    <th>Alamat</th>
                    <th>RT</th>
                    <th class="text-end">Anggota</th>
                    <th>Diubah</th>
                    <th class="text-end">Aksi</th>
                </tr>
            </thead>
        </table>
    </div>
</div>

@include('admin.keluarga._modal-form')
@endsection

@push('scripts')
<script type="module" nonce="{{ Vite::cspNonce() }}">
    const render = DataTable.render;

    const table = new DataTable('#tabel-keluarga', {
        ajax: { url: @js(route('admin.keluarga.data')), dataSrc: 'data' },
        columns: [
            { data: 'nomor_kk', render: render.text() },
            { data: 'kepala_keluarga', render: render.text() },
            { data: 'alamat', render: render.text(), className: 'text-truncate', width: '30%' },
            { data: 'rt', render: render.text() },
            { data: 'anggota_count', className: 'text-end' },
            { data: 'diubah', render: render.text() },
            {
                data: null, orderable: false, searchable: false, className: 'text-end text-nowrap',
                render: (row) => `
                    ${row.can.update ? `<button class="btn btn-sm btn-outline-secondary btn-ubah" data-id="${row.id}" aria-label="Ubah"><i class="bi bi-pencil"></i></button>` : ''}
                    ${row.can.delete ? `<button class="btn btn-sm btn-outline-danger btn-hapus" data-id="${row.id}" aria-label="Hapus"><i class="bi bi-trash"></i></button>` : ''}`,
            },
        ],
        order: [[0, 'asc']],
    });

    window.tabelKeluarga = table;
</script>
@endpush

render: DataTable.render.text() itu penting. Tanpa renderer ini, DataTables menyisipkan nilai sebagai HTML. Nama kepala keluarga <img src=x onerror=alert(1)> akan dieksekusi di browser admin. Renderer text() meng-escape nilai sebelum ditampilkan. Kolom aksi aman karena hanya menyisipkan row.id (angka dari server) dan HTML yang Anda tulis sendiri.

Langkah 7: Modal Tambah dan Ubah

{{-- resources/views/admin/keluarga/_modal-form.blade.php --}}
<div class="modal fade" id="modal-keluarga" tabindex="-1" aria-labelledby="modal-keluarga-title" aria-hidden="true">
    <div class="modal-dialog">
        <form class="modal-content" id="form-keluarga" novalidate>
            <div class="modal-header">
                <h5 class="modal-title" id="modal-keluarga-title">Tambah Keluarga</h5>
                <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Tutup"></button>
            </div>
            <div class="modal-body">
                <input type="hidden" name="id">
                <div class="mb-3">
                    <label class="form-label" for="f-nomor_kk">Nomor KK</label>
                    <input class="form-control" id="f-nomor_kk" name="nomor_kk" inputmode="numeric" maxlength="16" required>
                    <div class="invalid-feedback"></div>
                </div>
                <div class="mb-3">
                    <label class="form-label" for="f-kepala_keluarga">Kepala Keluarga</label>
                    <input class="form-control" id="f-kepala_keluarga" name="kepala_keluarga" maxlength="100" required>
                    <div class="invalid-feedback"></div>
                </div>
                <div class="mb-3">
                    <label class="form-label" for="f-alamat">Alamat</label>
                    <textarea class="form-control" id="f-alamat" name="alamat" rows="2" maxlength="255" required></textarea>
                    <div class="invalid-feedback"></div>
                </div>
                <div class="mb-3">
                    <label class="form-label" for="f-rukun_tetangga_id">RT</label>
                    <select class="form-select" id="f-rukun_tetangga_id" name="rukun_tetangga_id" required>
                        @foreach ($daftarRt as $rt)
                            <option value="{{ $rt->id }}">RT {{ $rt->nomor }}</option>
                        @endforeach
                    </select>
                    <div class="invalid-feedback"></div>
                </div>
            </div>
            <div class="modal-footer">
                <button type="button" class="btn btn-light" data-bs-dismiss="modal">Batal</button>
                <button type="submit" class="btn btn-primary" id="btn-simpan">
                    <span class="spinner-border spinner-border-sm d-none" aria-hidden="true"></span> Simpan
                </button>
            </div>
        </form>
    </div>
</div>

$daftarRt dikirim dari method index() controller dan sudah disaring sesuai cakupan pengguna, sehingga pengurus RT hanya bisa memilih RT-nya sendiri. Validasi di server (Rule::exists()->where(...)) tetap wajib, karena isi dropdown bisa dimanipulasi.

Langkah 8: Logika Simpan, Ubah, dan Hapus

// resources/js/admin/keluarga.js
const modalEl = document.getElementById('modal-keluarga');
const modal = bootstrap.Modal.getOrCreateInstance(modalEl);
const form = document.getElementById('form-keluarga');
const baseUrl = '/admin/keluarga';

function resetErrors() {
    form.querySelectorAll('.is-invalid').forEach((el) => el.classList.remove('is-invalid'));
    form.querySelectorAll('.invalid-feedback').forEach((el) => (el.textContent = ''));
}

function showErrors(errors) {
    for (const [field, messages] of Object.entries(errors)) {
        const input = form.elements[field];
        if (!input) continue;
        input.classList.add('is-invalid');
        input.parentElement.querySelector('.invalid-feedback').textContent = messages[0];
    }
    form.querySelector('.is-invalid')?.focus();
}

function setLoading(on) {
    const btn = document.getElementById('btn-simpan');
    btn.disabled = on;
    btn.querySelector('.spinner-border').classList.toggle('d-none', !on);
}

document.getElementById('btn-tambah')?.addEventListener('click', () => {
    form.reset();
    form.elements.id.value = '';
    resetErrors();
    document.getElementById('modal-keluarga-title').textContent = 'Tambah Keluarga';
    modal.show();
});

document.getElementById('tabel-keluarga').addEventListener('click', async (e) => {
    const btnUbah = e.target.closest('.btn-ubah');
    const btnHapus = e.target.closest('.btn-hapus');

    if (btnUbah) {
        const { data } = await api(`${baseUrl}/${btnUbah.dataset.id}`);
        form.reset();
        resetErrors();
        for (const key of ['id', 'nomor_kk', 'kepala_keluarga', 'alamat', 'rukun_tetangga_id']) {
            form.elements[key].value = data[key] ?? '';
        }
        document.getElementById('modal-keluarga-title').textContent = 'Ubah Keluarga';
        modal.show();
    }

    if (btnHapus) {
        if (!confirm('Hapus data keluarga ini? Tindakan ini tidak dapat dibatalkan.')) return;
        try {
            await api(`${baseUrl}/${btnHapus.dataset.id}`, { method: 'DELETE' });
            window.tabelKeluarga.ajax.reload(null, false);     // false: tetap di halaman yang sama
            toast('Data keluarga dihapus.');
        } catch (err) {
            toast(err.data?.message ?? 'Gagal menghapus data.', 'danger');
        }
    }
});

form.addEventListener('submit', async (e) => {
    e.preventDefault();
    resetErrors();
    setLoading(true);

    const payload = Object.fromEntries(new FormData(form));
    const id = payload.id;
    delete payload.id;

    try {
        await api(id ? `${baseUrl}/${id}` : baseUrl, { method: id ? 'PUT' : 'POST', body: payload });
        modal.hide();
        window.tabelKeluarga.ajax.reload(null, false);
        toast(id ? 'Data keluarga diperbarui.' : 'Data keluarga ditambahkan.');
    } catch (err) {
        if (err.status === 422) showErrors(err.data.errors);
        else toast(err.data?.message ?? 'Terjadi kesalahan. Coba lagi.', 'danger');
    } finally {
        setLoading(false);
    }
});

Muat skrip ini hanya di halaman yang membutuhkannya:

// vite.config.js → input
'resources/js/admin/keluarga.js',
@push('scripts')
    @vite('resources/js/admin/keluarga.js')
@endpush

Poin penting:

  • ajax.reload(null, false) memuat ulang data tanpa mengembalikan pengguna ke halaman pertama.
  • Error validasi 422 dipetakan langsung ke field, memakai struktur errors standar Laravel.
  • Konfirmasi confirm() bawaan browser sudah cukup untuk awal; ganti dengan modal Bootstrap bila diinginkan.

Langkah 9: Test

// tests/Feature/Admin/KeluargaDataTest.php
it('mengembalikan data sesuai cakupan pengguna', function () {
    $this->seed(\Database\Seeders\RolePermissionSeeder::class);
    $rt1 = RukunTetangga::factory()->create();
    $pengurus = User::factory()->create(['rukun_tetangga_id' => $rt1->id])->assignRole('pengurus');
    Keluarga::factory()->count(3)->for($rt1)->create();
    Keluarga::factory()->count(2)->create();                       // RT lain

    $this->actingAs($pengurus)
        ->getJson(route('admin.keluarga.data'))
        ->assertOk()
        ->assertJsonCount(3, 'data')
        ->assertJsonStructure(['data' => [['id', 'nomor_kk', 'kepala_keluarga', 'rt', 'can' => ['update', 'delete']]]]);
});

it('mengembalikan error validasi dalam format yang dipakai modal', function () {
    $admin = User::factory()->create()->assignRole('admin');

    $this->actingAs($admin)
        ->postJson(route('admin.keluarga.store'), ['nomor_kk' => '123'])
        ->assertUnprocessable()
        ->assertJsonValidationErrors(['nomor_kk', 'kepala_keluarga', 'alamat', 'rukun_tetangga_id']);
});

Troubleshooting

Error / Gejala Penyebab Solusi
Tabel tampil tanpa gaya Bootstrap CSS DataTables untuk Bootstrap tidak diimpor Impor datatables.net-bs5/css/dataTables.bootstrap5.css di admin.scss
DataTable is not defined Skrip halaman berjalan sebelum admin.js dimuat Gunakan type="module" (dieksekusi setelah modul lain) atau pindahkan ke file Vite sendiri
DataTables warning: ... Invalid JSON response Endpoint mengembalikan HTML (redirect login, error 500) Buka URL endpoint di browser; periksa autentikasi dan log Laravel
Requested unknown parameter 'rt' for row 0 Field tidak ada di respons JSON Samakan columns.data dengan kunci di Resource; gunakan defaultContent: '' untuk field opsional
Kolom berisi HTML pengguna dieksekusi Kolom tidak memakai renderer text() Tambahkan render: DataTable.render.text() pada setiap kolom data
419 saat simpan/hapus Header X-CSRF-TOKEN tidak terkirim Pastikan meta csrf-token ada dan helper api() dipakai
Tabel melebar keluar card di ponsel Responsive extension belum aktif atau w-100 hilang Impor datatables.net-responsive-bs5 dan beri class="w-100" pada tabel
Gaya Tailwind merusak halaman admin Kedua framework dimuat di halaman yang sama Pisahkan entry Vite; layout admin hanya memuat admin.scss

Best Practices

Keamanan

  • Gunakan DataTable.render.text() untuk setiap kolom yang berisi data pengguna.
  • Endpoint data menerapkan Policy dan scope yang sama seperti halaman biasa; jangan mengembalikan data yang tidak boleh dilihat lalu "menyembunyikannya" di frontend.
  • Kirim hanya kolom yang ditampilkan lewat API Resource.
  • Semua aksi pengubahan data lewat POST/PUT/DELETE dengan token CSRF.

Performa

  • Mode client-side cocok hingga beberapa ribu baris. Di atas itu, gunakan server-side processing.
  • Pilih kolom seperlunya dan gunakan withCount() daripada memuat relasi penuh.
  • Muat skrip per halaman lewat Vite agar halaman lain tidak membawa kode yang tidak dipakai.
  • Cache angka ringkasan dasbor beberapa menit.

Maintainability

  • Satu helper api() dan toast() untuk seluruh panel admin.
  • Pisahkan layout, partial modal, dan skrip halaman.
  • Pertimbangkan Blade Components untuk kartu, modal, dan tabel agar tidak diulang (lihat artikel Membuat Reusable Blade Components).
  • Simpan teks bahasa DataTables di satu tempat (DataTable.defaults).

Related Articles

Last Tested

Komponen Versi
Laravel 13.x
PHP 8.4
Bootstrap 5.3.x
DataTables 2.3.x
Node.js 22 LTS
Tanggal 19 Oktober 2026

Bagikan artikel:

Artikel lainnya