Document.execCommand()

当一个HTML文档切换到设计模式，文档对象会暴漏execCommand 方法，可以让用户运行命令操作可编辑区域的内容。大多指令作用于文档的选择（加粗，斜体等等），另外一些则是插入新元素（如添加一个链接）或者作用于一整行（如缩进）。当使用contentEditable 属性时，使用execCommand() 将会作用于当前激活的可编辑区域。

语法

bool = document.execCommand(aCommandName, aShowDefaultUI, aValueArgument)

返回值

如果指令不支持或无效会返回Boolean。

注意： 只有用户交互的部分也就是在渲染元素使用命令之前不被用来修改浏览器才会返回 true。

参数

aCommandName

 DOMString 指明执行指令的名臣。 查看 Commands 可找到合理的指令的列表。

aShowDefaultUI

Boolean 指示是否应该显示默认用户界面。这个未在Mozilla中实现。

aValueArgument

这个是指令要求的输入参数（如 insertImage, 也就是插入的图片的fURL ),这是 DOMString 提供的信息。 如果没有需要的参数可指定 null 。

指令

backColor

改变文档的背景颜色。在 styleWithCss 模式中，它会改变包含块的背景颜色。这个指令要求传入 <color> 字符串作为参数值传入。注意在IE中这个指令用来设置文本背景颜色。

bold

在选择点或插入点切换打开或关闭加粗。IE使用 <strong> 标签代替<b>.

contentReadOnly

使文档内容只读或者可编辑。此指令要求传入一个布尔值true或者false。（不支持IE浏览器。）

copy

将当前选定内容复制到剪贴板。不同浏览器使这种行为启用的条件不同，并且随着时间的推移而变化。检查兼容性表，以确定是否可以在您的情况下使用它。

createLink

只有当你有选区的时候才会从选区创建一个锚点链接。此指令要求一个HURF URI字符串作为参数传入。这个 URI 必须至少包含一个字符，即使是个空格。（IE浏览器将会船舰一个URI值为null的链接。）

cut

剪切当前选择内容复制到剪切板。 不同浏览器使这种行为启用的条件不同，并且随着时间的推移而变化。检查兼容性表，以确定是否可以在您的情况下使用它。

decreaseFontSize

在选择点或者插入点添加<small> 标签。 (IE不支持)

delete

删除当前选择内容。

enableInlineTableEditing

启用或禁用表格行和列的插入和删除控件。 (IE不支持。)

enableObjectResizing

启用或禁用图像和其他可调整对象的调整大小操作。 (IE不支持。)

fontName

改变选择点和插入点的文字名称。此指令需要传入一个文字名称的字符串（例如"Arial"）作为参数。

fontSize

改变选择点和插入点的文字大小。此指令需要一个 HTML font size (1-7) 作为参数传入。

foreColor

修改选择点或插入点的文字颜色。此指令要求一个颜色值作为参数传入。

formatBlock

在包含当前选择内容的行添加一个 HTML 块元素标签，如果已存在一个包含的块元素则会替换 (在火狐浏览器中， BLOCKQUOTE 是异常代码 - 它将包含任何包含的块元素)。此指令要求一个标签的字符串作为一个参数传入。 几乎所有的块央视标签都可以使用 (例如： "H1", "P", "DL", "BLOCKQUOTE")。 (IE只支持标题标签 H1 - H6, ADDRESS, and PRE，这些标签必须包含在分隔符< >中，就像 "<H1>".)

forwardDelete

此指令可以在光标位置之前删除字符。它与点击删除键相同。

heading

在选择点或者插入点增加一个标题标签。需要传入标签名为参数 (比如： "H1", "H6")。 (Internet Explorer 和 Safari不支持)

hiliteColor

改变选区或者插入点的背景颜色。需要传入一个颜色值作为参数。要发挥作用必须启用。(IE不支持。)

increaseFontSize

在选区或者插入点增加BIG标签。(IE不支持。)

indent

缩进包含选区或插入点的行。在火狐中，如果选区包含多个行不同层次的缩进，则选区中最少缩进的行才会被缩进。

insertBrOnReturn

控制是否用回车键插入一个br标签或是讲当前块元素拆分成两个。(IE不支持。)

insertHorizontalRule

在插入点插入水平线 (删除选区)。

insertHTML

在插入点插入HTML(删除选区)。需要传入一个有效的HTML字符串作为参数。(IE不支持。)

insertImage

在插入点插入一张图片 (删除选区)。 需要传入图片地址作为参数。此地址必须至少包含一个字符，哪怕是一个空格。(IE将会创建一个空值的链接)

insertOrderedList

为选择或插入点创建一个编号的有序列表。

insertUnorderedList

为选择或插入点创建一个未显示的无序列表。

insertParagraph

在选择或当前行周围插入段落。（IE在插入点插入段落，并删除选择区内容。）

insertText

在插入点插入给定的纯文本（删除选择区内容）。

italic

为选择或插入点打开/关闭斜体。（IE使用EM标记代替I）。

justifyCenter

使选区或插入点居中。

justifyFull

使选区或插入点每行排齐。

justifyLeft

使选区或插入点左对齐。

justifyRight

使选区或插入点右对齐。

outdent

使包含选区或插入点的行伸出排。

paste

在插入点粘贴剪贴板内容（替换当前选择区内容）。必须在user.js首选文件中启用剪贴板功能。 参见附注[1].

redo

重做以前的撤消命令。

removeFormat

从当前选区中移除所有格式。

selectAll

全选可编辑区域内容。

strikeThrough

在选择点或插入点切换打开或关闭。

subscript

在选择点或插入点切换下标打开或关闭。

superscript

在选择点或插入点切换上标打开或关闭。。

underline

切换选择或插入点的下划线打开或关闭。

undo

撤消最后执行的命令。

unlink

从选定的锚点链接中移除锚点标记。

useCSS {{ 禁止内联 }}

切换HTML标记或用于生成标记的CSS。需要布尔值true / false作为参数。注意：此参数在逻辑上是向后的（也就是说用false来使用CSS，用true来使用HTML）。（IE不支持）。这已被弃用；使用styleWithCSS指令代替。

styleWithCSS

替换 useCSS 指令；参数使用如下：true用来在标记中修改/生成样式属性，false用来生成格式化元素。

Example

在CodePen中的一个例子怎么用

详细说明

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

[1] 在Firefox 41之前，需要在user.js首选文件中启用剪贴板功能。有关更多信息，请参见Mozilla首选项的简要指南。如果指令不被支持或启用，execCommand 会引发异常而不是返回false。在Firefox 41和以后，在任何能够弹出窗口（半可信脚本）的事件处理程序中，默认情况下启用剪贴板功能。

请参阅

• HTMLElement.contentEditable
• document.designMode
• Rich-Text Editing in Mozilla
• Scribe's "Browser Inconsistencies" documentation with bugs related to document.execCommand.?