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

Blog / Dashboard Admin, CRUD & Frontend / Cara Membangun Form Dinamis La...
Dashboard Admin, CRUD & Frontend

Cara Membangun Form Dinamis Laravel dengan Alpine.js dan Validasi Backend

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
18 min read
11 views

Form dengan baris yang bisa ditambah dan dihapus, dropdown bertingkat, field kondisional, dan total yang dihitung langsung, tanpa framework SPA. Alpine.js menangani interaksi, Laravel tetap menjadi satu-satunya sumber kebenaran validasi, dan error dari server dipetakan kembali ke baris yang tepat.

Overview

Bendahara RW perlu mencatat pengeluaran kas dengan beberapa rincian: satu kegiatan (misalnya kerja bakti) bisa terdiri dari pembelian konsumsi, sewa alat, dan bahan bangunan. Form-nya harus:

  • menambah dan menghapus baris rincian,
  • menghitung total secara langsung,
  • menampilkan field "penerima" dan "bukti" hanya untuk jenis pengeluaran,
  • memuat daftar keluarga sesuai RT yang dipilih (dropdown bertingkat),
  • menampilkan error validasi per baris, misalnya "jumlah pada baris ke-2 wajib diisi",
  • tetap berfungsi ketika dikirim tanpa JavaScript, atau setidaknya tidak kehilangan data saat validasi gagal.

Kesalahan yang sering terjadi saat membangun form seperti ini:

  • validasi hanya di JavaScript, sehingga server menerima data apa pun,
  • total dihitung di browser lalu dikirim ke server dan dipercaya begitu saja,
  • error dari server tidak bisa dipetakan ke baris yang benar setelah ada baris yang dihapus,
  • data form hilang saat halaman di-reload karena validasi gagal.

Hasil akhir: form pengeluaran kas dengan rincian dinamis yang:

  • dibangun dengan Alpine.js sebagai komponen yang dapat dipakai ulang,
  • dikirim lewat fetch dengan fallback submit biasa,
  • divalidasi penuh oleh Form Request Laravel,
  • menghitung ulang total di server,
  • memetakan error rincian.1.jumlah ke field yang tepat.

Prerequisites

Komponen Versi
PHP 8.3+ (disarankan 8.4)
Laravel 13.x
Alpine.js 3.x
Tailwind CSS 4.x (atau Bootstrap 5, logika sama)
Testing Pest 4

Jika proyek memakai Livewire, Alpine sudah ikut dimuat oleh Livewire. Jangan memasangnya dua kali; cukup daftarkan komponen dengan document.addEventListener('alpine:init', ...).

Step-by-step Tutorial

Langkah 1: Pasang Alpine.js

npm install alpinejs
// resources/js/app.js
import Alpine from 'alpinejs';
import pengeluaranForm from './forms/pengeluaran-form';
import pilihKeluarga from './forms/pilih-keluarga';

Alpine.data('pengeluaranForm', pengeluaranForm);
Alpine.data('pilihKeluarga', pilihKeluarga);      // dibahas di Langkah 6

window.Alpine = Alpine;
Alpine.start();

Mendaftarkan komponen lewat Alpine.data() di file JavaScript (bukan menulis objek besar di atribut x-data) membuat kode lebih mudah diuji, di-review, dan sejalan dengan Content Security Policy.

Tambahkan gaya untuk elemen yang belum siap tampil:

/* resources/css/app.css */
@layer base {
    [x-cloak] { display: none !important; }
}

Catatan CSP: build standar Alpine mengevaluasi ekspresi di atribut (seperti x-show="jenis === 'keluar'") memakai konstruktor Function, sehingga membutuhkan 'unsafe-eval' di CSP. Bila aplikasi menerapkan CSP ketat (artikel Laravel Security Hardening), gunakan build @alpinejs/csp dan pindahkan semua logika ke method di Alpine.data(). Contoh di artikel ini sudah ditulis agar mudah dipindahkan ke build CSP: ekspresi di template dibuat sesederhana mungkin.

Langkah 2: Backend Terlebih Dahulu: Form Request

