JacksonTian/ejs-mate — 210★ on GitHub (JavaScript). Express 4.x layout, partial template functions for the EJS template engine.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Express 4.x layout, partial and block template functions for the EJS template engine.
Previously also offered include but you should use EJS 1.0.x's own directive for that now.
Installation
$ npm install ejs-mate --save
(--save automatically writes to your package.json file, tell your friends)
Usage
Run node app.js from examples and open localhost:3000 to see a working example.
Given a template, index.ejs:
<% layout('boilerplate') -%>
<h1>I am the <%= what %> template</h1>
And a layout, boilerplate.ejs:
<!DOCTYPE html>
<html>
<head>
<title>It's <%= who %></title>
</head>
<body>
<section>
<%- body -%>
</section>
</body>
</html>
When rendered by an Express 4.0 app:
var express = require('express'),
engine = require('ejs-mate'),
app = express();
// use ejs-locals for all ejs templates:
app.engine('ejs', engine);
app.set('views', __dirname + '/views');
app.set('view engine', 'ejs'); // so you can render('index')
// render 'index' into 'boilerplate':
app.get('/',function(req,res,next){
res.render('index', { what: 'best', who: 'me' });
});
app.listen(3000);
You get the following result:
<!DOCTYPE html>
<html>
<head>
<title>It's me</title>
</head>
<body>
<section>
<h1>I am the best template</h1>
</section>
</body>
</html>
Note, if you haven't seen it before, this example uses trailing dashes in the EJS includes to slurp trailing whitespace and generate cleaner HTML. It's not strictly necessary.
Features
layout(view)
When called anywhere inside a template, requests that the output of the current template be passed to the given view as the body local. Use this to specify layouts from within your template, which is recommended with Express 3.0, since the app-level layout functionality has been removed.
partial(name,optionsOrCollection)
When called anywhere inside a template, adds the given view to that template using the current given optionsOrCollection. The usual way to use this is to pass an Array as the collection argument. The given view is then executed for each item in the Array; the item is passed into the view as a local with a name generated from the view's filename.
For example, if you do <%-partial('thing',things)%> then each item in the things Array is passed to thing.ejs with the name thing. If you rename the template, the local name of each item will correspond to the template name.
block('name')
Calling block('name') creates the named block if it doesn't exist, and then returns an object with append(), prepend(), replace(), and toString().
Basic usage:
body-template.ejs
<% layout('boilerplate') -%>
<% block('head').append('<link type="text/css" href="/foo.css">') %>
<h1>I am the template</h1>
<% block('footer').append('<script src="/bar.js"></script>') %>
To run the test suite first invoke the following command within the repo, installing the development dependencies:
$ npm install -d
then run the tests:
$ npm test
Whither Include?
We upgrade EJS to v3.x, it used as a method now:
<%- include('path/view') %>
Credits
This library is a fork from Robert Tom Carden's ejs-locals, and the partial function remains relatively untouched from there (aside from cache support). Robert is still updating his library and it now supports other template engines - check it out!
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
'Software'), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
No homepage URL was recorded for JacksonTian/ejs-mate in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How many stars does JacksonTian/ejs-mate have?
JacksonTian/ejs-mate has 210 GitHub stars — refresh the page for the live number, or check github.com/JacksonTian/ejs-mate. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is JacksonTian/ejs-mate open source?
TopGit's metadata for JacksonTian/ejs-mate does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What is JacksonTian/ejs-mate?
JacksonTian/ejs-mate (JacksonTian/ejs-mate) is a JavaScript project on GitHub. From the project's own README: Express 4.x layout, partial template functions for the EJS template engine.
Where do I read more about JacksonTian/ejs-mate?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/JacksonTian/ejs-mate is the definitive source.
Read full README in the tab above.
Want a second opinion on ejs-mate?
Ask an AI that can read this page — one click and you get its take on ejs-mate.
/ejs-mate
