Panely

wire-panels je vrstva nad komponentami. Tabulka, formulář a infolist jsou nezávislé primitivy, které o sobě navzájem nevědí; tenhle balíček přidává třídu, která říká, že je to všechno jedna entita, a stránky, menu a routy, které z toho jednoho prohlášení plynou.

composer require nyoncode/wire-panels

Nic tenhle balíček nevyžaduje. Aplikace, která své tabulky a formuláře vykresluje z vlastních Livewire komponent, ho nikdy nenainstaluje a všechno pod ním funguje dál — což je zkouška toho, jestli je vlastnická vrstva opravdu volitelná.

Jak to funguje

Čtyři věci stojí na sobě a každá z nich je použitelná i bez té nad sebou:

Resource bez stránek je pořád zaregistrovaný a pořád introspektovatelný. Stránky fungují i bez resourcu — napište na stránku table() a je to obyčejná komponenta s WithTable. Položka menu, jejíž klíč nikam neroutuje, se vykreslí bez odkazu místo toho, aby spadla. Každá vrstva degraduje na tu pod sebou, místo aby ji vyžadovala.

Pohromadě je drží registr názvů tříd, ne objekt panelu. Nic tady nestaví tabulku, aby odpovědělo na otázku „co je v menu“: identita je statická, povrchy jsou instanční metody a menu o čtyřiceti resourcech nesestaví ani jeden z nich.

Co veze který balíček

Resource je deklarovaný napříč balíčky, které vlastní typy, jež jmenuje — takže aplikace instaluje jen to, co její resource opravdu používají:

Praktický důsledek: resource s formulářem a bez výpisu potřebuje wire-forms a nic víc. Identita přichází z wire-core, který si wire-forms už tak jako tak vyžaduje, takže deklarace resourcu nikdy nepřitáhne tabulkový balíček — včetně jeho assetů, migrací, configu a Livewire synthesizeru.

wire-panels sedí nad každým komponentovým balíčkem a nic na něm nezávisí. Ten směr je smyslem věci: resource skládá primitivy, takže balíček, který vlastní resource, je ten, který smí jmenovat všechny ostatní — a žádný z nich nesmí jmenovat jeho.

Rychlý start

Jedna entita, deklarovaná jednou, vykreslená stránkou o čtyřech řádcích:

use App\Models\Order;
use NyonCode\WireCore\Core\Resources\Concerns\DescribesRecords;
use NyonCode\WireCore\Core\Resources\Contracts\DescribesResource;
use NyonCode\WirePanels\Resources\Contracts\ProvidesResourceTable;
use NyonCode\WirePanels\Resources\Pages\ListPage;
use NyonCode\WireTable\Columns\TextColumn;
use NyonCode\WireTable\Table;
 
final class OrderResource implements DescribesResource, ProvidesResourceTable
{
    use DescribesRecords;
 
    public static function modelClass(): ?string   
    {
        return Order::class;
    }
 
    public function table(Table $table): Table
    {
        return $table->columns([
            TextColumn::make('number')->searchable(),
            TextColumn::make('customer.name')->label('Zákazník'),
        ]);
    }                                              
}
 
final class ListOrders extends ListPage
{
    protected static ?string $resource = OrderResource::class;   
}

// config/wire-core.php
'resources' => [
    App\Resources\OrderResource::class,
],

To je funkční výpis. Doplnění formuláře rozjede založení a editaci, doplnění navigation() ho dá do menu, deklarace pages() mu dá URL — každé zvlášť a v tomhle pořadí.

Co tenhle balíček nedělá

Neveze žádný layout, žádné markup sidebaru a žádný chrome dashboardu. Celostránková Livewire komponenta layout potřebuje a tenhle balíček ho nedodává — buď nastavte livewire.component_layout na vlastní, nebo nainstalujte admin shell, což je hotová odpověď a přesně proto samostatný balíček.

V této sekci

Jak dosáhnout na stránku, kterou posílá modul

Každá resource stránka implementuje IdentifiesHookTarget, takže plugin hook jde zúžit na resource, který ukazuje — for: 'invoices' dosáhne na list, formulář i detail toho modulu a na nic jiného. Stránka sama má taky svůj hook: page.mounting se spustí, jakmile se namountuje.

Běží poslední, a to je měření, ne preference: Livewire volá vlastní mount() komponenty dřív než mount{Trait} hooky, takže edit stránka už má vyřešený záznam a naplněný formulář — a proto callback může přidat klíč do state bagu, místo aby ho naplnění přepsalo.

Stránku měňte přes její veřejnou plochu. Namountuje se jednou a každý další update odpovídá ze snapshotu, který nese jen veřejné properties — stav zapsaný jinam je správný na prvním vykreslení a na druhém je pryč.

$manager->hook(Hook::PageMounting, function (PageMountingPayload $payload) {
    $payload->page->data['team_id'] = auth()->user()->team_id;   
 
    return $payload;
}, for: 'invoices');

$payload->title je ze stejného důvodu jen ke čtení: $title stránky je protected, takže hook, který by ho nastavil, by nabízel přesně tuhle past.

Související

• Admin shell — volitelný layout, uvnitř kterého se tyhle stránky vykreslují
• Hotové moduly — celé oblasti dodané jako balíčky, postavené na téhle vrstvě
• Globální vyhledávání — command palette nad stejným katalogem
• Konfigurace — kde se deklaruje resources a wire-panels.routes