GitHub - spatie/laravel-flash: A lightweight package to flash messages
source link: https://github.com/spatie/laravel-flash
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
README.md
A lightweight package to flash messages
This is a lightweight package to send flash messages in Laravel apps. A flash message is a message that is carried over the next request.
This is how it can be used:
class MySpecialSnowflakeController { public function store() { // … flash('My message', 'my-class'); return back(); } }
In your view you can do this:
@if(flash()->message) <div class="{{ flash()->class }}"> {{ flash()->message }} </div> @endif
Installation
You can install the package via composer:
composer require spatie/laravel-flash
Usage
Here is an example on how to flash a message.
class MyController { public function store() { // … flash('My message'); return back(); } }
In your view you can use it like this
@if(flash()->message) <div> {{ flash()->message }} </div> @endif
Using a class
You can add a class as the second parameter.
class MyController { public function store() { // … flash('My message', 'my-class')); return back(); } }
In your view you can use the class like this:
@if(flash()->message) <div class="{{ flash()->class }}> {{ flash()->message }} </div> @endif
You can also set an array of classes.
flash('My message', ['my-class', 'another-class']));
Adding your own methods
If you don't want to specify a class each time you want flash a message you can add a functions to flash
.
The easiest way is by passing an array to the levels
method. The key is the method name that should be added to flash()
. The value is the css class that just be used when rendering the message.
// this would probably go in a service provider \Spatie\Flash\Flash::levels([ 'success' => 'alert-success', 'warning' => 'alert-warning', 'error' => 'alert-eror', ]);
This will make these methods available on flash
:
flash()->succes('Hurray'); flash()->warning('Mayybeee'); flash()->error('Oh Oh');
When you've added your own method, you can also pass that method name as a second parameter to flash
itself.
flash('Hurray', 'success'); // `flash()->class` will output 'alert-success'
You can also add a method to flash
by using macro
.
Here's an example:
// this would probably go in a service provider use Spatie\Flash\Message; \Spatie\Flash\Flash::macro('warning', function(string $message) { return $this->flash(new Message($message, 'alert alert-warning')); });
You can now use a warning
method on flash
:
flash()->warning('Look above you!');
Alternatives
This package is intended to be lightweight. If you need things like multiple messages, support for Bootstrap, overlays, ... take a look at this excellent flash package by Jeffrey Way.
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Postcardware
You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.
We publish all received postcards on our company website.
Credits
Support us
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.
Does your business depend on our contributions? Reach out and support us on Patreon. All pledges will be dedicated to allocating workforce on maintenance and new awesome stuff.
License
The MIT License (MIT). Please see License File for more information.
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK