path: root/files/pl/web/api/document/execcommand/index.html

---
title: Document.execCommand()
slug: Web/API/Document/execCommand
tags:
  - API
  - DOM
  - Method
  - NeedsBrowserCompatibility
  - NeedsExample
  - Reference
  - edytor
translation_of: Web/API/Document/execCommand
---


<div>Kiedy dokument HTML jest przełączony w tryb <code>designMode</code>, obiekt dokumentu udostępnia metodę <code>execCommand</code>, 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 <code>contentEditable</code>, wywołanie <code>execCommand()</code> wpływa na aktywny edytowalny element.</div>

<h2 id="Składnia">Składnia</h2>

<pre class="syntaxbox notranslate"><em>bool</em> = document.execCommand(<em>aCommandName</em>, <em>aShowDefaultUI</em>, <em>aValueArgument</em>)
</pre>

<h3 id="Zwracane_wartości">Zwracane wartości</h3>

<p>Obiekt {{jsxref('Boolean')}}, który zwraca <code>false</code>, jeśli polecenie jest niewspierane lub włączone. <strong>Uwaga</strong>: 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. </p>

<h3 id="Parametry">Parametry</h3>

<dl>
 <dt><code>aCommandName</code></dt>
 <dd>Typu {{domxref("DOMString")}} - określanazwę polecenia do wykonania. Zobacz {{anch("Commands")}}, aby wyświetlić listę poleceń.</dd>
 <dt><code>aShowDefaultUI</code></dt>
 <dd>Typu {jsxref("Boolean")}} - wskazuje czy domyślny interfejs użytkownika powinien być pokazany. Nie jest implementowane przez Mozillę.</dd>
 <dt><code>aValueArgument</code></dt>
 <dd>W przypadku komend wymagających wprowadzenia argumentu (takiego jak <code>insertImage</code>, gdzie jest to URL do grafiki do wstawienia), jest to {{domxref("DOMString")}} przekazujący te informacje. Podaj null, jeśli niewymagany.</dd>
</dl>

<h3 id="Polecenia">Polecenia</h3>

