Odesza
Odesza allows you to write clean, expressive templates with inline JavaScript. It offers the flexibility of multiple inheritance and inline programming logic with the simplicity of writing plain HTML and JS.
- multiple inheritance
- variables
- fully expressive inline JavaScript
- support for Express
- no magic, 0 dependencies, and just 150 lines of code
Variables
Variables are passed in when Odesza templates are rendered. Scope is maintained through includes and extends.
var vars = {
name = 'world'
};
odesza.render('hello, ${name}', vars);
Inline JS
Odesza makes it easy to write inline JavaScript in your templates. Under the hood, templates are evaluated as ES6 template strings, which means you have access to ${}
expressions.
greetings.ode
<h2>welcome ${names.join(', ')}!</h2>
${(() => {
var items = [];
names.forEach((name, index) => {
items.push(`<div>${index + 1}: ${name}</div>`)
});
return items.join('<br/>');
})()}
code
var vars = {
names: ['wells', 'joe', 'dom']
};
odesza.compile('greetings.ode', vars);
output
<h2>welcome wells, joe, dom!</h2>
<div>1: wells</div><br/>
<div>2: joe</div><br/>
<div>3: dom</div>
Partials
Odesza makes it easy to nest templates within each other. You can include templates as many levels deep as you like.
greeting.ode
hello!
welcome.ode
include greeting
welcome, ${name}!
question.ode
include welcome
would you like to play a game, ${name}?
code
var vars = {
name: 'foo'
};
odesza.compile('question', vars);
output
hello!
welcome, foo!
would you like to play a game, foo?
Inheritance
Odesza gives you access to multiple inheritance through extending templates and block scopes.
layout.ode
<!doctype html>
<html>
<head>
<title>${title}</title>
block js
</head>
<body>
block content
</body>
</html>
page.ode (extends layout.ode)
extends layout
block js
<script src="${base_path}/page.js"></script>
endblock
block content
<p>
Some content.
</p>
endblock
extended_page.ode (extends page.ode, overwrites 'content' block)
extends page
block content
<p>
Overwritten content.
</p>
endblock
code
var vars = {
title: 'hello world',
base_path: 'public/js'
};
odesza.compile('extended_page.ode', vars);
output
<!doctype html>
<html>
<head>
<title>hello world</title>
<script src="public/js/page.js"></script>
</head>
<body>
<p>
Overwritten content.
</p>
</body>
</html>
Express Support
index.js
app.set('view engine', 'ode');
app.engine('.ode', require('odesza').__express);
controller
res.render('template', {
foo: 'bar'
});
Install
npm install odesza --save
License
MIT