express-twig-layout
Advanced tools
express-twig-layout is a layout system based on twig.
$ npm install express-twig-layout
This exemple use express and express-twig-layout
install express and express-twig-layout
$ npm install --save express
$ npm install --save express-twig-layout
Create a simple express app with two route: /home and /test
const express = require('express')
const layout = require('express-twig-layout')
const app = express()
//set the views directory
app.set('views', './views')
app.use(layout({
cache: false,
tmpDir: './tmp',
sourceMap: false,
mode: 'eval',
}))
//home route
app.get('/home', function (req, res) {
//load the layout from the file home.html
req.layout.loadTemplate('home.html').then(() => {
//send the layout html
req.layout.render().then((html) => {
res.send(html)
})
})
})
//test route
app.get('/test', function (req, res) {
//load the layout from the file test.html
req.layout.loadTemplate('test.html').then(() => {
//Set the title of the block head
req.layout.getBlock('head').data.title = 'Test page'
//send the layout html
req.layout.render().then((html) => {
res.send(html)
})
})
})
app.get('*', function (req, res) {
res.redirect('/home')
})
app.listen(3000, function () {
console.log('Example app listening on port 3000!')
})
The template for the page For the template syntax read the twig js documentation
<template>
<!doctype html>
<html lang="en">
<!-- block head -->
{{ getBlockHtml('head') }}
<body>
<header>
<nav>
<ul>
<li>
<a href="/home">Home</a>
</li>
<li>
<a href="/test">Test</a>
</li>
</ul>
</nav>
</header>
<main role="main">
<!-- block content -->
{{ getBlockHtml('content') }}
</main>
<footer>
<p>footer</p>
</footer>
</body>
</html>
</template>
<script>
//Require the block dependency
var Block = require('twig-layout/block')
//Block for the page
class Default extends Block {
init () {
//set the name of the block
//the name of the block can be define in this way or for other block it can be defined in the config
this.name = 'page'
//Head block
this.addBlock({name: 'head', template: 'page/head.html'})
//content block it just a block container
//to use block with no html temple use type
this.addBlock({name: 'content', script: 'twig-layout/scripts/container'})
}
/**
* before render callback
*/
beforeRender () {
//Add a css file
this.layout.getBlock('head').addCss('https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css', -10)
}
}
module.exports = Default
</script>
template for the head block define in the file views/page/default.html
<template>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta name="description" content="">
<meta name="author" content="">
<title>{{ title }}</title>
{% for css in this.css %}
<link rel="stylesheet" href="{{ css.file }}">
{% endfor %}
{% for js in this.js %}
<script src="{{ js.file }}"></script>
{% endfor %}
</head>
</template>
<script>
//requite the block object
var Block = require('twig-layout/block')
//A Test class for the test page
class Head extends Block {
/**
* Init method
*/
init() {
this.name = 'head'
//data array for render
this.css = []
this.js = []
}
//add css files
addCss (cssFiles, weight = 0) {
if (Array.isArray(cssFiles)) {
for (const key in cssFiles) {
this.css.push({weight: weight, file: cssFiles[key]})
}
} else if (typeof cssFiles === 'string') {
this.css.push({weight: weight, file: cssFiles})
} else {
throw Error('Invalid addCss argument')
}
}
//add js files to the data object
addJs (jsFiles) {
if (Array.isArray(jsFiles)) {
for (const key in jsFiles) {
this.js.push({weight: weight, file: jsFiles[key]})
}
} else if (typeof jsFiles === 'string') {
this.js.push({weight: weight, file: jsFiles})
} else {
throw Error('Invalid addJs argument')
}
}
/**
* Before render callback
*/
beforeRender() {
const sort = function(a, b) {
return a.weight - b.weight
}
this.css.sort(sort);
this.js.sort(sort);
}
}
module.exports = Head
</script>
The template for the /home route
<template>
<div>
<h1>{{ this.title }}</h1>
</div>
</template>
<script>
//requite the block object
var Block = require('twig-layout/block')
//A Block class for the home page
class Home extends Block {
init () {
this.page ='page/default.html'
//name of the parent block of this block
//here the block content, it is defined in the file page/default.html
this.parent = 'content'
this.name = 'home'
this.title = 'Home page'
}
beforeRender() {
this.layout.getBlock('head').data.title = 'Home page'
}
}
module.exports = Home
</script>
The template for the /test route
<template>
<div class="test">
<h1>{{ this.title }}</h1>
</div>
</template>
<script>
//requite the block object
var Block = require('twig-layout/block')
//A Test class for the test page
class Test extends Block {
init () {
this.page ='page/default.html'
//name of the parent block of this block
//here the block content, it is defined in the file page/default.html
this.parent = 'content'
this.name = 'test'
this.title = 'Test'
}
}
module.exports = Test
</script>
$ node index.js
FAQs
A template layout system for Express
We found that express-twig-layout demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Ongoing npm supply chain attack spreads to DuckDB: multiple packages compromised with the same wallet-drainer malware.
Security News
The MCP Steering Committee has launched the official MCP Registry in preview, a central hub for discovering and publishing MCP servers.
Product
Socket’s new Pull Request Stories give security teams clear visibility into dependency risks and outcomes across scanned pull requests.