Edit this page

up.script up.$compiler(selector, [options], compiler)
JavaScript function

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

Load unpoly-migrate.js to polyfill deprecated features.

Registers a function to be called when an element with the given selector is inserted into the DOM. The function is called with each matching element as a jQuery object.

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

Example

This jQuery compiler will insert the current time into a <div class='current-time'></div>:

up.$compiler('.current-time', function($element) {
  var now = new Date()
  $element.text(now.toString())
})

Parameters

selector
required

The selector to match.

string
[options]
compiler
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)