Neutralize Pesky Miscreants

    amplify-velocity-template

    1.4.6 • Public • Published

    Velocity - Template Engine

    NPM version build status Test coverage npm download

    Velocityjs is velocity template engine for javascript.

    中文版文档

    Features

    • Supports both client and server side usage.
    • Separation of parsing and rendering templates.
    • The basic syntax is fully supported all java version velocity.
    • Vim Syntax for vim.

    Install

    via npm:

    $ npm install velocityjs

    Browser

    Compatible with all modern browsers. You can try test case in your browser to test it.

    For other lower version browsers, you need have those polyfill functions:

    1. Array.prototype map, forEach, some, filter, every, indexOf
    2. Date.now
    3. Object.keys

    Examples

    You can find a lot of examples in the tests directory. There are no differences between using a browser and a node.js environment.

    Public API

    {
      // render method
      render(vm: string, context?: Object, macros?: Object): string;
    
      parse(vm: string, config?: Object, ignorespace?: boolean): Array<Ast>;
    
      Compile: {
        (asts: Array<Ast>, config?: Object): {
          render(context?: Object, macros?: Object);
        };
      };
    }
    

    render

    params:

    • vm {string} velocity string input
    • context {object} render context, data or function for vm
    • macros {object} such as #include('path/xxx') , you can define you include macro function
    var Velocity = require('velocityjs');
    
    Velocity.render('string of velocity', context, macros);

    context

    context is an object or undefined, for vm $foo.bar, data look up path will be context.foo.bar. context can have method, and call it just on velocity string.

    The context will have eval method on this of inner method body. You can eval to rerender velocity string as shown in this example: $control.setTemplate.

    Compile and parse

    parse method can parse vm, and return ast tree of velocity.

    Compile will render asts to result string.

    var Compile = Velocity.Compile;
    
    var asts = Velocity.parse('string of velocity');
    (new Compile(asts)).render(context, macros);
    

    Compile

    params:

    • asts {array} array of vm asts tree
    • config {object} you can define some option for Compile
    config
    • escape {boolean} default true, default escape variable to html encode, you can set false to close it.
    • unescape {object} define the object, which key do not need escape. For example, set unescape equal {control: true}, so $control.html will not escape.
    • env {string} when env equal development will throw error when null values are used
    • valueMapper {function} this config allow us to redefine the #set value, @see https://github.com/shepherdwind/velocity.js/pull/105

    parse

    params:

    • vm {string} string to parse
    • blocks {object} self define blocks, such as #cms(1) hello #end, you can set {cms: true}
    • ignorespace {boolean} if set true, then ignore the newline trim.

    Syntax

    Syntax you can find from velocity user guide

    Directives

    Directives supports have set, foreach, if|else|elseif, macro, break, stop, return.

    Some other directives such as evaluate, define, parse are not supported by default, but they can be used via context or macros, for example parse

    Questions

    You can find help from those ways:

    1. New issue
    2. Email to eward.song at gmail.com
    3. 阿里内部员工,可以通过 hanwen.sah 搜到我的旺旺

    Other

    Recommend an other velocity.

    License

    (The MIT License)

    Install

    npm i amplify-velocity-template

    DownloadsWeekly Downloads

    1,358,520

    Version

    1.4.6

    License

    (MIT OR Apache-2.0)

    Unpacked Size

    416 kB

    Total Files

    35

    Last publish

    Collaborators

    • amzn-oss
    • elorzafe
    • aws-amplify-ops