nunjucks-embed

A Twig-like embed custom tag for Nunjucks.

Usage

yarn add nunjucks-embed

let EmbedTag = require('nunjucks-embed');
env.addExtension('EmbedTag', new EmbedTag({ /* options */ }));

my-template.njk

{% embed 'note.njk' %}
    {% block content %}
    Hello world!
    {% endblock %}
{% endembed %}

note.njk

<div class='note'>
    {% block content %}
    <!-- content here -->
    {% endblock %}
</div>

Results in:

<div class='note'>
    Hello world!
</div>

Context

By default, the embedded template will have access to the current context. To explicitly pass or ingore it, use with context and without context:

{% embed with context 'note.njk' %}
    ...
{% endembed %}

Options

• sync: boolean, default true — whether to register it as a synchronous or asynchronous custom tag