This release makes it easier to migrate to a recent version of Unpoly when your app still depends on jQuery.
Unpoly dropped its jQuery dependency with version 0.60.0, but retains optional jQuery support through functions like
up.$compiler()
and up.$on()
. All Unpoly functions that take a native element as an
argument may also be called with a jQuery collection as an argument.
The following changes to the optional jQuery support were implemented:
window.jQuery
to be defined before
Unpoly is imported into the build. You still need to define window.jQuery
, but you may do so at any time in your
scripts, regardless of load order.up.$compiler()
now fail with a helpful message if the developer
forgets to define window.jQuery
.This release also exposes some convenience functions and selectors:
up.event.halt()
. It prevents the event from bubbling up the DOM.
It also prevents other event handlers bound on the same element. It also prevents the event's default action.up.form.fields()
. It returns a list of form fields within the given element.form[up-validate]
is now supported. It performs
server-side validation when any fieldset within this form changes. Previously only the variant
input[up-validate]
was supported.
If you're upgrading from an older Unpoly version you should load unpoly-migrate.js
to polyfill deprecated APIs.
Changes handled by unpoly-migrate.js
are not considered breaking changes.
See our upgrading guide for details.