diff -r 1bca6b7f56e1 -r 310f5517a2ea src/js/libs/mustache.js --- a/src/js/libs/mustache.js Thu Jan 05 11:08:25 2012 +0100 +++ b/src/js/libs/mustache.js Thu Jan 05 12:20:52 2012 +0100 @@ -4,8 +4,53 @@ See http://mustache.github.com/ for more info. */ -var Mustache = function() { - var Renderer = function() {}; +var Mustache = function () { + var _toString = Object.prototype.toString; + + Array.isArray = Array.isArray || function (obj) { + return _toString.call(obj) == "[object Array]"; + } + + var _trim = String.prototype.trim, trim; + + if (_trim) { + trim = function (text) { + return text == null ? "" : _trim.call(text); + } + } else { + var trimLeft, trimRight; + + // IE doesn't match non-breaking spaces with \s. + if ((/\S/).test("\xA0")) { + trimLeft = /^[\s\xA0]+/; + trimRight = /[\s\xA0]+$/; + } else { + trimLeft = /^\s+/; + trimRight = /\s+$/; + } + + trim = function (text) { + return text == null ? "" : + text.toString().replace(trimLeft, "").replace(trimRight, ""); + } + } + + var escapeMap = { + "&": "&", + "<": "<", + ">": ">", + '"': '"', + "'": ''' + }; + + function escapeHTML(string) { + return String(string).replace(/&(?!\w+;)|[<>"']/g, function (s) { + return escapeMap[s] || s; + }); + } + + var regexCache = {}; + var Renderer = function () {}; Renderer.prototype = { otag: "{{", @@ -17,16 +62,16 @@ }, context: {}, - render: function(template, context, partials, in_recursion) { + render: function (template, context, partials, in_recursion) { // reset buffer & set context - if(!in_recursion) { + if (!in_recursion) { this.context = context; this.buffer = []; // TODO: make this non-lazy } // fail fast - if(!this.includes("", template)) { - if(in_recursion) { + if (!this.includes("", template)) { + if (in_recursion) { return template; } else { this.send(template); @@ -34,44 +79,64 @@ } } + // get the pragmas together template = this.render_pragmas(template); + + // render the template var html = this.render_section(template, context, partials); - if(in_recursion) { - return this.render_tags(html, context, partials, in_recursion); + + // render_section did not find any sections, we still need to render the tags + if (html === false) { + html = this.render_tags(template, context, partials, in_recursion); } - this.render_tags(html, context, partials, in_recursion); + if (in_recursion) { + return html; + } else { + this.sendLines(html); + } }, /* Sends parsed lines */ - send: function(line) { - if(line !== "") { + send: function (line) { + if (line !== "") { this.buffer.push(line); } }, + sendLines: function (text) { + if (text) { + var lines = text.split("\n"); + for (var i = 0; i < lines.length; i++) { + this.send(lines[i]); + } + } + }, + /* Looks for %PRAGMAS */ - render_pragmas: function(template) { + render_pragmas: function (template) { // no pragmas - if(!this.includes("%", template)) { + if (!this.includes("%", template)) { return template; } var that = this; - var regex = new RegExp(this.otag + "%([\\w-]+) ?([\\w]+=[\\w]+)?" + - this.ctag, "g"); - return template.replace(regex, function(match, pragma, options) { - if(!that.pragmas_implemented[pragma]) { - throw({message: + var regex = this.getCachedRegex("render_pragmas", function (otag, ctag) { + return new RegExp(otag + "%([\\w-]+) ?([\\w]+=[\\w]+)?" + ctag, "g"); + }); + + return template.replace(regex, function (match, pragma, options) { + if (!that.pragmas_implemented[pragma]) { + throw({message: "This implementation of mustache doesn't understand the '" + pragma + "' pragma"}); } that.pragmas[pragma] = {}; - if(options) { + if (options) { var opts = options.split("="); that.pragmas[pragma][opts[0]] = opts[1]; } @@ -83,12 +148,12 @@ /* Tries to find a partial in the curent scope and render it */ - render_partial: function(name, context, partials) { - name = this.trim(name); - if(!partials || partials[name] === undefined) { + render_partial: function (name, context, partials) { + name = trim(name); + if (!partials || partials[name] === undefined) { throw({message: "unknown_partial '" + name + "'"}); } - if(typeof(context[name]) != "object") { + if (!context || typeof context[name] != "object") { return this.render(partials[name], context, partials, true); } return this.render(partials[name], context[name], partials, true); @@ -97,64 +162,94 @@ /* Renders inverted (^) and normal (#) sections */ - render_section: function(template, context, partials) { - if(!this.includes("#", template) && !this.includes("^", template)) { - return template; + render_section: function (template, context, partials) { + if (!this.includes("#", template) && !this.includes("^", template)) { + // did not render anything, there were no sections + return false; } var that = this; - // CSW - Added "+?" so it finds the tighest bound, not the widest - var regex = new RegExp(this.otag + "(\\^|\\#)\\s*(.+)\\s*" + this.ctag + - "\n*([\\s\\S]+?)" + this.otag + "\\/\\s*\\2\\s*" + this.ctag + - "\\s*", "mg"); + + var regex = this.getCachedRegex("render_section", function (otag, ctag) { + // This regex matches _the first_ section ({{#foo}}{{/foo}}), and captures the remainder + return new RegExp( + "^([\\s\\S]*?)" + // all the crap at the beginning that is not {{*}} ($1) + + otag + // {{ + "(\\^|\\#)\\s*(.+)\\s*" + // #foo (# == $2, foo == $3) + ctag + // }} + + "\n*([\\s\\S]*?)" + // between the tag ($2). leading newlines are dropped + + otag + // {{ + "\\/\\s*\\3\\s*" + // /foo (backreference to the opening tag). + ctag + // }} + + "\\s*([\\s\\S]*)$", // everything else in the string ($4). leading whitespace is dropped. + + "g"); + }); + // for each {{#foo}}{{/foo}} section do... - return template.replace(regex, function(match, type, name, content) { - var value = that.find(name, context); - if(type == "^") { // inverted section - if(!value || that.is_array(value) && value.length === 0) { + return template.replace(regex, function (match, before, type, name, content, after) { + // before contains only tags, no sections + var renderedBefore = before ? that.render_tags(before, context, partials, true) : "", + + // after may contain both sections and tags, so use full rendering function + renderedAfter = after ? that.render(after, context, partials, true) : "", + + // will be computed below + renderedContent, + + value = that.find(name, context); + + if (type === "^") { // inverted section + if (!value || Array.isArray(value) && value.length === 0) { // false or empty list, render it - return that.render(content, context, partials, true); + renderedContent = that.render(content, context, partials, true); } else { - return ""; + renderedContent = ""; } - } else if(type == "#") { // normal section - if(that.is_array(value)) { // Enumerable, Let's loop! - return that.map(value, function(row) { - return that.render(content, that.create_context(row), - partials, true); + } else if (type === "#") { // normal section + if (Array.isArray(value)) { // Enumerable, Let's loop! + renderedContent = that.map(value, function (row) { + return that.render(content, that.create_context(row), partials, true); }).join(""); - } else if(that.is_object(value)) { // Object, Use it as subcontext! - return that.render(content, that.create_context(value), + } else if (that.is_object(value)) { // Object, Use it as subcontext! + renderedContent = that.render(content, that.create_context(value), partials, true); - } else if(typeof value === "function") { + } else if (typeof value == "function") { // higher order section - return value.call(context, content, function(text) { + renderedContent = value.call(context, content, function (text) { return that.render(text, context, partials, true); }); - } else if(value) { // boolean section - return that.render(content, context, partials, true); + } else if (value) { // boolean section + renderedContent = that.render(content, context, partials, true); } else { - return ""; + renderedContent = ""; } } + + return renderedBefore + renderedContent + renderedAfter; }); }, /* Replace {{foo}} and friends with values from our view */ - render_tags: function(template, context, partials, in_recursion) { + render_tags: function (template, context, partials, in_recursion) { // tit for tat var that = this; - var new_regex = function() { - return new RegExp(that.otag + "(=|!|>|\\{|%)?([^\\/#\\^]+?)\\1?" + - that.ctag + "+", "g"); + var new_regex = function () { + return that.getCachedRegex("render_tags", function (otag, ctag) { + return new RegExp(otag + "(=|!|>|&|\\{|%)?([^#\\^]+?)\\1?" + ctag + "+", "g"); + }); }; var regex = new_regex(); - var tag_replace_callback = function(match, operator, name) { + var tag_replace_callback = function (match, operator, name) { switch(operator) { case "!": // ignore comments return ""; @@ -165,33 +260,34 @@ case ">": // render partial return that.render_partial(name, context, partials); case "{": // the triple mustache is unescaped + case "&": // & operator is an alternative unescape method return that.find(name, context); default: // escape the value - return that.escape(that.find(name, context)); + return escapeHTML(that.find(name, context)); } }; var lines = template.split("\n"); for(var i = 0; i < lines.length; i++) { lines[i] = lines[i].replace(regex, tag_replace_callback, this); - if(!in_recursion) { + if (!in_recursion) { this.send(lines[i]); } } - if(in_recursion) { + if (in_recursion) { return lines.join("\n"); } }, - set_delimiters: function(delimiters) { + set_delimiters: function (delimiters) { var dels = delimiters.split(" "); this.otag = this.escape_regex(dels[0]); this.ctag = this.escape_regex(dels[1]); }, - escape_regex: function(text) { + escape_regex: function (text) { // thank you Simon Willison - if(!arguments.callee.sRE) { + if (!arguments.callee.sRE) { var specials = [ '/', '.', '*', '+', '?', '|', '(', ')', '[', ']', '{', '}', '\\' @@ -207,8 +303,8 @@ find `name` in current `context`. That is find me a value from the view object */ - find: function(name, context) { - name = this.trim(name); + find: function (name, context) { + name = trim(name); // Checks whether a value is thruthy or false or 0 function is_kinda_truthy(bool) { @@ -216,54 +312,61 @@ } var value; - if(is_kinda_truthy(context[name])) { - value = context[name]; - } else if(is_kinda_truthy(this.context[name])) { - value = this.context[name]; + + // check for dot notation eg. foo.bar + if (name.match(/([a-z_]+)\./ig)) { + var childValue = this.walk_context(name, context); + if (is_kinda_truthy(childValue)) { + value = childValue; + } + } else { + if (is_kinda_truthy(context[name])) { + value = context[name]; + } else if (is_kinda_truthy(this.context[name])) { + value = this.context[name]; + } } - if(typeof value === "function") { + if (typeof value == "function") { return value.apply(context); } - if(value !== undefined) { + if (value !== undefined) { return value; } // silently ignore unkown variables return ""; }, + walk_context: function (name, context) { + var path = name.split('.'); + // if the var doesn't exist in current context, check the top level context + var value_context = (context[path[0]] != undefined) ? context : this.context; + var value = value_context[path.shift()]; + while (value != undefined && path.length > 0) { + value_context = value; + value = value[path.shift()]; + } + // if the value is a function, call it, binding the correct context + if (typeof value == "function") { + return value.apply(value_context); + } + return value; + }, + // Utility methods /* includes tag */ - includes: function(needle, haystack) { + includes: function (needle, haystack) { return haystack.indexOf(this.otag + needle) != -1; }, - /* - Does away with nasty characters - */ - escape: function(s) { - s = String(s === null ? "" : s); - return s.replace(/&(?!\w+;)|["'<>\\]/g, function(s) { - switch(s) { - case "&": return "&"; - case "\\": return "\\\\"; - case '"': return '"'; - case "'": return '''; - case "<": return "<"; - case ">": return ">"; - default: return s; - } - }); - }, - // by @langalex, support for arrays of strings - create_context: function(_context) { - if(this.is_object(_context)) { + create_context: function (_context) { + if (this.is_object(_context)) { return _context; } else { var iterator = "."; - if(this.pragmas["IMPLICIT-ITERATOR"]) { + if (this.pragmas["IMPLICIT-ITERATOR"]) { iterator = this.pragmas["IMPLICIT-ITERATOR"].iterator; } var ctx = {}; @@ -272,25 +375,14 @@ } }, - is_object: function(a) { + is_object: function (a) { return a && typeof a == "object"; }, - is_array: function(a) { - return Object.prototype.toString.call(a) === '[object Array]'; - }, - - /* - Gets rid of leading and trailing whitespace - */ - trim: function(s) { - return s.replace(/^\s*|\s*$/g, ""); - }, - /* Why, why, why? Because IE. Cry, cry cry. */ - map: function(array, fn) { + map: function (array, fn) { if (typeof array.map == "function") { return array.map(fn); } else { @@ -301,23 +393,42 @@ } return r; } + }, + + getCachedRegex: function (name, generator) { + var byOtag = regexCache[this.otag]; + if (!byOtag) { + byOtag = regexCache[this.otag] = {}; + } + + var byCtag = byOtag[this.ctag]; + if (!byCtag) { + byCtag = byOtag[this.ctag] = {}; + } + + var regex = byCtag[name]; + if (!regex) { + regex = byCtag[name] = generator(this.otag, this.ctag); + } + + return regex; } }; return({ name: "mustache.js", - version: "0.3.1-dev", + version: "0.5.0-dev", /* Turns a template and view into HTML */ - to_html: function(template, view, partials, send_fun) { + to_html: function (template, view, partials, send_fun) { var renderer = new Renderer(); - if(send_fun) { + if (send_fun) { renderer.send = send_fun; } - renderer.render(template, view, partials); - if(!send_fun) { + renderer.render(template, view || {}, partials); + if (!send_fun) { return renderer.buffer.join("\n"); } }