Validasi server adalah kontrak. Tulis lebih dulu, lalu bangun form yang memenuhinya.

// app/Http/Requests/StorePengeluaranRequest.php
namespace App\Http\Requests;

use App\Models\TransaksiKas;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
use Illuminate\Validation\Rules\File;

class StorePengeluaranRequest extends FormRequest
{
    public function authorize(): bool
    {
        return $this->user()->can('create', TransaksiKas::class);
    }

    protected function prepareForValidation(): void
    {
        // Normalisasi angka "250.000" atau "250000" menjadi integer
        $rincian = collect($this->input('rincian', []))->map(fn ($r) => [
            ...$r,
            'jumlah'      => isset($r['jumlah']) ? (int) preg_replace('/\D/', '', (string) $r['jumlah']) : null,
            'kuantitas'   => isset($r['kuantitas']) ? (int) $r['kuantitas'] : null,
        ])->values()->all();                        // values(): indeks dirapikan menjadi 0..n

        $this->merge(['rincian' => $rincian]);
    }

    public function rules(): array
    {
        return [
            'jenis'              => ['required', Rule::in(['keluar', 'masuk'])],
            'tanggal'            => ['required', 'date', 'before_or_equal:today'],
            'keterangan'         => ['required', 'string', 'max:255'],
            'penerima'           => ['exclude_unless:jenis,keluar', 'required', 'string', 'max:100'],
            'bukti'              => ['exclude_unless:jenis,keluar', 'required', File::types(['jpg', 'jpeg', 'png', 'pdf'])->max(4096)],

            'rincian'            => ['required', 'array', 'min:1', 'max:30'],
            'rincian.*.uraian'   => ['required', 'string', 'max:150'],
            'rincian.*.kuantitas'=> ['required', 'integer', 'min:1', 'max:10000'],
            'rincian.*.jumlah'   => ['required', 'integer', 'min:100', 'max:100000000'],
        ];
    }

    public function attributes(): array
    {
        return [
            'rincian.*.uraian'    => 'uraian pada baris ke-:position',
            'rincian.*.kuantitas' => 'kuantitas pada baris ke-:position',
            'rincian.*.jumlah'    => 'harga satuan pada baris ke-:position',
        ];
    }
}

->values() di prepareForValidation penting: bila pengguna menghapus baris di tengah, indeks yang dikirim bisa 0, 2, 3. Merapikannya menjadi 0, 1, 2 membuat pesan "baris ke-n" sesuai dengan urutan yang terlihat di layar, asalkan frontend juga mengirim baris dalam urutan tampilan (Langkah 5 melakukannya).

Langkah 3: Controller yang Menghitung Ulang Total

Jangan pernah mempercayai total yang dikirim browser. Server menghitungnya sendiri dari rincian yang sudah tervalidasi.

// app/Http/Controllers/PengeluaranController.php
namespace App\Http\Controllers;

use App\Http\Requests\StorePengeluaranRequest;
use App\Models\TransaksiKas;
use Illuminate\Support\Facades\DB;

class PengeluaranController extends Controller
{
    public function create()
    {
        return view('kas.pengeluaran.create');
    }

    public function store(StorePengeluaranRequest $request)
    {
        $data = $request->validated();

        $trx = DB::transaction(function () use ($data, $request) {
            $total = collect($data['rincian'])->sum(fn ($r) => $r['kuantitas'] * $r['jumlah']);

            $trx = TransaksiKas::create([
                'jenis'        => $data['jenis'],
                'tanggal'      => $data['tanggal'],
                'keterangan'   => $data['keterangan'],
                'penerima'     => $data['penerima'] ?? null,
                'jumlah'       => $total,                       // dihitung server
                'status'       => 'draft',
                'dicatat_oleh' => $request->user()->id,
            ]);

            $trx->rincian()->createMany(array_map(fn ($r) => [
                'uraian'    => $r['uraian'],
                'kuantitas' => $r['kuantitas'],
                'jumlah'    => $r['jumlah'],
                'subtotal'  => $r['kuantitas'] * $r['jumlah'],
            ], $data['rincian']));

            return $trx;
        });

        if ($request->hasFile('bukti')) {
            app(\App\Services\UnggahLampiran::class)->handle($trx, $request->file('bukti'), $request->user());
        }

        return $request->expectsJson()
            ? response()->json(['message' => 'Pengeluaran tersimpan.', 'redirect' => route('kas.show', $trx)], 201)
            : redirect()->route('kas.show', $trx)->with('status', 'Pengeluaran tersimpan.');
    }
}
// routes/web.php
Route::middleware(['auth', 'active'])->prefix('kas')->name('kas.')->group(function () {
    Route::get('pengeluaran/baru', [PengeluaranController::class, 'create'])->name('pengeluaran.create');
    Route::post('pengeluaran', [PengeluaranController::class, 'store'])->name('pengeluaran.store');
});

