3.11
API Tutorial Demo Install Changes Support GitHub Menu
Menu
Edit this page

up.script up.$macro(selector, options, macro)
JavaScript function

This feature has been deprecated. Use up.macro() with a callback that wraps the given native element in a jQuery collection.

Load unpoly-migrate.js to polyfill deprecated features.

Registers a compiler that is run before all other compilers. The compiler function is called with each matching element as a jQuery object.

If you're not using jQuery, use up.macro() instead, which calls the macro function with a native element.

Example

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

Parameters

selector
required

The selector to match.

string
options
required

See options argument for up.compiler().

Object
macro
required

The function to call when an element matching selector is inserted.

The function may accept up to three arguments:

  1. The new element being compiled.
  2. Any attached data.
  3. Information about the current render pass.

The function may return a destructor function that cleans the compiled object before it is removed from the DOM. The destructor function is called with the compiled element.

Function($element, data)
Made by Henning Koch
Imprint
Privacy policy