mergedelta.js 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
  1. /**
  2. * @license Copyright (c) 2003-2015, CKSource - Frederico Knabben. All rights reserved.
  3. * For licensing, see LICENSE.md.
  4. */
  5. 'use strict';
  6. CKEDITOR.define( [
  7. 'document/delta/delta',
  8. 'document/delta/register',
  9. 'document/position',
  10. 'document/element',
  11. 'document/operation/removeoperation',
  12. 'document/operation/moveoperation',
  13. 'ckeditorerror'
  14. ], ( Delta, register, Position, Element, RemoveOperation, MoveOperation, CKEditorError ) => {
  15. /**
  16. * To provide specific OT behavior and better collisions solving, {@link document.Transaction#merge} method
  17. * use `MergeDelta` class which inherit from `Delta` class and may overwrite some methods.
  18. *
  19. * @class document.delta.MergeDelta
  20. */
  21. class MergeDelta extends Delta {}
  22. /**
  23. * Merge two siblings at the given position.
  24. *
  25. * Node before and after the position have to be an element. Otherwise `transaction-merge-no-element-before` or
  26. * `transaction-merge-no-element-after` error will be thrown.
  27. *
  28. * @chainable
  29. * @memberOf document.Transaction
  30. * @method merge
  31. * @param {document.Position} position Position of merge.
  32. */
  33. register( 'merge', ( doc, transaction, position ) => {
  34. const delta = new MergeDelta();
  35. const nodeBefore = position.nodeBefore;
  36. const nodeAfter = position.nodeAfter;
  37. if ( !( nodeBefore instanceof Element ) ) {
  38. /**
  39. * Node before merge position must be an element.
  40. *
  41. * @error transaction-merge-no-element-before
  42. */
  43. throw new CKEditorError(
  44. 'transaction-merge-no-element-before: Node before merge position must be an element.' );
  45. }
  46. if ( !( nodeAfter instanceof Element ) ) {
  47. /**
  48. * Node after merge position must be an element.
  49. *
  50. * @error transaction-merge-no-element-after
  51. */
  52. throw new CKEditorError(
  53. 'transaction-merge-no-element-after: Node after merge position must be an element.' );
  54. }
  55. const positionAfter = Position.createFromParentAndOffset( nodeAfter, 0 );
  56. const positionBefore = Position.createFromParentAndOffset( nodeBefore, nodeBefore.getChildCount() );
  57. const move = new MoveOperation( positionAfter, positionBefore, nodeAfter.getChildCount(), doc.version );
  58. doc.applyOperation( move );
  59. delta.addOperation( move );
  60. const remove = new RemoveOperation( position, 1, doc.version );
  61. doc.applyOperation( remove );
  62. delta.addOperation( remove );
  63. transaction.addDelta( delta );
  64. } );
  65. return MergeDelta;
  66. } );