README

💡 What is Filament Revealable Field?

Filament Revealable Field is an Infolist Field for toggling the visibility of sensitive data. It provides a secure way to display confidential information that can be revealed on demand, with optional copy-to-clipboard functionality.

🛠 Requirements

⚙️ Installation

You can install the package via composer:

composer require codebar-ag/laravel-filament-revealable-field

CSS Setup

Add the following to your resources/css/app.css file:

@source '../../vendor/codebar-ag/laravel-filament-revealable-field/src/Infolists/Components/RevealableEntry.php';

Usage

Infolists:

use CodebarAg\FilamentRevealableField\Infolists\Components\RevealableEntry;

...

public function infolist(Infolist $infolist): Infolist
{
    return $infolist
        ->schema([
            RevealableEntry::make('revealable')
                ->label('REVEALABLE')
                ->copyable() // Enable copy functionality
                ->copyMessage('Value copied!') // Custom copy message
                ->copyableState('Custom copy text'); // Custom text to copy
        ]);
}
...

📋 Features

Revealable Content

• Click the eye icon to toggle visibility of sensitive data
• Hidden content is displayed as asterisks (********)
• Secure by default - content is hidden until explicitly revealed

Copyable Content

• Enable copy-to-clipboard functionality with ->copyable()
• Customize copy message with ->copyMessage('Custom message')
• Set custom text to copy with ->copyableState('Custom text')
• Set copy message duration with ->copyMessageDuration(3000)

Available Methods

RevealableEntry::make('field_name')
    ->label('Field Label')
    ->copyable() // Enable copy functionality
    ->copyMessage('Value copied to clipboard!') // Custom success message
    ->copyableState('Custom text to copy') // Custom text to copy (defaults to field value)
    ->copyMessageDuration(3000); // Message duration in milliseconds (default: 2000)

🚧 Testing

Copy your own phpunit.xml-file.

cp phpunit.xml.dist phpunit.xml

Run the tests:

./vendor/bin/pest

📝 Changelog

Please see CHANGELOG for recent changes.

✏️ Contributing

Please see CONTRIBUTING for details.

composer test

Code Style

./vendor/bin/pint

🧑‍💻 Security Vulnerabilities

Please review our security policy on reporting security vulnerabilities.

🙏 Credits

• Rhys Lees
• Sebastian Fix
• All Contributors
• Skeleton Repository from Spatie
• Laravel Package Training from Spatie

🎭 License

The MIT License (MIT). Please have a look at License File for more information.