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

Blog / Dashboard Admin, CRUD & Frontend / Membuat Reusable Blade Compone...
Dashboard Admin, CRUD & Frontend

Membuat Reusable Blade Components untuk Mempercepat Pengembangan UI Laravel

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
21 min read
10 views

Dari HTML yang di-copy-paste di puluhan view menjadi pustaka komponen: layout, tombol, input dengan pesan error, kartu, badge status, modal, tabel, dan empty state. Termasuk props, attribute merging, slot bernama, @aware, class component, halaman katalog komponen, dan test.

Overview

Setelah beberapa bulan, view di aplikasi admin biasanya penuh dengan blok seperti ini:

<div class="mb-4">
    <label for="alamat" class="block text-sm font-medium text-slate-700">Alamat</label>
    <input id="alamat" name="alamat" value="{{ old('alamat', $keluarga->alamat) }}"
           class="mt-1 w-full rounded-lg border-slate-300 @error('alamat') border-red-500 @enderror">
    @error('alamat') <p class="mt-1 text-sm text-red-600">{{ $message }}</p> @enderror
</div>

Blok ini diulang ratusan kali dengan variasi kecil. Akibatnya:

  • mengubah gaya input berarti mengedit puluhan file,
  • sebagian form lupa menampilkan error atau atribut aksesibilitas,
  • tampilan tombol dan badge status tidak konsisten antar halaman,
  • developer baru tidak tahu "cara yang benar" membuat elemen UI.

Blade Components menyelesaikan ini: tulis sekali, pakai di mana saja, dan perbaiki di satu tempat.

<x-form.input name="alamat" label="Alamat" :value="$keluarga->alamat" required />

Hasil akhir: pustaka komponen untuk aplikasi RW:

Komponen Kegunaan
<x-layouts.app> Layout halaman dengan slot judul dan aksi
<x-button> Tombol dengan varian, ukuran, dan mode tautan
<x-form.input>, <x-form.select>, <x-form.textarea> Field dengan label, error, dan atribut aksesibilitas
<x-card> Kartu dengan slot header dan footer
<x-badge.status> Badge dari enum status
<x-modal> Modal dengan Alpine.js
<x-table> Tabel dengan slot kolom dan empty state
<x-empty-state> Tampilan saat data kosong

Prerequisites

Komponen Versi
PHP 8.3+ (disarankan 8.4)
Laravel 13.x
Tailwind CSS 4.x (contoh gaya; konsep berlaku untuk Bootstrap)
Alpine.js 3.x (untuk komponen interaktif)
Testing Pest 4

Step-by-step Tutorial

Langkah 1: Pahami Dua Jenis Komponen

Anonymous component Class component
File Hanya Blade di resources/views/components Class PHP di app/View/Components + Blade
Props @props([...]) Parameter constructor
Logika Ringan (di Blade) Bisa kompleks, bisa di-inject service
Cocok untuk Tombol, input, kartu, badge Komponen yang perlu query, format kompleks, atau dependency

Mulailah dengan anonymous component. Pindahkan ke class component hanya bila logikanya terlalu panjang untuk Blade.

php artisan make:component Card --view          # anonymous: resources/views/components/card.blade.php
php artisan make:component StatistikKartu       # class: app/View/Components/StatistikKartu.php + view

Struktur folder yang disarankan:

resources/views/components/
├── layouts/
│   └── app.blade.php           → <x-layouts.app>
├── form/
│   ├── input.blade.php         → <x-form.input>
│   ├── select.blade.php
│   ├── textarea.blade.php
│   └── field.blade.php         → pembungkus label + error (dipakai komponen form lain)
├── badge/
│   └── status.blade.php        → <x-badge.status>
├── button.blade.php
├── card.blade.php
├── empty-state.blade.php
├── modal.blade.php
└── table.blade.php

Langkah 2: Komponen Tombol dengan Varian

{{-- resources/views/components/button.blade.php --}}
@props([
    'variant' => 'primary',     // primary | secondary | danger | ghost
    'size'    => 'md',          // sm | md
    'href'    => null,
    'type'    => 'button',
    'icon'    => null,
])