Controller melayani dua jenis request: JSON (dari fetch) dan form biasa (fallback). Penanganan upload mengikuti artikel Panduan Mengelola File Upload Laravel.

Langkah 4: Komponen Alpine

// resources/js/forms/pengeluaran-form.js
let nextKey = 0;
const barisBaru = (r = {}) => ({
    key: ++nextKey,                         // kunci stabil untuk x-for, tidak ikut dikirim
    uraian: r.uraian ?? '',
    kuantitas: r.kuantitas ?? 1,
    jumlah: r.jumlah ?? '',
});

export default (initial = {}) => ({
    jenis: initial.jenis ?? 'keluar',
    rincian: (initial.rincian?.length ? initial.rincian : [{}]).map(barisBaru),
    errors: initial.errors ?? {},
    loading: false,

    get total() {
        return this.rincian.reduce((sum, r) => sum + (Number(r.kuantitas) || 0) * this.angka(r.jumlah), 0);
    },

    get isKeluar() {
        return this.jenis === 'keluar';
    },

    angka(v) {
        return Number(String(v ?? '').replace(/\D/g, '')) || 0;
    },

    rupiah(v) {
        return 'Rp ' + new Intl.NumberFormat('id-ID').format(v);
    },

    tambah() {
        if (this.rincian.length >= 30) return;
        this.rincian.push(barisBaru());
        this.$nextTick(() => this.$root.querySelector(`[data-baris="${this.rincian.length - 1}"] input`)?.focus());
    },

    hapus(index) {
        if (this.rincian.length === 1) return;
        this.rincian.splice(index, 1);
        this.errors = {};                     // indeks bergeser: error lama tidak lagi akurat
    },

    error(field) {
        return this.errors[field]?.[0] ?? '';
    },

    hasError(field) {
        return Boolean(this.errors[field]);
    },

    async submit(event) {
        this.loading = true;
        this.errors = {};

        const form = event.target;
        const body = new FormData(form);      // termasuk file bukti dan token CSRF

        try {
            const res = await fetch(form.action, {
                method: 'POST',
                headers: { 'Accept': 'application/json' },
                body,
            });
            const data = await res.json().catch(() => ({}));

            if (res.status === 422) {
                this.errors = data.errors ?? {};
                this.$nextTick(() => this.$root.querySelector('[aria-invalid="true"]')?.focus());
                return;
            }
            if (!res.ok) throw new Error(data.message ?? 'Terjadi kesalahan.');

            window.location = data.redirect;
        } catch (e) {
            this.errors = { _form: [e.message] };
        } finally {
            this.loading = false;
        }
    },
});

Hal-hal penting:

  • key stabil per baris. x-for membutuhkan kunci unik agar Alpine tidak salah memindahkan nilai input saat baris dihapus. Jangan memakai indeks array sebagai kunci.
  • Error dikosongkan saat baris dihapus. Error dari server mengacu pada indeks lama (rincian.2.jumlah); setelah penghapusan, indeks itu tidak lagi menunjuk baris yang sama.
  • FormData(form) mengirim semua field termasuk file dan _token, sehingga tidak perlu menyusun payload manual.
  • Total di browser hanya untuk tampilan. Server menghitung ulang.

