diff options
| -rw-r--r-- | docs/compiler-api.md | 23 | ||||
| -rw-r--r-- | lib/handlebars/compiler/javascript-compiler.js | 18 |
2 files changed, 32 insertions, 9 deletions
diff --git a/docs/compiler-api.md b/docs/compiler-api.md index 5431a98..98ca894 100644 --- a/docs/compiler-api.md +++ b/docs/compiler-api.md @@ -208,6 +208,29 @@ scanner.accept(ast); The `Handlebars.JavaScriptCompiler` object has a number of methods that may be customized to alter the output of the compiler: +- `nameLookup(parent, name, type)` + Used to generate the code to resolve a give path component. + + - `parent` is the existing code in the path resolution + - `name` is the current path component + - `type` is the type of name being evaluated. May be one of `context`, `data`, `helper`, or `partial`. + +- `depthedLookup(name)` + Used to generate code that resolves parameters within any context in the stack. Is only used in `compat` mode. + +- `compilerInfo()` + Allows for custom compiler flags used in the runtime version checking logic. + +- `appendToBuffer(source, location, explicit)` + Allows for code buffer emitting code. Defaults behavior is string concatenation. + + - `source` is the source code whose result is to be appending + - `location` is the location of the source in the source map. + - `explicit` is a flag signaling that the emit operation must occur, vs. the lazy evaled options otherwise. + +- `initializeBuffer()` + Allows for buffers other than the default string buffer to be used. Generally needs to be paired with a custom `appendToBuffer` implementation. + ```javascript function MyCompiler() { Handlebars.JavaScriptCompiler.apply(this, arguments); diff --git a/lib/handlebars/compiler/javascript-compiler.js b/lib/handlebars/compiler/javascript-compiler.js index 6703b44..537d1b0 100644 --- a/lib/handlebars/compiler/javascript-compiler.js +++ b/lib/handlebars/compiler/javascript-compiler.js @@ -29,23 +29,23 @@ JavaScriptCompiler.prototype = { return [revision, versions]; }, - appendToBuffer: function(string, location, explicit) { - // Force a string as this simplifies the merge logic. - if (!isArray(string)) { - string = [string]; + appendToBuffer: function(source, location, explicit) { + // Force a source as this simplifies the merge logic. + if (!isArray(source)) { + source = [source]; } - string = this.source.wrap(string, location); + source = this.source.wrap(source, location); if (this.environment.isSimple) { - return ['return ', string, ';']; + return ['return ', source, ';']; } else if (explicit) { // This is a case where the buffer operation occurs as a child of another // construct, generally braces. We have to explicitly output these buffer // operations to ensure that the emitted code goes in the correct location. - return ['buffer += ', string, ';']; + return ['buffer += ', source, ';']; } else { - string.appendToBuffer = true; - return string; + source.appendToBuffer = true; + return source; } }, |