skuzalabs/filament-signature-pad

Signature Pad Field for Filamentphp Forms

v1.0.4 2023-03-11 05:33 UTC

This package is auto-updated.

Last update: 2024-05-11 08:25:16 UTC


README

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

img.png

A Signature Pad Field for the FilamentPHP Form Builder using szimek/signature_pad

Installation

You can install the package via composer:

composer require skuzalabs/filament-signature-pad

Usage

You can now use the SignaturePad field in your form builder.

    use Skuzalabs\SignaturePad\Forms\Components\Fields\SignaturePad;
    public static function form(Form $form): Form
    {
        return $form
            ->schema([
                // ... Other fields
                SignaturePad::make('signature'), // Chain your field modifiers here
                // Other fields
            ]);
    }

You can also set the Signature Pad Options as shown below. See SignaturePad Options Docs for more details.

    use Skuzalabs\SignaturePad\Forms\Components\Fields\SignaturePad;
    public static function form(Form $form): Form
    {
        return $form
            ->schema([
                // ... Other fields
                SignaturePad::make('signature')
                    ->strokeMinWidth(1.0)
                    ->strokeMaxWidth(2.5)
                    ->strokeDotSize(2.0)
                    ->penColor('rgb(0,0,255)') // Blue
                    ->backgroundColor('rgba(0,0,0,0)'), // Black Transparent
                // Other fields
            ]);
    }

img_1.png

Upon Saving, the signature image is saved to the database as a png data url. Plans are underway to also support uploading the signature to the server as an image blob file.

Testing

composer test

Credits

License

The MIT License (MIT). Please see License File for more information.