Skip to content

Latest commit

 

History

History
83 lines (58 loc) · 2.66 KB

README.md

File metadata and controls

83 lines (58 loc) · 2.66 KB
Raw

ember-jquery-legacy

Provides a helper function as specified in RFC294, that receives either a jQuery.Event API instance (when Ember is running with its jQuery integration enabled) or a native event (no jQuery), and will return a native event without triggering any deprecations.

Installation

ember install ember-jquery-legacy

Usage

As part of the effort to decouple Ember from jQuery, using event object APIs that are specific to jQuery.Event such as originalEvent are deprecated. Especially addons are urged to not use any jQuery specific APIs, so they are able to work in a world without jQuery.

Unfortunatly not all native event properties are available directly on an jQuery.Event instance. See the jQuery.Event API for details.

For those other properties it was necessary to get access to the native event object through originalEvent. To prevent your code from being coupled to jQuery in this way, use the normalizeEvent function provided by this addon, which will work with our without jQuery to provide the native event without triggering any deprecations.

Before:

// your event handler:
click(event) {
  let nativeEvent = event.originalEvent;
  ...
}

After:

import { normalizeEvent } from 'ember-jquery-legacy';

// your event handler:
click(event) {
  let nativeEvent = normalizeEvent(event);
  ...
}

Contributing

Installation

  • git clone <repository-url>
  • cd ember-jquery-legacy
  • yarn install

Linting

  • yarn lint:js
  • yarn lint:js --fix

Running tests

  • ember test – Runs the test suite on the current Ember version
  • ember test --server – Runs the test suite in "watch mode"
  • ember try:each – Runs the test suite against multiple Ember versions

Running the dummy application

For more information on using ember-cli, visit https://ember-cli.com/.

License

This project is licensed under the MIT License.