You can install the package via composer:
composer require eptic/turboAs per the official @Hotwired/Turbo documentation, you will need to add the TurboMiddleware provided in this package to the web group inside Kernel.php to handle the redirects as Turbo expects them.
You can read more information about this in the official documentation:
Redirecting After a Form Submission
Example:
'web' => [
\App\Http\Middleware\EncryptCookies::class,
\Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
\Illuminate\Session\Middleware\StartSession::class,
// \Illuminate\Session\Middleware\AuthenticateSession::class,
\Illuminate\View\Middleware\ShareErrorsFromSession::class,
\App\Http\Middleware\VerifyCsrfToken::class,
\Illuminate\Routing\Middleware\SubstituteBindings::class,
-> \Eptic\Turbo\Middleware\TurboMiddleware::class,
],You can publish the config file with:
php artisan vendor:publish --tag="turbo-config"Optionally, you can publish the views used as templates using
php artisan vendor:publish --tag="turbo-views"You can see the content of the config file in the configs folder.
To generate a turbo frame response
return response()->turboFrame()->generic(id: 'gallery', partial: view('pages.galleries._partials.create'), target: '#gallery-create');Check if the request was made inside a turbo-frame:
request()->wantsTurboFrame()To check if a request is a turbo stream request:
request()->expectsTurboStream()To generate a turbo stream, you can use the turboStream method on the response object.
It has all the signatures present in the original documentation from Hotwired:
- Append:
return response()->turboStream()->append(target: 'gallery-create', partial: view('pages.galleries._partials.create'));
- Prepend:
return response()->turboStream()->prepend(target: 'gallery-create', partial: view('pages.galleries._partials.create'));
- Replace:
return response()->turboStream()->replace(target: 'gallery-create', partial: view('pages.galleries._partials.create'));
- Update:
return response()->turboStream()->update(target: 'gallery-create', partial: view('pages.galleries._partials.create'));
- Remove:
return response()->turboStream()->remove(target: 'gallery-create');
- Before:
return response()->turboStream()->before(target: 'gallery-create', partial: view('pages.galleries._partials.gallery'));
- After:
return response()->turboStream()->after(target: 'gallery-create', partial: view('pages.galleries._partials.gallery'));
If you already have a view that contains the entire template and only want to set the correct content-type so it is recognised as a turbo stream, you can use:
return response()->turboStream()->view(view: 'pages.galleries.create', data: $data);
// Or you can pass in a view directly
return response()->turboStream()->view(view: view('pages.galleries.create', $data));composer testPlease see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.