fixing wrapping DocumentElements
[fnpeditor.git] / modules / documentCanvas / canvas / canvas.test3.js
1 define([
2 'libs/chai',
3 'modules/documentCanvas/canvas/canvas',
4 'modules/documentCanvas/canvas/documentElement'
5 ], function(chai, canvas, documentElement) {
6     
7 'use strict';
8
9 var expect = chai.expect;
10
11
12 describe('Canvas', function() {
13
14     describe('Internal HTML representation of a sample document', function() {
15         it('works', function() {
16             var c = canvas.fromXML('\
17                 <section>\
18                     This is some text without its own wrapping tag.\
19                     <div class="p.subclass">\
20                         This is a paragraph.\
21                     </div>\
22                     <div>\
23                         This is text in a div <span>with some inline text</span>.\
24                     </div>\
25                     This is some text without its own wrapping tag.\
26                 </section>\
27             ');
28             var expected = '<div wlxml-tag="section">'
29                             + 'This is some text without its own wrapping tag.'
30                             + '<div wlxml-tag="div" wlxml-class="p-subclass">This is a paragraph.</div>'
31                             + '<div wlxml-tag="div">This is text in a div <div wlxml-tag="span">with some inline text</div>.</div>'
32                             + 'This is some text without its own wrapping tag.'
33                             + '</div>';
34             expect(c.doc().dom()[0].isEqualNode($(expected)[0])).to.be.true;
35         });
36     });
37
38     describe('Internal HTML representation of a DocumentNodeElement', function() {
39         it('is always a div tag', function() {
40             ['section', 'header', 'span', 'aside', 'figure'].forEach(function(tagName) {
41                 var dom = canvas.fromXML('<' + tagName + '></' + tagName + '>').doc().dom();
42                 expect(dom.prop('tagName')).to.equal('DIV', tagName + ' is represented as div');
43             });
44         });
45         it('has wlxml tag put into wlxml-tag attribute', function() {
46             var dom = canvas.fromXML('<section></section>').doc().dom();
47             expect(dom.attr('wlxml-tag')).to.equal('section');
48         });
49         it('has wlxml class put into wlxml-class, dots replaced with dashes', function() {
50             var dom = canvas.fromXML('<section class="some.class"></section>').doc().dom();
51             expect(dom.attr('wlxml-class')).to.equal('some-class');
52         });
53     });
54
55     describe('Internal HTML representation of a DocumentTextElement', function() {
56         it('is just a TextNode', function() {
57             var dom = canvas.fromXML('<section>Alice</section>').doc().children()[0].dom();
58             expect(dom[0].nodeType === Node.TEXT_NODE);
59         });
60     });
61
62     describe('basic properties', function() {
63         it('renders empty document when canvas created from empty XML', function() {
64             var c = canvas.fromXML('');
65             expect(c.doc()).to.equal(null);
66         });
67
68         it('gives access to its document root node', function() {
69             var c = canvas.fromXML('<section></section>');
70             expect(c.doc().wlxmlTag).to.equal('section');
71         });
72
73         describe('DocumentTextElement', function() {
74             it('can have its content set', function() {
75                 var c = canvas.fromXML('<section>Alice</section>'),
76                     root = c.doc(),
77                     text = root.children()[0];
78                 
79                 text.setText('a cat');
80                 expect(root.children()[0].getText()).to.equal('a cat');
81             });
82         });
83
84         describe('DocumentNodeElement', function() {
85             it('knows index of its child', function() {
86                 var c = canvas.fromXML('<section><div></div><header></header><span></span></section>'),
87                     root = c.doc(),
88                     child = root.children()[1];
89                 expect(root.childIndex(child)).to.equal(1);
90             });
91
92             it('knows WLXML tag it renders', function(){
93                 var c = canvas.fromXML('<section></section>'),
94                     section = c.doc();
95                 expect(section.getWlxmlTag()).to.equal('section', 'initial tag is section');
96                 section.setWlxmlTag('header');
97                 expect(section.getWlxmlTag()).to.equal('header', 'tag is changed to header');
98             });
99
100             it('knows WLXML class of a WLXML tag it renders', function(){
101                 var c = canvas.fromXML('<section class="some.class"></section>'),
102                     section = c.doc();
103                 expect(section.getWlxmlClass()).to.equal('some.class');
104                 section.setWlxmlClass('some.other.class');
105                 expect(section.getWlxmlClass()).to.equal('some.other.class');
106                 section.setWlxmlClass(null);
107                 expect(section.getWlxmlClass()).to.be.undefined;
108             });
109         });
110     });
111
112
113
114     describe('document representation api', function() {
115         describe('document root element', function() {
116             var c = canvas.fromXML('<section></section>');
117             it('exists', function() {
118                 expect(c.doc()).to.be.instanceOf(documentElement.DocumentElement);
119             });
120             it('is of type DocumentNodeElement', function() {
121                 expect(c.doc()).to.be.instanceOf(documentElement.DocumentNodeElement);
122             });
123         });
124
125         describe('DocumentElements comparison', function() {
126             it('reports dwo DocumentElements to be the same when they represent the same wlxml document element', function() {
127                 var c = canvas.fromXML('<section><div></div><div></div></section>'),
128                     first_div1 = c.doc().children()[0],
129                     first_div2 = c.doc().children()[0],
130                     second_div = c.doc().children()[1];
131                 expect(first_div1.sameNode(first_div1)).to.be.true;
132                 expect(first_div1.sameNode(first_div2)).to.be.true;
133                 expect(first_div1.sameNode(second_div)).to.be.false;
134             });
135         });
136
137         describe('traversing', function() {
138             it('reports element nodes', function() {
139                 var c = canvas.fromXML('<section><div></div></section>'),
140                     children = c.doc().children();
141                 expect(children.length).to.equal(1);
142                 expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
143
144                 c = canvas.fromXML('<section><div></div><div></div></section>'),
145                     children = c.doc().children();
146                 expect(children.length).to.equal(2);
147                 expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
148                 expect(children[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
149             });
150             
151             it('reports text nodes', function() {
152                 var c = canvas.fromXML('<section>Alice</section>'),
153                     children = c.doc().children();
154                 expect(children.length).to.equal(1);
155                 expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
156             });
157
158             describe('accessing parents', function() {
159                 it('returns DocumentNodeElement representing parent in wlxml document as DocumentNodeElement parent', function() {
160                     var c = canvas.fromXML('<section><div></div></section>'),
161                         div = c.doc().children()[0];
162                     expect(div.parent().sameNode(c.doc())).to.be.true;
163                 });
164                 it('returns DocumentNodeElement representing parent in wlxml document as DocumentTextElement parent', function() {
165                     var c = canvas.fromXML('<section>Alice</section>'),
166                         text = c.doc().children()[0];
167                     expect(text.parent().sameNode(c.doc())).to.be.true;
168                 });
169             });
170
171             describe('free text handling', function() {
172                     it('sees free text', function() {
173                         var c = canvas.fromXML('<section>Alice <span>has</span> a cat</section>'),
174                             children = c.doc().children();
175                         expect(children.length).to.equal(3);
176                         expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
177                         expect(children[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
178                         expect(children[2]).to.be.instanceOf(documentElement.DocumentTextElement);
179                     });
180             });
181             
182             describe('white characters handling', function() {
183                 it('says empty element node has no children', function() {
184                     var c = canvas.fromXML('<section></section>');
185                     expect(c.doc().children().length).to.equal(0);
186                 });
187                 it('says element node with one space has one DocumentTextElement', function() {
188                     var c = canvas.fromXML('<section> </section>');
189                     expect(c.doc().children().length).to.equal(1);
190                     expect(c.doc().children()[0]).to.be.instanceOf(documentElement.DocumentTextElement);
191                     expect(c.doc().children()[0].getText()).to.equal(' ');
192                 });
193                 it('ignores white space surrounding block elements', function() {
194                     var c = canvas.fromXML('<section> <div></div> </section>');
195                     var children = c.doc().children();
196                     expect(children.length).to.equal(1);
197                     expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
198                 });
199                 it('ignores white space between block elements', function() {
200                     var c = canvas.fromXML('<section><div></div> <div></div></section>');
201                     var children = c.doc().children();
202                     expect(children.length === 2);
203                     [0,1].forEach(function(idx) {
204                         expect(children[idx]).to.be.instanceOf(documentElement.DocumentNodeElement);
205                     });
206                 });
207
208                 it('trims white space from the beginning and the end of the block elements', function() {
209                     var c = canvas.fromXML('<section> Alice <span>has</span> a cat </section>');
210                     expect(c.doc().children()[0].getText()).to.equal('Alice ');
211                     expect(c.doc().children()[2].getText()).to.equal(' a cat');
212                 });
213
214                 it('normalizes string of white characters to one space at the inline element boundries', function() {
215                     var c = canvas.fromXML('<span>   Alice has a cat   </span>');
216                     expect(c.doc().children()[0].getText()).to.equal(' Alice has a cat ');
217                 });
218
219                 it('normalizes string of white characters to one space before inline element', function() {
220                     var c = canvas.fromXML('<div>Alice has  <span>a cat</span></div>');
221                     expect(c.doc().children()[0].getText()).to.equal('Alice has ');
222                 });
223                 
224                 it('normalizes string of white characters to one space after inline element', function() {
225                     var c = canvas.fromXML('<div>Alice has <span>a</span>  cat</div>');
226                     expect(c.doc().children()[2].getText()).to.equal(' cat');
227                 });
228             });
229         });
230
231         describe('manipulation api', function() {
232
233             describe('Basic Element inserting', function() {
234                 it('can put new NodeElement at the end', function() {
235                     var c = canvas.fromXML('<section></section>'),
236                         appended = c.doc().append({tag: 'header', klass: 'some.class'}),
237                         children = c.doc().children();
238
239                     expect(children.length).to.equal(1);
240                     expect(children[0].sameNode(appended));
241                 });
242
243                 it('can put new TextElement at the end', function() {
244                     var c = canvas.fromXML('<section></section>'),
245                         appended = c.doc().append({text: 'Alice'}),
246                         children = c.doc().children();
247
248                     expect(children.length).to.equal(1);
249                     expect(children[0].sameNode(appended));
250                     expect(children[0].getText()).to.equal('Alice');
251                 });
252
253                 it('can put new NodeElement after another NodeElement', function() {
254                     var c = canvas.fromXML('<section><div></div></section>'),
255                         div = c.doc().children()[0],
256                         added = div.after({tag: 'header', klass: 'some.class'}),
257                         children = c.doc().children();
258                     expect(children.length).to.equal(2);
259                     expect(children[1].sameNode(added));
260                 });
261
262                 it('can put new Nodeelement before another element', function() {
263                     var c = canvas.fromXML('<section><div></div></section>'),
264                         div = c.doc().children()[0],
265                         added = div.before({tag: 'header', klass: 'some.class'}),
266                         children = c.doc().children();
267                     expect(children.length).to.equal(2);
268                     expect(children[0].sameNode(added));
269                 });
270
271                 it('can put new DocumentNodeElement after DocumentTextElement', function() {
272                     var c = canvas.fromXML('<section>Alice</section>'),
273                         text = c.doc().children()[0],
274                         added = text.after({tag: 'p'}),
275                         children = c.doc().children();
276
277                     expect(children.length).to.equal(2);
278                     expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
279                     expect(children[0].getText()).to.equal('Alice');
280                     expect(children[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
281                     expect(children[1].sameNode(added)).to.be.true;
282                 });
283                 it('can put new DocumentNodeElement before DocumentTextElement', function() {
284                     var c = canvas.fromXML('<section>Alice</section>'),
285                         text = c.doc().children()[0],
286                         added = text.before({tag: 'p'}),
287                         children = c.doc().children();
288
289                     expect(children.length).to.equal(2);
290                     expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
291                     expect(children[0].sameNode(added)).to.be.true;
292                     expect(children[1]).to.be.instanceOf(documentElement.DocumentTextElement);
293                     expect(children[1].getText()).to.equal('Alice');
294                 });
295             });
296
297             describe('Splitting text', function() {
298                 
299                 it('splits DocumentTextElement\'s parent into two DocumentNodeElements of the same type', function() {
300                     var c = canvas.fromXML('<section><header>Some header</header></section>'),
301                         section = c.doc(),
302                         text = section.children()[0].children()[0];
303
304                     text.split({offset: 5});
305                     expect(section.children().length).to.equal(2, 'section has two children');
306                     
307                     var header1 = section.children()[0];
308                     var header2 = section.children()[1];
309
310                     expect(header1.wlxmlTag).to.equal('header', 'first section child represents wlxml header');
311                     expect(header1.children().length).to.equal(1, 'first header has one text child');
312                     expect(header1.children()[0].getText()).to.equal('Some ', 'first header has correct content');
313                     expect(header2.wlxmlTag).to.equal('header', 'second section child represents wlxml header');
314                     expect(header2.children().length).to.equal(1, 'second header has one text child');
315                     expect(header2.children()[0].getText()).to.equal('header', 'second header has correct content');
316                 });
317
318                 it('keeps DocumentTextElement\'s parent\'s children elements intact', function() {
319                     var c = canvas.fromXML('\
320                             <section>\
321                                 <header>\
322                                     A <span>fancy</span> and <span>nice</span> header\
323                                 </header>\
324                             </section>'),
325                         section = c.doc(),
326                         header = section.children()[0],
327                         textAnd = header.children()[2];
328
329                     textAnd.split({offset: 2});
330                     
331                     var sectionChildren = section.children();
332                     expect(sectionChildren.length).to.equal(2, 'Section has two children');
333                     expect(sectionChildren[0].wlxmlTag).to.equal('header', 'First section element is a wlxml header');
334                     expect(sectionChildren[1].wlxmlTag).to.equal('header', 'Second section element is a wlxml header');
335
336                     var firstHeaderChildren = sectionChildren[0].children();
337                     expect(firstHeaderChildren.length).to.equal(3, 'First header has three children');
338                     expect(firstHeaderChildren[0].getText()).to.equal('A ', 'First header starts with a text');
339                     expect(firstHeaderChildren[1].wlxmlTag).to.equal('span', 'First header has span in the middle');
340                     expect(firstHeaderChildren[2].getText()).to.equal(' a', 'First header ends with text');
341
342                     var secondHeaderChildren = sectionChildren[1].children();
343                     expect(secondHeaderChildren.length).to.equal(3, 'Second header has three children');
344                     expect(secondHeaderChildren[0].getText()).to.equal('nd ', 'Second header starts with text');
345                     expect(secondHeaderChildren[1].wlxmlTag).to.equal('span', 'Second header has span in the middle');
346                     expect(secondHeaderChildren[2].getText()).to.equal(' header', 'Second header ends with text');
347                 });
348             });
349
350             describe('wrapping', function() {
351                 it('wraps DocumentNodeElement', function() {
352                     var c = canvas.fromXML('<section><div></div></section>'),
353                         div = c.doc().children()[0];
354                     
355                     var returned = div.wrapWithNodeElement({tag: 'header', klass: 'some.class'}),
356                         parent = div.parent(),
357                         parent2 = c.doc().children()[0];
358
359                     expect(returned.sameNode(parent)).to.be.true;
360                     expect(returned.sameNode(parent2)).to.be.true;
361                     expect(returned.getWlxmlTag()).to.equal('header');
362                     expect(returned.getWlxmlClass()).to.equal('some.class');
363                 });
364                 it('wraps DocumentTextElement', function() {
365                     var c = canvas.fromXML('<section>Alice</section>'),
366                         text = c.doc().children()[0];
367                     
368                     var returned = text.wrapWithNodeElement({tag: 'header', klass: 'some.class'}),
369                         parent = text.parent(),
370                         parent2 = c.doc().children()[0];
371
372                     expect(returned.sameNode(parent)).to.be.true;
373                     expect(returned.sameNode(parent2)).to.be.true;
374                     expect(returned.getWlxmlTag()).to.equal('header');
375                     expect(returned.getWlxmlClass()).to.equal('some.class');
376                 });
377                 
378                 it('wraps part of DocumentTextElement', function() {
379                     var c = canvas.fromXML('<section>Alice has a cat</section>'),
380                         text = c.doc().children()[0];
381                     
382                     var returned = text.wrapWithNodeElement({tag: 'header', klass: 'some.class', start: 5, end: 12}),
383                         children = c.doc().children();
384
385                     expect(children.length).to.equal(3);
386                     
387                     expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
388                     expect(children[0].getText()).to.equal('Alice');
389
390                     expect(children[1].sameNode(returned)).to.be.true;
391                     expect(returned.getWlxmlTag()).to.equal('header');
392                     expect(returned.getWlxmlClass()).to.equal('some.class');
393                     expect(children[1].children().length).to.equal(1);
394                     expect(children[1].children()[0].getText()).to.equal(' has a ');
395
396                     expect(children[2]).to.be.instanceOf(documentElement.DocumentTextElement);
397                     expect(children[2].getText()).to.equal('cat');
398                 });
399
400                 it('wraps text spanning multiple sibling DocumentTextNodes', function() {
401                     var c = canvas.fromXML('<section>Alice has a <span>small</span> cat</section>'),
402                         section = c.doc(),
403                         wrapper = c.wrapText({
404                             inside: section, 
405                             _with: {tag: 'span', klass: 'some.class'},
406                             offsetStart: 6,
407                             offsetEnd: 4,
408                             textNodeIdx: [0,2]
409                         });
410
411                     expect(section.children().length).to.equal(2);
412                     expect(section.children()[0]).to.be.instanceOf(documentElement.DocumentTextElement);
413                     expect(section.children()[0].getText()).to.equal('Alice ');
414
415                     var wrapper2 = section.children()[1];
416                     expect(wrapper2.sameNode(wrapper)).to.be.true;
417
418                     var wrapperChildren = wrapper.children();
419                     expect(wrapperChildren.length).to.equal(3);
420                     expect(wrapperChildren[0].getText()).to.equal('has a ');
421
422                     expect(wrapperChildren[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
423                     expect(wrapperChildren[1].children().length).to.equal(1);
424                     expect(wrapperChildren[1].children()[0].getText()).to.equal('small');
425
426                     expect(wrapperChildren[2].getText()).to.equal(' cat');
427                 });
428             });
429         });
430
431         describe('Lists api', function() {
432             it('allows creation of a list from existing sibling DocumentElements', function() {
433                 var c = canvas.fromXML('\
434                     <section>\
435                         Alice\
436                         <div>has</div>\
437                         a\
438                         <div>cat</div>\
439                     </section>'),
440                     section = c.doc(),
441                     textAlice = section.children()[0],
442                     divCat = section.children()[3]
443                 
444                 c.list.create({element1: textAlice, element2: divCat});
445
446                 expect(section.children().length).to.equal(1, 'section has one child element');
447
448                 var list = section.children()[0];
449                 expect(list.is('list')).to.equal(true, 'section\'s only child is a list');
450                 expect(list.children().length).to.equal(4, 'list contains four elements');
451                 list.children().forEach(function(child) {
452                     expect(child.getWlxmlClass()).to.equal('item', 'list childs have wlxml class of item');
453                 });
454             });
455
456             describe('extracting list items', function() {
457                 it('creates two lists with extracted items in the middle if extracting from the middle of the list', function() {
458                     var c = canvas.fromXML('\
459                         <section>\
460                             <div class="list.items">\
461                                 <div class="item">0</div>\
462                                 <div class="item">1</div>\
463                                 <div class="item">2</div>\
464                                 <div class="item">3</div>\
465                             </div>\
466                         </section>'),
467                         list = c.doc().children()[0],
468                         item1 = list.children()[1],
469                         item2 = list.children()[2];
470
471                     c.list.extractItems({element1: item1, element2: item2});
472
473                     var section = c.doc(),
474                         list1 = section.children()[0],
475                         oldItem1 = section.children()[1],
476                         oldItem2 = section.children()[2],
477                         list2 = section.children()[3];
478
479                     expect(section.children().length).to.equal(4, 'section contains four children');
480                     
481                     expect(list1.is('list')).to.equal(true, 'first section child is a list');
482                     expect(list1.children().length).to.equal(1, 'first list has one child');
483                     expect(list1.children()[0].children()[0].getText()).to.equal('0', 'first item of the first list is a first item of the original list');
484
485                     expect(oldItem1.children()[0].getText()).to.equal('1', 'first item got extracted');
486                     expect(oldItem1.getWlxmlClass() === undefined).to.equal(true, 'first extracted element has no wlxml class');
487
488                     expect(oldItem2.children()[0].getText()).to.equal('2', 'second item got extracted');
489                     expect(oldItem2.getWlxmlClass() === undefined).to.equal(true, 'second extracted element has no wlxml class');
490
491                     expect(list2.is('list')).to.equal(true, 'last section child is a list');
492                     expect(list2.children().length).to.equal(1, 'second list has one child');
493                     expect(list2.children()[0].children()[0].getText()).to.equal('3', 'first item of the second list is a last item of the original list');
494                 });
495
496                 it('puts extracted items above the list if starting item is the first one', function() {
497                     var c = canvas.fromXML('\
498                         <section>\
499                             <div class="list.items">\
500                                 <div class="item">0</div>\
501                                 <div class="item">1</div>\
502                             </div>\
503                         </section>'),
504                         list = c.doc().children()[0],
505                         item1 = list.children()[0],
506                         item2 = list.children()[1];
507
508                     c.list.extractItems({element1: item1, element2: item1});
509
510                     var section = c.doc(),
511                         oldItem = section.children()[0],
512                         newList = section.children()[1];
513
514                     expect(section.children().length).to.equal(2, 'section has two children');
515                     expect(oldItem.children()[0].getText()).to.equal('0', 'first item extracted');
516                     expect(newList.is('list')).to.equal(true, 'list lies below extracted item');
517                     expect(newList.children().length).to.equal(1, 'list has now one child');
518                 });
519
520                 it('puts extracted items below the list if ending item is the last one', function() {
521                     var c = canvas.fromXML('\
522                         <section>\
523                             <div class="list.items">\
524                                 <div class="item">0</div>\
525                                 <div class="item">1</div>\
526                             </div>\
527                         </section>'),
528                         list = c.doc().children()[0],
529                         item1 = list.children()[0],
530                         item2 = list.children()[1];
531
532                     c.list.extractItems({element1: item2, element2: item2});
533
534                     var section = c.doc(),
535                         oldItem = section.children()[1],
536                         newList = section.children()[0];
537
538                     expect(section.children().length).to.equal(2, 'section has two children');
539                     expect(oldItem.children()[0].getText()).to.equal('1', 'first item extracted');
540                     expect(newList.is('list')).to.equal(true, 'list lies above extracted item');
541                     expect(newList.children().length).to.equal(1, 'list has now one child');
542                 });
543
544                 it('removes list if all its items are extracted', function() {
545                     var c = canvas.fromXML('\
546                         <section>\
547                             <div class="list.items">\
548                                 <div class="item">some item</div>\
549                             </div>\
550                         </section>'),
551                         list = c.doc().children()[0],
552                         item = list.children()[0];
553
554                     c.list.extractItems({element1: item, element2: item});
555
556                     var section = c.doc(),
557                         list1 = section.children()[0],
558                         oldItem1 = section.children()[1],
559                         oldItem2 = section.children()[2],
560                         list2 = section.children()[3];
561
562                     expect(section.children().length).to.equal(1, 'section contains one child');
563                 });
564             });
565         });
566
567     });
568 });
569
570
571 });