src/wlxml/wlxml.js

   1 define([
   2     'libs/jquery',
   3     'libs/underscore',
   4     'smartxml/smartxml',
   5     'smartxml/transformations'
   6 ], function($, _, smartxml, transformations) {
   7
   8 'use strict';
   9
  10 // utils
  11
  12 var isMetaAttribute = function(attrName) {
  13     return attrName.substr(0, 5) === 'meta-';
  14 };
  15
  16 //
  17
  18 var AttributesList = function() {};
  19 AttributesList.prototype = Object.create({});
  20 AttributesList.prototype.keys = function() {
  21     return _.keys(this);
  22 };
  23
  24 var installObject = function(instance, klass) {
  25     var methods = instance.document.classMethods[klass] || instance.document.classTransformations;
  26     if(methods) {
  27         instance.object = Object.create(_.extend({
  28             transform: function(name, args) {
  29                 // TODO: refactor with DocumentElement.transform
  30                 var Transformation = instance.document.classTransformations[klass].get(name),
  31                     transformation;
  32                 if(Transformation) {
  33                     transformation = new Transformation(instance.document, instance, args);
  34                 }
  35                 return instance.document.transform(transformation);
  36             }
  37         }, methods));
  38         _.keys(methods).forEach(function(key) {
  39             instance.object[key] = _.bind(instance.object[key], instance);
  40         });
  41     }
  42 }
  43
  44 var WLXMLElementNode = function(nativeNode, document) {
  45     smartxml.ElementNode.call(this, nativeNode, document);
  46     installObject(this, this.getClass());
  47 };
  48 WLXMLElementNode.prototype = Object.create(smartxml.ElementNode.prototype);
  49
  50 $.extend(WLXMLElementNode.prototype, smartxml.ElementNode.prototype, {
  51     getClass: function() {
  52         return this.getAttr('class') || '';
  53     },
  54     setClass: function(klass) {
  55         var methods, object;
  56         if(klass !== this.klass) {
  57             installObject(this, klass);
  58             return this.setAttr('class', klass);
  59         }
  60     },
  61     is: function(klass) {
  62         return this.getClass().substr(0, klass.length) === klass;
  63     },
  64     getMetaAttributes: function() {
  65         var toret = new AttributesList(),
  66             classParts = [''].concat(this.getClass().split('.')),
  67             classCurrent, classDesc;
  68
  69         classParts.forEach(function(part) {
  70             classCurrent = classCurrent ? classCurrent + '.' + part : part;
  71             classDesc = this.document.options.wlxmlClasses[classCurrent];
  72             if(classDesc) {
  73                 _.keys(classDesc.attrs).forEach(function(attrName) {
  74                     toret[attrName] = _.extend({value: this.getAttr('meta-' + attrName)}, classDesc.attrs[attrName]);
  75                 }.bind(this));
  76             }
  77         }.bind(this));
  78         return toret;
  79     },
  80     setMetaAttribute: function(key, value) {
  81         this.setAttr('meta-'+key, value);
  82     },
  83     getOtherAttributes: function() {
  84         var toret = {};
  85         this.getAttrs().forEach(function(attr) {
  86             if(attr.name !== 'class' && !isMetaAttribute(attr.name)) {
  87                 toret[attr.name] = attr.value;
  88             }
  89         });
  90         return toret;
  91     },
  92
  93     _getXMLDOMToDump: function() {
  94         var DOM = this._$.clone(true, true);
  95
  96         DOM.find('*').addBack().each(function() {
  97             var el = $(this),
  98                 parent = el.parent(),
  99                 contents = parent.contents(),
 100                 idx = contents.index(el),
 101                 data = el.data();
 102
 103
 104             var txt;
 105
 106             if(data[formatter_prefix+ 'orig_before']) {
 107                 txt = idx > 0 && contents[idx-1].nodeType === Node.TEXT_NODE ? contents[idx-1] : null;
 108                 if(txt && txt.data === data[formatter_prefix + 'orig_before_transformed']) {
 109                     txt.data = data[formatter_prefix+ 'orig_before_original'];
 110                 } else {
 111                     el.before(data[formatter_prefix+ 'orig_before']);
 112                 }
 113             }
 114             if(data[formatter_prefix+ 'orig_after']) {
 115                 txt = idx < contents.length-1 && contents[idx+1].nodeType === Node.TEXT_NODE ? contents[idx+1] : null;
 116                 if(txt && txt.data === data[formatter_prefix + 'orig_after_transformed']) {
 117                     txt.data = data[formatter_prefix+ 'orig_after_original'];
 118                 } else {
 119                     el.after(data[formatter_prefix+ 'orig_after']);
 120                 }
 121             }
 122             if(data[formatter_prefix+ 'orig_begin']) {
 123                 el.prepend(data[formatter_prefix+ 'orig_begin']);
 124             }
 125             if(data[formatter_prefix+ 'orig_end']) {
 126                 contents = el.contents();
 127                 txt = (contents.length && contents[contents.length-1].nodeType === Node.TEXT_NODE) ? contents[contents.length-1] : null;
 128                 if(txt && txt.data === data[formatter_prefix + 'orig_end_transformed']) {
 129                     txt.data = data[formatter_prefix+ 'orig_end_original'];
 130                 } else {
 131                     el.append(data[formatter_prefix+ 'orig_end']);
 132                 }
 133             }
 134         });
 135
 136         return DOM;
 137     }
 138 });
 139
 140 WLXMLElementNode.prototype.transformations.register(transformations.createContextTransformation({
 141     name: 'wlxml.setMetaAttribute',
 142     impl: function(args) {
 143         this.setMetaAttribute(args.name, args.value);
 144     },
 145     getChangeRoot: function() {
 146         return this.context;
 147     }
 148 }));
 149
 150
 151
 152 var WLXMLDocumentNode = function() {
 153     smartxml.DocumentNode.apply(this, arguments);
 154 }
 155 WLXMLDocumentNode.prototype = Object.create(smartxml.DocumentNode.prototype);
 156
 157 var WLXMLDocument = function(xml, options) {
 158     smartxml.Document.call(this, xml);
 159     this.options = options;
 160
 161     // this.DocumentNodeFactory = function() {
 162     //     WLXMLDocumentNode.apply(this, arguments);
 163     // };
 164
 165     // this.DocumentNodeFactory.prototype = Object.create(WLXMLDocumentNode.prototype);
 166
 167     this.ElementNodeFactory = function() {
 168         WLXMLElementNode.apply(this, arguments);
 169     }
 170     this.ElementNodeFactory.prototype = Object.create(WLXMLElementNode.prototype);
 171     this.ElementNodeFactory.prototype.transformations = new transformations.TransformationStorage();
 172     this.ElementNodeFactory.prototype.registerTransformation = function(Transformation) {
 173         return this.transformations.register(Transformation);
 174     };
 175
 176     this.TextNodeFactory = function() {
 177         smartxml.TextNode.apply(this, arguments);
 178     }
 179     this.TextNodeFactory.prototype = Object.create(smartxml.TextNode.prototype);
 180     this.TextNodeFactory.prototype.transformations = new transformations.TransformationStorage();
 181     this.TextNodeFactory.prototype.registerTransformation = function(Transformation) {
 182         return this.transformations.register(Transformation);
 183     };
 184
 185     this.classMethods = {};
 186     this.classTransformations = {};
 187 };
 188
 189 var formatter_prefix = '_wlxml_formatter_';
 190
 191
 192 WLXMLDocument.prototype = Object.create(smartxml.Document.prototype);
 193 $.extend(WLXMLDocument.prototype, {
 194     ElementNodeFactory: WLXMLElementNode,
 195     loadXML: function(xml) {
 196         smartxml.Document.prototype.loadXML.call(this, xml, {silent: true});
 197         $(this.dom).find(':not(iframe)').addBack().contents()
 198             .filter(function() {return this.nodeType === Node.TEXT_NODE;})
 199             .each(function() {
 200                 var el = $(this),
 201                     text = {original: el.text(), trimmed: $.trim(el.text())},
 202                     elParent = el.parent(),
 203                     hasSpanParent = elParent.prop('tagName') === 'SPAN',
 204                     hasSpanBefore = el.prev().length && $(el.prev()).prop('tagName') === 'SPAN',
 205                     hasSpanAfter = el.next().length && $(el.next()).prop('tagName') === 'SPAN';
 206
 207
 208                 var addInfo = function(toAdd, where, transformed, original) {
 209                     var parentContents = elParent.contents(),
 210                         idx = parentContents.index(el[0]),
 211                         prev = idx > 0 ? parentContents[idx-1] : null,
 212                         next = idx < parentContents.length - 1 ? parentContents[idx+1] : null,
 213                         target, key;
 214
 215                     if(where === 'above') {
 216                         target = prev ? $(prev) : elParent;
 217                         key = prev ? 'orig_after' : 'orig_begin';
 218                     } else if(where === 'below') {
 219                         target = next ? $(next) : elParent;
 220                         key = next ? 'orig_before' : 'orig_end';
 221                     } else { throw new Error();}
 222
 223                     target.data(formatter_prefix + key, toAdd);
 224                     if(transformed !== undefined) {
 225                         target.data(formatter_prefix + key + '_transformed', transformed);
 226                     }
 227                     if(original !== undefined) {
 228                         target.data(formatter_prefix + key + '_original', original);
 229                     }
 230                 };
 231
 232                 text.transformed = text.trimmed;
 233
 234                 if(hasSpanParent || hasSpanBefore || hasSpanAfter) {
 235                     var startSpace = /\s/g.test(text.original.substr(0,1)),
 236                         endSpace = /\s/g.test(text.original.substr(-1)) && text.original.length > 1;
 237                     text.transformed = (startSpace && (hasSpanParent || hasSpanBefore) ? ' ' : '');
 238                     text.transformed += text.trimmed;
 239                     text.transformed += (endSpace && (hasSpanParent || hasSpanAfter) ? ' ' : '');
 240                 } else {
 241                     if(text.trimmed.length === 0 && text.original.length > 0 && elParent.contents().length === 1) {
 242                         text.transformed = ' ';
 243                     }
 244                 }
 245
 246                 if(!text.transformed) {
 247                     addInfo(text.original, 'below');
 248                     el.remove();
 249                     return true; // continue
 250                 }
 251
 252                 if(text.transformed !== text.original) {
 253                     // if(!text.trimmed) {
 254                     //     addInfo(text.original, 'below');
 255                     // } else {
 256                         var startingMatch = text.original.match(/^\s+/g),
 257                             endingMatch = text.original.match(/\s+$/g),
 258                             startingWhiteSpace = startingMatch ? startingMatch[0] : null,
 259                             endingWhiteSpace = endingMatch ? endingMatch[0] : null;
 260
 261                         if(endingWhiteSpace) {
 262                             if(text.transformed[text.transformed.length - 1] === ' ' && endingWhiteSpace[0] === ' ') {
 263                                 endingWhiteSpace = endingWhiteSpace.substr(1);
 264                             }
 265                             addInfo(endingWhiteSpace, 'below', !text.trimmed ? text.transformed : undefined, !text.trimmed ? text.original : undefined);
 266                         }
 267
 268                         if(startingWhiteSpace && text.trimmed) {
 269                             if(text.transformed[0] === ' ' && startingWhiteSpace[startingWhiteSpace.length-1] === ' ') {
 270                                 startingWhiteSpace = startingWhiteSpace.substr(0, startingWhiteSpace.length -1);
 271                             }
 272                             addInfo(startingWhiteSpace, 'above', !text.trimmed ? text.transformed : undefined, !text.trimmed ? text.original : undefined);
 273                         }
 274                     //}
 275                 }
 276
 277                 el.replaceWith(document.createTextNode(text.transformed));
 278             });
 279         this.trigger('contentSet');
 280     },
 281
 282     registerTransformation: function(Transformation) {
 283         return this.transformations.register(Transformation);
 284     },
 285
 286     registerClassTransformation: function(Transformation, className) {
 287         var thisClassTransformations = (this.classTransformations[className] = this.classTransformations[className] || new transformations.TransformationStorage());
 288         return thisClassTransformations.register(Transformation);
 289     },
 290
 291     registerClassMethod: function(methodName, method, className) {
 292         var thisClassMethods = (this.classMethods[className] = this.classMethods[className] || {});
 293         thisClassMethods[methodName] = method;
 294     },
 295
 296     registerExtension: function(extension) {
 297         //debugger;
 298         var doc = this,
 299             existingPropertyNames = _.values(this);
 300
 301         var getTrans = function(desc, methodName) {
 302             if(typeof desc === 'function') {
 303                 desc = {impl: desc};
 304             }
 305             if(!desc.impl) {
 306                 throw new Error('Got transformation description without implementation.')
 307             }
 308             desc.name = desc.name || methodName;
 309             return desc;
 310         };
 311
 312         [
 313             {source: extension.document, target: doc},
 314             {source: extension.documentNode, target: [doc.ElementNodeFactory.prototype, doc.TextNodeFactory.prototype]},
 315
 316         ].forEach(function(mapping) {
 317             if(mapping.source) {
 318                 if(mapping.source.methods) {
 319                     existingPropertyNames = _.values(mapping.target)
 320                     _.pairs(mapping.source.methods).forEach(function(pair) {
 321                         var methodName = pair[0],
 322                             method = pair[1],
 323                             targets = _.isArray(mapping.target) ? mapping.target : [mapping.target];
 324                         if(_.contains(existingPropertyNames, methodName)) {
 325                             throw new Error('Cannot extend {target} with method name {methodName}. Name already exists.'
 326                                 .replace('{target}', mapping.target)
 327                                 .replace('{methodName}', methodName)
 328                             );
 329                         }
 330                         targets.forEach(function(target) {
 331                             target[methodName] = method;
 332                         });
 333                     });
 334                 }
 335
 336                 if(mapping.source.transformations) {
 337                     _.pairs(mapping.source.transformations).forEach(function(pair) {
 338                         var transformation = getTrans(pair[1], pair[0]),
 339                             targets = _.isArray(mapping.target) ? mapping.target : [mapping.target];
 340                         targets.forEach(function(target) {
 341                             target.registerTransformation(transformations.createContextTransformation(transformation));
 342                         });
 343                     });
 344                 }
 345             }
 346         });
 347
 348         _.pairs(extension.wlxmlClass).forEach(function(pair) {
 349             var className = pair[0],
 350                 classExtension = pair[1];
 351
 352             _.pairs(classExtension.methods || {}).forEach(function(pair) {
 353                 var name = pair[0],
 354                     method = pair[1];
 355                 doc.registerClassMethod(name, method, className);
 356             });
 357
 358             _.pairs(classExtension.transformations || {}).forEach(function(pair) {
 359                 var transformation = getTrans(pair[1], pair[0]);
 360                 doc.registerClassTransformation(transformations.createContextTransformation(transformation), className);
 361             });
 362         });
 363
 364     }
 365
 366 });
 367
 368 var wlxmlClasses = {
 369     'uri': {
 370         attrs: {uri: {type: 'string'}}
 371     }
 372 };
 373
 374 var classMethods = {};
 375
 376 return {
 377     WLXMLDocumentFromXML: function(xml, options) {
 378         options = _.extend({wlxmlClasses: wlxmlClasses}, options);
 379         return new WLXMLDocument(xml, options);
 380     },
 381
 382     WLXMLElementNodeFromXML: function(xml) {
 383         return this.WLXMLDocumentFromXML(xml).root;
 384     },
 385
 386     registerExtension: function(extension) {
 387         // @@ depracated
 388         if(extension.documentTransformations) {
 389             extension.documentTransformations.forEach(function(method) {
 390                 WLXMLDocument.prototype.transformations.register(transformations.createContextTransformation(method));
 391             });
 392         }
 393
 394         _.pairs(extension.classMethods).forEach(function(pair) {
 395             var className = pair[0],
 396                 methods = pair[1];
 397             _.pairs(methods).forEach(function(pair) {
 398                 var methodName = pair[0],
 399                     method = pair[1];
 400                 classMethods[className] = classMethods[className] || {};
 401                 classMethods[className][methodName] = method;
 402             });
 403
 404         });
 405
 406         _.extend(WLXMLDocument.prototype, extension.documentMethods);
 407
 408     }
 409
 410 };
 411
 412 });