TallStackUI, Banner

# Concept

The banner component is a component intended to display text at the top of the page. It has two usage approaches: static usage to display fixed or random messages or Livewire integration to display messages that comes from the backend to the frontend.

# Usage

To use the component you must add it to your application's layout, within the body tag, but above anything else:

<html>
    <body>
        <x-banner /> 
 
        <!-- ... -->
    </body>
</html>

# Messages

<html>
    <body>
        <!-- Fixed text -->
        <x-banner text="Welcome to the TallStackUI!" />
 
        <!-- Random text -->
        <x-banner :text="['Welcome to the TallStackUI!', 'This is the TallStackUI']" />
 
        <!-- Random based on Collection -->
        <x-banner :text="collect(['Welcome to the TallStackUI!', 'This is the TallStackUI'])" />
    </body>
</html>

You can take advantage of collections to get an array of messages from the database.

# Left Slot

<html>
    <body>
        <x-banner text="Welcome to the TallStackUI!">
            <x-slot:left>
                <x-icon name="check" />
            </x-slot:left>
        </x-banner>
    </body>
</html>

# Close Option

<html>
    <body>
        <x-banner text="Welcome to the TallStackUI!" close />
    </body>
</html>

# Animations

<html>
    <body>
        <!-- Default: entering in 3 seconds -->
        <x-banner text="Welcome to the TallStackUI!" animated />
 
        <!-- Entering in 2 seconds, leaving in 5 seconds -->
        <x-banner text="Welcome to the TallStackUI!" animated :enter="2" :leave="5" />
 
        <!-- Only leaving effect -->
        <x-banner text="Welcome to the TallStackUI!" animated :enter="null" :leave="5" />
    </body>
</html>

# Date Limit

An option to control the final date to display the banner.

<html>
    <body>
        <!-- String -->
        <x-banner text="Welcome to the TallStackUI!" until="2023-12-31" />
 
        <!-- Carbon instance -->
        <x-banner text="Welcome to the TallStackUI!" :until="now()->addDay()" />
    </body>
</html>

# Size Variations

<html>
    <body>
        <!-- Allowed: sm, md, lg -->
        <x-banner text="Welcome to the TallStackUI!" size="lg" />
    </body>
</html>

# Color Variations & Light Option

<html>
    <body>
        <!-- All TailwindCSS colors -->
        <x-banner text="Welcome to the TallStackUI!" color="primary" />
        <x-banner text="Welcome to the TallStackUI!" color="secondary" />
 
        <!-- Light variation -->
        <x-banner text="Welcome to the TallStackUI!" color="primary" light />
        <x-banner text="Welcome to the TallStackUI!" color="secondary" light />
 
        <!-- Hexadecimal colors using TailwindCSS Arbitrary colors -->
        <x-banner text="Welcome to the TallStackUI!"
                  :color="[
                      'background' => 'bg-[#fde68a]',
                      'text' => 'text-[#1f2937]',
                  ]" />
    </body>
</html>

# Dispatching via Controllers NEW

use Illuminate\Http\Request;
use TallStackUi\Traits\Interactions;
 
class PaymentController extends Controller
{
    use Interactions; 
 
    public function index()
    {
        return view('payment.index', [
            //
        ]);
    }
 
    public function update(Request $request)
    {
        // ...
 
        $this->banner() 
            ->success('...')
            ->close()
            ->enter(seconds: 3)
            ->leave(seconds: 10)
            ->send();
    }
}

# Concept

Unlike the static format, the use of the banner with Livewire integration can only have the size configurable option in the layout. All other available options must be configured when dispatching the banner through Livewire, so in the layout, the banner must be added as follows:

<html>
    <body>
        <x-banner wire />
 
        <!-- or -->
 
        <!-- Allowed: sm, md, lg -->
        <x-banner wire size="lg" />
    </body>
</html>

When using the banner integrated with Livewire then the banner will be displayed as fixed. This is a strategy adopted so that the banner is displayed if the user is below the top of the page.

# Usage

1. Use the Interactions trait in your Livewire component.

use TallStackUi\Traits\Interactions; 
 
class CreateUser extends Component
{
    use Interactions; 
 
    // ...
}

2. Dispatch the Banner from a method.

public function save(): void
{
    $this->banner()->success('...')->send();
    $this->banner()->error('...')->send();
    $this->banner()->warning('...')->send();
    $this->banner()->info('...')->send();
}

This is an example. You can't dispatch all at the same time.

# Available Options

public function save(): void
{
    $this->banner()
        ->close() // Add the close button
        ->success('...')
        ->send();
 
    $this->banner()
        ->enter(seconds: 3) // Enter in 3 seconds
        ->leave(seconds: 10) // Leave in 10 seconds
        ->success('...')
        ->send();
 
    $this->banner()
        ->leave(seconds: 10) // Controlling only the seconds to leave
        ->success('...')
        ->send();
}

# Example

public function success(): void
{
    $this->banner()
        ->close()
        ->success('This is a banner dispatched through Livewire. Will disappear in 5 seconds.')
        ->leave(5)
        ->send();
}

# Display After Redirects

use Illuminate\Contracts\View\View;
use Livewire\Component;
use TallStackUi\Traits\Interactions;
 
class Payment extends Component
{
    use Interactions;
 
    public function render(): View
    {
        return view('livewire.livewire');
    }
 
    public function save()
    {
        $this->banner()
            ->success('Done!', 'Your money has been sent!')
            ->flash() 
            ->send();
 
        return $this->redirect(route('dashboard'));
    }
}

When using flash() method, the banner will not be displayed in the current request, but yes stored temporarily in the session and displayed in the next request.