@toptalo/twig-renderer
v0.5.0
Published
Renders Twig templates using Twig.js
Downloads
764
Readme
twig-renderer
Renders Twig templates using Twig.js
Build upon Twig.js, the JS port of the Twig templating language by John Roepke.
Install
npm install @toptalo/twig-renderer --save
Usage Example
const TwigRenderer = require('@toptalo/twig-renderer');
const options = {
globals: '',
extensions: [],
functions: {},
filters: {},
context: {},
namespaces: {}
};
const twigRenderer = new TwigRenderer(options);
twigRenderer.render(templatePath).then(html => {
console.log(html);
}).catch(error => {
console.log(error.message);
});
Options
options.globals
Type: String
Default value: ''
Path to JSON file with global context variables.
options.extensions
Type: Array
Default value: []
Can be an array of functions that extend TwigJS with custom tags.
options.functions
Type: Object
Default value: {}
Object hash defining functions in TwigJS.
options.filters
Type: Object
Default value: {}
Object hash defining filters in TwigJS.
options.context
Type: Object
Default value: {}
Object hash defining templates context variables.
options.namespaces
Type: Object
Default value: {}
Object hash defining namespaces.
Context hierarchy
Template context extends in this order:
options.context
providedoptions.globals
provided- template JSON context files (stored in template path, with same name,
example:
/templates/index.json
for/templates/index.twig
) if provided
Contributing
In lieu of a formal style guide, take care to maintain the existing coding style. Add functional tests for any new or changed functionality. Lint your code using ESLint. Test your code using Jest.
Sponsored by
Release History
See the CHANGELOG.