Čitateľné popisy

readable() prevedie prípad na čitateľný popis: hodnotu backed enumu — alebo názov prípadu pri čistom enume — spracuje cez Str::headline() a výsledok potom vyhľadá v prekladači Laravelu pre aktuálny jazyk. Ak preklad neexistuje, vráti samotný výsledok Str::headline(). label() je alias pre kód UI, ktorý uprednostňuje tento názov:

NewsCategory::HotNews->readable(); // "Hot News"
NewsCategory::HotNews->label();    // "Hot News"

enum Status { use Helpers; case Active; }

Status::Active->readable(); // "Active"

Ako z hodnôt vznikajú popisy

Popis vzniká z hodnoty, nie z názvu prípadu, preto voľte hodnoty, ktoré sa dobre čítajú — alebo ich preložte. Všetky ostatné metódy s popismi — labels(), toOptions(), toArray(), options(), fromLabel() a tryFromLabel() — idú cez readable(), takže vlastný alebo preložený popis sa prejaví všade naraz.

Popisy pochádzajú z prekladača aplikácie, takže metódy, ktoré ich vytvárajú, potrebujú spustenú Laravel aplikáciu. Ak výsledok Str::headline() náhodou pomenúva celú prekladovú skupinu namiesto jedného riadku — „Auth“ na súborovom systéme bez rozlišovania veľkosti písmen zodpovedá súboru lang/en/auth.php — vráti sa nepreložený text, nie celá skupina.

Všetky popisy naraz

NewsCategory::labels()->all(); // ['Hot News', 'Regular News', 'Private News']