express-ejs-layouts
Advanced tools
Layout support for ejs in express
$ npm install express-ejs-layouts
var express = require('express');
var expressLayouts = require('express-ejs-layouts');
var app = express();
app.set('view engine', 'ejs');
app.use(expressLayouts);
app.get('/', function(req, res) {
var locals = {
title: 'Page Title',
description: 'Page Description',
header: 'Page Header'
};
res.render('the-view', locals);
});
app.listen(3000);
contentForA view
somebody
<%- contentFor('foo') %>
club
<%- contentFor('bar') %>
fight
With a layout
<%-bar%> <%-foo%>
<%-body%>
Renders
fight club
somebody
As another example, consider this view:
foo
<%- contentFor('pageSectionA') %>
bar
<%- contentFor('pageSectionB') %>
baz
Using it with this layout:
<div class="header"><%- pageSectionA %></div>
<div class="body"><%- body %></div>
<div class="footer"><%-defineContent('pageSectionB')%></div>
Will render:
<div class="header">bar</div>
<div class="body">foo</div>
<div class="footer">baz</div>
Notice that the difference between using <%- pageSectionA %> and <%-defineContent('pageSectionA')%> is that the former will generate an error if the view doesn't define content for this section.
If you like to place all the script blocks at the end, you can do it like this:
app.set("layout extractScripts", true)
A view
something<script>somejs<script>something
With a layout
<body>
<%- body %>
<%- script %>
</body>
Renders
<body>
somethingsomething
<script>somejs<script>
</body>
Enabling invididually:
req.render('view', { extractScripts: true })
When the "layout extractScripts" option is activated, scripts defined in views will be extracted (won't be a part of body) and will be available for use in the layout through the variable scripts.
Another example:
This view:
<script src="/b.js" />
<div>foo</div>
<script src="/a.js" />
<div>bar</div>
<script src="/c.js" />
Used with this layout:
<div class="main">
<%- body %>
</div>
<!-- place the scripts at the end of the html page -->
<%- script %>
Will render:
<div class="main">
<div>foo</div>
<div>bar</div>
</div>
<!-- place the scripts at the end of the html page -->
<script src="/b.js" />
<script src="/a.js" />
<script src="/c.js" />
Works exactly like script blocks extraction except:
<link rel="stylesheet" …> and <style …>extractStylesstyleWorks exactly like script blocks extraction except:
<meta …> and <meta …/>extractMetasmetaIn a layout, you can have optional sections using defineContent:
Unspecified section content defaults to ''.
1
<%-defineContent('a')%>
2
<%-defineContent('b')%>
3
with a view:
<%- contentFor('a') %>
1.5
will render:
1
1.5
2
3
Clone the rep and run:
$ make test
MIT
FAQs
Layout support for ejs in express.
The npm package express-ejs-layouts receives a total of 10,846 weekly downloads. As such, express-ejs-layouts popularity was classified as popular.
We found that express-ejs-layouts 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.
Security News
Deno 2.2 enhances Node.js compatibility, improves dependency management, adds OpenTelemetry support, and expands linting and task automation for developers.
Security News
React's CRA deprecation announcement sparked community criticism over framework recommendations, leading to quick updates acknowledging build tools like Vite as valid alternatives.
Security News
Ransomware payment rates hit an all-time low in 2024 as law enforcement crackdowns, stronger defenses, and shifting policies make attacks riskier and less profitable.