@php
    $base = 'inline-flex items-center justify-center gap-2 rounded-lg font-semibold transition focus-visible:outline-2 focus-visible:outline-offset-2 disabled:pointer-events-none disabled:opacity-50';

    $variants = [
        'primary'   => 'bg-brand-600 text-white hover:bg-brand-700 focus-visible:outline-brand-600',
        'secondary' => 'border border-slate-300 bg-white text-slate-700 hover:bg-slate-50 focus-visible:outline-slate-400',
        'danger'    => 'bg-red-600 text-white hover:bg-red-700 focus-visible:outline-red-600',
        'ghost'     => 'text-slate-600 hover:bg-slate-100 focus-visible:outline-slate-400',
    ];

    $sizes = ['sm' => 'px-3 py-1.5 text-sm', 'md' => 'px-4 py-2 text-sm'];

    $classes = implode(' ', [$base, $variants[$variant] ?? $variants['primary'], $sizes[$size] ?? $sizes['md']]);
@endphp

@if ($href)
    <a href="{{ $href }}" {{ $attributes->class($classes) }}>
        @if ($icon) <x-dynamic-component :component="'icon.'.$icon" class="size-4" /> @endif
        {{ $slot }}
    </a>
@else
    <button type="{{ $type }}" {{ $attributes->class($classes) }}>
        @if ($icon) <x-dynamic-component :component="'icon.'.$icon" class="size-4" /> @endif
        {{ $slot }}
    </button>
@endif

Pemakaian:

<x-button type="submit">Simpan</x-button>
<x-button variant="secondary" :href="route('kas.index')">Batal</x-button>
<x-button variant="danger" size="sm" x-on:click="$dispatch('open-modal', 'hapus-{{ $item->id }}')">Hapus</x-button>
<x-button variant="ghost" class="w-full" data-testid="tombol-ekspor">Ekspor</x-button>

Konsep kunci:

  • @props mendefinisikan atribut yang dianggap data komponen beserta nilai bawaannya. Atribut lain (misalnya class, x-on:click, data-testid, disabled) masuk ke $attributes.
  • $attributes->class(...) menggabungkan class bawaan dengan class dari pemanggil, sehingga class="w-full" ditambahkan, bukan menimpa.
  • Tombol dan tautan memakai satu komponen dengan perilaku semantik yang benar (<a> untuk navigasi, <button> untuk aksi).

Langkah 3: Komponen Field Form yang Lengkap

Pisahkan pembungkus (label, petunjuk, error) dari input agar bisa dipakai oleh input, select, dan textarea.

{{-- resources/views/components/form/field.blade.php --}}
@props(['name', 'label' => null, 'hint' => null, 'id' => null, 'required' => false])

@php
    $id ??= str_replace(['[', ']', '.'], ['-', '', '-'], $name);
    $errorKey = str_replace(['[', ']'], ['.', ''], $name);   // rincian[0][jumlah] → rincian.0.jumlah
@endphp

<div {{ $attributes->class('space-y-1') }}>
    @if ($label)
        <label for="{{ $id }}" class="block text-sm font-medium text-slate-700 dark:text-slate-200">
            {{ $label }} @if ($required) <span class="text-red-600" aria-hidden="true">*</span> @endif
        </label>
    @endif

    {{ $slot }}

    @if ($hint && ! $errors->has($errorKey))
        <p id="{{ $id }}-hint" class="text-sm text-slate-500">{{ $hint }}</p>
    @endif

    @error($errorKey)
        <p id="{{ $id }}-error" class="text-sm text-red-600">{{ $message }}</p>
    @enderror
</div>
{{-- resources/views/components/form/input.blade.php --}}
@props([
    'name',
    'label'    => null,
    'type'     => 'text',
    'value'    => null,
    'hint'     => null,
    'required' => false,
    'id'       => null,
])

@php
    $id ??= str_replace(['[', ']', '.'], ['-', '', '-'], $name);
    $errorKey = str_replace(['[', ']'], ['.', ''], $name);
    $hasError = $errors->has($errorKey);
    $describedBy = $hasError ? "{$id}-error" : ($hint ? "{$id}-hint" : null);
    $oldValue = $type === 'password' ? null : old($errorKey, $value);    // jangan isi ulang password
@endphp

