Feature request: Expose Nunjucks' addGlobal

[robdodson]

I was curious if addGlobal might be something eleventy could expose.

In my instance I wanted to call a function that takes two arguments. It doesn't feel like I could do this correctly with a filter. I could use a shortcode to do this, but then I can't pipe the results into a filter.

Essentially I'm trying to do:

{{ findItemInCollection(collection, slug) | dump }}

[Ryuno-Ki]

Would a syntax like {{ collection | findItem(slug) | dump }} work for you?

(I believe I implemented something related to that but haven't packaged it up, yet)

[robdodson]

I think that might work but it's sort of arcane syntax. Kind of related to this comment from the nunjucks maintainer that filters are somewhat awkward syntax on top of function calls.

[edwardhorsford]

@robdodson Elventy might not directly support it, but you can add them manually (I discovered this week) by using your own Nunjucks environment. I'm already doing similar to be able to set some specific Nunjucks options.

Inside your eleventy.js:

  let nunjucksEnvironment = new Nunjucks.Environment(
    new Nunjucks.FileSystemLoader(["src/site/_templates"]), // we need to pass in our includes dir here
    { 
      lstripBlocks: true,
      trimBlocks: true,
      autoescape: false
     });

  nunjucksEnvironment.addGlobal(name, nunjucksGlobals[name]);

  eleventyConfig.setLibrary("njk", nunjucksEnvironment);

FWIW I've made a similar filter. I'm pleased to see the syntax matches @Ryuno-Ki's suggested. I also accept an optional arg to do exact matching or not.

I've also just found out that filters (at least for Nunjucks) have access to the context. So I'm tempted to rework my filter to not require collections at all - just take a slug and return the item / array of items / false.

[zachleat]

This repository is now using lodash style issue management for enhancements. This means enhancement issues will now be closed instead of leaving them open.

View the enhancement backlog here. Don’t forget to upvote the top comment with 👍!