Jade Node.js Template Engine, Include & Template Inheritance Part 6
In this post, I will write about using includes and template inheritance in Jade template engine.
You can also check out my previous 5 post on Jade.
- Jade Node.js Template Engine Part 1
- Jade Node.js Template Engine Basics Syntax Part 2
- Jade Node.js Template Engine DataBinding Part 3
- Jade Node.js Template Engine, Conditional Logic Statements Part 4
- Jade Node.js Template Engine, Filters & Mixins Part 5
Includes (aka partial views for .net developers)
To include css, javascript, html file, one can use the include directive in Jade. Lets say, you have a css that you wish to include in your jade file, you can then use the include like below, include can also import any html file that you may, or even markup text.
|
1 2 3 4 5 6 7 8 9 10 |
html head title Hello Includes include style.css style(type="text/css") include style2.css body p Two css were added include footer.jade include data/copyright.html |
One thing to note is the scope in the parent file and the include file is shared, so it allows one to use variables inside the include that are defined outside. Also one has to use the right extension for the file with the correct path. The example above shows the data/copyright.html is an html file located in the data folder.
There are also some other ways to include, css and javascript code blocks in Jade.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
//include the jquery with script tag script(type='text/javascript' src='jquery.min.js') //code inside of script tag script(type='text/javascript'). if (typeof username !== "undefined") { alert(username); } //include with link tag for css link(rel='stylesheet', href='style.css') //style inside of style tag style(type='text/css'). #content { font: 12px Arial; } |
Template Inheritance
Most sites have a generic look and feel, and if you are using includes (partials) it could soon become very ugly and hard to maintain all the includes. This is where Jade provides us with template inheritance, using the Block keyword as placeholders to inject other templates into the view.
We may have already seen this if we have used express web engine the layout.jade file as show below
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
//layout.jade doctype html html head title= title block stylesheets link(rel='stylesheet', href='/stylesheets/style.css') block jscripts script(src="jquery.min.js") body block content block footer |
In order to use this layout file, Jade provides us with the keyword extends, for example in our index.jade file we can extend the layout like.
|
1 2 3 4 5 6 7 8 |
extends layout block content h1= title p Welcome to #{title} block footer Copyright © 2014 |
From the above example, we see that we are replacing content, but Jade also provides us with prepend and append to the blocks. For example, if we wish to add zepto.js to our layout we can use the append keyword.
|
1 2 3 4 5 6 7 8 9 10 11 |
extends layout append jscripts script(src="zepto.js") block content h1= title p Welcome to #{title} block footer Copyright © 2014 |
Or if we want to prepend a css file to the link tag, so that style2.css loads before style.css we can use the prepend keyword.
|
1 2 3 4 5 6 7 8 9 10 11 |
extends layout prepend stylesheets link(rel='stylesheet', href='/stylesheets/style2.css') block content h1= title p Welcome to #{title} block footer Copyright © 2014 |
Note: Conditional statements like if else do not work with blocks since they are evaluated during compile time. The code below does not work.
|
1 2 3 4 |
if(loadLogin) extends loginlayout else extends layout |
Summary
This marks the end of the Jade, node.js template engine series, if you have any questions feel free to contact me, in the upcoming post I will write more about node and grunt/gulp (the Javascript task runner/ stream building system).
Sign up and follow my mail list if you wish to be posted on upcoming blog post.
Thanks you Taswar for shedding some light on this somewhat obscure language. I have added some valuable notes to my collection!