<x-form.field :name="$name" :label="$label" :hint="$hint" :id="$id" :required="$required">
    <input
        id="{{ $id }}"
        name="{{ $name }}"
        type="{{ $type }}"
        @if (! is_null($oldValue)) value="{{ $oldValue }}" @endif
        @required($required)
        @if ($hasError) aria-invalid="true" @endif
        @if ($describedBy) aria-describedby="{{ $describedBy }}" @endif
        {{ $attributes->class([
            'block w-full rounded-lg shadow-sm sm:text-sm',
            'border-slate-300 focus:border-brand-500 focus:ring-brand-500' => ! $hasError,
            'border-red-500 focus:border-red-500 focus:ring-red-500' => $hasError,
        ]) }}
    >
</x-form.field>
{{-- resources/views/components/form/select.blade.php --}}
@props(['name', 'label' => null, 'options' => [], 'value' => null, 'placeholder' => null, 'required' => false, 'id' => null])

@php
    $id ??= str_replace(['[', ']', '.'], ['-', '', '-'], $name);
    $errorKey = str_replace(['[', ']'], ['.', ''], $name);
    $selected = (string) old($errorKey, $value instanceof \BackedEnum ? $value->value : $value);
@endphp

<x-form.field :name="$name" :label="$label" :id="$id" :required="$required">
    <select id="{{ $id }}" name="{{ $name }}" @required($required)
            @error($errorKey) aria-invalid="true" aria-describedby="{{ $id }}-error" @enderror
            {{ $attributes->class('block w-full rounded-lg border-slate-300 shadow-sm sm:text-sm') }}>
        @if ($placeholder) <option value="">{{ $placeholder }}</option> @endif
        @foreach ($options as $optValue => $optLabel)
            <option value="{{ $optValue }}" @selected($selected === (string) $optValue)>{{ $optLabel }}</option>
        @endforeach
    </select>
</x-form.field>

Pemakaian di form:

<form method="POST" action="{{ route('admin.keluarga.update', $keluarga) }}" class="space-y-4">
    @csrf @method('PUT')

    <x-form.input name="nomor_kk" label="Nomor KK" :value="$keluarga->nomor_kk"
                  inputmode="numeric" maxlength="16" required hint="16 digit sesuai kartu keluarga" />

    <x-form.input name="kepala_keluarga" label="Kepala Keluarga" :value="$keluarga->kepala_keluarga" required />

    <x-form.select name="rukun_tetangga_id" label="RT" :value="$keluarga->rukun_tetangga_id"
                   :options="$daftarRt->pluck('nomor', 'id')->map(fn ($n) => 'RT '.$n)"
                   placeholder="Pilih RT" required />

    <x-button type="submit">Simpan</x-button>
</form>

Setiap field sekarang otomatis memiliki label yang terhubung, nilai old(), pesan error, aria-invalid, dan aria-describedby, tanpa developer harus mengingatnya.

Langkah 4: Kartu dengan Slot Bernama

{{-- resources/views/components/card.blade.php --}}
@props(['padding' => true])

<section {{ $attributes->class('rounded-card bg-white shadow-card dark:bg-slate-900') }}>
    @isset($header)
        <header {{ $header->attributes->class('flex items-center justify-between gap-4 border-b border-slate-100 px-5 py-4 dark:border-slate-800') }}>
            {{ $header }}
        </header>
    @endisset

    <div @class(['p-5' => $padding])>
        {{ $slot }}
    </div>

    @isset($footer)
        <footer {{ $footer->attributes->class('border-t border-slate-100 px-5 py-3 dark:border-slate-800') }}>
            {{ $footer }}
        </footer>
    @endisset
</section>
<x-card>
    <x-slot:header>
        <h2 class="font-semibold">Iuran Bulan Ini</h2>
        <x-button size="sm" variant="secondary" :href="route('iuran.index')">Lihat semua</x-button>
    </x-slot:header>

    <p>Terkumpul Rp 4.250.000 dari 85 keluarga.</p>

    <x-slot:footer class="text-right text-sm text-slate-500">
        Diperbarui {{ now()->diffForHumans() }}
    </x-slot:footer>
</x-card>

Slot bernama juga memiliki $attributes sendiri, sehingga class="text-right" pada <x-slot:footer> digabungkan ke elemen footer.

