diff options
Diffstat (limited to 'files/ru/web/api/document/execcommand/index.html')
| -rw-r--r-- | files/ru/web/api/document/execcommand/index.html | 358 |
1 files changed, 358 insertions, 0 deletions
diff --git a/files/ru/web/api/document/execcommand/index.html b/files/ru/web/api/document/execcommand/index.html new file mode 100644 index 0000000000..b858471dc2 --- /dev/null +++ b/files/ru/web/api/document/execcommand/index.html @@ -0,0 +1,358 @@ +--- +title: Document.execCommand() +slug: Web/API/Document/execCommand +tags: + - API + - DOM + - editor + - wysiwyg +translation_of: Web/API/Document/execCommand +--- +<div>{{ApiRef("DOM")}}{{Obsolete_header}}</div> + +<div> +<h2 id="Summary" name="Summary">Обзор</h2> + +<p>Когда HTML документ переключен в режим редактирования ({{domxref("document.designMode")}}), для него будет доступен метод <code>execCommand</code>, который предоставляет команды для работы с контентом в редактируемой области. Большинство команд влияют на выделение (bold, italics, и т. п.), другие вставляют новые элементы (createLink) или влияют на всю строку (<span style="font-family: segoe ui;">indenting</span>). При использовании <code>contentEditable</code>, вызов <code>execCommand</code> влияет на активный редактируемый элемент.</p> + +<h2 id="Syntax" name="Syntax">Синтаксис</h2> + +<pre class="brush: js notranslate">execCommand(String aCommandName, Boolean aShowDefaultUI, String aValueArgument) +</pre> + +<h3 id="Аргументы">Аргументы</h3> + +<blockquote> +<dl> + <dt>String aCommandName</dt> + <dd>имя команды</dd> +</dl> + +<dl> + <dt>Boolean aShowDefaultUI</dt> + <dd>нужно ли показать пользовательский интерфейс по умолчанию. Это не реализовано в Mozilla.</dd> +</dl> + +<dl> + <dt>String aValueArgument</dt> + <dd>некоторым командам (например insertimage) также требуется значение аргумента (url картинки). Е<span style="line-height: 1.5;">сли аргумент не нужен введите</span><span style="line-height: 1.5;"> </span><code style="font-style: normal; line-height: 1.5;">null</code><span style="line-height: 1.5;">.</span></dd> +</dl> +</blockquote> + +<h2 id="Команды">Команды</h2> + + +<blockquote> +<dl> + <dt>backColor</dt> + <dd>Изменить цвет фона документа. В режиме styleWithCss командой устанавливается цвет фона родительского блока. Необходима передача строкового значения цвета в качестве аргумента. (Internet Explorer таким образом устанавливает цвет фона текста.)</dd> +</dl> + +<dl> + <dt>bold</dt> + <dd>Включает/отключает выделение жирным bold отмеченного текста или начиная с места ввода текста. (Internet Explorer использует тег {{HTMLElement("strong")}} вместо {{HTMLElement("b")}}.)</dd> +</dl> + +<dl> + <dt>contentReadOnly</dt> + <dd>Делает содержимое документа либо неизменяемым либо редактируемым. Требуется передача булевого true/false в качестве аргумента. (Не поддерживается Internet Explorer.)</dd> +</dl> + +<dl> + <dt>copy</dt> + <dd>Копирует выделенное в буфер обмена. Возможность такого поведения отличается от браузера к браузеру и расширяется со временем. Следует проверить таблицу совместимости, чтобы убедиться в возможности использования.</dd> +</dl> + +<dl> + <dt>createLink</dt> + <dd>Создает ссылку из выделения, если таковое имеется. Необходима передача HREF URI в качестве аргумента. URI должен содержать как минимум один символ, допускается пробельный. (Internet Explorer создаст ccылку и без URI.)</dd> +</dl> + +<dl> + <dt>cut</dt> + <dd>Вырезает выделенное и помещает его в буфер обмена. Возможность такого поведения отличается от браузера к браузеру и расширяется со временем. Следует проверить таблицу совместимости, чтобы убедиться в возможности использования.</dd> +</dl> + +<dl> + <dt>decreaseFontSize</dt> + <dd>Добавляет тег {{HTMLElement("small")}} вокруг выделения или с места ввода текста. (Не поддерживается Internet Explorer.)</dd> +</dl> + +<dl> + <dt>delete</dt> + <dd>Удаляет выделенное.</dd> +</dl> + +<dl> + <dt>enableInlineTableEditing</dt> + <dd>Включает/выключает возможность вставки и удаления строк/столбцов таблицы. (Не поддерживается Internet Explorer.)</dd> +</dl> + +<dl> + <dt>enableObjectResizing</dt> + <dd>Включает/выключает возможность изменения размера картинок и других объектов. (Не поддерживается Internet Explorer.)</dd> +</dl> + +<dl> + <dt>fontName</dt> + <dd>Изменяет название шрифта для выделенного текста или с места ввода текста. Требует передачи в качестве аргумента наименования шрифта (напр., "Arial") </dd> +</dl> + +<dl> + <dt>fontSize</dt> + <dd>Изменяет размер шрифта выделенного текста или с места ввода текста. Требует передачи в качестве аргумента размера шрифта (1-7).</dd> +</dl> + +<dl> + <dt>foreColor</dt> + <dd>Изменяет цвет шрифта выделенного текста или с места ввода текста. Требует передачи в качестве аргумента наименования шрифта.</dd> +</dl> + +<dl> + <dt>formatBlock</dt> + <dd>Добавляет тег HTML-блока вокруг строк, содержащих в себе выделенный текст, заменяя блочный элемент, содержащий такие строки, если он существует (в Firefox, BLOCKQUOTE является исключением - он обернет любой блочный элемент). Требует передачи в качестве аргумента наименования Тега. Теоретически может использоваться любой блочный тег (напр., "H1", "P", "DL", "BLOCKQUOTE"). (Internet Explorer поддерживает только теги заголовков H1 - H6, ADDRESS и PRE, которые должны также быть заключены в символы < >, как например: "<H1>".)</dd> +</dl> + +<dl> + <dt>forwardDelete</dt> + <dd>Удаляет символ справа от курсора, так же как при нажатии на клавишу delete.</dd> + <dt>heading</dt> + <dd>Добавляет тег заголовка вокруг выделенного текста либо в месте, где установлен курсор.<br> + Требует передачи строки имени тега в качестве аргумента. (то есть "H1", "H6"). (Не поддерживается в Internet Explorer и Safari)</dd> +</dl> + +<dl> + <dt>hiliteColor</dt> + <dd>Изменяет цвет фона для выделенного текста либо в месте, где установлен курсор. Требует передачи цвета в качестве аргумента. UseCSS должен быть включен для работы этой функции. (Не поддерживается в Internet Explorer)</dd> +</dl> + +<dl> + <dt>increaseFontSize</dt> + <dd>Добавляет тег BIG вокруг выделенного текста или на месте курсора. (Не поддерживается в Internet Explorer)</dd> +</dl> + +<dl> + <dt>indent</dt> + <dd>Добавляет отступ в строку, в которой расположен курсор (или что-то выделено). В Firefox, если выделение охватывает несколько строк с разными уровнями отступа, будут сдвинуты только строки с наименьшим отступом.</dd> +</dl> + +<dl> + <dt>insertBrOnReturn</dt> + <dd>Добавляет тег {{HTMLElement("br")}} или разбивает текущий элемент на два блока. Не работает в Internet Explorer</dd> +</dl> + +<dl> + <dt>insertHorizontalRule</dt> + <dd>Вставляет горизонтальную линию на месте курсора (удаляет выделение).</dd> +</dl> + +<dl> + <dt>insertHTML</dt> + <dd>Вставляет HTML текст на месте курсора (удаляет выделенный текст). Требует передачи правильной HTML строки в качестве аргумента. (Не поддерживается в Internet Explorer)</dd> +</dl> + +<dl> + <dt>insertImage</dt> + <dd>Вставляет изображение на место курсора (удаляет выделенный текст). Необходимо указывать ссылку на изображение в параметре "aValueArgument". (Internet Explorer может создавать изображения с пустым SRC)</dd> +</dl> + +<dl> + <dt>insertOrderedList</dt> + <dd>Создает пронумерованный список из выбранного или на месте курсора.</dd> +</dl> + +<dl> + <dt>insertUnorderedList</dt> + <dd>Создает список из выбранного или на месте курсора.</dd> +</dl> + +<dl> + <dt>insertParagraph</dt> + <dd>Вставляет параграф вокруг выделения или для текущей строки. (Internet Explorer вставляет параграф в месте курсора и удаляет выделенный текст)</dd> + <dt>insertText</dt> + <dd>Вставляет простой текст в месте курсора или выделения (выделенный текст будет заменен).</dd> +</dl> + +<dl> + <dt>italic</dt> + <dd>Переключает курсив в месте курсора или выделения. (Internet Explorer использует теги {{HTMLElement("em")}} вместо {{HTMLElement("i")}}.)</dd> +</dl> + +<dl> + <dt>justifyCenter</dt> + <dd>Центрирует строку, в которой есть выделение или установлен курсор.</dd> +</dl> + +<dl> + <dt>justifyFull</dt> + <dd>Выравнивает по ширине строку, в которой есть выделение или установлен курсор.</dd> +</dl> + +<dl> + <dt>justifyLeft</dt> + <dd>Выравнивает по левому краю строку, в которой есть выделение или установлен курсор.</dd> +</dl> + +<dl> + <dt>justifyRight</dt> + <dd>Выравнивает по правому краю строку, в которой есть выделение или установлен курсор.</dd> +</dl> + +<dl> + <dt>outdent</dt> + <dd>Добавляет выступ для строки, в которой расположен курсор (или что-то выделено).</dd> +</dl> + +<dl> + <dt>paste</dt> + <dd>Вставляет данные из буфера обмена в место курсора или выделения (последнее заменяется). Доступ к буферу обмена должен быть включен в файле user.js</dd> +</dl> + +<dl> + <dt>redo</dt> + <dd>Повтор последнего действия. (Если было отменено с помощью <strong>undo</strong> или <strong>ctrl+z</strong>)</dd> +</dl> + +<dl> + <dt>removeFormat</dt> + <dd>Очищает форматирование для выделенного.</dd> +</dl> + +<dl> + <dt>selectAll</dt> + <dd>Выделяет всё в редактируемом документе.</dd> +</dl> + +<dl> + <dt>strikeThrough</dt> + <dd>Переключает зачеркивание текста для выделения или на месте курсора.</dd> +</dl> + +<dl> + <dt>subscript</dt> + <dd>Переключает нижний индекс для выбранного или на месте курсора.</dd> +</dl> + +<dl> + <dt>superscript</dt> + <dd>Переключает верхний индекс для выбранного или на месте курсора.</dd> +</dl> + +<dl> + <dt>underline</dt> + <dd>Переключает подчёркивание для выбранного или на месте курсора.</dd> +</dl> + +<dl> + <dt>undo</dt> + <dd>Отменяет последнее действие.</dd> +</dl> + +<dl> + <dt>unlink</dt> + <dd>Удаляет ссылку или якорь для выбранной ссылки/якоря</dd> +</dl> + +<dl> + <dt>useCSS {{ Deprecated_inline() }}</dt> + <dd>Переключает режим стилизации HTML и CSS для генерируемой разметки. Может принимать только булевы значения true/false. ПРИМЕЧАНИЕ: этот аргумент с перевернутой логикой (т.е. false = CSS / true = HTML). (Не поддерживается в Internet Explorer.) <strong>Внимание! Эта команда является устаревшей, используйте <em>styleWithCSS.</em></strong></dd> +</dl> + +<dl> + <dt>styleWithCSS</dt> + <dd><strong>Заменяет команду useCSS.</strong> Аргумент работает как ожидалось, т.е. true модифицирует/генерирует атрибуты стиля в разметке, false генерирует элементы форматирования.</dd> +</dl> +</blockquote> +</div> + +<h2 id="Example" name="Example">Пример</h2> + +<pre class="notranslate"><code>iframeNode</code>.execCommand("bold"); // Жирный текст +<code>iframeNode</code>.execCommand("undo"); // Отмена последнего действия +<code>iframeNode</code>.execCommand("insertText", false, "Lorem ipsum dolor sit amet, consectetur adipisicing elit."); // Вставка текста +</pre> + +<h2 id="Browser_Compatibility" name="Browser_Compatibility">Совместимость с браузерами</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Базовая поддержка</td> + <td>{{ CompatVersionUnknown() }}</td> + <td>{{ CompatVersionUnknown() }}</td> + <td>{{ CompatUnknown() }}</td> + <td>{{ CompatUnknown() }}</td> + <td>{{ CompatVersionUnknown() }}</td> + </tr> + <tr> + <td>insertBrOnReturn</td> + <td>{{ CompatNo() }}</td> + <td>{{ CompatVersionUnknown() }}</td> + <td>{{ CompatNo() }}</td> + <td>{{ CompatNo() }}</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 для Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Базовая поддержка</td> + <td>{{ CompatUnknown() }}</td> + <td>{{ CompatUnknown() }}</td> + <td>{{ CompatVersionUnknown() }}</td> + <td>{{ CompatUnknown() }}</td> + <td>{{ CompatUnknown() }}</td> + <td>{{ CompatUnknown() }}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Specification" name="Specification">Спецификация</h2> + +<table class="spectable standard-table"> + <tbody> + <tr> + <th scope="col">Спецификация</th> + <th scope="col">Статус</th> + <th scope="col">Комментарий</th> + </tr> + <tr> + <td>{{SpecName('HTML Editing','#execcommand()','execCommand')}}</td> + <td>{{Spec2('HTML Editing')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="See_also" name="See_also">Смотрите также</h2> + +<ul> + <li>{{domxref("document.contentEditable")}}</li> + <li>{{domxref("document.designMode")}}</li> + <li><a href="/en-US/docs/Rich-Text_Editing_in_Mozilla">Rich-Text Editing в Mozilla</a></li> +</ul> |