MarkdownEditor

Markdown editor s toolbarovými zkratkami a volitelným live náhledem. Ukládá prostý Markdown text.

use NyonCode\WireForms\Components\MarkdownEditor;

Základní použití

MarkdownEditor::make('description')
    ->minHeight(300)

S náhledovou záložkou

MarkdownEditor::make('content')
    ->withPreview()    // výchozí — přidá přepínač záložek Write / Preview

Náhled vedle sebe

MarkdownEditor::make('article')
    ->livePreview()    // editor a náhled vykreslené vedle sebe

Bez náhledu

MarkdownEditor::make('notes')
    ->withPreview(false)

Limit znaků

MarkdownEditor::make('bio')
    ->maxLength(500)   // zobrazí počítadlo a vynutí limit

Toolbarové zkratky

Toolbar poskytuje klávesnicí přístupná tlačítka pro:

Vykreslení náhledu

Vestavěný náhled zvládá: nadpisy (#, ##, ###), bold/italic/strikethrough, inline kód, odkazy, blockquoty a neseřazené/seřazené seznamy. Pro plné GFM vykreslení uložený Markdown post-processujte na straně serveru knihovnou jako CommonMark.

Náhled běží v prohlížeči a zapisuje se přes x-html, takže syrové HTML v Markdownu se escapuje, nevykresluje: <img src=x onerror=…> se zobrazí jako text. URL odkazů jsou navíc omezené na http(s):, mailto:, # a cesty od kořene — cokoli jiného se změní na #, takže přes náhled nelze podstrčit javascript: odkaz.

Lokalizace

Tooltipy toolbaru i popisky záložek Psát/Náhled pocházejí ze sdílené slovní zásoby editorů wire-forms::fields.editor.* — ze stejných klíčů, jaké používají TiptapEditor a RichEditor, takže všechny tři editory zní v každém jazyce stejně. Angličtina (en) a čeština (cs) jsou součástí balíčku; česká aplikace zobrazí Tučné, Kód v textu a záložky Psát / Náhled.

Formulaci změníte (nebo přidáte další jazyk) publikováním překladů a úpravou lang/vendor/wire-forms/{locale}/fields.php:

php artisan vendor:publish --tag=wire-forms::translations

Metody

Popisek, hint, tooltip a další sdílené metody viz Společné API pole.