Langkah 5: Badge dari Enum

Status tampil di banyak halaman (daftar, detail, dasbor, email). Satu komponen menjamin konsistensi.

// app/Enums/StatusTransaksi.php
enum StatusTransaksi: string
{
    case Draft = 'draft';
    case Menunggu = 'menunggu';
    case Disetujui = 'disetujui';
    case Ditolak = 'ditolak';

    public function label(): string
    {
        return match ($this) {
            self::Draft     => 'Draf',
            self::Menunggu  => 'Menunggu Persetujuan',
            self::Disetujui => 'Disetujui',
            self::Ditolak   => 'Ditolak',
        };
    }

    public function badgeClass(): string
    {
        return match ($this) {
            self::Draft     => 'bg-slate-100 text-slate-700',
            self::Menunggu  => 'bg-amber-100 text-amber-800',
            self::Disetujui => 'bg-emerald-100 text-emerald-700',
            self::Ditolak   => 'bg-red-100 text-red-700',
        };
    }
}
{{-- resources/views/components/badge/status.blade.php --}}
@props(['status'])

<span {{ $attributes->class(['inline-flex items-center rounded-full px-2.5 py-0.5 text-xs font-medium', $status->badgeClass()]) }}>
    {{ $status->label() }}
</span>
<x-badge.status :status="$trx->status" />

Karena nama class ditulis utuh di enum, Tailwind dapat menemukannya saat build (lihat artikel Integrasi Laravel dengan Tailwind CSS 4). Pastikan folder app/Enums ikut dipindai, misalnya dengan @source '../../app/Enums';.

Langkah 6: Modal dengan Alpine.js

{{-- resources/views/components/modal.blade.php --}}
@props(['name', 'title' => null, 'maxWidth' => 'lg'])

@php
    $width = ['sm' => 'sm:max-w-sm', 'md' => 'sm:max-w-md', 'lg' => 'sm:max-w-lg', 'xl' => 'sm:max-w-xl'][$maxWidth] ?? 'sm:max-w-lg';
@endphp

<div x-data="{ show: false, name: @js($name) }"
     x-on:open-modal.window="if ($event.detail === name) show = true"
     x-on:close-modal.window="if ($event.detail === name) show = false"
     x-on:keydown.escape.window="show = false"
     x-show="show" x-cloak
     class="fixed inset-0 z-50 flex items-end justify-center p-4 sm:items-center"
     role="dialog" aria-modal="true" @if ($title) aria-labelledby="modal-{{ $name }}-title" @endif>

    <div x-show="show" x-transition.opacity class="fixed inset-0 bg-slate-900/50" x-on:click="show = false"></div>

    <div x-show="show" x-transition x-trap.noscroll="show"
         {{ $attributes->class(['relative w-full rounded-card bg-white p-6 shadow-xl dark:bg-slate-900', $width]) }}>
        @if ($title)
            <h2 id="modal-{{ $name }}-title" class="mb-4 text-lg font-semibold">{{ $title }}</h2>
        @endif

        {{ $slot }}

        @isset($footer)
            <div class="mt-6 flex justify-end gap-3">{{ $footer }}</div>
        @endisset
    </div>
</div>

x-trap berasal dari plugin @alpinejs/focus. Plugin ini menjaga fokus keyboard tetap di dalam modal dan mengembalikannya saat modal ditutup, yang penting untuk aksesibilitas:

npm install @alpinejs/focus
import focus from '@alpinejs/focus';
Alpine.plugin(focus);

Contoh modal konfirmasi hapus yang aman (POST + CSRF + DELETE):

<x-button variant="danger" size="sm" x-data x-on:click="$dispatch('open-modal', 'hapus-{{ $keluarga->id }}')">
    Hapus
</x-button>

<x-modal name="hapus-{{ $keluarga->id }}" title="Hapus data keluarga?" max-width="md">
    <p class="text-sm text-slate-600">
        Data keluarga <strong>{{ $keluarga->kepala_keluarga }}</strong> akan dihapus. Tindakan ini tidak dapat dibatalkan.
    </p>

    <x-slot:footer>
        <x-button variant="secondary" x-on:click="$dispatch('close-modal', 'hapus-{{ $keluarga->id }}')">Batal</x-button>
        <form method="POST" action="{{ route('admin.keluarga.destroy', $keluarga) }}">
            @csrf @method('DELETE')
            <x-button type="submit" variant="danger">Ya, hapus</x-button>
        </form>
    </x-slot:footer>