Langkah 5: Template Blade

{{-- resources/views/kas/pengeluaran/create.blade.php --}}
<x-layouts.app title="Catat Transaksi Kas">
<form method="POST" action="{{ route('kas.pengeluaran.store') }}" enctype="multipart/form-data"
      x-data="pengeluaranForm(@js([
          'jenis'   => old('jenis', 'keluar'),
          'rincian' => old('rincian', []),
          'errors'  => $errors->toArray(),
      ]))"
      x-on:submit.prevent="submit"
      class="mx-auto max-w-3xl space-y-6" novalidate>
    @csrf

    <div x-show="error('_form')" x-cloak role="alert"
         class="rounded-lg bg-red-50 p-3 text-sm text-red-700" x-text="error('_form')"></div>

    {{-- Jenis transaksi --}}
    <fieldset class="flex gap-4">
        <legend class="mb-2 text-sm font-medium">Jenis</legend>
        <label class="flex items-center gap-2"><input type="radio" name="jenis" value="keluar" x-model="jenis"> Pengeluaran</label>
        <label class="flex items-center gap-2"><input type="radio" name="jenis" value="masuk" x-model="jenis"> Pemasukan</label>
    </fieldset>

    <div class="grid gap-4 sm:grid-cols-2">
        <div>
            <label for="tanggal" class="block text-sm font-medium">Tanggal</label>
            <input id="tanggal" type="date" name="tanggal" value="{{ old('tanggal', now()->toDateString()) }}"
                   max="{{ now()->toDateString() }}" class="mt-1 w-full rounded-lg"
                   :aria-invalid="hasError('tanggal')" aria-describedby="err-tanggal">
            <p id="err-tanggal" class="mt-1 text-sm text-red-600" x-text="error('tanggal')"></p>
        </div>
        <div>
            <label for="keterangan" class="block text-sm font-medium">Keterangan</label>
            <input id="keterangan" name="keterangan" value="{{ old('keterangan') }}" maxlength="255"
                   class="mt-1 w-full rounded-lg" :aria-invalid="hasError('keterangan')" aria-describedby="err-keterangan">
            <p id="err-keterangan" class="mt-1 text-sm text-red-600" x-text="error('keterangan')"></p>
        </div>
    </div>

    {{-- Field kondisional: hanya untuk pengeluaran --}}
    <template x-if="isKeluar">
        <div class="grid gap-4 sm:grid-cols-2">
            <div>
                <label for="penerima" class="block text-sm font-medium">Penerima</label>
                <input id="penerima" name="penerima" value="{{ old('penerima') }}" maxlength="100"
                       class="mt-1 w-full rounded-lg" :aria-invalid="hasError('penerima')">
                <p class="mt-1 text-sm text-red-600" x-text="error('penerima')"></p>
            </div>
            <div>
                <label for="bukti" class="block text-sm font-medium">Bukti (JPG, PNG, PDF, maks. 4 MB)</label>
                <input id="bukti" type="file" name="bukti" accept=".jpg,.jpeg,.png,.pdf"
                       class="mt-1 w-full" :aria-invalid="hasError('bukti')">
                <p class="mt-1 text-sm text-red-600" x-text="error('bukti')"></p>
            </div>
        </div>
    </template>

    {{-- Rincian dinamis --}}
    <section aria-labelledby="judul-rincian">
        <div class="mb-2 flex items-center justify-between">
            <h2 id="judul-rincian" class="font-semibold">Rincian</h2>
            <button type="button" x-on:click="tambah" class="rounded-lg border px-3 py-1.5 text-sm"
                    :disabled="rincian.length >= 30">+ Tambah baris</button>
        </div>

        <p class="mb-2 text-sm text-red-600" x-text="error('rincian')"></p>

        <div class="space-y-3">
            <template x-for="(baris, i) in rincian" :key="baris.key">
                <div class="grid grid-cols-12 items-start gap-2 rounded-lg border p-3" :data-baris="i">
                    <div class="col-span-12 sm:col-span-6">
                        <label class="sr-only" :for="`uraian-${baris.key}`">Uraian</label>
                        <input :id="`uraian-${baris.key}`" :name="`rincian[${i}][uraian]`" x-model="baris.uraian"
                               placeholder="Uraian" maxlength="150" class="w-full rounded-lg"
                               :aria-invalid="hasError(`rincian.${i}.uraian`)">
                        <p class="mt-1 text-xs text-red-600" x-text="error(`rincian.${i}.uraian`)"></p>
                    </div>
                    <div class="col-span-4 sm:col-span-2">
                        <input :name="`rincian[${i}][kuantitas]`" x-model.number="baris.kuantitas" type="number" min="1"
                               class="w-full rounded-lg" aria-label="Kuantitas"
                               :aria-invalid="hasError(`rincian.${i}.kuantitas`)">
                        <p class="mt-1 text-xs text-red-600" x-text="error(`rincian.${i}.kuantitas`)"></p>
                    </div>
                    <div class="col-span-6 sm:col-span-3">
                        <input :name="`rincian[${i}][jumlah]`" x-model="baris.jumlah" inputmode="numeric"
                               placeholder="Harga satuan" class="w-full rounded-lg" aria-label="Harga satuan"
                               :aria-invalid="hasError(`rincian.${i}.jumlah`)">
                        <p class="mt-1 text-xs text-red-600" x-text="error(`rincian.${i}.jumlah`)"></p>
                    </div>
                    <div class="col-span-2 sm:col-span-1 text-right">
                        <button type="button" x-on:click="hapus(i)" :disabled="rincian.length === 1"
                                class="rounded-lg p-2 text-red-600 disabled:opacity-30" aria-label="Hapus baris">✕</button>
                    </div>
                </div>
            </template>
        </div>

        <div class="mt-4 flex justify-end text-lg font-semibold">
            Total: <span class="ml-2" x-text="rupiah(total)">Rp 0</span>
        </div>
    </section>

    <div class="flex justify-end gap-3">
        <a href="{{ route('kas.index') }}" class="rounded-lg px-4 py-2">Batal</a>
        <button type="submit" class="rounded-lg bg-brand-600 px-4 py-2 font-semibold text-white disabled:opacity-60"
                :disabled="loading">
            <span x-show="!loading">Simpan</span>
            <span x-show="loading" x-cloak>Menyimpan...</span>
        </button>
    </div>
