快速上手

    可直接使用 nunjucks.js (),如果针对编译后的模板可使用 nunjucks-slim.js ()。

    • nunjucks.js 可用于动态加载模板,当模板变化时重新加载,也可以用于预编译后的模板。包含编译器,所以会比较大 (20K min/gzipped)。如果你刚接触 nunjucks 可使用这个文件,如果你不在意大小也可以在生产环境使用。

    1. <script src="nunjucks.js"></script>

    或者可以作为一个 AMD 模块加载:

    这是最简单使用 nunjucks 的方式,首先设置配置项(如 autoescaping),然后渲染一个字符串:

    1. nunjucks.configure({ autoescape: true });
    2. nunjucks.renderString('Hello {{ username }}', { username: 'James' });

    renderString 并不常用,而是使用 来直接渲染文件,这种方式支持继承(extends)和包含(include)模板。使用之前需要配置文件的路径:

    如果使用 express 可直接传入 configure

    1. var app = express();
    2. express: app
    3. });
    4. app.get('/', function(req, res) {
    5. });

    上面的 API 适用于 node 端和浏览器端 (express 只适用于 node 端),在 node 端 nunjucks 从文件系统加载模板,在浏览器端通过 http 加载模板。

    如果你在浏览器上使用编译后的模板的话,你不需要额外做其他的事情系统也能够理解它们。这使得我们可以轻松地在开发环境和生产环境上使用同一份代码,并在生产环境上只使用已经编译过的模板。

    原文: