K

Formuláře

RichEditor

Pole pro formátovaný text s konfigurovatelnou lištou — pro HTML psané někým, kdo HTML nepíše.

Na této stránce

Rich text editor s konfigurovatelným toolbarem.

use NyonCode\WireForms\Components\RichEditor;

Použití

RichEditor::make('content')
->toolbarButtons([
'bold', 'italic', 'underline',
'h2', 'h3',
'bulletList', 'orderedList',
'link', 'blockquote',
])

Výchozí toolbar

Když není zavoláno toolbarButtons() (a není přepsán config), výchozí toolbar je:

Klíč tlačítka Popis
bold Tučné
italic Kurzíva
underline Podtržení
strike Přeškrtnutí
h2 Nadpis 2
h3 Nadpis 3
bulletList Neseřazený seznam
orderedList Seřazený seznam
link Hypertextový odkaz
blockquote Blokový citát
codeBlock Blok kódu
undo Zpět
redo Znovu

Výchozí lze přepsat globálně přes config('wire-forms.rich_editor.toolbar').

Znepřístupnit konkrétní tlačítka

RichEditor::make('content')
->disableToolbarButtons(['codeBlock', 'attachFiles'])

Znepřístupnit všechna tlačítka

RichEditor::make('content')
->disableAllToolbarButtons() // prostý rich text, bez toolbaru

Limit znaků

RichEditor::make('summary')
->maxLength(500)

Lokalizace

Tooltipy toolbaru i prompt pro odkaz pocházejí ze sdílené slovní zásoby editorů wire-forms::fields.editor.* — ze stejných klíčů, jaké používají TiptapEditor a MarkdownEditor, 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é, Číslovaný seznam, Nadpis 2 a prompt URL odkazu.

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

Metoda Typ Popis
toolbarButtons(array) array Nahradit toolbar touto sadou tlačítek
disableToolbarButtons(array) array Odstranit konkrétní tlačítka z toolbaru
disableAllToolbarButtons() Nezobrazovat toolbar (prostý rich text)
maxLength(int|null) int Limit znaků
disabled(bool|Closure) bool Znepřístupnit editor
readOnly(bool|Closure) bool Read-only režim
required() Označit jako povinné

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