raf-plus

raf-plus is window.requestAnimationFrame with queue management, which will only invokes the passed function at most once per animation frame.

可观看中文文档

Reason

Also note that multiple calls to requestAnimationFrame with the same callback (before callbacks are invoked and the list is cleared) will result in multiple entries being in the list with that same callback, and thus will result in that callback being invoked more than once for the animation frame. -- w3c

For example:

const animation = () => {
    // A animation function
}

document.addEventListener('scroll', e => requestAnimationFrame(animation), false)

The scroll event may fire more than once within one frame, so the animation function may be called more than once before next repaint, but repetitively call animation at one animation frame is unnecessary and waste of resources!!!

The raf-plus help you manage requestAnimationFrame's queue by ignoring the duplicate callback function in same animation frame. For comparison:

import { requestAnimationFrame } from 'raf-plus'
const animationTwice = () => console.log('I will be invoked twice!')
const animationOnce = () => console.log('Although call twice, I will be invoked once')

// call same animation within one animation frame lead to animation twice
window.requestAnimationFrame(animationTwice)
window.requestAnimationFrame(animationTwice)

// call same animation within one animation frame but only invoke once
requestAnimationFrame(animationOnce)
requestAnimationFrame(animationOnce)

Install

$ npm install --save raf-plus

$ yarn add raf-plus

Usage

The raf-plus provides two methods requestAnimationFrame and cancelAnimationFrame. They keep the same API as window.requestAnimationFrame and window.cancelAnimationFrame. Therefore, It is costless to switch from native's to raf-plus's.

`requestAnimationFrame(callback)`

The same as requestAnimationFrame. Be aware that raf-plus uses === operator to compare two callbacks, so passing anonymous function won't invoke the management!

const { requestAnimationFrame } from 'raf-plus'

const animation = timeStamp => {
    // animation
}

// animation will be invoked once within one frame
requestAnimationFrame(animation)
requestAnimationFrame(animation)

// animation will be invoked twice cause the function are not equal
requestAnimationFrame(timeStamp => { /* animation */})
requestAnimationFrame(timeStamp => { /* animation */})

`cancelAnimationFrame(requestID)`

The same as cancelAnimationFrame.

const { requestAnimationFrame, cancelAnimationFrame } from 'raf-plus'

const animation = timeStamp => {
    // animation
}
const requestId = requestAnimationFrame(animation)
cancelAnimationFrame(requestId)

Contributing

⇄ Pull requests and ★ Stars are always welcome.
For bugs and feature requests, please create an issue.

Licence

MIT

weiying-shenzhen/raf-plus