</form>
</x-layouts.app>

Beberapa detail desain:

  • old() dan $errors diteruskan ke Alpine lewat @js(...). Bila browser mengirim form tanpa JavaScript dan validasi gagal, Laravel me-redirect kembali, lalu Alpine merender ulang baris dari old('rincian') beserta error-nya.
  • Nama input rincian[${i}][uraian] memakai indeks tampilan saat ini, sehingga urutan yang dikirim selalu sesuai urutan di layar.
  • <template x-if> untuk field kondisional benar-benar menghapus input dari DOM, sehingga field penerima dan bukti tidak ikut terkirim saat jenis "masuk". Server tetap membuangnya lewat exclude_unless.
  • Atribut aksesibilitas: aria-invalid, label tersembunyi (sr-only), dan fokus otomatis ke field pertama yang error.

Langkah 6: Dropdown Bertingkat (RT → Keluarga)

Untuk form pencatatan iuran, daftar keluarga bergantung pada RT yang dipilih.

// routes/web.php
Route::get('api/rt/{rukunTetangga}/keluarga', function (Request $request, RukunTetangga $rukunTetangga) {
    Gate::authorize('view', $rukunTetangga);

    return $rukunTetangga->keluarga()
        ->visibleTo($request->user())
        ->orderBy('kepala_keluarga')
        ->get(['id', 'nomor_kk', 'kepala_keluarga']);
})->middleware(['auth', 'throttle:60,1'])->name('api.rt.keluarga');
// resources/js/forms/pilih-keluarga.js
export default ({ rtAwal = '', keluargaAwal = '' } = {}) => ({
    rt: rtAwal,
    keluargaId: keluargaAwal,
    daftar: [],
    memuat: false,
    controller: null,

    async init() {
        if (this.rt) await this.muat();
        this.$watch('rt', () => { this.keluargaId = ''; this.muat(); });
    },

    async muat() {
        this.controller?.abort();                       // batalkan request sebelumnya
        if (!this.rt) { this.daftar = []; return; }

        this.controller = new AbortController();
        this.memuat = true;
        try {
            const res = await fetch(`/api/rt/${encodeURIComponent(this.rt)}/keluarga`, {
                headers: { Accept: 'application/json' },
                signal: this.controller.signal,
            });
            this.daftar = res.ok ? await res.json() : [];
        } catch (e) {
            if (e.name !== 'AbortError') this.daftar = [];
        } finally {
            this.memuat = false;
        }
    },
});
<div x-data="pilihKeluarga(@js(['rtAwal' => old('rt_id', ''), 'keluargaAwal' => old('keluarga_id', '')]))" class="grid gap-4 sm:grid-cols-2">
    <select name="rt_id" x-model="rt" class="rounded-lg">
        <option value="">Pilih RT</option>
        @foreach ($daftarRt as $rt)
            <option value="{{ $rt->id }}">RT {{ $rt->nomor }}</option>
        @endforeach
    </select>

    <select name="keluarga_id" x-model="keluargaId" :disabled="!rt || memuat" class="rounded-lg">
        <option value="" x-text="memuat ? 'Memuat...' : 'Pilih keluarga'"></option>
        <template x-for="k in daftar" :key="k.id">
            <option :value="k.id" x-text="`${k.kepala_keluarga} (${k.nomor_kk})`"></option>
        </template>
    </select>
