Core

Entries

Všechny typy entries, které infolist může držet, jaký stav která očekává a jako co ho vykreslí.

Entry je jeden fakt o záznamu. Po které třídě sáhnete, rozhoduje to, co hodnota je — řetězec, stav s barvou, boolean, seznam, obrázek, diff — a všechny sdílejí slovník popisku, ikony, barvy, velikosti a viditelnosti z Foundation.

TextEntry

Výchozí entry. Sdílí kanonický concern FormatsState se sloupci tabulek, takže money(), numeric(), date(), dateTime() a since() formátují hodnotu přesně jako odpovídající TextColumn.

TextEntry::make('total')->money('Kč');                 // 1 234 Kč
TextEntry::make('weight')->numeric(2);                  // 1 234,50
TextEntry::make('created_at')->date();                  // 20.06.2026
TextEntry::make('updated_at')->dateTime()->since();     // 3 hours ago
 
TextEntry::make('status')->badge()->color(Color::Success);
TextEntry::make('email')->icon('envelope')->copyable();
TextEntry::make('bio')->limit(120);
TextEntry::make('name')->weight('bold');                // normal|medium|semibold|bold|light
TextEntry::make('notes')->prose();                      // dlouhý text, prose stylování
TextEntry::make('tags')->bulleted();                    // array → odrážkový seznam
TextEntry::make('aliases')->listWithLineBreaks();       // array → seznam oddělený řádky

TextEntry API

BadgeEntry

Prvotřídní TextEntry přednastavený na vykreslení jako badge — ergonomická forma TextEntry::make(...)->badge(). Dědí plné TextEntry API (barva, ikona, formátování), takže badge chrome zůstane vlastněno na jednom místě.

use NyonCode\WireCore\Infolists\Components\BadgeEntry;
 
BadgeEntry::make('status')
    ->color(fn ($state) => $state === 'active' ? Color::Success : Color::Gray)
    ->icon('check-circle');

IconEntry

Vykreslí ikonu odvozenou ze stavu. Použijte boolean() pro true/false nebo icons() pro mapu hodnota → ikona.

IconEntry::make('is_verified')->boolean();              // ✓ success / ✕ danger
 
IconEntry::make('is_active')
    ->boolean()
    ->trueIcon('check-badge')->trueColor('success')
    ->falseIcon('no-symbol')->falseColor('gray');
 
IconEntry::make('status')
    ->icons(['draft' => 'pencil', 'published' => 'check', 'archived' => 'archive-box'])
    ->colors(['draft' => 'gray', 'published' => 'success', 'archived' => 'warning']);

IconEntry API

BooleanEntry

Prvotřídní IconEntry přednastavený na boolean režim — ergonomická forma IconEntry::make(...)->boolean(). Truthy stav vykreslí success check ikonu, falsy stav danger x ikonu; ikony a barvy zůstanou přepsatelné.

use NyonCode\WireCore\Infolists\Components\BooleanEntry;
 
BooleanEntry::make('is_verified');
 
BooleanEntry::make('is_active')
    ->trueIcon('check-badge')->trueColor('success')
    ->falseIcon('no-symbol')->falseColor('gray');

ListEntry

Vykreslí kolekční stav jako odrážkový seznam nebo řadu badge chipů — střední cesta mezi jednou TextEntry a plnou RepeatableEntry. Stav může být array/iterable nebo oddělovaný řetězec rozdělený separator(). Položky znovupoužívají TextEntry formátování (číslo/měna/datum, formatStateUsing(), limit()).

use NyonCode\WireCore\Infolists\Components\ListEntry;
 
ListEntry::make('tags');                                  // odrážkový seznam
 
ListEntry::make('tags')->badge()->color('primary');       // badge chipy
 
ListEntry::make('roles')->separator(',');                 // "admin, editor" → dvě položky
 
ListEntry::make('categories')->badge()->limitList(3);     // první 3 chipy + pilulka "+N"

ListEntry API

ImageEntry

Vykreslí stav jako jeden nebo více obrázků. Absolutní/data URL se použijí doslovně; relativní cesty resolvují přes nakonfigurovaný disk().

ImageEntry::make('avatar')->circular()->imageSize(56);
 
ImageEntry::make('logo')->disk('public')->defaultImageUrl('/img/placeholder.png');
 
ImageEntry::make('gallery')->stacked()->imageSize(40);  // array stav → překrytá galerie

ImageEntry API

ColorEntry

Vykreslí vzorek plus hodnotu barvy, volitelně kopírovatelnou.

ColorEntry::make('brand_color')->copyable();

