Formello: Paket Laravel untuk Membuat Form Cepat & Mudah

Formello: Solusi Praktis untuk Membuat Form di Laravel 🚀

Kalau kamu sering ngoding pakai Laravel, pasti pernah merasakan ribetnya bikin form yang itu-itu lagi. Mulai dari bikin input field, validasi, error handling, sampai rendering di Blade. Nah, sekarang ada Formello, paket Laravel yang dibuat khusus untuk mempermudah hidup developer saat bikin form.

Formello punya fitur yang pas:

• Lebih simpel daripada library form yang kompleks.
• Lebih ringan daripada admin panel penuh fitur seperti Nova atau Filament.

Jadi, kalau kamu butuh bikin form cepat tapi tetap fleksibel dan mudah diatur, Formello bisa jadi teman baru terbaikmu.

✨ Fitur Utama Formello

• Definisi form gampang banget pakai kelas Laravel.
• Otomatis dirender langsung ke Blade.
• Mendukung banyak tipe field: text, textarea, select, select2, radio, checkbox, toggle, date, datetime, upload, hidden, sampai widget custom.
• Error handling otomatis, gak perlu dibuat manual.
• Validasi form langsung terintegrasi.
• Support styling: Bootstrap 5 (Tailwind CSS sebentar lagi).

Dengan fitur-fitur ini, kamu bisa fokus ke logika aplikasi tanpa harus copy-paste form berulang kali.

🛠️ Cara Install Formello

Instal paket melalui composer:

composer require metalogico/laravel-formello

Lalu, publish assets-nya:

php artisan vendor:publish --tag=formello-assets

Kalau mau assets selalu update tiap composer update, tinggal tambahkan ke composer.json.

"scripts": {
    "post-update-cmd": [
        "@php artisan vendor:publish --tag=formello-assets --force"
    ]
}

😎 Cara Pakai Formello di Laravel

Berikut adalah cara untuk mulai menggunakannya dalam proyek Laravel kamu.

1. Buat Kelas Form

Pertama, buat form class yang extend Metalogico\Formello\Formello.

Contoh sederhana buat ProductForm:

<?php

namespace App\Forms;

use Metalogico\Formello\Formello;
use Metalogico\Formello\Widgets\SelectWidget;

class ProductForm extends Formello
{
    protected function create(): array
    {
        return [
            'method' => 'POST',
            'action' => route('products.store'),
        ];
    }

    protected function edit(): array
    {
        return [
            'method' => 'POST',
            'action' => route('products.update', $this->model->id),
        ];
    }    

    protected function fields(): array
    {
        return [
            'name' => [
                'label' => __('Product Name'),
                'help' => 'Enter the name of the product',
            ],
            'description' => [
                'label' => __('Description'),
            ],
            'category_id' => [
                'label' => __('Category'),
                'widget' => 'select',
                'choices' => Category::pluck('name', 'id')->toArray(),
            ],
            'in_stock' => [
              'label' => __('In Stock'),
            ],
        ];
    }
}

⚠️ Catatan: Pastikan field ini masuk ke $fillable di model, kalau tidak Formello gak bakal render.

class Product extends Model
{
    protected $fillable = [
        'name',
        'category_id',
        'description',
        'in_stock',
    ];
}

2. Generate Form Otomatis dengan Artisan

Males nulis manual? Tenang, Formello bisa generate form otomatis dari fillable fields model kamu:

php artisan make:formello --model=Product

Perintah ini bakal bikin skeleton form berdasarkan field yang ada di model. Hemat waktu banget, kan?

3. Render Form di Controller & Blade

Controller – Create Form (New Record)

public function create()
{
    $formello = new ProductForm(Product::class);
    return view('products.create', [
      'formello' => $formello
    ]);
}

Controller – Edit Form (Update Record)

public function edit(Product $product)
{
    $formello = new ProductForm($product);
    return view('products.edit', [
        'formello' => $formello
    ]);
}

Blade Template – Render the Form

{!! $formello->render() !!}

Kalau cuma mau render field tanpa <form> tag:

@foreach ($formello->getFields() as $name => $field)
    {!! $formello->renderField($name) !!}
@endforeach

4. Conditional Logic (Beda Buat Create & Edit)

Formello punya method isCreating() dan isEditing() untuk bikin field dinamis.

Misal: password wajib saat create, tapi opsional saat edit.

protected function fields(): array
{
    return [
        'name' => [
            'label' => __('User Name'),
            'help' => 'Enter the name of the user',
        ],
        'password' => [
            'label' => __('Password'),
            'type' => 'password',
            'required' => $this->isCreating(),
            'help' => $this->isEditing() ? 'Leave empty to keep current password' : '',
        ],
    ];
}

Dengan cara ini, kolom kata sandi diwajibkan saat membuat data baru, tetapi bersifat opsional saat mengedit.

🎉 Beres! Dengan langkah-langkah ini, bikin form Laravel jadi lebih cepat, rapi, dan fleksibel pakai Formello.
Sekarang support Bootstrap 5, buat yang penggemar Tailwind CSS sabar ya… sebentar lagi hadir!

👉 Untuk info lebih lengkap, cek Github.