templates

System for creating and managing template collections, and rendering templates with any node.js template engine. Can be used as the basis for creating a static site generator or blog framework.

templates

System for creating and managing template collections, and rendering templates with any node.js template engine. Can be used as the basis for creating a static site generator or blog framework.

(TOC generated by verb using markdown-toc)

Install with npm:

$ npm i templates --save

Features

  • create custom view collections using app.create('foo')
  • register any template engine for rendering views
  • register helpers
  • partial support
  • plugins and middleware

Example

This is just a very small glimpse at the templates API!

var templates = require('templates');
var app = templates();
 
// create a collection 
app.create('pages');
 
// add views to the collection 
app.page('a.html', {content: 'this is <%= foo %>'});
app.page('b.html', {content: 'this is <%= bar %>'});
app.page('c.html', {content: 'this is <%= baz %>'});
 
app.pages.getView('a.html')
  .render({foo: 'home'}, function (errview) {
    //=> 'this is home' 
  });
var templates = require('templates');
var app = templates();

This section describes API features that are shared by all Templates classes.

Set or get an option value.

Params

  • key {String|Object}: Pass a key-value pair or an object to set.
  • val {any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.
  • returns {Object}: Returns the instance for chaining.

Example

app.option('a', 'b');
app.option({c: 'd'});
console.log(app.options);
//=> {a: 'b', c: 'd'} 

Run a plugin on the given instance. Plugins are invoked immediately upon instantiating in the order in which they were defined.

Example

The simplest plugin looks something like the following:

app.use(function(inst) {
  // do something to `inst` 
});

Note that inst is the instance of the class you're instantiating. So if you create an instance of Collection, inst is the collection instance.

Params

  • fn {Function}: Plugin function. If the plugin returns a function it will be passed to the use method of each item created on the instance.
  • returns {Object}: Returns the instance for chaining.

Usage

collection.use(function(items) {
  // `items` is the instance, as is `this` 
 
  // optionally return a function to be passed to 
  // the `.use` method of each item created on the 
  // instance 
  return function(item) {
    // do stuff to each `item` 
  };
});

API for the main Templates class.

Templates

This function is the main export of the templates module. Initialize an instance of templates to create your application.

Params

  • options {Object}

Example

var templates = require('templates');
var app = templates();

.list

Create a new list. See the list docs for more information about lists.

Params

  • opts {Object}: List options
  • returns {Object}: Returns the list instance for chaining.

Example

var list = app.list();
list.addItem('abc', {content: '...'});
 
// or, create list from a collection 
app.create('pages');
var list = app.list(app.pages);

.collection

Create a new collection. Collections are decorated with special methods for getting and setting items from the collection. Note that, unlike the create method, collections created with .collection() are not cached.

See the collection docs for more information about collections.

Params

  • opts {Object}: Collection options
  • returns {Object}: Returns the collection instance for chaining.

.create

Create a new view collection to be stored on the app.views object. See the create docs for more details.

Params

  • name {String}: The name of the collection to create. Plural or singular form may be used, as the inflections are automatically resolved when the collection is created.
  • opts {Object}: Collection options
  • returns {Object}: Returns the collection instance for chaining.

.engine

Register a view engine callback fn as ext.

Params

  • exts {String|Array}: String or array of file extensions.
  • fn {Function|Object}: or settings
  • settings {Object}: Optionally pass engine options as the last argument.

Example

app.engine('hbs', require('engine-handlebars'));
 
// using consolidate.js 
var engine = require('consolidate');
app.engine('jade', engine.jade);
app.engine('swig', engine.swig);
 
// get a registered engine 
var swig = app.engine('swig');

.helper

Register a template helper.

Params

  • name {String}: Helper name
  • fn {Function}: Helper function.

Example

app.helper('upper', function(str) {
  return str.toUpperCase();
});

.helpers

Register multiple template helpers.

Params

  • helpers {Object|Array}: Object, array of objects, or glob patterns.

Example

app.helpers({
  foofunction() {},
  barfunction() {},
  bazfunction() {}
});

.helper

Get a sync helper that was previously registered.

Params

  • name {String}: Helper name
  • fn {Function}: Helper function.

Example

app.helper('upper', function(str) {
  return str.toUpperCase();
});

.asyncHelper

Register an async helper.

Params

  • name {String}: Helper name.
  • fn {Function}: Helper function

Example

app.asyncHelper('upper', function(strnext) {
  next(null, str.toUpperCase());
});

.asyncHelpers

Register multiple async template helpers.

Params

  • helpers {Object|Array}: Object, array of objects, or glob patterns.

Example

app.asyncHelpers({
  foofunction() {},
  barfunction() {},
  bazfunction() {}
});

.helperGroup

Register a namespaced helper group.

Params

  • helpers {Object|Array}: Object, array of objects, or glob patterns.

Example

// markdown-utils 
app.helperGroup('mdu', {
  foofunction() {},
  barfunction() {},
});
 
// Usage: 
// <%= mdu.foo() %> 
// <%= mdu.bar() %> 

Params

  • name {String}
  • collection {String}
  • returns {String}

Example

<%= view("foo") %>

If the helper is used as a handlebars block helper, the collection array will be exposed as context to options.fn(), otherwise the List array is returned.

Params

  • options {Object}: Locals or handlebars options object
  • callback {String}: Handled internally by the templates library.

Example

// create a collection 
app.create('pages');
 
// use the `pages` helper 
// {{#pages}} ... {{/pages}} 

API for the View class.

View

Create an instance of View. Optionally pass a default object to use.

Params

  • view {Object}

Example

var view = new View({
  path: 'foo.html',
  content: '...'
});

.context

Creates a context object from front-matter data, view.locals and the given locals object.

Params

  • locals {Object}: Optionally pass locals to the engine.
  • returns {Object}: Returns the context object.

Example

var ctx = page.context({foo: 'bar'});

.compile

Synchronously compile a view.

Params

  • locals {Object}: Optionally pass locals to the engine.
  • returns {Object} View: instance, for chaining.

Example

var view = page.compile();
view.fn({title: 'A'});
view.fn({title: 'B'});
view.fn({title: 'C'});

.render

Asynchronously render a view.

Params

  • locals {Object}: Optionally pass locals to the engine.
  • returns {Object} View: instance, for chaining.

Example

view.render({title: 'Home'}, function(errres) {
  //=> view object with rendered `content` 
});

.isType

Return true if the view is the given view type. Since types are assigned by collections, views that are "collection-less" will not have a type, and thus will always return false (as expected).

Params

  • type {String}: (renderable, partial, layout)

Example

view.isType('partial');

.data

Set, get and load data to be passed to templates as context at render-time.

Params

  • key {String|Object}: Pass a key-value pair or an object to set.
  • val {any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.
  • returns {Object}: Returns an instance of Templates for chaining.

Example

view.data('a', 'b');
view.data({c: 'd'});
console.log(view.cache.data);
//=> {a: 'b', c: 'd'} 

.context

Build the context for the given view and locals.

Params

  • view {Object}: The view being rendered
  • locals {Object}
  • returns {Object}: The object to be passed to engines/views as context.

.mergePartials

Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.

Params

  • options {Object}: Optionally pass an array of viewTypes to include on options.viewTypes
  • returns {Object}: Merged partials

API for the Item class.

Item

Create an instance of Item. Optionally pass a default object to use.

Params

  • item {Object}

Example

var item = new Item({
  path: 'foo.html',
  content: '...'
});

.clone

Re-decorate Item methods after calling vinyl's .clone() method.

Params

  • options {Object}
  • returns {Object} item: Cloned instance

Example

item.clone({deep: true}); // false by default 

.data

Set, get and load data to be passed to templates as context at render-time.

Params

  • key {String|Object}: Pass a key-value pair or an object to set.
  • val {any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.
  • returns {Object}: Returns an instance of Templates for chaining.

Example

item.data('a', 'b');
item.data({c: 'd'});
console.log(item.cache.data);
//=> {a: 'b', c: 'd'} 

.context

Build the context for the given view and locals.

Params

  • view {Object}: The view being rendered
  • locals {Object}
  • returns {Object}: The object to be passed to engines/views as context.

.mergePartials

Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.

Params

  • options {Object}: Optionally pass an array of viewTypes to include on options.viewTypes
  • returns {Object}: Merged partials

API for the Views class.

Views

Create an instance of Views with the given options.

Params

  • options {Object}

Example

var collection = new Views();
collection.addView('foo', {content: 'bar'});

.setView

Set a view on the collection. This is identical to addView except setView does not emit an event for each view.

Params

  • key {String|Object}: View key or object
  • value {Object}: If key is a string, value is the view object.
  • returns {Object}: returns the view instance.

Example

collection.setView('foo', {content: 'bar'});

.addView

Similar to setView, adds a view to the collection but also fires an event and iterates over the loading queue for loading views from the addView event listener. If the given view is not already an instance of View, it will be converted to one before being added to the views object.

Params

  • key {String}
  • value {Object}
  • returns {Object}: Returns the instance of the created View to allow chaining view methods.

Example

var views = new Views(...);
views.addView('a.html', {path: 'a.html', contents: '...'});

.deleteView

Delete a view from collection views.

Params

  • key {String}
  • returns {Object}: Returns the instance for chaining

Example

views.deleteView('foo.html');

.addViews

Load multiple views onto the collection.

Params

  • views {Object|Array}
  • returns {Object}: returns the collection object

Example

collection.addViews({
  'a.html': {content: '...'},
  'b.html': {content: '...'},
  'c.html': {content: '...'}
});

.addList

Load an array of views onto the collection.

Params

  • list {Array}
  • returns {Object}: returns the views instance

Example

collection.addList([
  {path: 'a.html', content: '...'},
  {path: 'b.html', content: '...'},
  {path: 'c.html', content: '...'}
]);

.getView

Get view name from collection.views.

Params

  • key {String}: Key of the view to get.
  • fn {Function}: Optionally pass a function to modify the key.
  • returns {Object}

Example

collection.getView('a.html');

.extendView

Load a view from the file system.

Params

  • view {Object}
  • returns {Object}

Example

collection.loadView(view);

.isType

Return true if the collection belongs to the given view type.

Params

  • type {String}: (renderable, partial, layout)

Example

collection.isType('partial');

.data

Set, get and load data to be passed to templates as context at render-time.

Params

  • key {String|Object}: Pass a key-value pair or an object to set.
  • val {any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.
  • returns {Object}: Returns an instance of Templates for chaining.

Example

views.data('a', 'b');
views.data({c: 'd'});
console.log(views.cache.data);
//=> {a: 'b', c: 'd'} 

.context

Build the context for the given view and locals.

Params

  • view {Object}: The view being rendered
  • locals {Object}
  • returns {Object}: The object to be passed to engines/views as context.

.mergePartials

Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.

Params

  • options {Object}: Optionally pass an array of viewTypes to include on options.viewTypes
  • returns {Object}: Merged partials

.find

Find a view by name, optionally passing a collection to limit the search. If no collection is passed all renderable collections will be searched.

Params

  • name {String}: The name/key of the view to find
  • colleciton {String}: Optionally pass a collection name (e.g. pages)
  • returns {Object|undefined}: Returns the view if found, or undefined if not.

Example

var page = app.find('my-page.hbs');
 
// optionally pass a collection name as the second argument 
var page = app.find('my-page.hbs', 'pages');

.getView

Get view key from the specified collection.

Params

  • collection {String}: Collection name, e.g. pages
  • key {String}: Template name
  • fn {Function}: Optionally pass a renameKey function
  • returns {Object}

Example

var view = app.getView('pages', 'a/b/c.hbs');
 
// optionally pass a `renameKey` function to modify the lookup 
var view = app.getView('pages', 'a/b/c.hbs', function(fp) {
  return path.basename(fp);
});

.getViews

Get all views from a collection using the collection's singular or plural name.

Params

  • name {String}: The collection name, e.g. pages or page
  • returns {Object}

Example

var pages = app.getViews('pages');
//=> { pages: {'home.hbs': { ... }} 
 
var posts = app.getViews('posts');
//=> { posts: {'2015-10-10.md': { ... }} 

API for the Collections class.

Collection

Create an instance of Collection with the given options.

Params

  • options {Object}

Example

var collection = new Collection();
collection.addItem('foo', {content: 'bar'});

.setItem

Set an item on the collection. This is identical to addItem except setItem does not emit an event for each item and does not iterate over the item queue.

Params

  • key {String|Object}: Item key or object
  • value {Object}: If key is a string, value is the item object.
  • returns {Object}: returns the item instance.

Example

collection.setItem('foo', {content: 'bar'});

.addItem

Similar to setItem, adds an item to the collection but also fires an event and iterates over the item queue to load items from the addItem event listener. An item may be an instance of Item, if not, the item is converted to an instance of Item.

Params

  • key {String}
  • value {Object}

Example

var list = new List(...);
list.addItem('a.html', {path: 'a.html', contents: '...'});

.deleteItem

Delete an item from collection items.

Params

  • key {String}
  • returns {Object}: Returns the instance for chaining

Example

items.deleteItem('abc');

.addItems

Load multiple items onto the collection.

Params

  • items {Object|Array}
  • returns {Object}: returns the instance for chaining

Example

collection.addItems({
  'a.html': {content: '...'},
  'b.html': {content: '...'},
  'c.html': {content: '...'}
});

.addList

Load an array of items onto the collection.

Params

  • items {Array}: or an instance of List
  • fn {Function}: Optional sync callback function that is called on each item.
  • returns {Object}: returns the Collection instance for chaining

Example

collection.addList([
  {path: 'a.html', content: '...'},
  {path: 'b.html', content: '...'},
  {path: 'c.html', content: '...'}
]);

.getItem

Get an item from the collection.

Params

  • key {String}: Key of the item to get.
  • returns {Object}

Example

collection.getItem('a.html');

.data

Set, get and load data to be passed to templates as context at render-time.

Params

  • key {String|Object}: Pass a key-value pair or an object to set.
  • val {any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.
  • returns {Object}: Returns an instance of Templates for chaining.

Example

collection.data('a', 'b');
collection.data({c: 'd'});
console.log(collection.cache.data);
//=> {a: 'b', c: 'd'} 

.context

Build the context for the given view and locals.

Params

  • view {Object}: The view being rendered
  • locals {Object}
  • returns {Object}: The object to be passed to engines/views as context.

.mergePartials

Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.

Params

  • options {Object}: Optionally pass an array of viewTypes to include on options.viewTypes
  • returns {Object}: Merged partials

API for the List class.

List

Create an instance of List with the given options. Lists differ from collections in that items are stored as an array, allowing items to be paginated, sorted, and grouped.

Params

  • options {Object}

Example

var list = new List();
list.addItem('foo', {content: 'bar'});

.setItem

Set an item on the collection. This is identical to addItem except setItem does not emit an event for each item and does not iterate over the item queue.

Params

  • key {String|Object}: Item key or object
  • value {Object}: If key is a string, value is the item object.
  • returns {Object}: returns the item instance.

Example

collection.setItem('foo', {content: 'bar'});

.addItem

Similar to setItem, adds an item to the list but also fires an event and iterates over the item queue to load items from the addItem event listener. If the given item is not already an instance of Item, it will be converted to one before being added to the items object.

Params

  • key {String}
  • value {Object}
  • returns {Object}: Returns the instance of the created Item to allow chaining item methods.

Example

var items = new Items(...);
items.addItem('a.html', {path: 'a.html', contents: '...'});

.addItems

Load multiple items onto the collection.

Params

  • items {Object|Array}
  • returns {Object}: returns the instance for chaining

Example

collection.addItems({
  'a.html': {content: '...'},
  'b.html': {content: '...'},
  'c.html': {content: '...'}
});

.addList

Load an array of items or the items from another instance of List.

Params

  • items {Array}: or an instance of List
  • fn {Function}: Optional sync callback function that is called on each item.
  • returns {Object}: returns the List instance for chaining

Example

var foo = new List(...);
var bar = new List(...);
bar.addList(foo);

.hasItem

Return true if the list has the given item (name).

Params

  • key {String}
  • returns {Object}

Example

list.addItem('foo.html', {content: '...'});
list.hasItem('foo.html');
//=> true 

.getIndex

Get a the index of a specific item from the list by key.

Params

  • key {String}
  • returns {Object}

Example

list.getIndex('foo.html');
//=> 1 

.getItem

Get a specific item from the list by key.

Params

  • key {String}: The item name/key.
  • returns {Object}

Example

list.getItem('foo.html');
//=> '<Item <foo.html>>' 

.getView

Proxy for getItem

Params

  • key {String}: Pass the key of the item to get.
  • returns {Object}

Example

list.getItem('foo.html');
//=> '<Item "foo.html" <buffer e2 e2 e2>>' 

.deleteItem

Remove an item from the list.

Params

  • key {Object|String}: Pass an item instance (object) or item.key (string).

Example

list.deleteItem('a.html');

.removeItem

Remove an item from the list.

Params

  • key {Object|String}: Pass an item instance or item.key

Example

list.removeItem('a.html');

.extendItem

Decorate each item on the list with additional methods and properties. This provides a way of easily overriding defaults.

Params

  • item {Object}
  • returns {Object}: Instance of item for chaining

.groupBy

Group all list items using the given property, properties or compare functions. See group-array for the full range of available features and options.

  • returns {Object}: Returns the grouped items.

Example

var list = new List();
list.addItems(...);
var groups = list.groupBy('data.date', 'data.slug');

.sortBy

Sort all list items using the given property, properties or compare functions. See array-sort for the full range of available features and options.

  • returns {Object}: Returns a new List instance with sorted items.

Example

var list = new List();
list.addItems(...);
var result = list.sortBy('data.date');
//=> new sorted list 

.paginate

Paginate all items in the list with the given options, See paginationator for the full range of available features and options.

  • returns {Object}: Returns the paginated items.

Example

var list = new List(items);
var pages = list.paginate({limit: 5});

.data

Set, get and load data to be passed to templates as context at render-time.

Params

  • key {String|Object}: Pass a key-value pair or an object to set.
  • val {any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.
  • returns {Object}: Returns an instance of Templates for chaining.

Example

list.data('a', 'b');
list.data({c: 'd'});
console.log(list.cache.data);
//=> {a: 'b', c: 'd'} 

.context

Build the context for the given view and locals.

Params

  • view {Object}: The view being rendered
  • locals {Object}
  • returns {Object}: The object to be passed to engines/views as context.

.mergePartials

Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.

Params

  • options {Object}: Optionally pass an array of viewTypes to include on options.viewTypes
  • returns {Object}: Merged partials

API for the Group class.

Group

Create an instance of Group with the given options.

Params

  • options {Object}

Example

var group = new Group({
  'foo': { items: [1,2,3] }
});

.find

Find a view by name, optionally passing a collection to limit the search. If no collection is passed all renderable collections will be searched.

Params

  • name {String}: The name/key of the view to find
  • colleciton {String}: Optionally pass a collection name (e.g. pages)
  • returns {Object|undefined}: Returns the view if found, or undefined if not.

Example

var page = app.find('my-page.hbs');
 
// optionally pass a collection name as the second argument 
var page = app.find('my-page.hbs', 'pages');

.getView

Get view key from the specified collection.

Params

  • collection {String}: Collection name, e.g. pages
  • key {String}: Template name
  • fn {Function}: Optionally pass a renameKey function
  • returns {Object}

Example

var view = app.getView('pages', 'a/b/c.hbs');
 
// optionally pass a `renameKey` function to modify the lookup 
var view = app.getView('pages', 'a/b/c.hbs', function(fp) {
  return path.basename(fp);
});

.getViews

Get all views from a collection using the collection's singular or plural name.

Params

  • name {String}: The collection name, e.g. pages or page
  • returns {Object}

Example

var pages = app.getViews('pages');
//=> { pages: {'home.hbs': { ... }} 
 
var posts = app.getViews('posts');
//=> { posts: {'2015-10-10.md': { ... }} 

.compile

Compile content with the given locals.

Params

  • view {Object|String}: View object.
  • locals {Object}
  • isAsync {Boolean}: Load async helpers
  • returns {Object}: View object with fn property with the compiled function.

Example

var indexPage = app.page('some-index-page.hbs');
var view = app.compile(indexPage);
// view.fn => [function] 
 
// you can call the compiled function more than once 
// to render the view with different data 
view.fn({title: 'Foo'});
view.fn({title: 'Bar'});
view.fn({title: 'Baz'});

.render

Render a view with the given locals and callback.

Params

  • view {Object|String}: Instance of View
  • locals {Object}: Locals to pass to template engine.
  • callback {Function}

Example

var blogPost = app.post.getView('2015-09-01-foo-bar');
app.render(blogPost, {title: 'Foo'}, function(errview) {
  // `view` is an object with a rendered `content` property 
});

.data

Set, get and load data to be passed to templates as context at render-time.

Params

  • key {String|Object}: Pass a key-value pair or an object to set.
  • val {any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.
  • returns {Object}: Returns an instance of Templates for chaining.

Example

app.data('a', 'b');
app.data({c: 'd'});
console.log(app.cache.data);
//=> {a: 'b', c: 'd'} 

.context

Build the context for the given view and locals.

Params

  • view {Object}: The view being rendered
  • locals {Object}
  • returns {Object}: The object to be passed to engines/views as context.

.mergePartials

Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.

Params

  • options {Object}: Optionally pass an array of viewTypes to include on options.viewTypes
  • returns {Object}: Merged partials

.handle

Handle a middleware method for view.

Params

  • method {String}: Name of the router method to handle. See router methods
  • view {Object}: View object
  • callback {Function}: Callback function
  • returns {Object}

Example

app.handle('customMethod', view, callback);

.route

Create a new Route for the given path. Each route contains a separate middleware stack.

See the [route API documentation][route-api] for details on adding handlers and middleware to routes.

Params

  • path {String}
  • returns {Object} Route: for chaining

Example

app.create('posts');
app.route(/blog/)
  .all(function(viewnext) {
    // do something with view 
    next();
  });
 
app.post('whatever', {path: 'blog/foo.bar', content: 'bar baz'});

.all

Special route method that works just like the router.METHOD() methods, except that it matches all verbs.

Params

  • path {String}
  • callback {Function}
  • returns {Object} this: for chaining

Example

app.all(/\.hbs$/, function(viewnext) {
  // do stuff to view 
  next();
});

.param

Add callback triggers to route parameters, where name is the name of the parameter and fn is the callback function.

Params

  • name {String}
  • fn {Function}
  • returns {Object}: Returns the instance of Templates for chaining.

Example

app.param('title', function(viewnexttitle) {
  //=> title === 'foo.js' 
  next();
});
 
app.onLoad('/blog/:title', function(viewnext) {
  //=> view.path === '/blog/foo.js' 
  next();
});

Params

  • val {Object}: The value to test.
  • returns {Boolean}

Example

var templates = require('templates');
var app = templates();
 
templates.isApp(templates);
//=> false 
 
templates.isApp(app);
//=> true 

Params

  • val {Object}: The value to test.
  • returns {Boolean}

Example

var templates = require('templates');
var app = templates();
 
app.create('pages');
templates.isCollection(app.pages);
//=> true 

Params

  • val {Object}: The value to test.
  • returns {Boolean}

Example

var templates = require('templates');
var app = templates();
 
app.create('pages');
templates.isViews(app.pages);
//=> true 

Params

  • val {Object}: The value to test.
  • returns {Boolean}

Example

var templates = require('templates');
var List = templates.List;
var app = templates();
 
var list = new List();
templates.isList(list);
//=> true 

Params

  • val {Object}: The value to test.
  • returns {Boolean}

Example

var templates = require('templates');
var Group = templates.Group;
var app = templates();
 
var group = new Group();
templates.isGroup(group);
//=> true 

Params

  • val {Object}: The value to test.
  • returns {Boolean}

Example

var templates = require('templates');
var app = templates();
 
templates.isView('foo');
//=> false 
 
var view = app.view('foo', {content: '...'});
templates.isView(view);
//=> true 

Params

  • val {Object}: The value to test.
  • returns {Boolean}

Example

var templates = require('templates');
var app = templates();
 
templates.isItem('foo');
//=> false 
 
var view = app.view('foo', {content: '...'});
templates.isItem(view);
//=> true 

Params

  • val {Object}: The value to test.
  • returns {Boolean}

Example

var File = require('vinyl');
var templates = require('templates');
var app = templates();
 
var view = app.view('foo', {content: '...'});
templates.isVinyl(view);
//=> true 
 
var file = new File({path: 'foo', contents: new Buffer('...')});
templates.isVinyl(file);
//=> true 

v0.11.0

  • Default engine can now be defined on app or a collection using using app.option('engine'), views.option('engine')
  • Default layout can now defined using app.option('layout'), views.option('layout'). No changes have been made to view.layout, it should work as before. Resolves issue/#818
  • Improves logic for finding a layout, this should make layouts easier to define and find going forward.
  • The built-in view helper has been refactored completely. The helper is now async and renders the view before returning its content.
  • Adds isApp, isViews, isCollection, isList, isView, isGroup, and isItem static methods. All return true when the given value is an instance of the respective class.
  • Adds deleteItem method to List and Collection, and deleteView method to Views.
  • Last, the static _.proto property which is only exposed for unit tests was renamed to _.plugin.

v0.10.7

  • Force-update base to v0.6.4 to take advantage of isRegistered feature.

v0.10.6

  • Re-introduces fs logic to getView, now that the method has been refactored to be faster.

v0.10.0

  • getView method no longer automatically reads views from the file system. This was undocumented before and, but it's a breaking change nonetheless. The removed functionality can easily be done in a plugin.

v0.9.5

  • Fixes error messages when no engine is found for a view, and the view does not have a file extension.

v0.9.4

  • Fixes a lookup bug in render and compile that was returning the first view that matched the given name from any collection. So if a partial and a page shared the same name, if the partial was matched first it was returned. Now the renderable view is rendered (e.g. page)

v0.9.0

  • breaking change: changes parameters on app.context method. It now only accepts two arguments, view and locals, since ctx (the parameter that was removed) was technically being merged in twice.

0.8.0

  • Exposes isType method on view. Shouldn't be any breaking changes.

v0.7.0

  • breaking change: renamed .error method to .formatError
  • adds mergeContext option
  • collection name is now emitted with view and item as the second argument
  • adds isType method for checking the viewType on a collection
  • also now emits an event with the collection name when a view is created

v0.5.1

  • fixes bug where default layout was automatically applied to partials, causing an infinite loop in rare cases.

You might also be interested in these projects:

  • assemble: Assemble is a powerful, extendable and easy to use static site generator for node.js. Used… more | homepage
  • en-route: Routing for static site generators, build systems and task runners, heavily based on express.js routes… more | homepage
  • engine: Template engine based on Lo-Dash template, but adds features like the ability to register helpers… more | homepage
  • layouts: Wraps templates with layouts. Layouts can use other layouts and be nested to any depth.… more | homepage
  • verb: Documentation generator for GitHub projects. Verb is extremely powerful, easy to use, and is used… more | homepage

Install dev dependencies:

$ npm i -d && npm test

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Jon Schlinkert

Copyright © 2016 Jon Schlinkert Released under the MIT license.


This file was generated by verb on January 30, 2016.