express-ejs-extend
v0.0.1
Published
Layouts support for EJS templates in Express 3+.
Readme
Express EJS Extend
Layouts support for EJS templates in Express 3+.
Usage
First, add it as engine in your app:
// server.js
var express = require('express'),
path = require('path');
var app = express();
app.engine('ejs', require('express-ejs-extend')); // add this line
app.set('view engine', 'ejs');
app.set('views', path.join(__dirname, 'views'));
app.get('/', function (req, res) {
res.render('index', {title: 'world!'});
});
app.listen(3000);Finally, in your views, call the extend function:
<%# views/index.ejs %>
<% extend('layout') %>
<h1>Hello <%= title %></h1><%# views/layout.ejs %>
<!DOCTYPE html>
<html>
<body>
<%- content %>
</body>
</html>That's all, your GET / will render:
<!DOCTYPE html>
<html>
<body>
<h1>Hello world!</h1>
</body>
</html>Notes:
- In your view (the one that calls
extend), you can surround theextendwith any combination of (<%or<%-) and (%>or-%>). - In your layout, it's recommended to use exactly
<%- content %>so the engine doesn't escape your HTML tags. Also you can end it with-%>instead to avoid any trailing\n. - The signature of
extendis:extend(layout[, data]), so you can also pass an object with data and that will be passed to the layout.
License
This project is released under the MIT license.