</x-modal>

Perhatikan @js($name) di komponen modal: nama modal disisipkan ke ekspresi Alpine sebagai literal JavaScript yang di-escape dengan benar.

Langkah 7: Tabel dengan Empty State dan @aware

{{-- resources/views/components/table.blade.php --}}
@props(['rows', 'dense' => false])

<div class="overflow-x-auto">
    <table {{ $attributes->class('min-w-full divide-y divide-slate-200 text-sm dark:divide-slate-800') }}>
        <thead class="bg-slate-50 text-left text-xs font-semibold uppercase tracking-wide text-slate-500 dark:bg-slate-800/50">
            <tr>{{ $head }}</tr>
        </thead>
        <tbody class="divide-y divide-slate-100 dark:divide-slate-800">
            @if ($rows->isEmpty())
                <tr><td colspan="100">{{ $empty ?? '' }}</td></tr>
            @else
                {{ $slot }}
            @endif
        </tbody>
    </table>
</div>

@if ($rows instanceof \Illuminate\Contracts\Pagination\Paginator && $rows->hasPages())
    <div class="mt-4">{{ $rows->links() }}</div>
@endif
{{-- resources/views/components/table/cell.blade.php --}}
@aware(['dense' => false])

<td {{ $attributes->class(['px-4 text-slate-700 dark:text-slate-200', 'py-2' => $dense, 'py-3' => ! $dense]) }}>
    {{ $slot }}
</td>

@aware membuat komponen anak (<x-table.cell>) membaca prop dense dari komponen induk (<x-table>) tanpa harus meneruskannya satu per satu.

{{-- resources/views/components/empty-state.blade.php --}}
@props(['title' => 'Belum ada data', 'description' => null])

<div class="flex flex-col items-center gap-2 py-12 text-center">
    <p class="font-semibold text-slate-700 dark:text-slate-200">{{ $title }}</p>
    @if ($description) <p class="max-w-sm text-sm text-slate-500">{{ $description }}</p> @endif
    {{ $slot }}
</div>
<x-table :rows="$transaksi" dense>
    <x-slot:head>
        <th class="px-4 py-3">Tanggal</th>
        <th class="px-4 py-3">Keterangan</th>
        <th class="px-4 py-3 text-right">Jumlah</th>
        <th class="px-4 py-3">Status</th>
    </x-slot:head>

    @foreach ($transaksi as $trx)
        <tr>
            <x-table.cell>{{ $trx->tanggal->translatedFormat('d M Y') }}</x-table.cell>
            <x-table.cell>{{ $trx->keterangan }}</x-table.cell>
            <x-table.cell class="text-right tabular-nums">{{ \App\Support\Money::rupiah($trx->jumlah) }}</x-table.cell>
            <x-table.cell><x-badge.status :status="$trx->status" /></x-table.cell>
        </tr>
    @endforeach

    <x-slot:empty>
        <x-empty-state title="Belum ada transaksi" description="Transaksi kas yang dicatat akan tampil di sini.">
            @can('create', App\Models\TransaksiKas::class)
                <x-button :href="route('kas.pengeluaran.create')" size="sm">Catat transaksi</x-button>
            @endcan
        </x-empty-state>
    </x-slot:empty>
</x-table>

Langkah 8: Layout sebagai Komponen

{{-- resources/views/components/layouts/app.blade.php --}}
@props(['title' => null])

<!doctype html>
<html lang="id" class="{{ request()->cookie('tema') === 'gelap' ? 'dark' : '' }}">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="csrf-token" content="{{ csrf_token() }}">
    <title>{{ $title ? "{$title} · " : '' }}{{ config('app.name') }}</title>
    @vite(['resources/css/app.css', 'resources/js/app.js'])
    {{ $head ?? '' }}
