Clicks and selections

The calendar can report clicks on dates, events and empty list views back to your widget. All of these are disabled by default. Once you enable one, a request is sent to livewire every time it happens, so only enable what you actually use.

For each click type you can either implement your own handler, or use the context menu feature. If both are present, the context menu wins.

Date click

Triggered when a date cell is clicked. Enable it first:

protected bool $dateClickEnabled = true;

Then override the onDateClick method:

use Guava\Calendar\ValueObjects\DateClickInfo;

protected function onDateClick(DateClickInfo $info): void
{
    // For example, mount a create action
    $this->mountAction('createFoo');
}

The DateClickInfo gives you the clicked date, whether it was an allDay cell, the current view and the resource if you clicked inside a resource view.

Date selection

Triggered when the user drags across date cells to make a selection. Enable it first:

protected bool $dateSelectEnabled = true;

Then override the onDateSelect method:

use Guava\Calendar\ValueObjects\DateSelectInfo;

protected function onDateSelect(DateSelectInfo $info): void
{
    $this->mountAction('createFoo');
}

The DateSelectInfo gives you the start and end of the selection, which is great for prefilling the dates of a create form through mountUsing, see accessing context information.

Event click

Triggered when an event is clicked. Enable it first:

protected bool $eventClickEnabled = true;

Unlike the other clicks, this one does something by default: it mounts the view action with the clicked record. You can change the default action:

protected ?string $defaultEventClickAction = 'edit';

It can be any action defined in your widget, even your own custom ones. Individual events can also override it via action().

To take full control instead, override the onEventClick method:

use Guava\Calendar\ValueObjects\EventClickInfo;
use Illuminate\Database\Eloquent\Model;

protected function onEventClick(EventClickInfo $info, Model $event, ?string $action = null): void
{
    // $event contains the clicked record, also available as $info->record
}

No events click

Triggered when a list view has no events and its empty content is clicked. Enable it first:

protected bool $noEventsClickEnabled = true;

Then override the onNoEventsClick method:

use Guava\Calendar\ValueObjects\NoEventsClickInfo;

protected function onNoEventsClick(NoEventsClickInfo $info): void
{
    $this->mountAction('createFoo');
}

Security

The info objects are built from data sent by the browser, so they can be tampered with. Always validate on the server side and never trust the data blindly.