[TOC] ## deleteText <!-- Deletes text from the editor, returning a [Delta](../guides/designing-the-delta-format.md) representing the change. [Source](/docs/api/#events) may be `"user"`, `"api"`, or `"silent"`. Calls where the `source` is `"user"` when the editor is [disabled](#disable) are ignored. --> 从编辑器中删除文本，返回代表对应变化的[Delta](../guides/designing-the-delta-format.md)数据。[Source](事件events.md)可能是 `"user"`、 `"api"` 或者 `"silent"`。当编辑器不可用[disabled]#disable且`source`参数为“user”时，调用将被忽略。 **方法** ```javascript deleteText(index:Number, length: Number, source: String = 'api'): Delta ``` **示例** ```javascript quill.deleteText(6, 4); ``` ## getContents <!-- Retrieves contents of the editor, with formatting data, represented by a [Delta]() object. --> 返回编辑器的内容——包含格式数据的[Delta](../增量Delta.md)数据。 **方法** ```javascript getContents(index: Number = 0, length: Number = remaining): Delta ``` **示例** ```javascript var delta = quill.getContents(); ``` ## getLength <!-- Retrieves the length of the editor contents. Note even when Quill is empty, there is still a blank line represented by '\n', so `getLength` will return 1. --> 返回编辑器内容的长度。注意，当Quill为空时，仍然包含一个由'\n'解析成的空行，所以`getLength`将返回1。 **方法** ```javascript getLength(): Number ``` **示例** ```javascript var length = quill.getLength(); ``` ## getText <!-- Retrieves the string contents of the editor. Non-string content are omitted, so the returned string's length may be shorter than the editor's as returned by [`getLength`](#getlength). Note even when Quill is empty, there is still a blank line in the editor, so in these cases `getText` will return '\n'. The `length` parameter defaults to the length of the remaining document. --> 返回编辑器的字符串内容。由于非字符串内容会被忽略掉，所以返回字符串内容的长度会比[`getLength`](#getlength)返回的长度小。注意，尽管Quill为空，编辑器里仍有一行空行，所以这种情况会返回”\n”。 `length`参数默认为剩下文本的长度。 **方法** ```javascript getText(index: Number = 0, length: Number = remaining): String ``` **示例** ```javascript var text = quill.getText(0, 10); ``` ## insertEmbed <!-- Insert embedded content into the editor, returning a [Delta](../guides/designing-the-delta-format.md) representing the change. [Source](/docs/api/#events) may be `"user"`, `"api"`, or `"silent"`. Calls where the `source` is `"user"` when the editor is [disabled](#disable) are ignored. --> 插入嵌入对象内容到编辑器，返回代表对应变化的[Delta](../guides/designing-the-delta-format.md)数据。 [Source](事件events.md)可能是 `"user"`、 `"api"` 或者 `"silent"`。当编辑器不可用[disabled]#disable且`source`参数为“user”时，调用将被忽略。 **方法** ```javascript insertEmbed(index: Number, type: String, value: any, source: String = 'api'): Delta ``` **示例** ```javascript quill.insertEmbed(10, 'image', 'https://quilljs.com/images/cloud.png'); ``` ## insertText <!-- Inserts text into the editor, optionally with a specified format or multiple [formats](/docs/formats/). Returns a [Delta](../guides/designing-the-delta-format.md) representing the change. [Source](/docs/api/#events) may be `"user"`, `"api"`, or `"silent"`. Calls where the `source` is `"user"` when the editor is [disabled](#disable) are ignored. --> 向编辑器中插入文本，可选带有指定的文本格式或多个文本[格式](../格式formats.md)，返回代表对应变化的[Delta](../guides/designing-the-delta-format.md)数据。 [Source](事件events.md)可能是 `"user"`、 `"api"` 或者 `"silent"`。当编辑器不可用[disabled]#disable且`source`参数为“user”时，调用将被忽略。 **方法** ```javascript insertText(index: Number, text: String, source: String = 'api'): Delta insertText(index: Number, text: String, format: String, value: any, source: String = 'api'): Delta insertText(index: Number, text: String, formats: { [String]: any }, source: String = 'api'): Delta ``` **示例** ```javascript quill.insertText(0, 'Hello', 'bold', true); quill.insertText(5, 'Quill', { 'color': '#ffff00', 'italic': true }); ``` ## pasteHTML ***弃用的*** <!-- This API has been moved into [Clipboard](/docs/modules/clipboard/#dangerouslypastehtml) and renamed. It will be removed as a top level API in 2.0. --> 这个接口已经移动到[Clipboard](../modules/粘贴板clipboard.md)中，并且重命名。在更高版本的2.0API中，它将被移除。 ## setContents <!-- Overwrites editor with given contents. Contents should end with a [newline](#line-formatting). Returns a Delta representing the change. This will be the same as the Delta passed in, if given Delta had no invalid operations. [Source](/docs/api/#events) may be `"user"`, `"api"`, or `"silent"`. Calls where the `source` is `"user"` when the editor is [disabled](#disable) are ignored. --> 用给定的内容覆盖原编辑器内容。内容将会用[换行符](../增量Delta.md)结尾。返回代表对应变化的Delta数据。如果给定的Delta没有无效的操作，返回值和传入的值相同。 [Source](事件events.md)可能是 `"user"`、 `"api"` 或者 `"silent"`。当编辑器不可用[disabled]#disable且`source`参数为“user”时，调用将被忽略。 **方法** ```javascript setContents(delta: Delta, source: String = 'api'): Delta ``` **示例** ```javascript quill.setContents([ { insert: 'Hello ' }, { insert: 'World!', attributes: { bold: true } }, { insert: '\n' } ]); ``` ## setText <!-- Sets contents of editor with given text, returing a [Delta](../guides/designing-the-delta-format.md) representing the change. Note Quill documents must end with a newline so one will be added for you if omitted. [Source](/docs/api/#events) may be `"user"`, `"api"`, or `"silent"`. Calls where the `source` is `"user"` when the editor is [disabled](#disable) are ignored. --> 用给定的文本设置为编辑器的内容，返回代表对应变化的 [Delta](../guides/designing-the-delta-format.md)数据。注意，Quill文档必须以换行符结尾，如果没有则会自动添加。 [Source](事件events.md)可能是 `"user"`、 `"api"` 或者 `"silent"`。当编辑器不可用[disabled]#disable且`source`参数为“user”时，调用将被忽略。 **方法** ```javascript setText(text: String, source: String = 'api'): Delta ``` **示例** ```javascript quill.setText('Hello\n'); ``` ## updateContents <!-- Applies Delta to editor contents, returing a [Delta](../guides/designing-the-delta-format.md) representing the change. These Deltas will be the same if the Delta passed in had no invalid operations. [Source](/docs/api/#events) may be `"user"`, `"api"`, or `"silent"`. Calls where the `source` is `"user"` when the editor is [disabled](#disable) are ignored. --> 让编辑器内容执行Delta数据方法，返回代表对应变化的 [Delta](../guides/designing-the-delta-format.md)数据。如果给定的Delta没有无效的操作，返回值和传入的值相同。 [Source](事件events.md)可能是 `"user"`、 `"api"` 或者 `"silent"`。当编辑器不可用[disabled]#disable且`source`参数为“user”时，调用将被忽略。 **方法** ```javascript updateContents(delta: Delta, source: String = 'api'): Delta ``` **示例** ```javascript // Assuming editor currently contains [{ insert: 'Hello World!' }] quill.updateContents(new Delta() .retain(6) // Keep 'Hello ' .delete(5) // 'World' is deleted .insert('Quill') .retain(1, { bold: true }) // Apply bold to exclamation mark }); // Editor should now be [ // { insert: 'Hello Quill' }, // { insert: '!', attributes: { bold: true} } // ] ```