Is the glue for express and nunjucks
npm install express-nunjucksIs the glue for express and nunjucks.
Supports ESM modules 👍
- Easy connection.
- Uses of common templates, filters and extensions.
- Uses an asynchronous loader templates nunjucks-async-loader.
- Support context processors.
``bash`
$ npm i nunjucks express-nunjucks
`typescript
import express from 'express';
import expressNunjucks from 'express-nunjucks';
// For CommonJS
// const expressNunjucks = require('express-nunjucks').default;
const app = express();
const isDev = app.get('env') === 'development';
app.set('views', __dirname + '/templates');
const njk = expressNunjucks(app, {
watch: isDev,
noCache: isDev,
});
app.get('/', (req, res) => {
res.render('index');
});
app.listen(3000);
`
#### apps {Object|Array}
[Express application][exp_app] or an array of applications.
#### config {Object}
- watch=false {Boolean} - if true, the system will automatically update templates when they are changed on the filesystem.noCache=false {Boolean}
- - if true, the system will avoid using a cache and templates will be recompiled every single time.autoescape=true {Boolean}
- - controls if output with dangerous characters are escaped automatically.throwOnUndefined=false {Boolean}
- - throw errors when outputting a null/undefined value.trimBlocks=false {Boolean}
- - automatically remove trailing newlines from a block/tag.lstripBlocks=false {Boolean}
- - automatically remove leading whitespace from a block/tag.tags
- - defines the syntax for [nunjucks tags][njk_custom_tags].filters
- - defines the syntax for [nunjucks filters][njk_custom_filters].loader
- - defines [loader templates][njk_loader]. The default is the asynchronous loader templates.globals
- - defines [global variables][njk_globals].
Creates [Express middleware][exp_middleware] to work context processors.
Returns [Nunjucks Environment][njk_env].
Create [custom filters][njk_custom_filters] in nunjucks.
`typescript
import express from 'express';
import expressNunjucks from 'express-nunjucks';
import filters from './filters';
const app = express();
app.set('views', __dirname + '/templates');
const njk = expressNunjucks(app, {
// Add custom filter.
filters: filters,
});
app.get('/', (req, res) => {
res.render('index');
});
app.listen(3000);
`
Defines [globals][njk_globals] to use this in templates.
`typescript
import express from 'express';
import expressNunjucks from 'express-nunjucks';
import { asset } from './utils';
const app = express();
app.set('views', __dirname + '/templates');
const njk = expressNunjucks(app, {
// Defines globals.
globals: { asset: asset },
});
app.get('/', (req, res) => {
res.render('index');
});
app.listen(3000);
`
`html`
...
...
Context processors is one great idea from the [django framework][dj_ctx_processors].
`typescript
import express from 'express';
import expressNunjucks from 'express-nunjucks';
import { webpackAssets } from './build/assets';
const app = express();
app.set('views', __dirname + '/templates');
// Adds information about the request in the context of the template.
const reqCtxProcessor = (req, ctx) => {
ctx.req = req;
};
// Adds links to statics in the context of the template.
const assetsCtxProcessor = (req, ctx) => {
ctx.scripts = webpackAssets.scripts;
ctx.styles = webpackAssets.styles;
};
const njk = expressNunjucks(app);
app.use(njk.ctxProc([reqCtxProcessor, assetsCtxProcessor]));
app.get('/', (req, res) => {
res.render('index');
});
app.listen(3000);
`
Warning! Context processors not supported to app.render().
`typescript
import express from 'express';
import expressNunjucks from 'express-nunjucks';
const app = express();
app.set('views', __dirname + '/templates');
const njk = expressNunjucks(app, {
loader: nunjucks.FileSystemLoader,
});
app.get('/', (req, res) => {
res.render('index');
});
app.listen(3000);
`
#### General application
`typescript
// proj/app.js
import express from 'express';
import expressNunjucks from 'express-nunjucks';
import subApp from './subapp';
const app = express();
app.set('views', __dirname + '/templates');
const njk = expressNunjucks([app, subApp]);
app.get('/', (req, res) => {
res.render('index');
});
app.use('/subApp', subApp);
// and more...
app.listen(3000);
`
#### Sub application
`typescript
// proj/subapp/index.js
import express from 'express';
const app = express();
app.set('views', __dirname + '/templates');
app.get('/', (req, res) => {
res.render('index');
});
module.exports = app;
`
#### Template hierarchy
``
proj
|
|- templates
| |
| |- base.html
| |- index.html
| |-subapp
| |
| |-page.html
|
|- subapp
|
|-templates
|
|-subapp
|
|-index.html
|-page.html
The templates in the directory proj/templates/subapp override templates proj/subapp/templates/subapp.
If you're having trouble importing a module into TypeScript, try adding settings to tsconfig.json:
`json`
{
"compilerOptions": {
"esModuleInterop": true,
"allowSyntheticDefaultImports": true
}
}
To run the test suite, first install the dependencies, then run npm test:
`bash``
$ npm ci
$ npm test
[dj_ctx_processors]: https://docs.djangoproject.com/en/1.9/ref/templates/api/#built-in-template-context-processors
[njk_custom_filters]: http://mozilla.github.io/nunjucks/api.html#custom-filters
[njk_custom_tags]: http://mozilla.github.io/nunjucks/api.html#customizing-syntax
[njk_env]: http://mozilla.github.io/nunjucks/api.html#environment
[njk_loader]: https://mozilla.github.io/nunjucks/api.html#loader
[njk_globals]: http://mozilla.github.io/nunjucks/api.html#addglobal
[exp_engine]: http://expressjs.com/en/api.html#app.engine
[exp_app]: http://expressjs.com/en/api.html#app
[exp_middleware]: http://expressjs.com/en/guide/writing-middleware.html