<dl>
 <dt><code>backColor</code></dt>
 <dd>Zmienia kolor tła. W trybie <code>styleWithCss</code> zmieia kolor jedynie zawierającego elementu. Wymaga podania ciągu znaków{{cssxref("&lt;color&gt;")}} jako wartości argumentu. Zwróć uwagę na to, że Internet Explorer używa tego do zmiany koloru tła tekstu.</dd>
 <dt><code>bold</code></dt>
 <dd>Włącza/wyłącza pogrubienie w zaznaczeniu lub miejscu wstawiania. IE używa znacznika {{HTMLElement("strong")}} zamiast {{HTMLElement("b")}}.</dd>
 <dt><code>contentReadOnly</code></dt>
 <dd>Sprawia, że dokument jest zawartość jest tylko do odczytu lub edytowalna. Wymaga prawdy/fałszu jako wartości argumentu. (Nie wspierany przez IE).</dd>
 <dt><code>copy</code></dt>
 <dd>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.</dd>
 <dt><code>createLink</code></dt>
 <dd>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).</dd>
 <dt><code>cut</code></dt>
 <dd>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.</dd>
 <dt><code>decreaseFontSize</code></dt>
 <dd>Wstawia znacznik {{HTMLElement("small")}} wokół zaznaczenia lub w miejscu wstawienia. (Nie wspierane przez IE.)</dd>
 <dt><code>defaultParagraphSeparator</code></dt>
 <dd>Zmienia separator akapitu używany podczas tworzenia nowych akapitów w edytowalnych regionach tekstowych.  Zobacz <a href="/pl/docs/Web/Guide/HTML/Editable_content#Differences_in_markup_generation">Differences in markup generation</a> po więcej szczegółów.</dd>
 <dt><code>delete</code></dt>
 <dd>Usuwa zaznaczenie.</dd>
 <dt><code>enableInlineTableEditing</code></dt>
 <dd>Włącza lub wyłącza wstawianie wierszy i kolumn oraz elementy sterujące usuwaniem. (Nie obsługiwane przez Internet Explorer.)</dd>
 <dt><code>enableObjectResizing</code></dt>
 <dd>Umożliwia lub uniemożliwia zmianę rozmiaru uchwytów na obrakach lub innych skalowalnych obiektów.  (Nie wspierane przez IE)</dd>
 <dt><code>fontName</code></dt>
 <dd>Zmienia nazwę czcionki dla zaznaczenia lub w punkcie wstawiania. Wymaga ciągu znaków (np. <code>"Arial"</code>) jako wartości argumentu.</dd>
 <dt><code>fontSize</code></dt>
 <dd>Zmienia rozmiar czcionki dla zaznaczenia lub w punkcie wstawiania. Wymaga rozmiaru czcionki HTML (<code>1</code>-<code>7</code>) jako wartości argumentu.</dd>
 <dt><code>foreColor</code></dt>
 <dd>Zmienia kolor czcionki dla zaznaczenia lub w punkcie wstawiania. Wymaga wartości koloru (w postaci ciągu znaków) jako wartości argumentu.</dd>
 <dt><code>formatBlock</code></dt>
 <dd>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 &lt;&gt;, tak jak "&lt;h1"&gt;).</dd>
 <dt><code>forwardDelete</code></dt>
 <dd>Usuwa znak przed pozycją <a href="http://en.wikipedia.org/wiki/Cursor_%28computers%29">kursora</a>.  Działa jak wciśnięcie klawisza Delete.</dd>
 <dt><code>heading</code></dt>
 <dd>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).</dd>
 <dt><code>hiliteColor</code></dt>
 <dd>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).</dd>
 <dt><code>increaseFontSize</code></dt>
 <dd>Wstawia tag BIG naokoło zaznaczenia lub w miejscu wstawiania. (Nie wspierane przez IE).</dd>
 <dt><code>indent</code></dt>
 <dd>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.</dd>
 <dt><code>insertBrOnReturn</code></dt>
 <dd>Kontroluje, czy klawisz Enter wstawia tag BR, czy dzieli elemet blokowy na dwa (Nie wspierane przez IE)</dd>
 <dt><code>insertHorizontalRule</code></dt>
 <dd>Wstawia poziomą linię w miejscu wstawiania (usuwa zaznaczenie).</dd>
 <dt><code>insertHTML</code></dt>
 <dd>Wstawia ciąg znaków w postaci kodu HTML (usuwa zaznaczenie). Wymaga poprawnego kodu jako wartość argumentu. (Nie wspierane prze</dd>
 <dt><code>insertImage</code></dt>
 <dd>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).</dd>
 <dt><code>insertOrderedList</code></dt>
 <dd>Wstawia numerowaną listę dla zaznaczenia lub w punkcie wstawiania.</dd>
 <dt><code>insertUnorderedList</code></dt>
 <dd>Wstawia punktowaną listę dla zaznaczenia lub w punkcie wstawiania.</dd>
 <dt><code>insertParagraph</code></dt>
 <dd>Wstawia akapit naokoło zaznaczenia lub w danej linii. (IE wstawia akapit w miejscu wstaawiania i usuwa zaznaczenie).</dd>
 <dt><code>insertText</code></dt>
 <dd>Wstawia dany tekst w miejsce wstawiania (usuwa zaznaczenie).</dd>
 <dt><code>italic</code></dt>
 <dd>Włącza/wyłącza pochylenie dla zaznaczenia lub w miejscu wstawiania (IE używa tagu EM zamiast I).</dd>
 <dt><code>justifyCenter</code></dt>
 <dd>Wyśrodkowuje zaznaczenie lub miejsce wstawiania.</dd>
 <dt><code>justifyFull</code></dt>
 <dd>Justuje zaznaczenie lub miejsce wstawiania.</dd>
 <dt><code>justifyLeft</code></dt>
 <dd>Wyrównuje do lewej zaznaczenie lub miejsce wstawiania.</dd>
 <dt><code>justifyRight</code></dt>
 <dd>Wyrównuje do prawej zaznaczenie lub miejsce wstawiaia.</dd>
 <dt><code>outdent</code></dt>
 <dd>Wysuwa linię zawierającą zaznaczenie lub punkt wstawiania.</dd>
 <dt><code>paste</code></dt>
 <dd>Wstawia zawartość schowka w miejscu wstawiania (zastępuje zaznaczenie). Nie działa dla zawartości z internetu. Zobacz [1]</dd>
 <dt><code>redo</code></dt>
 <dd>Ponawia ostatnio cofniętą komendę.</dd>
 <dt><code>removeFormat</code></dt>
 <dd>Usuwa całe formatowanie z zaznaczenia.</dd>
 <dt><code>selectAll</code></dt>
 <dd>Zaznacza całą zawartość z edytowalnego obszaru.</dd>
 <dt><code>strikeThrough</code></dt>
 <dd>Włącza/wyłącza przekreślenie dla zaznaczenia lub w punkcie wstawiania.</dd>
 <dt><code>subscript</code></dt>
 <dd>Włącza/wyłącza indeks dolny dla zaznaczenia lub w punkcie wstawiania.</dd>
 <dt><code>superscript</code></dt>
 <dd>Włącza/wyłącza indeks górny dla zaznaczenia lub w punkcie wstawiania.</dd>
 <dt><code>underline</code></dt>
 <dd>Włącza/wyłącza podkreślenie dla zaznaczenia lub w punkcie wstawiania.</dd>
 <dt><code>undo</code></dt>
 <dd>Cofa ostatnio wykonaną komendę.</dd>
 <dt><code>unlink</code></dt>
 <dd>Usuwa tag kotwicy z zaznaczonego linku.</dd>
 <dt><code>useCSS</code> {{Deprecated_inline}}</dt>
 <dd>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 <em>styleWithCSS</em></dd>
 <dt><code>styleWithCSS</code></dt>
 <dd>Zastępuje <em>useCSS</em>; działa normalnie - dla CSS wymaga prawdy, fałsz generuje HTML.</dd>
