Quill中文文档
  • 简介
  • 文档(Document)
    • 快速开始(QuickStart)
    • 下载(Download)
    • 配置项(Configuration)
    • 格式化(Formats)
    • API
      • content
      • formatting
      • selection
      • editor
      • events
      • model
      • extension
    • Delta
    • 模块(Modules)
      • 工具栏(Toolbar)
      • 键盘(Keyboard)
      • 历史(History)
      • 剪贴板(Clipboard)
      • 格式化(Formula)
      • 语法高亮(Syntax Highlighter)
    • 主题(Themes)
  • 指南(Guides)
    • 为什么要用Quill?(Why Quill)
    • 怎么自定义Quill
    • 将Quill添加到你的构建系统
    • 构建自定义模块
    • 通过Parchment克隆Medium
    • 设计Delta的格式
    • 与其他富文本编辑器对比
    • 升级到1.0
  • 其他相关库(Other)
    • Parchment
    • 自定义总结
  • 更新日志
Powered by GitBook
On this page
  • deleteText
  • getContents
  • getLength
  • getText
  • insertEmbed
  • insertText
  • pasteHTML
  • setContents
  • setText
  • updateContents
  1. 文档(Document)
  2. API

content

deleteText

从编辑器删除文本,返回一个改变的Delta对象。操作来源可能是:‘user’、‘api’或者‘silent’。当编辑器被禁用时,来源‘user’将被忽略。

Methods

deleteText(index: Number, length: Number, source: String = 'api'): Delta

Examples

quill.deleteText(6, 4);

getContents

检索编辑器的内容,格式化返回一个Delta对象。

Methods

getContents(index: Number = 0, length: Number = remaining): Delta

Examples

var delta = quill.getContents();

getLength

检索返回编辑器的内容长度。注意:即使Quill是空的,编辑器仍然有一个‘\n’表示的空行,所以getLength将返回1。

Methods

getLength(): Number

Examples

var length = quill.getLength();

getText

检索并已字符串的方式返回编辑器的内容。非空字符串会被忽略,因此返回的字符串长度可能比getLength返回的编辑器长度短。注意:即使Quill为空,依然存在一个空行,所以在这种情况下getText会返回一个‘\n’。

Methods

// index:开始位置索引  length:结束索引,默认为当前剩余文档的长度
getText(index: Number = 0, length: Number = remaining): String

Examples

var text = quill.getText(0, 10);

insertEmbed

向编辑器中插入嵌入式内容,返回一个改变后的Delta对象。操作来源可能为:‘user’、‘api’或者‘silent’。当编辑器被禁用时,来源‘user’将被忽略。

Methods

insertEmbed(index: Number, type: String, value: any, source: String = 'api'): Delta

Examples

quill.insertEmbed(10, 'image', 'http://quilljs.com/images/cloud.png');

insertText

向编辑器中插入文本,可以使用指定的格式或者多种格式。返回一个改变后的Delta对象。操作来源可能为:‘user’、‘api’或者‘silent’。当编辑器被禁用时,来源‘user’将被忽略。

Methods

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

Examples

quill.insertText(0, 'Hello', 'bold', true);

quill.insertText(5, 'Quill', {
  'color': '#ffff00',
  'italic': true
});

pasteHTML

弃用

这个API已经被移动到Clipboard并且改名。它会在2.0的顶级API中删除。

setContents

用给定的内容覆盖编辑器的内容。内容应该以一个新行或者换行符结束。返回一个改变的Delta。如果被给定的Delta没有无效操作,那么就会作为新的Delta通过。操作来源可能为:‘user’、‘api’或者‘silent’。当编辑器被禁用时,来源‘user’将被忽略。

Methods

setContents(delta: Delta, source: String = 'api'): Delta

Examples

quill.setContents([
  { insert: 'Hello ' },
  { insert: 'World!', attributes: { bold: true } },
  { insert: '\n' }
]);

setText

使用给定的文本设置为编辑器的内容,返回一个改变后的Delta对象。注意:Quill文档必须以一个换行符结束,如果省略将会为你加一个。操作来源可能为:‘user’、‘api’或者‘silent’。当编辑器被禁用时,来源‘user’将被忽略。

Methods

setText(text: String, source: String = 'api'): Delta

Examples

quill.setText('Hello\n');

updateContents

将Delta应用于编辑器的内容,返回一个改变后的Delta对象。如果这个Delta通过没有无效的操作,那么这些Deltas将是相同的。操作来源可能为:‘user’、‘api’或者‘silent’。当编辑器被禁用时,来源‘user’将被忽略。

Methods

updateContents(delta: Delta, source: String = 'api'): Delta

Examples

// 假设编辑器当前包含 [{ insert: 'Hello World!' }]
quill.updateContents(new Delta()
  .retain(6)                  // Keep 'Hello '
  .delete(5)                  // 'World' is deleted
  .insert('Quill')
  .retain(1, { bold: true })  // 将粗体应用于感叹号
});
// 编辑器现在应该是 [
//  { insert: 'Hello Quill' },
//  { insert: '!', attributes: { bold: true} }
// ]
PreviousAPINextformatting

Last updated 5 years ago