| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103 |
- /**
- * @license Copyright (c) 2003-2017, CKSource - Frederico Knabben. All rights reserved.
- * For licensing, see LICENSE.md.
- */
- /**
- * @module enter/entercommand
- */
- import Command from '@ckeditor/ckeditor5-core/src/command';
- import Position from '@ckeditor/ckeditor5-engine/src/model/position';
- /**
- * Enter command. It is used by the {@link module:enter/enter~Enter Enter feature} to handle the <kbd>Enter</kbd> key.
- *
- * @extends module:core/command~Command
- */
- export default class EnterCommand extends Command {
- /**
- * @inheritDoc
- */
- execute() {
- const doc = this.editor.document;
- const batch = doc.batch();
- doc.enqueueChanges( () => {
- enterBlock( this.editor.data, batch, doc.selection, doc.schema );
- this.fire( 'afterExecute', { batch } );
- } );
- }
- }
- // Creates a new block in the way that the <kbd>Enter</kbd> key is expected to work.
- //
- // @param {engine.controller.DataController} dataController
- // @param {module:engine/model/batch~Batch} batch A batch to which the deltas will be added.
- // @param {module:engine/model/selection~Selection} selection Selection on which the action should be performed.
- // @param {module:engine/model/schema~Schema} schema
- function enterBlock( dataController, batch, selection, schema ) {
- const isSelectionEmpty = selection.isCollapsed;
- const range = selection.getFirstRange();
- const startElement = range.start.parent;
- const endElement = range.end.parent;
- // Don't touch the roots and other limit elements.
- if ( schema.limits.has( startElement.name ) || schema.limits.has( endElement.name ) ) {
- // Delete the selected content but only if inside a single limit element.
- // Abort, when crossing limit elements boundary (e.g. <limit1>x[x</limit1>donttouchme<limit2>y]y</limit2>).
- // This is an edge case and it's hard to tell what should actually happen because such a selection
- // is not entirely valid.
- if ( !isSelectionEmpty && startElement == endElement ) {
- dataController.deleteContent( selection, batch );
- }
- return;
- }
- if ( isSelectionEmpty ) {
- splitBlock( batch, selection, range.start );
- } else {
- const leaveUnmerged = !( range.start.isAtStart && range.end.isAtEnd );
- const isContainedWithinOneElement = ( startElement == endElement );
- dataController.deleteContent( selection, batch, { leaveUnmerged } );
- if ( leaveUnmerged ) {
- // Partially selected elements.
- //
- // <h>x[xx]x</h> -> <h>x^x</h> -> <h>x</h><h>^x</h>
- if ( isContainedWithinOneElement ) {
- splitBlock( batch, selection, selection.focus );
- }
- // Selection over multiple elements.
- //
- // <h>x[x</h><p>y]y<p> -> <h>x^</h><p>y</p> -> <h>x</h><p>^y</p>
- else {
- selection.setCollapsedAt( endElement );
- }
- }
- }
- }
- function splitBlock( batch, selection, splitPos ) {
- const oldElement = splitPos.parent;
- const newElement = new oldElement.constructor( oldElement.name, oldElement.getAttributes() );
- if ( splitPos.isAtEnd ) {
- // If the split is at the end of element, instead of splitting, just create a clone of position's parent
- // element and insert it after split element. The result is the same but less operations are done
- // and it's more semantically correct (when it comes to operational transformation).
- batch.insert( Position.createAfter( splitPos.parent ), newElement );
- } else if ( splitPos.isAtStart ) {
- // If the split is at the start of element, instead of splitting, just create a clone of position's parent
- // element and insert it before split element. The result is the same but less operations are done
- // and it's more semantically correct (when it comes to operational transformation).
- batch.insert( Position.createBefore( splitPos.parent ), newElement );
- } else {
- batch.split( splitPos );
- }
- selection.setCollapsedAt( splitPos.parent.nextSibling );
- }
|