simpleHelper

  • typedef

{function(arg..., options)}

 

A helper function passed to registerSimpleHelper.

function(arg..., options)

Parameters

  1. arg {*}Optional Variable

    Arguments passed from the tag. After the helper name, any space seperated keys, numbers or strings are passed as arguments.

    The following template:

    <p>{{madLib "Lebron James" verb 4}}</p>
    

    Rendered with

    {verb: "swept"}
    

    Will call a madLib helper with the following arguements.

    can.stache.registerSimpleHelper('madLib',
      function(subject, verb, number){
        // subject -> "Lebron James"
        // verb -> "swept"
        // number -> 4
    });
    

    Unlike can.stache.helper simple helpers will always pass the actual value (instead of a compute).

  2. options {helperOptions}

    An options object that gets populated with optional:

    • fn and inverse section rendering functions
    • a hash object of the maps passed to the helper

Returns

{String | function(HTMLElement)}

The content to be inserted into the template.

This

{can.stache.context}

The context the helper was called within.

can.stache.simpleHelper

Returning an element callback function

If a helper returns a function, that function is called back after the template has been rendered into DOM elements. This can be used to create mustache tags that have rich behavior.

If the helper is called within a tag like:

<ul {{sortable}}/>

The returned function is called with the <ul> element:

can.stache.registerSimpleHelper("sortable",function(){
  return function(el){
    $(el).slider();
  }
});

If the helper is called between tags like:

<ul>{{items}}</ul>

The returned function is called with a temporary element. The following helper would be called with a temporary <li> element:

can.stache.registerSimpleHelper("items",function(){
  return function(li){

  }
});

The temporary element depends on the parent element. The default temporary element is a <span> element.