Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.
Обзор
Когда HTML документ переключен в designMode, объект document предоставляет метод execCommand
, который предоставляет команды для работы с контентом в редактируемой области. Большинство команд влияют на выделение (bold, italics, и тп.), другие вставляют новые элементы (createLink) или влияют на всю строку (indenting). При использовании contentEditable
, вызов execCommand
влияет на активный редактируемый элемент.
Синтаксис
execCommand(String aCommandName, Boolean aShowDefaultUI, String aValueArgument)
Аргументы
- String aCommandName
- имя команды
- Boolean aShowDefaultUI
- нужно ли показать пользовательский интерфейс по умолчанию. Это не реализовано в Mozilla.
- String aValueArgument
- некоторым командам (например insertimage) также требуется значение аргумента (url картинки). Если аргумент не нужен введите
null
.
Команды
- backColor
- Изменить цвет фона документа. В режиме styleWithCss командой устанавливается цвет фона родительского блока. Необходима передача строкового значения цвета в качестве аргумента. (Internet Explorer таким образом устанавливает цвет фона текста.)
- bold
- Включает/отключает выделение жирным bold отмеченного текста или начиная с места ввода тескта. (Internet Explorer ипсользует таг STRONG вместо B.)
- contentReadOnly
- Делает содержимое документа либо неизменяемым либо редактируемым. Требуется передача булевого true/false в качестве аргумента. (Не поддерживается Internet Explorer.)
- copy
- Копирует выделенное в буфер обмена. Возможность такого поведения отличается от броузера к броузеру и расширяется со временем. Следует проверить таблицу совместимости, чтобы убедиться в возможности использования.
- createLink
- Создает ссылку из выделения, если таковое имеется. Необходима передача HREF URI вв качестве аргумента. URI должен содержать как минимум один символ, допускается пробельный. (Internet Explorer создаст ccылку и без URI.)
- cut
- Вырезает выделенное и помещает его в буфер обмена. Возможность такого поведения отличается от броузера к броузеру и расширяется со временем. Следует проверить таблицу совместимости, чтобы убедиться в возможности использования.
- decreaseFontSize
- Добавляет таг "SMALL" вокруг выделения или с места ввода текста. (Не поддерживается Internet Explorer.)
- delete
- Удаляет выделенное.
- enableInlineTableEditing
- Включает/выключает взоможность вставки и удаления строк/столбцов таблицы. (Не поддерживается Internet Explorer.)
- enableObjectResizing
- Включает/выключает возможность изменения размера картинок и других объектов. (Не поддерживается Internet Explorer.)
- fontName
- Изменияет название шрифта для выделенного текста или с меств ввода текста. Требует передачи в качестве аргумента наиименования шрифта (напр., "Arial")
- fontSize
- Изменяет размер шрифта выделенного текста или с места ввода текста. Требует передачи в качестве аргумента размера шрифта (1-7).
- foreColor
- Изменяет цвет шрифта выделенного текста или с места ввода текста. Требует передачи в качестве аргумента наименования шрифта.
- formatBlock
- Добавляет таг HTML-блока вокруг строк, содержащих в себе выделенный текст, заменяя блочный элемент, содержащий такие строки если он существует (в Firefox, BLOCKQUOTE является исключением - он обернет любой блочный элемент). Требует передачи в качестве аргумента наименования Тага. Теоретически может использоваться любой блочный таг (напр., "H1", "P", "DL", "BLOCKQUOTE"). (Internet Explorer поддерживает только таги заголовков H1 - H6, ADDRESS, and PRE, которые должны также быть заключены в символы < >, как например: "<H1>".)
- forwardDelete
- Удаляет символ справа от курсора, так же как при нажатии на клавишу delete.
- heading
- Добавляет тег заголовка вокруг выделенного текста либо в месте где установлен курсор.
Требует передачи строки имени тега в качестве аргумента. (то есть "H1", "H6"). (Не поддерживается в Internet Explorer и Safari)
- hiliteColor
- Изменяет цвет фона для выделенного текста либо в месте где установлен курсор. Требует передачи цвета в качестве аргумента. UseCSS должен быть включен для работы этой функции. (Не поддерживается в Internet Explorer)
- increaseFontSize
- Добавляет тег BIG вокруг выделенного текста или на месте курсора. (Не поддерживается в Internet Explorer)
- indent
- Indents the line containing the selection or insertion point. In Firefox, if the selection spans multiple lines at different levels of indentation, only the least indented lines in the selection will be indented.
- insertBrOnReturn
- Controls whether the Enter key inserts a br tag or splits the current block element into two. (Not supported by Internet Explorer.)
- insertHorizontalRule
- Вставляет горизонтальную линию на месте курсора (удаляет выделение).
- insertHTML
- Вставляет HTML текст на месте курсора (удаляет выделенный текст). Требует передачи правильной HTML строки как аргумент. (Не поддерживается в Internet Explorer)
- insertImage
- Inserts an image at the insertion point (deletes selection). Requires the image SRC URI string to be passed in as a value argument. The URI must contain at least a single character, which may be a white space. (Internet Explorer will create a link with a null URI value.)
- insertOrderedList
- Creates a numbered ordered list for the selection or at the insertion point.
- insertUnorderedList
- Creates a bulleted unordered list for the selection or at the insertion point.
- insertParagraph
- Inserts a paragraph around the selection or the current line. (Internet Explorer inserts a paragraph at the insertion point and deletes the selection.)
- insertText
- Inserts the given plain text at the insertion point (deletes selection).
- italic
- Toggles italics on/off for the selection or at the insertion point. (Internet Explorer uses the EM tag instead of I.)
- justifyCenter
- Centers the selection or insertion point.
- justifyFull
- Justifies the selection or insertion point.
- justifyLeft
- Justifies the selection or insertion point to the left.
- justifyRight
- Right-justifies the selection or the insertion point.
- outdent
- Outdents the line containing the selection or insertion point.
- paste
- Pastes the clipboard contents at the insertion point (replaces current selection). Clipboard capability must be enabled in the user.js preference file. See
- redo
- Redoes the previous undo command.
- removeFormat
- Removes all formatting from the current selection.
- selectAll
- Selects all of the content of the editable region.
- strikeThrough
- Toggles strikethrough on/off for the selection or at the insertion point.
- subscript
- Toggles subscript on/off for the selection or at the insertion point.
- superscript
- Toggles superscript on/off for the selection or at the insertion point.
- underline
- Toggles underline on/off for the selection or at the insertion point.
- undo
- Undoes the last executed command.
- unlink
- Removes the anchor tag from a selected anchor link.
- useCSS
- Toggles the use of HTML tags or CSS for the generated markup. Requires a boolean true/false as a value argument. NOTE: This argument is logically backwards (i.e. use false to use CSS, true to use HTML). (Not supported by Internet Explorer.) This has been deprecated; use the styleWithCSS command instead.
- styleWithCSS
- Replaces the useCSS command; argument works as expected, i.e. true modifies/generates style attributes in markup, false generates formatting elements.
Example
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Да) | (Да) | ? | ? | (Да) |
insertBrOnReturn | Нет | (Да) | Нет | Нет | Нет |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | ? | ? | (Да) | ? | ? | ? |
Specification
Specification | Status | Comment |
---|---|---|
HTML Editing APIs Определение 'execCommand' в этой спецификации. |
Редакторский черновик |