CKEDITOR.document和CKEDITOR.dom.document有什么区别？

Question

在ck-editor文档中,CkEDITOR.dom.document被定义为 -

Represents a DOM document.

示例给出 -

var document = new CKEDITOR.dom.document( document )

该函数的参数'document'应该是什么？

同样在CKEDITOR核心代码库中给出了这个定义 -

CKEDITOR.document = new CKEDITOR.dom.document( document );

表示CKEDITOR.document是包含CKEDITOR实例的窗口的文档.例如,可以从窗口的DOM中获取任何内容 -

alert( CKEDITOR.document.getBody().getName() ); // 'body'

我对这两者的重要性以及如何以不同方式使用它们,在何处使用它们感到困惑？

谢谢.

Answer 1

CKEDITOR.document

您注意到CKEDITOR.document的定义如下

CKEDITOR.document = new CKEDITOR.dom.document( document );

这意味着它是CKEditor库的最顶层 document.这是包含和加载库的文档.通常,它也是网页的最顶层文档

window.document === CKEDITOR.document.$ // true

CKEDITOR.document也是所有CKEditor 内联实例的通用文档.所以,如果你创建了许多像

var i1 = CKEDITOR.inline( 'inline1' );
var i2 = CKEDITOR.inline( 'inline2' );

你会注意到他们都共享同一个文件

i1.document.equals( CKEDITOR.document ); // true
i2.document.equals( CKEDITOR.document ); // true 

因为WYSIWYG编辑直接在其中的可信元素中进行CKEDITOR.document.

CKEDITOR.document 和 editor.document

另一方面,网页中可能有许多子文档,即因为每个<iframe>windowwindow.document子文档都是新的和.这正是当你创建一个经典的编辑器实例时会发生的事情,这个实例带来了一个<iframe>带有满足感的主体进行编辑(是的,你正在编辑文本,而<iframe>不是<textarea>).

您可能会注意到每个实例都有自己的单独document(CKEDITOR.editor-property-document),并且这些文档没有与之相关CKEDITOR.document.

var c1 = CKEDITOR.replace( 'textarea1' );
var c2 = CKEDITOR.replace( 'textarea2' );

c1.document.equals( CKEDITOR.document ); // false
c2.document.equals( CKEDITOR.document ); // false
c1.document.equals( c2.document ); // false

每个实例都调用new CKEDITOR.dom.document( documentWithinAnIframe )并分配给它editor.document.

结论

所以总结一下

• CKEDITOR.document是document包含和加载CKEditor库的最顶层的.
• editor.document是与编辑器实例关联的文档.所有内联实例共享同一文档(CKEDITOR.document),而所有经典实例都有自己的文档.
• CKEDITOR.dom.document是CKEditor库的构造函数,它包含本机DOM文档CKEDITOR.dom.domObject,向用户公开了很好的API(如equals()方法),以便在代码中进行操作.
  • 它类似于CKEDITOR.dom.element文档而不是元素.
  • 这两个CKEDITOR.document和editor.document的实例CKEDITOR.dom.document.