Formátovaná hodnota se zobrazí jako text, ale vzorek se vykreslí jen tehdy, když projde seznamem povolených CSS barev: hex, rgb()/rgba(), hsl()/hsla() nebo samotné klíčové slovo CSS barvy. Nepodporované nebo nebezpečné hodnoty nevytvoří vzorek, místo aby se vložily do atributu style. copyable() pochází ze sdílené schopnosti kopírovatelného entry.

ColorEntry API

->getSwatch(): ?string              // bezpečná CSS barva, nebo null, pokud nejde o přijatou barvu

KeyValueEntry

Vykreslí array nebo iterable (včetně JSON-cast atributu) jako tabulku klíč/hodnota. Vnořené hodnoty se zakódují jako JSON; prázdný nebo neiterovatelný stav vykreslí placeholder entry.

KeyValueEntry::make('meta')
    ->keyLabel('Attribute')
    ->valueLabel('Value');

KeyValueEntry API

->keyLabel(string $label): static       // popisek hlavičky — výchozí 'Key'
->getKeyLabel(): string
->valueLabel(string $label): static     // popisek hlavičky — výchozí 'Value'
->getValueLabel(): string
->getPairs(): array                     // normalizované dvojice; neiterovatelný stav se změní na []

HtmlEntry

Uložený obsah z editoru vytištěný jako markup, ne jako escapovaný text, se všemi zmínkami v něm dohledanými při vykreslení.

use NyonCode\WireCore\Infolists\Components\HtmlEntry;
 
HtmlEntry::make('body')
    ->zone('business');     // kam vedou zmínky, když resource routuje po zónách

Je to záměrně samostatná entry, ne přepínač na TextEntry: textová entry escapuje a escapovat musí dál. Vytisknout markup je rozhodnutí, které aplikace dělá vědomě a o sloupci, který má pod kontrolou — takže je to jiné jméno, ne přepínač, který potichu vypne escapování.

Zmínky se čtou znovu, nepřehrávají se. @člověk nebo #článek uložený v dokumentu nese identitu, ne jméno a odkaz, takže je entry při každém vykreslení dohledá znovu: přejmenovaný záznam se tu čte přejmenovaně a zmínka, jejíž záznam je pryč (nebo na něj čtenář nemá právo), degraduje na prostý text místo mrtvého odkazu. zone() je to, co předá stránka, která si v mount() přečetla Zone::current(), aby odkazy mířily do místa, kde čtenář právě je; bez ní vedou přes výchozí zónu. Zapisovací polovinu popisuje TiptapEditor → Zmínky.

->zone(?string $zone)             // zóna, ve které se odkazy zmínek dohledávají
->getRenderedHtml(): string       // dokument se všemi dohledanými zmínkami

RepeatableEntry

Vykreslí vnořené schéma entries jednou pro každou položku iterovatelného stavu — hasMany relace nebo pole řádků.

RepeatableEntry::make('items')
    ->columns(3)
    ->schema([
        TextEntry::make('label')->weight('medium'),
        TextEntry::make('price')->money('Kč'),
        TextEntry::make('qty')->numeric(),
    ]);

RepeatableEntry API

->schema(array $components): static       // Entry objekty vykreslené pro každou položku
->getSchema(): array
->columns(int $columns): static            // sloupce mřížky položky — výchozí 1
->getColumns(): int
->contained(bool $condition = true): static // zabalit každou položku do orámované karty — výchozí true
->isContained(): bool
->with(array|string $relations): static    // eager-load relací; opakovaná volání se sloučí bez duplicit
->getWith(): array
->getRowItems(): array                     // seznam položek stavu přeindexovaných od nuly
->getRows(): array                         // seznam naklonovaných podřízených entries navázaných na položku

Akce pro každý řádek actions(array $actions) se dědí ze sdíleného API entry; viz Akce infolistu.

Předcházení N+1 na řádcích relace

Když jsou řádky Eloquent modely, jejichž dětské entries čtou vnořenou cestu relace (např. product.name na každém řádku objednávky), čtení té cesty načte relaci líně, jednou pro každý řádek — N+1. Deklarujte relace pomocí with() a načtou se eager loadem přes všechny řádky v jednom dotazu před renderem:

RepeatableEntry::make('lines')
    ->with(['product', 'tax'])              // jeden dotaz na relaci, ne na řádek
    ->schema([
        TextEntry::make('product.name'),
        TextEntry::make('tax.rate')->numeric(2),
    ]);

with() je no-op pro array řádky a slučuje se napříč opakovanými voláními. (Relace, která pohání samotné repeatable — lines — by měla být načtená eager loadem na rodičovském dotazu jako obvykle.)

ChangesEntry

Vykreslí rozdíl před/po jako jednu tabulku — řádek na každé pole, které se pohnulo, stará a nová hodnota vedle sebe a barevně, s jednou sadou záhlaví pro celý rozdíl.

