|
|
@@ -370,13 +370,28 @@ export default class Model {
|
|
|
* editor.model.insertContent( writer.createText( 'x' ), writer.createPositionAt( doc.getRoot(), 2 ) );
|
|
|
* } );
|
|
|
*
|
|
|
- * If an instance of {@link module:engine/model/selection~Selection} is passed as `selectable`
|
|
|
- * it will be moved to the target position (where the document selection should be moved after the insertion).
|
|
|
+ * If you want the document selection to be moved to the inserted content, use the
|
|
|
+ * {@link module:engine/model/writer~Writer#setSelection `setSelection()`} method of the writer after inserting
|
|
|
+ * the content:
|
|
|
*
|
|
|
* editor.model.change( writer => {
|
|
|
- * // Insert text replacing the given selection instance.
|
|
|
+ * const paragraph = writer.createElement( 'paragraph' );
|
|
|
+ *
|
|
|
+ * // Insert an empty paragraph at the beginning of the root.
|
|
|
+ * editor.model.insertContent( paragraph, writer.createPositionAt( editor.model.document.getRoot(), 0 ) );
|
|
|
+ *
|
|
|
+ * // Move the document selection to the inserted paragraph.
|
|
|
+ * writer.setSelection( paragraph, 'in' );
|
|
|
+ * } );
|
|
|
+ *
|
|
|
+ * If an instance of the {@link module:engine/model/selection~Selection model selection} is passed as `selectable`,
|
|
|
+ * the new content will be inserted at the passed selection (instead of document selection):
|
|
|
+ *
|
|
|
+ * editor.model.change( writer => {
|
|
|
+ * // Create a selection in a paragraph that will be used as a place of insertion.
|
|
|
* const selection = writer.createSelection( paragraph, 'in' );
|
|
|
*
|
|
|
+ * // Insert the new text at the created selection.
|
|
|
* editor.model.insertContent( writer.createText( 'x' ), selection );
|
|
|
*
|
|
|
* // insertContent() modifies the passed selection instance so it can be used to set the document selection.
|