</head>
<body class="min-h-screen bg-slate-50 text-slate-900 antialiased dark:bg-slate-950 dark:text-slate-100">
    <x-navigation />

    <main class="mx-auto max-w-7xl px-4 py-8 sm:px-6">
        @if ($title || isset($actions))
            <div class="mb-6 flex flex-wrap items-center justify-between gap-4">
                @if ($title) <h1 class="font-display text-2xl font-bold">{{ $title }}</h1> @endif
                @isset($actions) <div class="flex gap-2">{{ $actions }}</div> @endisset
            </div>
        @endif

        <x-flash />
        {{ $slot }}
    </main>
</body>
</html>
<x-layouts.app title="Data Keluarga">
    <x-slot:actions>
        <x-button :href="route('admin.keluarga.create')">Tambah</x-button>
    </x-slot:actions>

    {{-- isi halaman --}}
</x-layouts.app>

Dibandingkan @extends/@section, layout berbasis komponen lebih eksplisit: prop dan slot yang tersedia terlihat jelas di satu file.

Langkah 9: Class Component untuk Logika yang Lebih Berat

Kartu statistik yang memformat angka, menghitung persentase perubahan, dan memilih warna tren lebih rapi sebagai class:

// app/View/Components/StatistikKartu.php
namespace App\View\Components;

use Closure;
use Illuminate\Contracts\View\View;
use Illuminate\View\Component;

class StatistikKartu extends Component
{
    public function __construct(
        public string $label,
        public int|float $nilai,
        public int|float|null $sebelumnya = null,
        public string $format = 'angka',      // angka | rupiah | persen
    ) {}

    public function nilaiTampil(): string
    {
        return match ($this->format) {
            'rupiah' => 'Rp '.number_format($this->nilai, 0, ',', '.'),
            'persen' => number_format($this->nilai, 1, ',', '.').'%',
            default  => number_format($this->nilai, 0, ',', '.'),
        };
    }

    public function perubahan(): ?float
    {
        if (! $this->sebelumnya) {
            return null;
        }

        return round((($this->nilai - $this->sebelumnya) / $this->sebelumnya) * 100, 1);
    }

    public function render(): View|Closure|string
    {
        return view('components.statistik-kartu');
    }
}
{{-- resources/views/components/statistik-kartu.blade.php --}}
<x-card {{ $attributes }}>
    <p class="text-sm text-slate-500">{{ $label }}</p>
    <p class="mt-1 text-2xl font-bold tabular-nums">{{ $nilaiTampil() }}</p>

    @if (! is_null($perubahan()))
        <p @class(['mt-1 text-sm', 'text-emerald-600' => $perubahan() >= 0, 'text-red-600' => $perubahan() < 0])>
            {{ $perubahan() >= 0 ? '▲' : '▼' }} {{ abs($perubahan()) }}% dari periode sebelumnya
        </p>
    @endif
</x-card>
<x-statistik-kartu label="Iuran Terkumpul" :nilai="4250000" :sebelumnya="3900000" format="rupiah" />

Method publik di class component bisa dipanggil langsung di view ($nilaiTampil()).

Langkah 10: Halaman Katalog Komponen (Hanya Lokal)

Halaman katalog membantu tim melihat semua komponen dan variannya di satu tempat:

// routes/web.php
if (app()->isLocal()) {
    Route::view('_komponen', 'dev.komponen')->name('dev.komponen');
}
{{-- resources/views/dev/komponen.blade.php --}}
<x-layouts.app title="Katalog Komponen">
    <x-card>
        <x-slot:header><h2 class="font-semibold">Tombol</h2></x-slot:header>
        <div class="flex flex-wrap gap-3">
            @foreach (['primary', 'secondary', 'danger', 'ghost'] as $v)
                <x-button :variant="$v">{{ ucfirst($v) }}</x-button>
            @endforeach
            <x-button disabled>Nonaktif</x-button>
        </div>
    </x-card>

    <x-card class="mt-6">
        <x-slot:header><h2 class="font-semibold">Badge Status</h2></x-slot:header>
        <div class="flex gap-2">
            @foreach (App\Enums\StatusTransaksi::cases() as $s)
                <x-badge.status :status="$s" />
            @endforeach
        </div>
    </x-card>
    {{-- input, modal, tabel, empty state, ... --}}
</x-layouts.app>

Route ini hanya terdaftar di lingkungan lokal, sehingga tidak pernah ada di production.

Langkah 11: Test Komponen