ChangesEntry::make('changes');

Sáhněte po něm všude, kde se zaznamenává, co se změnilo: záznam auditu, revize, výsledek synchronizace. Právě tohle kreslí stránka záznamu v modulu auditu a totéž kreslí slide-over s auditní stopou nad záznamem — stejná tabulka, takže rozdíl se čte v obou místech stejně.

Co přijímá jako stav

Dva tvary, a rozliší si je sám, protože volající má jeden z nich a oba znamenají totéž:

• mapu {old, new}, kterou produkuje záznam auditu — ['status' => ['old' => 'draft', 'new' => 'sent']]
• řádky, které už jsou {field, before, after}

Tak či tak hodnoty projdou přes NyonCode\WireCore\Foundation\ValueObjects\ChangeSet, který vlastní jak se uložená hodnota čte: null zůstane null, aby renderer mohl říct (prázdné), boolean se píše true / false místo 1 a ničeho, a pole je JSON s ponechanými lomítky i diakritikou.

Ten jediný vlastník je pointa. To pravidlo bývalo napsané dvakrát — jednou v modulu auditu a jednou v Blade ternáru ve stopě — a ta kopie, na kterou nedosáhl žádný test, tiskla booleany jako 1.

V kontextu

use NyonCode\WireCore\Foundation\Schema\Section;
use NyonCode\WireCore\Infolists\Components\ChangesEntry;
use NyonCode\WireCore\Infolists\Components\TextEntry;
 
public function infolist(Infolist $infolist): Infolist
{
    return $infolist->schema([
        Section::make('what-happened')->label('Co se stalo')->columns(2)->schema([
            TextEntry::make('event')->badge(),
            TextEntry::make('created_at'),
        ]),
 
        Section::make('changes')->label('Změny')->schema([
            ChangesEntry::make('changes')                                  
                // Stavem je rozdíl, nikdy záznam: předejte dvojice,
                // nebo řádky, které jste si už postavili.
                ->state(fn ($record): array => $record->getChangeDiff())
                ->hiddenLabel()
                ->placeholder('Žádné pole se nezměnilo.'),                 
        ]),
    ]);
}

dense() ho nakreslí o velikost menší — pro rozdíl, který je uvnitř něčeho jiného doprovodným důkazem, ne předmětem stránky. Přesně tak ho kreslí slide-over s auditní stopou.

ChangesEntry API

->dense(bool $dense = true)           // menší písmo, pro rozdíl uvnitř slide-overu nebo timeline
->isDense(): bool
->getRows(): array                    // [['field' => string, 'before' => ?string, 'after' => ?string], ...]

Všechno ostatní — label(), hiddenLabel(), state(), placeholder(), columnSpan(), visible() — je sdílená plocha entry popsaná výše.

Vlastní entry

Pro hodnotu, kterou žádná z entry výše nenakreslí, napište třídu entry a její pohled:

php artisan make:wire-entry Money

zapíše app/Infolists/Components/MoneyEntry.php — Entry, jehož jedinou povinností je viewName() — a pohled, který jmenuje:

namespace App\Infolists\Components;
 
use NyonCode\WireCore\Infolists\Components\Entry;
 
class MoneyEntry extends Entry
{
    protected function viewName(): string
    {
        return 'infolists.entries.money';
    }
}

{{-- resources/views/infolists/entries/money.blade.php --}}
@php
    $value = $field->getFormattedState();
@endphp
 
<div class="{{ $field->getColumnSpanClass() }}" @wireExtraAttributes($field)>
    @if($field->hasVisibleLabel()) 
        @include('wire-core::partials.entry-label', ['text' => $field->getLabel()])
    @endif 
 
    <div class="text-sm text-gray-900 dark:text-white">
        @if($value !== '-' && $value !== '')
            {{ $value }}
        @else
            <span class="text-gray-400">{{ $field->getPlaceholder() ?? '-' }}</span>
        @endif
    </div>
 
    @if($field->hasActions())@include('wire-core::infolists.entry-actions')@endif 
</div>

Pohled dostane entry jako $field a label, šířku sloupce, extra atributy a akce entry kreslí stejnými partialy jako vestavěné entry, takže s nimi lícuje. Stav čtěte přes getFormattedState(), které uplatní formatStateUsing() a ostatní. Existující pohled se nikdy nepřepíše, --force nahradí jen třídu a php artisan vendor:publish --tag=wire-core::stubs vám dovolí změnit, co zapisuje.

Související

• Infolisty — objekt, do kterého se tyhle entries skládají
• Akce — jak vedle nich postavit tlačítko
• Sloupce — tabulkové protějšky sdílející tytéž povrchy
• Editovatelné panely — entries, které zapisují zpět