### Overview `Stubble4js` is a javascript version of `Stubble` plugin for dart. `Stubble` is a simplified version of the `Handlebars` template engine for Dart. ### Example ```javascript const { Stubble } = require('stubble4js'); let s = new Stubble(); let template = 'Hello! I\'m {{name}}! Nice to meet you!' ; let data = {'name': 'Stubble'}; let fn = s.compile(template); console.log(fn(data)); ``` ### Stubble constructions `{{}}` - getter for property from `data` by it's `path`. If property by this `path` is exists then `{{}}` will be replaced by a string representation of its value `{{$ []}}` - simple helper-function call. Will be replaced by a helper's result `{{# []}}{{/}}` - block helper-function call. Also will be replaced with result of helper call. The second parameter of helper function in this case is compile function with block's 'body' as template `{{#if }}{{/if}}` - is statement block. If `` is true, will be replaced with body. Body will be compiled too. `{{#with }}{{/with}}` - allows to pass a part of context data and work with it directly `{{#each }}{{/each}}` - loop for a context data by path. data should has a type of `array` or `map` ### Path requirements `path` is a string, starts with an alphabet character and can consist of: - lowercase or uppercase `latin characters` - `numbers` - `underscore` - `dot` as path divider. It's mean that `A.B.C` will return `data["A"]["B"]["C"]`, not a `data["A.B.C"]` Other character are prohibited Restrictions: - Path can't begin with `dot` - Path can't end with `dot` ### Helper functions `Stubble` object has an registerHelper method, that allows to register special named functions that can be used in templates by names. Example: ```javascript let s = Stubble(); s.registerHelper('testHelper', (attr, fn) => { return attr[0] * 10; }); ``` Each registered function should have two parameters: 1. List of attributes. All helper functions attributes from it's call in template will be placed here in order left to right like they passed in helper call 2. Compiler function - available only in block-helper calls. The body of helper-function is a template of this compiler function. Example: ```javascript let s = Stubble(); stubble.registerHelper('simpleBlockHelper', (List attrs, Function fn) => { // fn - is a result of Stubble.compile(