Custom JavaScript up.macro(selector, options, macro) function

Registers a compiler that is run before all other compilers.

You can use up.macro() to register a compiler that sets other UJS attributes.

Example

You will sometimes find yourself setting the same combination of UJS attributes again and again:

<a href="/page1" up-target=".content" up-transition="cross-fade" up-duration="300">Page 1</a>
<a href="/page2" up-target=".content" up-transition="cross-fade" up-duration="300">Page 2</a>
<a href="/page3" up-target=".content" up-transition="cross-fade" up-duration="300">Page 3</a>

We would much rather define a new content-link attribute that let's us write the same links like this:

<a href="/page1" content-link>Page 1</a>
<a href="/page2" content-link>Page 2</a>
<a href="/page3" content-link>Page 3</a>

We can define the content-link attribute by registering a macro that sets the up-target, up-transition and up-duration attributes for us:

up.macro('[content-link]', function($link) {
  $link.attr('up-target', '.content');
  $link.attr('up-transition', 'cross-fade');
  $link.attr('up-duration', '300');
});

Examples for built-in macros are a[up-dash] and [up-expand].