mrshanebarron/infinite-scroll

Load more on scroll for Laravel. Supports Livewire and Blade.

dev-main 2025-12-14 04:34 UTC

Requires

• php: ^8.1
• illuminate/support: ^10.0|^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0
• pestphp/pest: ^2.0

MIT

• Shane Barron

• ui
• component
• laravel
• blade
• infinite-scroll
• livewire

README

Load more content on scroll automatically. Built for Laravel with support for Livewire, Blade, and Alpine.js.

Installation

composer require mrshanebarron/infinite-scroll

The service provider will be auto-discovered. If you need to register it manually:

// config/app.php
'providers' => [
    // ...
    MrShaneBarron\InfiniteScroll\InfiniteScrollServiceProvider::class,
];

Usage

Livewire Component

<livewire:ld-infinite-scroll />

Blade Component

<x-ld-infinite-scroll />

With Props

<x-ld-infinite-scroll
    :threshold="200"
    loadingText='Loading...'
    endText='No more items'
/>

Props

Prop	Type	Default	Description
threshold	number	200	Pixels from bottom to trigger load
loadingText	string	'Loading...'	Text shown while loading
endText	string	'No more items'	Text shown when no more items

Configuration

Publish the config file:

php artisan vendor:publish --tag=ld-infinite-scroll-config

This will create a config/ld-infinite-scroll.php file where you can customize default values.

Customization

Publishing Views

Customize the component appearance by publishing the views:

php artisan vendor:publish --tag=ld-infinite-scroll-views

Views will be published to resources/views/vendor/ld-infinite-scroll/.

Styling

The component uses Tailwind CSS classes by default. You can customize styles by:

1. Publishing views and modifying the Blade templates
2. Using the class attribute to add custom classes
3. Overriding default styles in your CSS

<x-ld-infinite-scroll class="custom-class" />

Events

The component dispatches Livewire events you can listen to:

Event	Payload	Description
infinite-scroll:updated	Component data	Fired when state changes
infinite-scroll:initialized	Initial data	Fired on component mount

// In your Livewire component
protected $listeners = ['infinite-scroll:updated' => 'handleUpdate'];

public function handleUpdate($data)
{
    // Handle the update
}

Alpine.js Integration

The component works seamlessly with Alpine.js:

<div x-data="{ ' }} selected: null {{ ' }">
    <x-ld-infinite-scroll x-model="selected" />
    <p x-text="selected"></p>
</div>

Requirements

• PHP 8.1+
• Laravel 10.x, 11.x, or 12.x
• Livewire 3.x
• Tailwind CSS 3.x (optional, for default styling)

Testing

composer test

Changelog

Please see CHANGELOG for recent changes.

Contributing

Contributions are welcome! Please see CONTRIBUTING for details.

Security

If you discover a security vulnerability, please email [e-mail] instead of using the issue tracker.

Credits

• Shane Barron
• All Contributors

License

The MIT License (MIT). Please see License File for more information.