https://github.com/dburles/meteor-spacebars-tohtml

Meteor package to ease rendering spacebars to html
https://github.com/dburles/meteor-spacebars-tohtml

meteor meteor-package meteor-spacebars

Last synced: 5 days ago
JSON representation

Meteor package to ease rendering spacebars to html

• Host: GitHub
• URL: https://github.com/dburles/meteor-spacebars-tohtml
• Owner: dburles
• License: mit
• Created: 2014-09-01T02:20:25.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2015-10-21T01:01:23.000Z (about 9 years ago)
• Last Synced: 2023-05-09T13:36:50.273Z (over 1 year ago)
• Topics: meteor, meteor-package, meteor-spacebars
• Language: JavaScript
• Homepage: https://atmospherejs.com/dburles/spacebars-tohtml
• Size: 204 KB
• Stars: 36
• Watchers: 4
• Forks: 7
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
Meteor Spacebars.toHTML

=======================

A simple helper function to assist with rendering spacebars to HTML. Works on both the server and the client.

## Installation

```sh

$ meteor add dburles:spacebars-tohtml

```

# API

Super basic example

```js

Spacebars.toHTML({ name: 'foo' }, '
Hello {{name}}
');

```


Any helpers defined with `Template.registerHelper` will be rendered just like usual. If you're on the server you'll need to make sure they're not just defined on the client so it can see them.

## Rendering templates on the server

We can render templates on the server by creating files within the `private` directory.

For example, we could create `private/example.html` and its contents might look like:

```html

  Example

  
Example

  

  
Hello {{name}} this is just an example!


```

We can then render it using Meteor's [Assets API](http://docs.meteor.com/#assets)

```js

var html = Spacebars.toHTML({ name: 'foo' }, Assets.getText('example.html'));

```

This is very useful for sending HTML emails.

## Iron Router

We can also serve templates using [Iron Router's](https://atmospherejs.com/package/iron-router) server side routes.

Here's a simple example:

```js

Router.route('/test', function() {

  // This could also come from a Collection

  var data = { name: 'foo' };

  

  this.response.writeHead(200, { 'Content-Type': 'text/html' });

  this.response.end(Spacebars.toHTML(data, Assets.getText('example.html')));

}, { where: 'server' });

```

## Template inclusion

*Server side only*

Currently there's no way to pull in templates using the `{{> inclusion}}` operator, though we can create our own helper to do much the same thing.

```js

Template.registerHelper('include', function(template, data) {

  data = data || {};

  return Spacebars.toHTML(data, Assets.getText(template));

});

```

and within our template, for example:

```html

  {{{include 'navigation.html'}}}

...

```

We can also pass in an optional data context:

```html

  {{{include 'navigation.html' navItems}}}

...

```

Note that we use the triple-stash here so the HTML is not escaped.

# License

MIT