</div>

AbortController mencegah race condition: bila pengguna cepat berganti RT, respons lama yang datang terlambat tidak menimpa daftar yang benar. x-text selalu memasukkan teks (bukan HTML), sehingga nama keluarga aman dari XSS.

Server tetap memvalidasi bahwa keluarga_id milik RT yang dipilih dan berada dalam cakupan pengguna (artikel Panduan Validasi Form Laravel).

Langkah 7: Test Backend

Logika penting ada di server, jadi test di sana memberi jaminan paling besar.

// tests/Feature/Kas/PengeluaranTest.php
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;

beforeEach(function () {
    Storage::fake('private');
    $this->seed(\Database\Seeders\RolePermissionSeeder::class);
    $this->bendahara = User::factory()->create()->assignRole('bendahara');
});

it('menyimpan pengeluaran dan menghitung total di server', function () {
    $this->actingAs($this->bendahara)->postJson('/kas/pengeluaran', [
        'jenis' => 'keluar', 'tanggal' => today()->toDateString(), 'keterangan' => 'Kerja bakti',
        'penerima' => 'Toko Bangunan Jaya',
        'bukti' => UploadedFile::fake()->create('nota.pdf', 100, 'application/pdf'),
        'total' => 1,                                                       // diabaikan server
        'rincian' => [
            ['uraian' => 'Semen', 'kuantitas' => 2, 'jumlah' => '65.000'],
            ['uraian' => 'Konsumsi', 'kuantitas' => 20, 'jumlah' => '15000'],
        ],
    ])->assertCreated();

    $trx = TransaksiKas::first();
    expect($trx->jumlah)->toBe(430000)
        ->and($trx->rincian)->toHaveCount(2);
});

it('memetakan error ke baris yang benar', function () {
    $this->actingAs($this->bendahara)->postJson('/kas/pengeluaran', [
        'jenis' => 'masuk', 'tanggal' => today()->toDateString(), 'keterangan' => 'Iuran',
        'rincian' => [
            ['uraian' => 'Iuran RT 01', 'kuantitas' => 1, 'jumlah' => 50000],
            ['uraian' => '', 'kuantitas' => 1, 'jumlah' => 10],
        ],
    ])->assertUnprocessable()
      ->assertJsonValidationErrors(['rincian.1.uraian', 'rincian.1.jumlah'])
      ->assertJsonMissingValidationErrors(['rincian.0.uraian', 'penerima', 'bukti']);
});

