downcast-selection-converters.js 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605
  1. /**
  2. * @license Copyright (c) 2003-2018, CKSource - Frederico Knabben. All rights reserved.
  3. * For licensing, see LICENSE.md.
  4. */
  5. import Model from '../../src/model/model';
  6. import ModelElement from '../../src/model/element';
  7. import ModelRange from '../../src/model/range';
  8. import ModelPosition from '../../src/model/position';
  9. import View from '../../src/view/view';
  10. import ViewUIElement from '../../src/view/uielement';
  11. import Mapper from '../../src/conversion/mapper';
  12. import DowncastDispatcher from '../../src/conversion/downcastdispatcher';
  13. import {
  14. convertRangeSelection,
  15. convertCollapsedSelection,
  16. clearAttributes,
  17. } from '../../src/conversion/downcast-selection-converters';
  18. import {
  19. insertElement,
  20. insertText,
  21. wrap,
  22. highlightElement,
  23. highlightText,
  24. removeHighlight
  25. } from '../../src/conversion/downcast-converters';
  26. import createViewRoot from '../view/_utils/createroot';
  27. import { stringify as stringifyView } from '../../src/dev-utils/view';
  28. import { setData as setModelData } from '../../src/dev-utils/model';
  29. describe( 'downcast-selection-converters', () => {
  30. let dispatcher, mapper, model, view, modelDoc, modelRoot, docSelection, viewDoc, viewRoot, viewSelection, highlightDescriptor;
  31. beforeEach( () => {
  32. model = new Model();
  33. modelDoc = model.document;
  34. modelRoot = modelDoc.createRoot();
  35. docSelection = modelDoc.selection;
  36. model.schema.extend( '$text', { allowIn: '$root' } );
  37. view = new View();
  38. viewDoc = view.document;
  39. viewRoot = createViewRoot( viewDoc );
  40. viewSelection = viewDoc.selection;
  41. mapper = new Mapper();
  42. mapper.bindElements( modelRoot, viewRoot );
  43. highlightDescriptor = { classes: 'marker', priority: 1 };
  44. dispatcher = new DowncastDispatcher( { mapper, viewSelection } );
  45. dispatcher.on( 'insert:$text', insertText() );
  46. const strongCreator = ( modelAttributeValue, viewWriter ) => viewWriter.createAttributeElement( 'strong' );
  47. dispatcher.on( 'attribute:bold', wrap( strongCreator ) );
  48. dispatcher.on( 'addMarker:marker', highlightText( highlightDescriptor ) );
  49. dispatcher.on( 'addMarker:marker', highlightElement( highlightDescriptor ) );
  50. dispatcher.on( 'removeMarker:marker', removeHighlight( highlightDescriptor ) );
  51. // Default selection converters.
  52. dispatcher.on( 'selection', clearAttributes(), { priority: 'low' } );
  53. dispatcher.on( 'selection', convertRangeSelection(), { priority: 'low' } );
  54. dispatcher.on( 'selection', convertCollapsedSelection(), { priority: 'low' } );
  55. } );
  56. afterEach( () => {
  57. view.destroy();
  58. } );
  59. describe( 'default converters', () => {
  60. describe( 'range selection', () => {
  61. it( 'in same container', () => {
  62. test(
  63. [ 1, 4 ],
  64. 'foobar',
  65. 'f{oob}ar'
  66. );
  67. } );
  68. it( 'in same container with unicode characters', () => {
  69. test(
  70. [ 2, 6 ],
  71. 'நிலைக்கு',
  72. 'நி{லைக்}கு'
  73. );
  74. } );
  75. it( 'in same container, over attribute', () => {
  76. test(
  77. [ 1, 5 ],
  78. 'fo<$text bold="true">ob</$text>ar',
  79. 'f{o<strong>ob</strong>a}r'
  80. );
  81. } );
  82. it( 'in same container, next to attribute', () => {
  83. test(
  84. [ 1, 2 ],
  85. 'fo<$text bold="true">ob</$text>ar',
  86. 'f{o}<strong>ob</strong>ar'
  87. );
  88. } );
  89. it( 'in same attribute', () => {
  90. test(
  91. [ 2, 4 ],
  92. 'f<$text bold="true">ooba</$text>r',
  93. 'f<strong>o{ob}a</strong>r'
  94. );
  95. } );
  96. it( 'in same attribute, selection same as attribute', () => {
  97. test(
  98. [ 2, 4 ],
  99. 'fo<$text bold="true">ob</$text>ar',
  100. 'fo{<strong>ob</strong>}ar'
  101. );
  102. } );
  103. it( 'starts in text node, ends in attribute #1', () => {
  104. test(
  105. [ 1, 3 ],
  106. 'fo<$text bold="true">ob</$text>ar',
  107. 'f{o<strong>o}b</strong>ar'
  108. );
  109. } );
  110. it( 'starts in text node, ends in attribute #2', () => {
  111. test(
  112. [ 1, 4 ],
  113. 'fo<$text bold="true">ob</$text>ar',
  114. 'f{o<strong>ob</strong>}ar'
  115. );
  116. } );
  117. it( 'starts in attribute, ends in text node', () => {
  118. test(
  119. [ 3, 5 ],
  120. 'fo<$text bold="true">ob</$text>ar',
  121. 'fo<strong>o{b</strong>a}r'
  122. );
  123. } );
  124. it( 'consumes consumable values properly', () => {
  125. // Add callback that will fire before default ones.
  126. // This should prevent default callback doing anything.
  127. dispatcher.on( 'selection', ( evt, data, conversionApi ) => {
  128. expect( conversionApi.consumable.consume( data.selection, 'selection' ) ).to.be.true;
  129. }, { priority: 'high' } );
  130. // Similar test case as the first in this suite.
  131. test(
  132. [ 1, 4 ],
  133. 'foobar',
  134. 'foobar' // No selection in view.
  135. );
  136. } );
  137. it( 'should convert backward selection', () => {
  138. test(
  139. [ 1, 3, 'backward' ],
  140. 'foobar',
  141. 'f{oo}bar'
  142. );
  143. expect( viewSelection.focus.offset ).to.equal( 1 );
  144. } );
  145. } );
  146. describe( 'collapsed selection', () => {
  147. let marker;
  148. it( 'in container', () => {
  149. test(
  150. [ 1, 1 ],
  151. 'foobar',
  152. 'f{}oobar'
  153. );
  154. } );
  155. it( 'in attribute', () => {
  156. test(
  157. [ 3, 3 ],
  158. 'f<$text bold="true">ooba</$text>r',
  159. 'f<strong>oo{}ba</strong>r'
  160. );
  161. } );
  162. it( 'in attribute and marker', () => {
  163. setModelData( model, 'fo<$text bold="true">ob</$text>ar' );
  164. model.change( writer => {
  165. const range = ModelRange.createFromParentsAndOffsets( modelRoot, 1, modelRoot, 5 );
  166. marker = writer.addMarker( 'marker', { range, usingOperation: false } );
  167. writer.setSelection( new ModelRange( ModelPosition.createAt( modelRoot, 3 ) ) );
  168. } );
  169. // Remove view children manually (without firing additional conversion).
  170. viewRoot._removeChildren( 0, viewRoot.childCount );
  171. // Convert model to view.
  172. view.change( writer => {
  173. dispatcher.convertInsert( ModelRange.createIn( modelRoot ), writer );
  174. dispatcher.convertMarkerAdd( marker.name, marker.getRange(), writer );
  175. dispatcher.convertSelection( docSelection, model.markers, writer );
  176. } );
  177. // Stringify view and check if it is same as expected.
  178. expect( stringifyView( viewRoot, viewSelection, { showType: false } ) ).to.equal(
  179. '<div>f<span class="marker">o<strong>o{}b</strong>a</span>r</div>'
  180. );
  181. } );
  182. it( 'in attribute and marker - no attribute', () => {
  183. setModelData( model, 'fo<$text bold="true">ob</$text>ar' );
  184. model.change( writer => {
  185. const range = ModelRange.createFromParentsAndOffsets( modelRoot, 1, modelRoot, 5 );
  186. marker = writer.addMarker( 'marker', { range, usingOperation: false } );
  187. writer.setSelection( new ModelRange( ModelPosition.createAt( modelRoot, 3 ) ) );
  188. writer.removeSelectionAttribute( 'bold' );
  189. } );
  190. // Remove view children manually (without firing additional conversion).
  191. viewRoot._removeChildren( 0, viewRoot.childCount );
  192. // Convert model to view.
  193. view.change( writer => {
  194. dispatcher.convertInsert( ModelRange.createIn( modelRoot ), writer );
  195. dispatcher.convertMarkerAdd( marker.name, marker.getRange(), writer );
  196. dispatcher.convertSelection( docSelection, model.markers, writer );
  197. } );
  198. // Stringify view and check if it is same as expected.
  199. expect( stringifyView( viewRoot, viewSelection, { showType: false } ) )
  200. .to.equal( '<div>f<span class="marker">o<strong>o</strong>[]<strong>b</strong>a</span>r</div>' );
  201. } );
  202. it( 'in marker - using highlight descriptor creator', () => {
  203. dispatcher.on( 'addMarker:marker2', highlightText(
  204. data => ( { classes: data.markerName } )
  205. ) );
  206. setModelData( model, 'foobar' );
  207. model.change( writer => {
  208. const range = ModelRange.createFromParentsAndOffsets( modelRoot, 1, modelRoot, 5 );
  209. marker = writer.addMarker( 'marker2', { range, usingOperation: false } );
  210. writer.setSelection( new ModelRange( ModelPosition.createAt( modelRoot, 3 ) ) );
  211. } );
  212. // Remove view children manually (without firing additional conversion).
  213. viewRoot._removeChildren( 0, viewRoot.childCount );
  214. // Convert model to view.
  215. view.change( writer => {
  216. dispatcher.convertInsert( ModelRange.createIn( modelRoot ), writer );
  217. dispatcher.convertMarkerAdd( marker.name, marker.getRange(), writer );
  218. dispatcher.convertSelection( docSelection, model.markers, writer );
  219. } );
  220. // Stringify view and check if it is same as expected.
  221. expect( stringifyView( viewRoot, viewSelection, { showType: false } ) )
  222. .to.equal( '<div>f<span class="marker2">oo{}ba</span>r</div>' );
  223. } );
  224. it( 'should do nothing if creator return null', () => {
  225. dispatcher.on( 'addMarker:marker3', highlightText( () => null ) );
  226. setModelData( model, 'foobar' );
  227. model.change( writer => {
  228. const range = ModelRange.createFromParentsAndOffsets( modelRoot, 1, modelRoot, 5 );
  229. marker = writer.addMarker( 'marker3', { range, usingOperation: false } );
  230. writer.setSelection( new ModelRange( ModelPosition.createAt( modelRoot, 3 ) ) );
  231. } );
  232. // Remove view children manually (without firing additional conversion).
  233. viewRoot._removeChildren( 0, viewRoot.childCount );
  234. // Convert model to view.
  235. view.change( writer => {
  236. dispatcher.convertInsert( ModelRange.createIn( modelRoot ), writer );
  237. dispatcher.convertMarkerAdd( marker.name, marker.getRange(), writer );
  238. dispatcher.convertSelection( docSelection, model.markers, writer );
  239. } );
  240. // Stringify view and check if it is same as expected.
  241. expect( stringifyView( viewRoot, viewSelection, { showType: false } ) )
  242. .to.equal( '<div>foo{}bar</div>' );
  243. } );
  244. // #1072 - if the container has only ui elements, collapsed selection attribute should be rendered after those ui elements.
  245. it( 'selection with attribute before ui element - no non-ui children', () => {
  246. setModelData( model, '' );
  247. // Add two ui elements to view.
  248. viewRoot._appendChild( [
  249. new ViewUIElement( 'span' ),
  250. new ViewUIElement( 'span' )
  251. ] );
  252. model.change( writer => {
  253. writer.setSelection( new ModelRange( new ModelPosition( modelRoot, [ 0 ] ) ) );
  254. writer.setSelectionAttribute( 'bold', true );
  255. } );
  256. // Convert model to view.
  257. view.change( writer => {
  258. dispatcher.convertSelection( docSelection, model.markers, writer );
  259. } );
  260. // Stringify view and check if it is same as expected.
  261. expect( stringifyView( viewRoot, viewSelection, { showType: false } ) )
  262. .to.equal( '<div><span></span><span></span><strong>[]</strong></div>' );
  263. } );
  264. // #1072.
  265. it( 'selection with attribute before ui element - has non-ui children #1', () => {
  266. setModelData( model, 'x' );
  267. model.change( writer => {
  268. writer.setSelection( new ModelRange( new ModelPosition( modelRoot, [ 1 ] ) ) );
  269. writer.setSelectionAttribute( 'bold', true );
  270. } );
  271. // Convert model to view.
  272. view.change( writer => {
  273. dispatcher.convertInsert( ModelRange.createIn( modelRoot ), writer );
  274. // Add ui element to view.
  275. const uiElement = new ViewUIElement( 'span' );
  276. viewRoot._insertChild( 1, uiElement );
  277. dispatcher.convertSelection( docSelection, model.markers, writer );
  278. } );
  279. // Stringify view and check if it is same as expected.
  280. expect( stringifyView( viewRoot, viewSelection, { showType: false } ) )
  281. .to.equal( '<div>x<strong>[]</strong><span></span></div>' );
  282. } );
  283. // #1072.
  284. it( 'selection with attribute before ui element - has non-ui children #2', () => {
  285. setModelData( model, '<$text bold="true">x</$text>y' );
  286. model.change( writer => {
  287. writer.setSelection( new ModelRange( new ModelPosition( modelRoot, [ 1 ] ) ) );
  288. writer.setSelectionAttribute( 'bold', true );
  289. } );
  290. // Convert model to view.
  291. view.change( writer => {
  292. dispatcher.convertInsert( ModelRange.createIn( modelRoot ), writer );
  293. // Add ui element to view.
  294. const uiElement = new ViewUIElement( 'span' );
  295. viewRoot._insertChild( 1, uiElement, writer );
  296. dispatcher.convertSelection( docSelection, model.markers, writer );
  297. } );
  298. // Stringify view and check if it is same as expected.
  299. expect( stringifyView( viewRoot, viewSelection, { showType: false } ) )
  300. .to.equal( '<div><strong>x{}</strong><span></span>y</div>' );
  301. } );
  302. it( 'consumes consumable values properly', () => {
  303. // Add callbacks that will fire before default ones.
  304. // This should prevent default callbacks doing anything.
  305. dispatcher.on( 'selection', ( evt, data, conversionApi ) => {
  306. expect( conversionApi.consumable.consume( data.selection, 'selection' ) ).to.be.true;
  307. }, { priority: 'high' } );
  308. dispatcher.on( 'attribute:bold', ( evt, data, conversionApi ) => {
  309. expect( conversionApi.consumable.consume( data.item, 'attribute:bold' ) ).to.be.true;
  310. }, { priority: 'high' } );
  311. // Similar test case as above.
  312. test(
  313. [ 3, 3 ],
  314. 'f<$text bold="true">ooba</$text>r',
  315. 'foobar' // No selection in view and no attribute.
  316. );
  317. } );
  318. } );
  319. } );
  320. describe( 'clean-up', () => {
  321. describe( 'convertRangeSelection', () => {
  322. it( 'should remove all ranges before adding new range', () => {
  323. test(
  324. [ 0, 2 ],
  325. 'foobar',
  326. '{fo}obar'
  327. );
  328. test(
  329. [ 3, 5 ],
  330. 'foobar',
  331. 'foo{ba}r'
  332. );
  333. expect( viewSelection.rangeCount ).to.equal( 1 );
  334. } );
  335. } );
  336. describe( 'convertCollapsedSelection', () => {
  337. it( 'should remove all ranges before adding new range', () => {
  338. test(
  339. [ 2, 2 ],
  340. 'foobar',
  341. 'fo{}obar'
  342. );
  343. test(
  344. [ 3, 3 ],
  345. 'foobar',
  346. 'foo{}bar'
  347. );
  348. expect( viewSelection.rangeCount ).to.equal( 1 );
  349. } );
  350. } );
  351. describe( 'clearAttributes', () => {
  352. it( 'should remove all ranges before adding new range', () => {
  353. test(
  354. [ 3, 3 ],
  355. 'foobar',
  356. 'foo<strong>[]</strong>bar',
  357. { bold: 'true' }
  358. );
  359. view.change( writer => {
  360. const modelRange = ModelRange.createFromParentsAndOffsets( modelRoot, 1, modelRoot, 1 );
  361. model.change( writer => {
  362. writer.setSelection( modelRange );
  363. } );
  364. dispatcher.convertSelection( modelDoc.selection, model.markers, writer );
  365. } );
  366. expect( viewSelection.rangeCount ).to.equal( 1 );
  367. const viewString = stringifyView( viewRoot, viewSelection, { showType: false } );
  368. expect( viewString ).to.equal( '<div>f{}oobar</div>' );
  369. } );
  370. it( 'should do nothing if the attribute element had been already removed', () => {
  371. test(
  372. [ 3, 3 ],
  373. 'foobar',
  374. 'foo<strong>[]</strong>bar',
  375. { bold: 'true' }
  376. );
  377. view.change( writer => {
  378. // Remove <strong></strong> manually.
  379. writer.mergeAttributes( viewSelection.getFirstPosition() );
  380. const modelRange = ModelRange.createFromParentsAndOffsets( modelRoot, 1, modelRoot, 1 );
  381. model.change( writer => {
  382. writer.setSelection( modelRange );
  383. } );
  384. dispatcher.convertSelection( modelDoc.selection, model.markers, writer );
  385. } );
  386. expect( viewSelection.rangeCount ).to.equal( 1 );
  387. const viewString = stringifyView( viewRoot, viewSelection, { showType: false } );
  388. expect( viewString ).to.equal( '<div>f{}oobar</div>' );
  389. } );
  390. it( 'should clear fake selection', () => {
  391. const modelRange = ModelRange.createFromParentsAndOffsets( modelRoot, 1, modelRoot, 1 );
  392. view.change( writer => {
  393. writer.setSelection( modelRange, { fake: true } );
  394. dispatcher.convertSelection( docSelection, model.markers, writer );
  395. } );
  396. expect( viewSelection.isFake ).to.be.false;
  397. } );
  398. } );
  399. } );
  400. describe( 'table cell selection converter', () => {
  401. beforeEach( () => {
  402. model.schema.register( 'table' );
  403. model.schema.register( 'tr' );
  404. model.schema.register( 'td' );
  405. model.schema.extend( 'table', { allowIn: '$root' } );
  406. model.schema.extend( 'tr', { allowIn: 'table' } );
  407. model.schema.extend( 'td', { allowIn: 'tr' } );
  408. model.schema.extend( '$text', { allowIn: 'td' } );
  409. // "Universal" converter to convert table structure.
  410. const containerCreator = ( modelElement, viewWriter ) => viewWriter.createContainerElement( modelElement.name );
  411. const tableConverter = insertElement( containerCreator );
  412. dispatcher.on( 'insert:table', tableConverter );
  413. dispatcher.on( 'insert:tr', tableConverter );
  414. dispatcher.on( 'insert:td', tableConverter );
  415. // Special converter for table cells.
  416. dispatcher.on( 'selection', ( evt, data, conversionApi ) => {
  417. const selection = data.selection;
  418. if ( !conversionApi.consumable.test( selection, 'selection' ) || selection.isCollapsed ) {
  419. return;
  420. }
  421. for ( const range of selection.getRanges() ) {
  422. const node = range.start.nodeAfter;
  423. if ( node == range.end.nodeBefore && node instanceof ModelElement && node.name == 'td' ) {
  424. conversionApi.consumable.consume( selection, 'selection' );
  425. const viewNode = conversionApi.mapper.toViewElement( node );
  426. conversionApi.writer.addClass( 'selected', viewNode );
  427. }
  428. }
  429. } );
  430. } );
  431. it( 'should not be used to convert selection that is not on table cell', () => {
  432. test(
  433. [ 1, 5 ],
  434. 'f{o<$text bold="true">ob</$text>a}r',
  435. 'f{o<strong>ob</strong>a}r'
  436. );
  437. } );
  438. it( 'should add a class to the selected table cell', () => {
  439. test(
  440. // table tr#0 |td#0, table tr#0 td#0|
  441. [ [ 0, 0, 0 ], [ 0, 0, 1 ] ],
  442. '<table><tr><td>foo</td></tr><tr><td>bar</td></tr></table>',
  443. '<table><tr><td class="selected">foo</td></tr><tr><td>bar</td></tr></table>'
  444. );
  445. } );
  446. it( 'should not be used if selection contains more than just a table cell', () => {
  447. test(
  448. // table tr td#1, table tr#2
  449. [ [ 0, 0, 0, 1 ], [ 0, 0, 2 ] ],
  450. '<table><tr><td>foo</td><td>bar</td></tr></table>',
  451. '<table><tr><td>f{oo</td><td>bar</td>]</tr></table>'
  452. );
  453. } );
  454. } );
  455. // Tests if the selection got correctly converted.
  456. // Because `setData` might use selection converters itself to set the selection, we can't use it
  457. // to set the selection (because then we would test converters using converters).
  458. // Instead, the `test` function expects to be passed `selectionPaths` which is an array containing two numbers or two arrays,
  459. // that are offsets or paths of selection positions in root element.
  460. function test( selectionPaths, modelInput, expectedView, selectionAttributes = {} ) {
  461. // Parse passed `modelInput` string and set it as current model.
  462. setModelData( model, modelInput );
  463. // Manually set selection ranges using passed `selectionPaths`.
  464. const startPath = typeof selectionPaths[ 0 ] == 'number' ? [ selectionPaths[ 0 ] ] : selectionPaths[ 0 ];
  465. const endPath = typeof selectionPaths[ 1 ] == 'number' ? [ selectionPaths[ 1 ] ] : selectionPaths[ 1 ];
  466. const startPos = new ModelPosition( modelRoot, startPath );
  467. const endPos = new ModelPosition( modelRoot, endPath );
  468. const isBackward = selectionPaths[ 2 ] === 'backward';
  469. model.change( writer => {
  470. writer.setSelection( new ModelRange( startPos, endPos ), { backward: isBackward } );
  471. // And add or remove passed attributes.
  472. for ( const key in selectionAttributes ) {
  473. const value = selectionAttributes[ key ];
  474. if ( value ) {
  475. writer.setSelectionAttribute( key, value );
  476. } else {
  477. writer.removeSelectionAttribute( key );
  478. }
  479. }
  480. } );
  481. // Remove view children manually (without firing additional conversion).
  482. viewRoot._removeChildren( 0, viewRoot.childCount );
  483. // Convert model to view.
  484. view.change( writer => {
  485. dispatcher.convertInsert( ModelRange.createIn( modelRoot ), writer );
  486. dispatcher.convertSelection( docSelection, model.markers, writer );
  487. } );
  488. // Stringify view and check if it is same as expected.
  489. expect( stringifyView( viewRoot, viewSelection, { showType: false } ) ).to.equal( '<div>' + expectedView + '</div>' );
  490. }
  491. } );