8
0

datacontroller.js 7.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207
  1. /**
  2. * @license Copyright (c) 2003-2016, CKSource - Frederico Knabben. All rights reserved.
  3. * For licensing, see LICENSE.md.
  4. */
  5. import Mapper from './conversion/mapper.js';
  6. import ModelConversionDispatcher from './conversion/modelconversiondispatcher.js';
  7. import { insertText } from './conversion/model-to-view-converters.js';
  8. import ViewConversionDispatcher from './conversion/viewconversiondispatcher.js';
  9. import { convertText, convertToModelFragment } from './conversion/view-to-model-converters.js';
  10. import ViewDocumentFragment from './view/documentfragment.js';
  11. import ModelRange from './model/range.js';
  12. import ModelPosition from './model/position.js';
  13. /**
  14. * Controller for the data pipeline. The data pipeline controls how data is retrieved from the document
  15. * and set inside it. Hence, the controller features two methods which allow to {@link engine.DataController#get get}
  16. * and {@link engine.DataController#set set} data of the {@link engine.DataController#model model}
  17. * using given:
  18. *
  19. * * {@link engine.dataProcessor.DataProcessor data processor},
  20. * * {@link engine.conversion.ModelConversionDispatcher model to view} and
  21. * * {@link engine.conversion.ViewConversionDispatcher view to model} converters.
  22. *
  23. * @memberOf engine
  24. */
  25. export default class DataController {
  26. /**
  27. * Creates data controller instance.
  28. *
  29. * @param {engine.model.Document} model Document model.
  30. * @param {engine.dataProcessor.DataProcessor} [dataProcessor] Data processor which should used by the controller.
  31. */
  32. constructor( model, dataProcessor ) {
  33. /**
  34. * Document model.
  35. *
  36. * @readonly
  37. * @member {engine.model.document} engine.DataController#model
  38. */
  39. this.model = model;
  40. /**
  41. * Data processor used during the conversion.
  42. *
  43. * @readonly
  44. * @member {engine.dataProcessor.DataProcessor} engine.DataController#processor
  45. */
  46. this.processor = dataProcessor;
  47. /**
  48. * Mapper used for the conversion. It has no permanent bindings, because they are created when getting data and
  49. * cleared directly after data are converted. However, the mapper is defined as class property, because
  50. * it needs to be passed to the `ModelConversionDispatcher` as a conversion API.
  51. *
  52. * @member {engine.conversion.Mapper} engine.DataController#_mapper
  53. */
  54. this.mapper = new Mapper();
  55. /**
  56. * Model to view conversion dispatcher used by the {@link engine.DataController#get get method}.
  57. * To attach model to view converter to the data pipeline you need to add lister to this property:
  58. *
  59. * data.modelToView( 'insert:$element', customInsertConverter );
  60. *
  61. * Or use {@link engine.conversion.ModelConverterBuilder}:
  62. *
  63. * buildModelConverter().for( data.modelToView ).fromAttribute( 'bold' ).toElement( 'b' );
  64. *
  65. * @readonly
  66. * @member {engine.conversion.ModelConversionDispatcher} engine.DataController#modelToView
  67. */
  68. this.modelToView = new ModelConversionDispatcher( {
  69. mapper: this.mapper
  70. } );
  71. this.modelToView.on( 'insert:$text', insertText(), { priority: 'lowest' } );
  72. /**
  73. * View to model conversion dispatcher used by the {@link engine.DataController#set set method}.
  74. * To attach view to model converter to the data pipeline you need to add lister to this property:
  75. *
  76. * data.viewToModel( 'element', customElementConverter );
  77. *
  78. * Or use {@link engine.conversion.ViewConverterBuilder}:
  79. *
  80. * buildViewConverter().for( data.viewToModel ).fromElement( 'b' ).toAttribute( 'bold', 'true' );
  81. *
  82. * @readonly
  83. * @member {engine.conversion.ViewConversionDispatcher} engine.DataController#viewToModel
  84. */
  85. this.viewToModel = new ViewConversionDispatcher( {
  86. schema: model.schema
  87. } );
  88. // Define default converters for text and elements.
  89. //
  90. // Note that if there is no default converter for the element it will be skipped, for instance `<b>foo</b>` will be
  91. // converted to nothing. We add `convertToModelFragment` as a last converter so it converts children of that
  92. // element to the document fragment so `<b>foo</b>` will be converted to `foo` if there is no converter for `<b>`.
  93. this.viewToModel.on( 'text', convertText(), { priority: 'lowest' } );
  94. this.viewToModel.on( 'element', convertToModelFragment(), { priority: 'lowest' } );
  95. this.viewToModel.on( 'documentFragment', convertToModelFragment(), { priority: 'lowest' } );
  96. }
  97. /**
  98. * Returns model's data converted by the {@link engine.DataController#modelToView model to view converters} and
  99. * formatted by the {@link engine.DataController#processor data processor}.
  100. *
  101. * @param {String} [rootName='main'] Root name.
  102. * @returns {String} Output data.
  103. */
  104. get( rootName = 'main' ) {
  105. // Get model range.
  106. return this.stringify( this.model.getRoot( rootName ) );
  107. }
  108. /**
  109. * Returns the content of the given {@link engine.model.Element model's element} converted by the
  110. * {@link engine.DataController#modelToView model to view converters} and formatted by the
  111. * {@link engine.DataController#processor data processor}.
  112. *
  113. * @param {engine.model.Element} modelElement Element which content will be stringified.
  114. * @returns {String} Output data.
  115. */
  116. stringify( modelElement ) {
  117. // model -> view
  118. const viewDocumentFragment = this.toView( modelElement );
  119. // view -> data
  120. return this.processor.toData( viewDocumentFragment );
  121. }
  122. /**
  123. * Returns the content of the given {@link engine.model.Element model's element} converted by the
  124. * {@link engine.DataController#modelToView model to view converters} to the
  125. * {@link engine.view.DocumentFragment view DocumentFragment}.
  126. *
  127. * @param {engine.model.Element} modelElement Element which content will be stringified.
  128. * @returns {engine.view.DocumentFragment} Output view DocumentFragment.
  129. */
  130. toView( modelElement ) {
  131. const modelRange = ModelRange.createIn( modelElement );
  132. const viewDocumentFragment = new ViewDocumentFragment();
  133. this.mapper.bindElements( modelElement, viewDocumentFragment );
  134. this.modelToView.convertInsertion( modelRange );
  135. this.mapper.clearBindings();
  136. return viewDocumentFragment;
  137. }
  138. /**
  139. * Sets input data parsed by the {@link engine.DataController#processor data processor} and
  140. * converted by the {@link engine.DataController#viewToModel view to model converters}.
  141. *
  142. * This method also creates a batch with all the changes applied. If all you need is to parse data use
  143. * the {@link engine.dataController#parse} method.
  144. *
  145. * @param {String} data Input data.
  146. * @param {String} [rootName='main'] Root name.
  147. */
  148. set( data, rootName = 'main' ) {
  149. // Save to model.
  150. const modelRoot = this.model.getRoot( rootName );
  151. this.model.enqueueChanges( () => {
  152. // Clearing selection is a workaround for ticket #569 (LiveRange loses position after removing data from document).
  153. // After fixing it this code should be removed.
  154. this.model.selection.removeAllRanges();
  155. this.model.selection.clearAttributes();
  156. // Initial batch should be ignored by features like undo, etc.
  157. this.model.batch( 'transparent' )
  158. .remove( ModelRange.createIn( modelRoot ) )
  159. .insert( ModelPosition.createAt( modelRoot, 0 ), this.parse( data ) );
  160. } );
  161. }
  162. /**
  163. * Returns data parsed by the {@link engine.DataController#processor data processor} and then
  164. * converted by the {@link engine.DataController#viewToModel view to model converters}.
  165. *
  166. * @see engine.DataController#set
  167. * @param {String} data Data to parse.
  168. * @param {String} [context='$root'] Base context in which view will be converted to the model. See:
  169. * {@link engine.conversion.ViewConversionDispatcher#convert}.
  170. * @returns {engine.model.DocumentFragment} Parsed data.
  171. */
  172. parse( data, context = '$root' ) {
  173. // data -> view
  174. const viewDocumentFragment = this.processor.toView( data );
  175. // view -> model
  176. return this.viewToModel.convert( viewDocumentFragment, { context: [ context ] } );
  177. }
  178. /**
  179. * Removes all event listeners set by the DataController.
  180. */
  181. destroy() {}
  182. }