Jsin NPM | npm.io

JSIN - Javascript Include

Template engine for use at server and client side.

Features

Well-known PHP-like template tags.
Accurate quote parsing.
Asynchronous compiling of templates on the fly.
Pre-compiling for use in browser.
Supports includings and layoutings.

Usage

Syntax

Constructions:

<?js /* any javascript code */ ?>
<?= /* print value or result of expression */ ?>
<?h= /* print value or result of expression with escaped html special chars <>&" */ ?>
<?s= /* print value or result of expression with backslashed script special chars \\n\r"' */ ?>

Functions:

print(string)
printh(string, [apos]) - if set apos to true, then apostrophe ' will be escaped instead of quotes ".
prints(string)
include(template, [data])
layout(template, [data], callback)
contents()

Example

<!-- mytemplate.jsin -->
<h1>Example</h1>
<p>
    <?= "Check ?>'\" special chars and variable " + boo ?>
<p>
    <?h= "Check html escaping &<>\"" ?>
<p>
    <?s= "Check script escaping \\\n\r\"\'" ?>
</p>
<p>
    <?js if (1 === 1) { ?>
        1 === 1
    <?js } else { ?>
        1 !== 1
    <?js } ?>
</p>
<?js

include('include');

print("<p>Example print</p>\n");

?>
<?js layout('layout', function(){ ?>
        <div>
            <p>Example layout inside</p>
            <?js include('layout-include-inside') ?>
        </div>
<?js }) ?>

<p>Thanx!</p>

<!-- layout.jsin -->
<div>
    <p>Example layout begin with variable <?= boo ?></p>
    <div>
        <?js contents() ?>
    </div>
    <?js include('layout-include') ?>
    <p>Example layout end</p>
</div>

Server side

var jsin = require('jsin');

jsin.setDirectory('path/to/templates');

// you can omit extension .jsin
jsin.include('mytemplate', {
    boo: 'booooooo'
}, function(err, res) {
    if (err) {
        console.log('Error: ' + err);
    } else {
        console.log(res);
    }
});

Client side

Compile client-side script using jsinc command-line tool:

$ jsinc path/to/*.jsin jsin.compiled.js

$ jsinc -d path/to/jsin/dir jsin.compiled.js

Options:

-d - compile all files in directory and subdirectories, excluding this directory from template names.
-t - compile templates only, exclude definition of jsin object.
-b - beautify.
-u - uglify.

In browser:

<script src="jsin.compiled.js"></script>
<script>
    var res = jsin.include('mytemplate', {
        boo: 'booooo'
    });
    document.getElementById('res').innerHTML = res;
</script>

License

This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.