</dl>

<h2 id="Example">Example</h2>

<p>Zobacz <a href="http://codepen.io/netsi1964/full/QbLLGW/">how to use</a> w CodePen.</p>

<h2 id="Specifications">Specifications</h2>

<table class="spectable standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML Editing', '#execcommand()', 'execCommand')}}</td>
   <td>{{Spec2('HTML Editing')}}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

<h2 id="Kompatybilność_przeglądarek">Kompatybilność przeglądarek</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Edge</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}<sup>[1]</sup></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
  <tr>
   <td><code>insertBrOnReturn</code></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
  <tr>
   <td><code>copy</code>/<code>cut</code></td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoDesktop(41)}}</td>
   <td>9</td>
   <td>29</td>
   <td>10</td>
  </tr>
  <tr>
   <td><code>defaultParagraphSeparator</code></td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoDesktop(55)}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Chrome for Android</th>
   <th>Edge</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}<sup>[1]</sup></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>insertBrOnReturn</code></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
  <tr>
   <td><code>copy</code>/<code>cut</code></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoMobile(41)}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatNo}}</td>
  </tr>
  <tr>
   <td><code>defaultParagraphSeparator</code></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoMobile(55)}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[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 <a href="/en-US/docs/Preferences/A_brief_guide_to_Mozilla_preferences">Krótki przewodnik po preferencjach Mozilli</a>. Jeśli polecenie nie było obsługiwane lub włączone, <code>execCommand</code> rzucał wyjątek zamiast zwracać <code>false</code>. W Firefoxie 41 i nowszych, schowek może zostać zapisany w dowolnym programie obsługi zdarzeń read the clipboard. WebExtensions can <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Interact_with_the_clipboard">interact with the clipboard</a>.</p>

<p>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.</p>

<h2 id="Zobacz_również">Zobacz również</h2>

<ul>
 <li>{{domxref("HTMLElement.contentEditable")}}</li>
 <li>{{domxref("document.designMode")}}</li>
 <li><a href="/en-US/docs/Rich-Text_Editing_in_Mozilla">Rich-Text Editing in Mozilla</a></li>
 <li><a href="https://github.com/guardian/scribe/blob/master/BROWSERINCONSISTENCIES.md">Scribe's "Browser Inconsistencies" documentation</a> z błędami odnoszącymi się do <code>document.execCommand</code>.{{CompatUnknown}}</li>
</ul>