putyourlightson/datastar-php

A set of PHP helper classes for working with Datastar.

1.0.3 2024-11-05 19:17 UTC

This package is auto-updated.

Last update: 2024-11-05 19:17:33 UTC


README

A dependency-free set of PHP helper classes for working with Datastar.

License

This plugin is licensed for free under the MIT License.

Requirements

This plugin requires Datastar 0.19.3 or later and PHP 8.0.0 or later.

Installation

Install using composer or download and require the classes manually.

composer require putyourlightson/datastar-php

Usage

Datastar Event Class

use putyourlightson\datastar\events\FragmentEvent;
use putyourlightson\datastar\events\SignalEvent;
use putyourlightson\datastar\events\DeleteEvent;
use putyourlightson\datastar\events\RedirectEvent;
use putyourlightson\datastar\events\ConsoleEvent;

$event = new FragmentEvent();
$event->content = '<div id="primary">New content</div>';
// Optional
$event->id = 1;
$event->selector = '#secondary';
$event->merge = 'morph';
$event->settle = 100;
$event->vt = 'false';

$event = new SignalEvent();
$event->store = '{foo: "bar"}';
// Optional
$event->id = 1;
$event->onlyIfMissing = 'true';

$event = new DeleteEvent();
$event->selector = '#primary';
// Optional
$event->id = 1;

$event = new RedirectEvent();
$event->content = '/new-url';
// Optional
$event->id = 1;

$event = new ConsoleEvent();
$event->content = 'Hello world';
// Optional
$event->id = 1;
$event->mode = 'error';

// Returns the output of a Datastar event.
$output = $event->getOutput();

Datastar Response Class

use putyourlightson\datastar\DatastarResponse;

$response = new DatastarResponse();

// Sends Datastar events to the browser.
$response->sendEvent($event1);
$response->sendEvent($event2);
$response->sendEvent($event3);

// Ends the response and closes the connection.
$response->end();

Created by PutYourLightsOn.