// tests/Feature/Components/FormInputTest.php
use Illuminate\Support\MessageBag;
use Illuminate\Support\ViewErrorBag;

it('menampilkan error dan atribut aksesibilitas', function () {
    $errors = (new ViewErrorBag)->put('default', new MessageBag(['nomor_kk' => ['Nomor KK wajib diisi.']]));
    view()->share('errors', $errors);

    $this->blade('<x-form.input name="nomor_kk" label="Nomor KK" required />')
        ->assertSee('Nomor KK wajib diisi.')
        ->assertSee('aria-invalid="true"', false)
        ->assertSee('aria-describedby="nomor_kk-error"', false)
        ->assertSee('for="nomor_kk"', false);
});

it('memetakan nama array ke kunci error', function () {
    $errors = (new ViewErrorBag)->put('default', new MessageBag(['rincian.0.jumlah' => ['Jumlah wajib diisi.']]));
    view()->share('errors', $errors);

    $this->blade('<x-form.input name="rincian[0][jumlah]" />')
        ->assertSee('Jumlah wajib diisi.');
});

it('menggabungkan class dari pemanggil', function () {
    $this->blade('<x-button class="w-full">Simpan</x-button>')
        ->assertSee('w-full', false)
        ->assertSee('bg-brand-600', false);
});

it('tidak mengisi ulang password', function () {
    session()->flashInput(['password' => 'rahasia']);

    $this->blade('<x-form.input name="password" type="password" />')
        ->assertDontSee('rahasia');
});

Troubleshooting

Error / Gejala Penyebab Solusi
Unable to locate a class or view for component [form.input] File tidak ada di path yang sesuai Pastikan resources/views/components/form/input.blade.php
Prop dianggap atribut HTML (label="..." muncul di tag) Prop tidak dideklarasikan di @props Tambahkan ke @props
class dari pemanggil menimpa class bawaan Menulis class="{{ ... }}" manual Gunakan $attributes->class(...) atau $attributes->merge(['class' => ...])
Nilai prop berupa string "$keluarga->alamat" Lupa awalan titik dua Gunakan :value="$keluarga->alamat" untuk ekspresi PHP
Error validasi untuk field array tidak tampil Nama rincian[0][jumlah] dicari apa adanya Konversi ke rincian.0.jumlah seperti di komponen field
Class dari enum tidak muncul di production (Tailwind) Folder app/Enums tidak dipindai Tambahkan @source '../../app/Enums';
Modal tidak bisa ditutup dengan keyboard / fokus lari Plugin focus belum dipasang Pasang @alpinejs/focus dan gunakan x-trap
Komponen tidak berubah setelah diedit di production View di-cache php artisan view:clear lalu view:cache saat deploy

Best Practices

Keamanan

  • Biarkan {{ }} meng-escape konten; hindari {!! !!} di dalam komponen. {{ $slot }} aman dipakai karena slot berisi HTML yang sudah dirender (dan di-escape) oleh view pemanggil.
  • Gunakan @js() untuk menyisipkan nilai PHP ke ekspresi Alpine/JavaScript.
  • Jangan isi ulang password atau secret di komponen input.
  • Komponen yang menampilkan tombol aksi tidak menggantikan otorisasi di server.

Performa

  • Anonymous component sangat ringan; tidak perlu khawatir memakainya berulang kali.
  • Hindari query database di dalam komponen yang dipakai dalam loop; kirim data yang sudah dimuat lewat prop.
  • Jalankan php artisan view:cache saat deploy.

Maintainability

  • Kelompokkan komponen per domain dalam folder (form/, badge/, layouts/).
  • Satu sumber kebenaran untuk gaya: varian tombol, warna status, dan ukuran ada di komponen atau enum, bukan tersebar di view.
  • Sediakan halaman katalog komponen di lokal agar tim mudah menemukan dan memakai komponen yang sudah ada.
  • Uji komponen form untuk error, aksesibilitas, dan perilaku old().

Related Articles

Last Tested

Komponen Versi
Laravel 13.x
PHP 8.4
Tailwind CSS 4.3.x
Alpine.js 3.x (+ @alpinejs/focus)
Pest 4.x
Tanggal 19 Oktober 2026

Bagikan artikel:

Artikel lainnya