it('merapikan indeks baris yang bolong', function () {
    $this->actingAs($this->bendahara)->postJson('/kas/pengeluaran', [
        'jenis' => 'masuk', 'tanggal' => today()->toDateString(), 'keterangan' => 'Iuran',
        'rincian' => [0 => ['uraian' => 'A', 'kuantitas' => 1, 'jumlah' => 1000], 3 => ['uraian' => '', 'kuantitas' => 1, 'jumlah' => 1000]],
    ])->assertJsonValidationErrors(['rincian.1.uraian']);
});

it('menolak lebih dari 30 baris', function () {
    $this->actingAs($this->bendahara)->postJson('/kas/pengeluaran', [
        'jenis' => 'masuk', 'tanggal' => today()->toDateString(), 'keterangan' => 'X',
        'rincian' => array_fill(0, 31, ['uraian' => 'x', 'kuantitas' => 1, 'jumlah' => 1000]),
    ])->assertJsonValidationErrors('rincian');
});

Untuk interaksi frontend (tambah/hapus baris, total), gunakan test browser dengan Laravel Dusk atau Pest Browser Testing pada alur utama saja.

Troubleshooting

Error / Gejala Penyebab Solusi
Elemen kondisional berkedip sebelum Alpine siap Atribut x-cloak tanpa CSS Tambahkan [x-cloak] { display: none !important; }
Alpine Expression Error: pengeluaranForm is not defined Komponen didaftarkan setelah Alpine.start() Panggil Alpine.data(...) sebelum Alpine.start()
Nilai input pindah ke baris lain setelah menghapus x-for memakai indeks sebagai :key Gunakan kunci unik per baris (baris.key)
Error muncul di baris yang salah Indeks bolong atau error lama tidak dibersihkan ->values() di prepareForValidation; kosongkan errors saat baris dihapus
419 saat submit lewat fetch Token CSRF tidak ikut Pastikan @csrf ada di dalam form dan kirim new FormData(form)
File tidak terkirim Payload dikirim sebagai JSON Gunakan FormData dan jangan set Content-Type manual
Data hilang setelah validasi gagal tanpa JavaScript old() tidak diteruskan ke komponen Kirim old('rincian') dan $errors ke x-data lewat @js
EvalError / pelanggaran CSP di console CSP tanpa 'unsafe-eval' dengan build Alpine standar Gunakan @alpinejs/csp
Alpine berjalan dua kali di aplikasi Livewire Alpine dipasang manual dan oleh Livewire Hapus import Alpine manual; daftarkan komponen di event alpine:init

Best Practices

Keamanan

  • Server adalah satu-satunya sumber kebenaran: validasi penuh di Form Request, hitung ulang semua nilai turunan (total, subtotal).
  • Batasi jumlah baris (max:30) di frontend dan server.
  • Endpoint untuk dropdown bertingkat menerapkan otorisasi dan scope yang sama seperti halaman lain.
  • Gunakan x-text, bukan x-html, untuk menampilkan data dari server.

Performa

  • Daftarkan komponen dengan Alpine.data() di bundel Vite, bukan objek besar di atribut HTML.
  • Batalkan request yang usang dengan AbortController; beri throttle pada endpoint pendukung.
  • Muat data dropdown hanya saat dibutuhkan, bukan seluruh daftar keluarga di awal.

Maintainability

  • Satu file JavaScript per komponen form, nama sesuai fungsinya.
  • Format nama field mengikuti notasi array Laravel (rincian[0][jumlah]) agar error rincian.0.jumlah bisa dipetakan langsung.
  • Dukung submit biasa sebagai fallback dengan meneruskan old() dan $errors ke komponen.
  • Bungkus field berulang (label + input + error) menjadi Blade Component (artikel Membuat Reusable Blade Components).

Related Articles

Last Tested

Komponen Versi
Laravel 13.x
PHP 8.4
Alpine.js 3.x
Tailwind CSS 4.3.x
Pest 4.x
Tanggal 19 Oktober 2026

Bagikan artikel:

Artikel lainnya