---
title: Document.execCommand()
slug: Web/API/Document/execCommand
tags:
- API
- DOM
- Method
- NeedsBrowserCompatibility
- NeedsExample
- Reference
- edytor
translation_of: Web/API/Document/execCommand
---
Kiedy dokument HTML jest przełączony w tryb designMode
, obiekt dokumentu udostępnia metodę execCommand
, która pozwala uruchomić komendy manipulujące edytowalnym obszarem. Większość poleceń wpływa na zaznaczony obszar (pogrubienie, kursywa itd.), podczas gdy inne wstawiają nowe elementy (dodawanie linku) lub wpływają na całą linię (wcięcia). Przy użyciu contentEditable
, wywołanie execCommand()
wpływa na aktywny edytowalny element.
Składnia
bool = document.execCommand(aCommandName, aShowDefaultUI, aValueArgument)
Zwracane wartości
Obiekt {{jsxref('Boolean')}}, który zwraca false
, jeśli polecenie jest niewspierane lub włączone. Uwaga: Zwraca prawdę tylko jeśli jest częścią UI, to znaczy - nie jest używana do sprawdzania wsparcia przeglądarki przed renderowaniem elementu, który wywołuje polecenie.
Parametry
aCommandName
- Typu {{domxref("DOMString")}} - określanazwę polecenia do wykonania. Zobacz {{anch("Commands")}}, aby wyświetlić listę poleceń.
aShowDefaultUI
- Typu {jsxref("Boolean")}} - wskazuje czy domyślny interfejs użytkownika powinien być pokazany. Nie jest implementowane przez Mozillę.
aValueArgument
- W przypadku komend wymagających wprowadzenia argumentu (takiego jak
insertImage
, gdzie jest to URL do grafiki do wstawienia), jest to {{domxref("DOMString")}} przekazujący te informacje. Podaj null, jeśli niewymagany.
Polecenia
backColor
- Zmienia kolor tła. W trybie
styleWithCss
zmieia kolor jedynie zawierającego elementu. Wymaga podania ciągu znaków{{cssxref("<color>")}} jako wartości argumentu. Zwróć uwagę na to, że Internet Explorer używa tego do zmiany koloru tła tekstu.
bold
- Włącza/wyłącza pogrubienie w zaznaczeniu lub miejscu wstawiania. IE używa znacznika {{HTMLElement("strong")}} zamiast {{HTMLElement("b")}}.
contentReadOnly
- Sprawia, że dokument jest zawartość jest tylko do odczytu lub edytowalna. Wymaga prawdy/fałszu jako wartości argumentu. (Nie wspierany przez IE).
copy
- Kopiuje zaznaczenie do schowkka. Warunki włączenia tego zachowania różnią się między przeglądarkami i zmieniają się w czasie. Sprawdź tabelę zgodności, aby określić, czy możesz użyć w swoim przypadku.
createLink
- Wstawia link z zaznaczenia (wymaga zaznaczenia). HREF URI musi być podany jako wartość argumentu. URI musi zawierać co najmniej jeden zak, może być białym znakiem (IE utworzy link z wartością null).
cut
- Usuwa zaznaczenie kopiując do schowka. Warunki włączenia tego zachowania różnią się między przeglądarkami i zmieniają się w czasie. Sprawdź tabelę zgodności, aby określić, czy możesz użyć w swoim przypadku.
decreaseFontSize
- Wstawia znacznik {{HTMLElement("small")}} wokół zaznaczenia lub w miejscu wstawienia. (Nie wspierane przez IE.)
defaultParagraphSeparator
- Zmienia separator akapitu używany podczas tworzenia nowych akapitów w edytowalnych regionach tekstowych. Zobacz Differences in markup generation po więcej szczegółów.
delete
- Usuwa zaznaczenie.
enableInlineTableEditing
- Włącza lub wyłącza wstawianie wierszy i kolumn oraz elementy sterujące usuwaniem. (Nie obsługiwane przez Internet Explorer.)
enableObjectResizing
- Umożliwia lub uniemożliwia zmianę rozmiaru uchwytów na obrakach lub innych skalowalnych obiektów. (Nie wspierane przez IE)
fontName
- Zmienia nazwę czcionki dla zaznaczenia lub w punkcie wstawiania. Wymaga ciągu znaków (np.
"Arial"
) jako wartości argumentu.
fontSize
- Zmienia rozmiar czcionki dla zaznaczenia lub w punkcie wstawiania. Wymaga rozmiaru czcionki HTML (
1
-7
) jako wartości argumentu.
foreColor
- Zmienia kolor czcionki dla zaznaczenia lub w punkcie wstawiania. Wymaga wartości koloru (w postaci ciągu znaków) jako wartości argumentu.
formatBlock
- Wstawia tag stylu blokowego dla linii w zaznaczeniu, zastępując blokowy element zawierający linię, jeśli taki istnieje (w Firefoxie, BLOCKQUOTE jest wyjątkiem - zawinie blokowy element zawierający). Wymaga ciągu znaków oznaczającego znacznik jako wartość argumentu. Można użyć praktycznie wszystkich (np. "H1", "P", "DL", "BLOCKQUOTE). (IE wspiera jedynie H1-H6, "ADDRESS", PRE, które jeszcze muszą zawierać nawiasy znaczników <>, tak jak "<h1">).
forwardDelete
- Usuwa znak przed pozycją kursora. Działa jak wciśnięcie klawisza Delete.
heading
- Wstawia tag nagłówka naokoło zaznaczenia lub w miejscu wstawiania. Wymaga ciągu znaków oznaczającego nazwę tagu jako wartości argumentu (np. "H1", "H6"). (Nie wspierane przez IE ani Safari).
hiliteColor
- Zmienia kolor tła dla zaznaczenia lub w miejscu wstawiania. Wymaga ciągu znaków w postaci wartości kolorów jako wartości argumentu. Do użycia tej funkcji jest wymagane użycie CSS. (Nie wspierane przez IE).
increaseFontSize
- Wstawia tag BIG naokoło zaznaczenia lub w miejscu wstawiania. (Nie wspierane przez IE).
indent
- Wcina wiersz zawierający zaznaczenie lub punkt wstawiania. W Firefixie, jeśli zaznaczenie obejmuje wiele linii na różnych poziomach wcięcia, jedynie ostatnie wcięte linie zostaną wcięte.
insertBrOnReturn
- Kontroluje, czy klawisz Enter wstawia tag BR, czy dzieli elemet blokowy na dwa (Nie wspierane przez IE)
insertHorizontalRule
- Wstawia poziomą linię w miejscu wstawiania (usuwa zaznaczenie).
insertHTML
- Wstawia ciąg znaków w postaci kodu HTML (usuwa zaznaczenie). Wymaga poprawnego kodu jako wartość argumentu. (Nie wspierane prze
insertImage
- Wstawia grafikę w punkcie wstawiania (usuwa zaznaczenie). Wymaga ciągu znaków w postaci SRC URI jako wartości argumentu. URI musi zawierać co najmniej jeden znak (może być to biały znak). (Nie wspierane przez IE).
insertOrderedList
- Wstawia numerowaną listę dla zaznaczenia lub w punkcie wstawiania.
insertUnorderedList
- Wstawia punktowaną listę dla zaznaczenia lub w punkcie wstawiania.
insertParagraph
- Wstawia akapit naokoło zaznaczenia lub w danej linii. (IE wstawia akapit w miejscu wstaawiania i usuwa zaznaczenie).
insertText
- Wstawia dany tekst w miejsce wstawiania (usuwa zaznaczenie).
italic
- Włącza/wyłącza pochylenie dla zaznaczenia lub w miejscu wstawiania (IE używa tagu EM zamiast I).
justifyCenter
- Wyśrodkowuje zaznaczenie lub miejsce wstawiania.
justifyFull
- Justuje zaznaczenie lub miejsce wstawiania.
justifyLeft
- Wyrównuje do lewej zaznaczenie lub miejsce wstawiania.
justifyRight
- Wyrównuje do prawej zaznaczenie lub miejsce wstawiaia.
outdent
- Wysuwa linię zawierającą zaznaczenie lub punkt wstawiania.
paste
- Wstawia zawartość schowka w miejscu wstawiania (zastępuje zaznaczenie). Nie działa dla zawartości z internetu. Zobacz [1]
redo
- Ponawia ostatnio cofniętą komendę.
removeFormat
- Usuwa całe formatowanie z zaznaczenia.
selectAll
- Zaznacza całą zawartość z edytowalnego obszaru.
strikeThrough
- Włącza/wyłącza przekreślenie dla zaznaczenia lub w punkcie wstawiania.
subscript
- Włącza/wyłącza indeks dolny dla zaznaczenia lub w punkcie wstawiania.
superscript
- Włącza/wyłącza indeks górny dla zaznaczenia lub w punkcie wstawiania.
underline
- Włącza/wyłącza podkreślenie dla zaznaczenia lub w punkcie wstawiania.
undo
- Cofa ostatnio wykonaną komendę.
unlink
- Usuwa tag kotwicy z zaznaczonego linku.
useCSS
{{Deprecated_inline}}
- Przełącza użycie HTML/CSS dla generowanego kodu. Wymaga prawdy/fałszu jako wartości argumentu. UWAGA: dla CSS wymaga fałszu, dla HTML - prawdy. (Nie jest wspierane przez IE). Deprecjonowana właściwość. Użyj styleWithCSS
styleWithCSS
- Zastępuje useCSS; działa normalnie - dla CSS wymaga prawdy, fałsz generuje HTML.
Example
Zobacz how to use w CodePen.
Specifications
Specification |
Status |
Comment |
{{SpecName('HTML Editing', '#execcommand()', 'execCommand')}} |
{{Spec2('HTML Editing')}} |
Initial definition |
Kompatybilność przeglądarek
{{CompatibilityTable}}
Feature |
Chrome |
Edge |
Firefox (Gecko) |
Internet Explorer |
Opera |
Safari |
Basic support |
{{CompatVersionUnknown}} |
{{CompatVersionUnknown}} |
{{CompatVersionUnknown}}[1] |
{{CompatUnknown}} |
{{CompatUnknown}} |
{{CompatVersionUnknown}} |
insertBrOnReturn |
{{CompatNo}} |
{{CompatNo}} |
{{CompatVersionUnknown}} |
{{CompatNo}} |
{{CompatNo}} |
{{CompatNo}} |
copy /cut |
{{CompatVersionUnknown}} |
{{CompatVersionUnknown}} |
{{CompatGeckoDesktop(41)}} |
9 |
29 |
10 |
defaultParagraphSeparator |
{{CompatVersionUnknown}} |
{{CompatVersionUnknown}} |
{{CompatGeckoDesktop(55)}} |
{{CompatNo}} |
{{CompatVersionUnknown}} |
{{CompatNo}} |
Feature |
Android |
Chrome for Android |
Edge |
Firefox Mobile (Gecko) |
IE Mobile |
Opera Mobile |
Safari Mobile |
Basic support |
{{CompatUnknown}} |
{{CompatVersionUnknown}} |
{{CompatVersionUnknown}} |
{{CompatVersionUnknown}}[1] |
{{CompatUnknown}} |
{{CompatUnknown}} |
{{CompatUnknown}} |
insertBrOnReturn |
{{CompatNo}} |
{{CompatNo}} |
{{CompatNo}} |
{{CompatVersionUnknown}} |
{{CompatNo}} |
{{CompatNo}} |
{{CompatNo}} |
copy /cut |
{{CompatNo}} |
{{CompatVersionUnknown}} |
{{CompatVersionUnknown}} |
{{CompatGeckoMobile(41)}} |
{{CompatUnknown}} |
{{CompatUnknown}} |
{{CompatNo}} |
defaultParagraphSeparator |
{{CompatNo}} |
{{CompatVersionUnknown}} |
{{CompatVersionUnknown}} |
{{CompatGeckoMobile(55)}} |
{{CompatNo}} |
{{CompatVersionUnknown}} |
{{CompatNo}} |
[1] Przed przeglądarką Firefox 41 w pliku preferencji user.js trzeba było włączyć obsługę schowka. Aby uzyskać więcej informacji, zobacz Krótki przewodnik po preferencjach Mozilli. Jeśli polecenie nie było obsługiwane lub włączone, execCommand
rzucał wyjątek zamiast zwracać false
. W Firefoxie 41 i nowszych, schowek może zostać zapisany w dowolnym programie obsługi zdarzeń read the clipboard. WebExtensions can interact with the clipboard.
Przed przeglądarką Firefox 41 w pliku preferencji user.js trzeba było włączyć obsługę schowka. Aby uzyskać więcej informacji, zobacz Krótki przewodnik po preferencjach Mozilli. Jeśli polecenie nie było obsługiwane lub włączone, execCommand podnosił wyjątek zamiast zwracać fałsz. W przeglądarce Firefox 41 i nowszych schowek może zostać zapisany w dowolnej obsłudze zdarzeń, która może spowodować wyskoczenie okna (częściowo zaufane skrypty), ale żadna treść internetowa nie może odczytać schowka. WebExtensions mogą wchodzić w interakcje ze schowkiem.
Zobacz również