Skip to content

Simple generic scheduler that wraps the Ember runloop and requestAnimationFrame

License

Notifications You must be signed in to change notification settings

html-next/ember-raf-scheduler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Build Status

ember-raf-scheduler

Super simple RAF scheduler that integrates with the Ember runloop

Compatibility

  • Ember.js v3.12 or above (possibly older, but older than 3.12 is untested)
  • Ember CLI v4.4 or above
  • Node.js v16 or above

Basics

Super simple example:

import { scheduler } from 'ember-raf-scheduler';

// schedule a job
const job = scheduler.schedule('measure', () => {
  console.log('Hello, world!');
});

// cancel the job
scheduler.forget(job);

There are 4 queues:

  • sync - Wrapped in a runloop, use this queue for all Ember related work
  • layout - This queue can be used for touch up on the Ember work in general (small DOM manipulations, for instance)
  • measure - General measurements should occur here
  • affect - Fixup DOM manipulation after measurements have been done

Tokens

Tokens can be created and passed into the scheduler. All jobs that were scheduled with a token can be cancelled by cancelling the parent token.

import { scheduler, Token } from 'ember-raf-scheduler';

export default Component.extend({
  init() {
    this.token = new Token();
  },

  willDestroy() {
    scheduler.forget(this.token);
  },

  schedule(queue, job) {
    scheduler.schedule(queue, job, this.token);
  }
});

Perf Notes

Measurements in RAFs are basically free if you do them before any other DOM manipulation (same rules as standard forced layouts, etc), so you should batch all measurements in measure and if possible avoid using the sync and layout queues. There are times when it's necessary to do Ember specific manipulations (for instance, you need to use set and you want the template to render before you measure) which is what the sync and layout queues are for.

Installation

  • git clone <repository-url> this repository
  • cd ember-raf-scheduler
  • yarn install

Running

Running Tests

  • yarn test (Runs ember try:each to test your addon against multiple Ember versions)
  • ember test
  • ember test --server

Building

  • ember build

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

About

Simple generic scheduler that wraps the Ember runloop and requestAnimationFrame

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages