Momentum Modal (React)

Momentum Modal is a package that lets you implement backend-driven modal dialogs for Inertia apps with React.

Installation

First you need to install the Laravel package. You can find the full documentation of Momentum Modal here.

Then install the react adapter:

npm i momentum-modal-react

Warning The package utilizes axios under the hood. If your app is already using axios as a dependency, make sure to lock it to the same version Inertia uses.

npm i axios@1.2.0

Setup

Modal is a headless component, meaning you have full control over its look, whether it's a modal dialog or a slide-over panel. You are free to use any 3rd-party solutions to power your modals, such as Headless UI or Radix.

Put the Modal component somewhere within the layout. Also, you can pass the component resolver to the Modal component, or use it globally.

Global

// app.jsx
...
globalThis.resolveMomentumModal = (name) => {
    const modals = import.meta.glob("./modals/**/*.jsx", {eager: true});
    return modals[`./modals/${name}.jsx`];
};
createInertiaApp(...)
...

// YourLayout.jsx
import {Modal} from 'momentum-modal-react';

export function YourLayout({children}) {
  return <>
    {children}
    <Modal/>
  </>
}

In the component

// YourLayout.jsx
import {Modal} from 'momentum-modal-react';

const resolver = (name) => {
  const modals = import.meta.glob('../path/to/your/modals/**/*.jsx', {eager: true});
  return modals[`../path/to/your/modals/${name}.jsx`];
};

export function YourLayout({children}) {
  return (
    <>
      {children}
      <Modal resolver={resolver} />
    </>
  );
}

The resolver can be the same you use to render Inertia pages.

Usage

Modals have their own routes, letting you access them even via direct URLs. Define routes for your modal pages.

// background context / base page
Route::get('{user}', ShowUser::class)
    ->name('users.show');

// modal route
Route::get('{user}/{tweet}', ShowTweet::class)
    ->name('users.tweets.show');

Render a modal from a controller. Specify the base route to render the background when the modal is accessed directly.

class ShowTweet extends Controller
{
    public function __invoke(User $user, Tweet $tweet)
    {
        return Inertia::modal('Tweets/Show')
            ->with([
                'user' => $user,
                'tweet' => $tweet,
            ])
            ->baseRoute('users.show', $user);
    }
}

Credits

• Creator of the original Laravel and Vue 3 packages Boris Lepikhin
• Jose María Gómez
• All Contributors

License

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