describe('Canvas', function() {
- describe('Internal HTML representation of a sample document', function() {
- it('works', function() {
- var c = canvas.fromXML('\
- <section>\
- This is some text without its own wrapping tag.\
- <div class="p.subclass">\
- This is a paragraph.\
- </div>\
- <div>\
- This is text in a div <span>with some inline text</span>.\
- </div>\
- This is some text without its own wrapping tag.\
- </section>\
- ');
- var expected = '<div wlxml-tag="section">'
- + 'This is some text without its own wrapping tag.'
- + '<div wlxml-tag="div" wlxml-class="p-subclass">This is a paragraph.</div>'
- + '<div wlxml-tag="div">This is text in a div <div wlxml-tag="span">with some inline text</div>.</div>'
- + 'This is some text without its own wrapping tag.'
- + '</div>';
- expect(c.doc().dom()[0].isEqualNode($(expected)[0])).to.be.true;
- });
- });
-
describe('Internal HTML representation of a DocumentNodeElement', function() {
it('is always a div tag', function() {
['section', 'header', 'span', 'aside', 'figure'].forEach(function(tagName) {
expect(dom.prop('tagName')).to.equal('DIV', tagName + ' is represented as div');
});
});
- it('has wlxml tag put into wlxml-tag attribute', function() {
+ it('has wlxml tag put into wlxml-tag attribute of its internal container', function() {
var dom = canvas.fromXML('<section></section>').doc().dom();
- expect(dom.attr('wlxml-tag')).to.equal('section');
+ expect(dom.children('[document-element-content]').attr('wlxml-tag')).to.equal('section');
});
- it('has wlxml class put into wlxml-class, dots replaced with dashes', function() {
+ it('has wlxml class put into wlxml-class attribute of its internal containr, dots replaced with dashes', function() {
var dom = canvas.fromXML('<section class="some.class"></section>').doc().dom();
- expect(dom.attr('wlxml-class')).to.equal('some-class');
+ expect(dom.children('[document-element-content]').attr('wlxml-class')).to.equal('some-class');
});
});
describe('Internal HTML representation of a DocumentTextElement', function() {
- it('is just a TextNode', function() {
+ it('is text node wrapped in a div with document-text-element attribute set', function() {
var dom = canvas.fromXML('<section>Alice</section>').doc().children()[0].dom();
- expect(dom[0].nodeType === Node.TEXT_NODE);
+ expect(dom.prop('tagName')).to.equal('DIV');
+ expect(dom.attr('document-text-element')).to.equal('');
+ expect(dom.contents().length).to.equal(1);
+ expect(dom.contents()[0].nodeType).to.equal(Node.TEXT_NODE);
+ expect($(dom.contents()[0]).text()).to.equal('Alice');
});
});
expect(c.doc().getWlxmlTag()).to.equal('section');
});
+ describe('root element', function() {
+ it('has no parent', function() {
+ var c = canvas.fromXML('<section></section>');
+ expect(c.doc().parent()).to.be.null;
+ });
+ });
+
describe('DocumentTextElement', function() {
it('can have its content set', function() {
var c = canvas.fromXML('<section>Alice</section>'),
});
it('knows WLXML class of a WLXML tag it renders', function(){
- var c = canvas.fromXML('<section class="some.class"></section>'),
+ var c = canvas.fromXML('<section class="some.class.A"></section>'),
section = c.doc();
- expect(section.getWlxmlClass()).to.equal('some.class');
- section.setWlxmlClass('some.other.class');
- expect(section.getWlxmlClass()).to.equal('some.other.class');
+ expect(section.getWlxmlClass()).to.equal('some.class.A');
+ section.setWlxmlClass('some.class.B');
+ expect(section.getWlxmlClass()).to.equal('some.class.B');
section.setWlxmlClass(null);
expect(section.getWlxmlClass()).to.be.undefined;
});
+
+
+
+ describe('element has meta attributes', function() {
+ it('can change its meta attributes', function() {
+ var c = canvas.fromXML('<section><span class="uri" meta-uri="someuri"></span></section>'),
+ span = c.doc().children()[0];
+
+ expect(span.getWlxmlMetaAttr('uri')).to.equal('someuri');
+ span.setWlxmlMetaAttr('uri', 'otheruri');
+ expect(span.getWlxmlMetaAttr('uri')).to.equal('otheruri');
+ });
+
+ it('changes its meta attributes with class change', function() {
+ var c = canvas.fromXML('<section><span class="uri" meta-uri="someuri"></span></section>'),
+ span = c.doc().children()[0];
+
+ expect(span.getWlxmlMetaAttr('uri')).to.equal('someuri');
+ span.setWlxmlClass('author');
+ expect(span.getWlxmlMetaAttr('uri')).to.be.undefined;
+ });
+
+ it('keeps meta attribute value on class change if a new class has this attribute', function() {
+ var c = canvas.fromXML('<section><span class="uri" meta-uri="someuri"></span></section>'),
+ span = c.doc().children()[0];
+ span.setWlxmlClass('uri.some.subclass');
+ expect(span.getWlxmlMetaAttr('uri')).to.equal('someuri');
+ });
+ });
});
it('returns DocumentNodeElement instance from HTMLElement', function() {
it('returns DocumentTextElement instance from Text Node', function() {
var c = canvas.fromXML('<section>Alice</section>'),
aliceElement = c.doc().children()[0],
- textNode = aliceElement.dom()[0],
+ textNode = aliceElement.dom().contents()[0],
element = c.getDocumentElement(textNode);
expect(textNode.nodeType).to.equal(Node.TEXT_NODE, 'text node selected');
expect(c.doc().children()[2].getText()).to.equal(' cat');
});
});
+
+ describe('getting vertically first text element', function() {
+ it('returns the first child if it\'s text element, ignores metadata', function() {
+ var c = canvas.fromXML('<section><metadata><dc:author>author</dc:author></metadata>Alice<div>has</div>a cat</section>'),
+ first = c.doc().getVerticallyFirstTextElement();
+
+ expect(first.sameNode(c.doc().children()[1])).to.be.true;
+ });
+
+ it('looks recursively inside node elements if they precede text element', function() {
+ var c = canvas.fromXML('\
+ <section>\
+ <div>\
+ <div>\
+ Alice\
+ </div>\
+ </div>\
+ Some text\
+ </section>'),
+ textAlice = c.doc().children()[0].children()[0].children()[0],
+ first = c.doc().getVerticallyFirstTextElement();
+
+ expect(textAlice).to.be.instanceOf(documentElement.DocumentTextElement);
+ expect(first.sameNode(textAlice)).to.be.true;
+ });
+ });
});
describe('manipulation api', function() {
children = c.doc().children();
expect(children.length).to.equal(1);
- expect(children[0].sameNode(appended));
+ expect(children[0].sameNode(appended)).to.be.true;
});
it('can put new TextElement at the end', function() {
children = c.doc().children();
expect(children.length).to.equal(1);
- expect(children[0].sameNode(appended));
+ expect(children[0].sameNode(appended)).to.be.true;
expect(children[0].getText()).to.equal('Alice');
});
added = div.after({tag: 'header', klass: 'some.class'}),
children = c.doc().children();
expect(children.length).to.equal(2);
- expect(children[1].sameNode(added));
+ expect(children[1].sameNode(added)).to.be.true;
});
it('can put new Nodeelement before another element', function() {
added = div.before({tag: 'header', klass: 'some.class'}),
children = c.doc().children();
expect(children.length).to.equal(2);
- expect(children[0].sameNode(added));
+ expect(children[0].sameNode(added)).to.be.true;
});
it('can put new DocumentNodeElement after DocumentTextElement', function() {
expect(children[1]).to.be.instanceOf(documentElement.DocumentTextElement);
expect(children[1].getText()).to.equal('Alice');
});
+
+ it('can divide DocumentTextElement with a new DocumentNodeElement', function() {
+ var c = canvas.fromXML('<section>Alice has a cat</section>'),
+ section = c.doc(),
+ text = section.children()[0];
+
+ var returned = text.divide({tag: 'aside', klass: 'footnote', offset: 5}),
+ sectionChildren = section.children(),
+ lhsText = sectionChildren[0],
+ rhsText = sectionChildren[2];
+
+ expect(lhsText.getText()).to.equal('Alice');
+ expect(returned.sameNode(sectionChildren[1]));
+ expect(rhsText.getText()).to.equal(' has a cat');
+ });
+
+ it('treats dividing DocumentTextElement at the very end as appending after it', function() {
+ var c = canvas.fromXML('<section>Alice has a cat</section>'),
+ section = c.doc(),
+ text = section.children()[0];
+
+ var returned = text.divide({tag: 'aside', klass: 'footnote', offset: 15}),
+ sectionChildren = section.children(),
+ textElement = sectionChildren[0],
+ nodeElement = sectionChildren[1];
+
+ expect(sectionChildren.length).to.equal(2);
+ expect(textElement.getText()).to.equal('Alice has a cat');
+ expect(returned.sameNode(nodeElement)).to.be.true;
+ expect(nodeElement.getWlxmlTag()).to.equal('aside');
+ });
+
+ it('treats dividing DocumentTextElement at the very beginning as appending before it', function() {
+ var c = canvas.fromXML('<section>Alice has a cat</section>'),
+ section = c.doc(),
+ text = section.children()[0];
+
+ var returned = text.divide({tag: 'aside', klass: 'footnote', offset: 0}),
+ sectionChildren = section.children(),
+ nodeElement = sectionChildren[0],
+ textElement = sectionChildren[1];
+
+ expect(sectionChildren.length).to.equal(2);
+ expect(textElement.getText()).to.equal('Alice has a cat');
+ expect(returned.sameNode(nodeElement)).to.be.true;
+ expect(nodeElement.getWlxmlTag()).to.equal('aside');
+ });
});
describe('Splitting text', function() {
section = c.doc(),
text = section.children()[0].children()[0];
- text.split({offset: 5});
+ var returnedValue = text.split({offset: 5});
expect(section.children().length).to.equal(2, 'section has two children');
var header1 = section.children()[0];
expect(header2.getWlxmlTag()).to.equal('header', 'second section child represents wlxml header');
expect(header2.children().length).to.equal(1, 'second header has one text child');
expect(header2.children()[0].getText()).to.equal('header', 'second header has correct content');
+
+ expect(returnedValue.first.sameNode(header1)).to.equal(true, 'first node returnde');
+ expect(returnedValue.second.sameNode(header2)).to.equal(true, 'second node returned');
});
it('leaves empty copy of DocumentNodeElement if splitting at the very beginning', function() {
describe('unwrapping', function() {
it('unwraps DocumentTextElement from its parent DocumentNodeElement if it\'s its only child', function() {
- var c = canvas.fromXML('<section><div>Alice has a cat</div></section>'),
+ var c = canvas.fromXML('<section>Alice <span>has a</span> cat</section>'),
section = c.doc(),
- text = section.children()[0].children()[0];
+ text = section.children()[1].children()[0];
- text.unwrap();
+ var newTextContainer = text.unwrap();
- expect(section.children().length).to.equal(1);
+ expect(section.children().length).to.equal(1, 'section has one child');
expect(section.children()[0].getText()).to.equal('Alice has a cat');
+ expect(newTextContainer.sameNode(c.doc())).to.equal(true, 'unwrap returns new text parent DocumentNodeElement');
})
});
});
var getSelection;
+ var findTextNode = function(inside, text) {
+ var nodes = inside.find(':not(iframe)').addBack().contents().filter(function() {
+ return this.nodeType === Node.TEXT_NODE && this.data === text;
+ });
+ if(nodes.length)
+ return nodes[0];
+ return null;
+ }
+
beforeEach(function() {
getSelection = sinon.stub(window, 'getSelection');
});
it('returns position when browser selection collapsed', function() {
var c = canvas.fromXML('<section>Alice has a cat</section>'),
dom = c.doc().dom(),
- text = dom.contents()[0];
+ text = findTextNode(dom, 'Alice has a cat');
+ expect(text.nodeType).to.equal(Node.TEXT_NODE, 'correct node selected');
expect($(text).text()).to.equal('Alice has a cat');
getSelection.returns({
expect(cursor.isSelecting()).to.equal(false, 'cursor is not selecting anything');
expect(position.element.getText()).to.equal('Alice has a cat');
expect(position.offset).to.equal(5);
+ expect(position.offsetAtEnd).to.equal(false, 'offset is not at end');
+
+ getSelection.returns({
+ anchorNode: text,
+ focusNode: text,
+ anchorOffset: 15,
+ focusOffset: 15,
+ isCollapsed: true
+ });
+
+ expect(cursor.getPosition().offsetAtEnd).to.equal(true, 'offset at end');
});
it('returns boundries of selection when browser selection not collapsed', function() {
var c = canvas.fromXML('<section>Alice <span>has</span> a <span>big</span> cat</section>'),
dom = c.doc().dom(),
text = {
- alice: dom.contents()[0],
- has: $(dom.contents()[1]).contents()[0],
- cat: dom.contents()[4]
+ alice: findTextNode(dom, 'Alice '),
+ has: findTextNode(dom, 'has'),
+ cat: findTextNode(dom, ' cat')
},
cursor = c.getCursor(),
aliceElement = c.getDocumentElement(text.alice),
var c = canvas.fromXML('<section>Alice <span>has</span> a <span>big</span> cat</section>'),
dom = c.doc().dom(),
text = {
- alice: dom.contents()[0],
- has: $(dom.contents()[1]).contents()[0],
- a: dom.contents()[2],
- big: $(dom.contents()[3]).contents()[0],
- cat: dom.contents()[4]
+ alice: findTextNode(dom, 'Alice '),
+ has: findTextNode(dom, 'has'),
+ a: findTextNode(dom, ' a '),
+ big: findTextNode(dom, 'big'),
+ cat: findTextNode(dom, ' cat'),
},
cursor = c.getCursor();
})
});
+
+ describe('Serializing document to WLXML', function() {
+ it('keeps document intact when no changes have been made', function() {
+ var xmlIn = '<section>Alice<div>has</div>a <span class="uri" meta-uri="http://cat.com">cat</span>!</section>',
+ c = canvas.fromXML(xmlIn),
+ xmlOut = c.toXML();
+
+ var parser = new DOMParser(),
+ input = parser.parseFromString(xmlIn, "application/xml").childNodes[0],
+ output = parser.parseFromString(xmlOut, "application/xml").childNodes[0];
+
+ expect(input.isEqualNode(output)).to.be.true;
+ });
+
+ it('keeps arbitrary node attributes intact', function() {
+ var xmlIn = '<section a="1" xmlns:dcterms="http://purl.org/dc/terms/"></section>',
+ $xmlOut = $(canvas.fromXML(xmlIn).toXML());
+
+ expect($xmlOut.attr('a')).to.equal('1');
+ expect($xmlOut.attr('xmlns:dcterms')).to.equal('http://purl.org/dc/terms/');
+ });
+
+ it('doesn\' serialize meta attribute if its empty', function() {
+ var c;
+
+ c = canvas.fromXML('<section class="uri" meta-uri="some.uri"></section>');
+ c.doc().setWlxmlMetaAttr('uri', '');
+ expect($(c.toXML()).attr('meta-uri')).to.equal(undefined, 'overriding attribute with zero length string');
+
+ c = canvas.fromXML('<section class="uri"></section>');
+ c.doc().setWlxmlMetaAttr('uri', '');
+ expect($(c.toXML()).attr('meta-uri')).to.equal(undefined, 'setting attribute to zero length string');
+ });
+
+ describe('output xml', function() {
+ it('keeps entities intact', function() {
+ var xmlIn = '<section>< ></section>',
+ c = canvas.fromXML(xmlIn),
+ xmlOut = c.toXML();
+ expect(xmlOut).to.equal(xmlIn);
+ });
+ it('keeps entities intact when they form html/xml', function() {
+ var xmlIn = '<section><abc></section>',
+ c = canvas.fromXML(xmlIn),
+ xmlOut = c.toXML();
+ expect(xmlOut).to.equal(xmlIn);
+ });
+ });
+
+ describe('formatting output xml', function() {
+ /*it('keeps white spaces at the edges of input xml', function() {
+ var xmlIn = ' <section></section> ',
+ c = canvas.fromXML(xmlIn),
+ xmlOut = c.toXML();
+
+ expect(xmlOut.substr(4)).to.equal(' <', 'start');
+ expect(xmlOut.substr(-2)).to.equal('> ', 'end');
+ });*/
+ it('keeps white space between XML nodes', function() {
+ var xmlIn = '<section>\n\n\n<div></div>\n\n\n<div></div>\n\n\n</section>',
+ c = canvas.fromXML(xmlIn),
+ xmlOut = c.toXML();
+
+ var partsIn = xmlIn.split('\n\n\n'),
+ partsOut = xmlOut.split('\n\n\n');
+
+ expect(partsIn).to.deep.equal(partsOut);
+ });
+
+ it('keeps white space between XML nodes - inline case', function() {
+ var xmlIn = '<section>\n\n\n<span></span>\n\n\n<span></span>\n\n\n</section>',
+ c = canvas.fromXML(xmlIn),
+ xmlOut = c.toXML();
+
+ var partsIn = xmlIn.split('\n\n\n'),
+ partsOut = xmlOut.split('\n\n\n');
+
+ expect(partsIn).to.deep.equal(partsOut);
+ });
+
+ it('keeps white space at the beginning of text', function() {
+ var xmlIn = '<section> abc<div>some div</div> abc</section>',
+ c = canvas.fromXML(xmlIn),
+ xmlOut = c.toXML();
+
+ expect(xmlOut).to.equal(xmlIn);
+ });
+
+ it('nests new children block elements', function() {
+ var c = canvas.fromXML('<section></section>');
+
+ c.doc().append({tag: 'header'});
+
+ var xmlOut = c.toXML();
+ expect(xmlOut.split('\n ')[0]).to.equal('<section>', 'nesting start ok');
+ expect(xmlOut.split('\n').slice(-1)[0]).to.equal('</section>', 'nesting end ok');
+
+ });
+
+ it('doesn\'t nest new children inline elements', function() {
+ var c = canvas.fromXML('<section></section>');
+
+ c.doc().append({tag: 'span'});
+
+ var xmlOut = c.toXML();
+ expect(xmlOut).to.equal('<section><span></span></section>');
+ });
+
+ it('keeps original white space at the end of text', function() {
+
+ var xmlIn = '<header> Some text ended with white space \
+ \
+ <span class="uri">Some text</span> some text\
+ \
+ </header>',
+ c = canvas.fromXML(xmlIn);
+
+ var xmlOut = c.toXML();
+ console.log(xmlOut);
+ expect(xmlOut).to.equal(xmlIn);
+ });
+
+ it('keeps white space around text node', function() {
+ var xmlIn = '<section>\
+ <header>header1</header>\
+ Some text surrounded by white space\
+ <header>header2</header>\
+ </section>',
+ c = canvas.fromXML(xmlIn);
+
+ var xmlOut = c.toXML();
+ expect(xmlOut).to.equal(xmlIn);
+ });
+
+ it('keeps white space around text node - last node case', function() {
+ var xmlIn = '<section>\
+ <header>header</header>\
+ \
+ Some text surrounded by white space\
+ \
+ </section>',
+ c = canvas.fromXML(xmlIn);
+
+ var xmlOut = c.toXML();
+ expect(xmlOut).to.equal(xmlIn);
+ });
+
+ it('keeps white space after detaching text element', function() {
+ var xmlIn = '<section><header>header</header>\n\
+ \n\
+ text1\n\
+ \n\
+ </section>',
+ expectedXmlOut = '<section><header>header</header>\n\
+ \n\
+ \n\
+ \n\
+ </section>',
+ c = canvas.fromXML(xmlIn),
+ children = c.doc().children(),
+ text = children[children.length-1];
+
+ expect(text.getText()).to.equal('text1');
+
+ text.detach();
+
+ var xmlOut = c.toXML();
+ expect(xmlOut).to.equal(expectedXmlOut);
+ });
+
+ })
+ })
});