undocumented features - @helpers and @macro

[dctikan]

Hi,

I was going through the code and documentation and I noticed that the code has references to '@helpers' and '@macro' which are not documented in the official documentation.

Does anyone know what are they and how to use them?

[dctikan]

I was able to locate more details about "helpers" and "@helpers" from the code.

I hope it may help other folks

Helpers are functions which can be defined either globally:
Ractive.helpers.upper=(v)=>{return v.toUpperCase();}

or for a given instance:

new Ractive({
      target: fixture,
      template: `{{upper(foo) + ' ' + upper(foo)}}`,
      data: { foo: 'bar' },
      helpers: {
        upper(v) {
          return v.toUpperCase();
        }
      }
    }
)

Helpers can be used in the template as following
<h1>{{upper(title)}}</h1>
or
using '@helpers.' prefix
<h1>{{@helpers.upper(title)}}</h1>

helpers can accept multiple arguments:
<h1>{{@helpers.myhelper(title,subtitle)}}</h1>

unlike handlebars helpers, Ractive helpers do not have access to the context by default, however, it is possible to pass current context (and even Ractive instance as well as reference to other helpers if needed) to the helper function as following:
<h1>{{@helpers.myhelper(title,subtitle,this,@this,@helpers)}}</h1>

I did not find any details about @macro though :(

[evs-chris]

The @macro special reference resolves to the special macro context, similar to @this for a component, in a macro.