https://github.com/bastinald/laravel-livewire-loader

Laravel Livewire global loading spinner.
https://github.com/bastinald/laravel-livewire-loader

javascript js laravel laravel-livewire livewire loader

Last synced: 4 days ago
JSON representation

Laravel Livewire global loading spinner.

• Host: GitHub
• URL: https://github.com/bastinald/laravel-livewire-loader
• Owner: bastinald
• Created: 2021-07-01T14:18:15.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2022-08-02T21:56:02.000Z (about 2 years ago)
• Last Synced: 2024-09-25T20:32:03.650Z (8 days ago)
• Topics: javascript, js, laravel, laravel-livewire, livewire, loader
• Language: Blade
• Homepage:
• Size: 11.7 KB
• Stars: 24
• Watchers: 1
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# Laravel Livewire Loader

This package adds a global loading spinner to your Laravel Livewire project. The loading spinner shows when any Livewire action is being executed. This keeps users engaged as they won't become frustrated by page hanging due to network latency. It also keeps your code much cleaner, as you won't be having to add loading spinners all over the place.

## Documentation

- [Requirements](#requirements)

- [Installation](#installation)

- [Publishing Assets](#publishing-assets)

    - [Custom Config](#custom-config)

    - [Custom View](#custom-view)

## Requirements

- Bootstrap 5 must be installed via webpack first

## Installation

Require the package:

```console

composer require bastinald/laravel-livewire-loader

```

Add the `livewire:loader` component to your app layout view:

```html

```

Require `../../vendor/bastinald/laravel-livewire-loader/resources/js/loader` in your app javascript file:

```javascript

require('@popperjs/core');

require('bootstrap');

require('../../vendor/bastinald/laravel-livewire-loader/resources/js/loader');

```

## Publishing Assets

### Custom Config

Customize the loader configuration by publishing the config file:

```console

php artisan vendor:publish --tag=laravel-livewire-loader:config

```

Now you can easily change things like the show delay and animation speed.

### Custom View

Use your own loader view by publishing the view file:

```console

php artisan vendor:publish --tag=laravel-livewire-loader:views

```

Now edit the view file inside `resources/views/vendor/laravel-livewire-loader`. The package will use this view to render the component.