Skip to content

Vue directive to detect resize events with deboucing and throttling capacity.

License

Notifications You must be signed in to change notification settings

ELFoglalt/Vue.resize

 
 

Repository files navigation

Vue.resize

GitHub open issues GitHub closed issues Npm download Npm version vue2 MIT License

Vue directive to detect HTML resize events based on CSS Element Queries with debouncing and throttling capacity.

Demo

demo gif

Typical usage

Simple

Use this option when you need to receive all the resize events.

The onResize function will be called each time the element resizes with the corresponding HTML element as only argument.

<div v-resize="onResize">

Throttle

Use throttle when you need to rate-limit resize events frequency.

  • With default timeout (150 ms):
<div v-resize:throttle="onResize">
  • With custom timeout (in ms):
<div v-resize:throttle.100="onResize">

Debounce

Use debounce when you only need to be notified when resize events ends.

  • With default timeout (150 ms):
<div v-resize:debounce="onResize">
  • With custom timeout (in ms):
<div v-resize:debounce.50="onResize">

Initial

Use this option to receive the resize callback right after the element is mounted on the DOM and visible.

<div v-resize.initial="onResize">

Installation

  • Available through npm:
 npm install vue-resize-directive --save
  • For Modules
// ES6
import resize from 'vue-resize-directive'
//...
export default {
    directives: {
        resize,
    }
//...

// ES5
var resize = require('vue-resize-directive')
  • For <script> Include

    Just include Vueresize.js after ResizeSensor.js from css-element-queries and lodash.js script.

Polyfills

⚠️ Should you require compatibility with older browsers (most notably, IE), make sure to include the following (or equivalent) polyfills: Array.prototype.find polyfill andIntersectionObserver polyfill.

This package used to include it's own polyfills for Array.prototype.find and IntersectionObserver. As per the recommendations of the Vue Cli developers guide, polyfills are no longer shipped as part of this repository.

Read more about this subject here.

About

Vue directive to detect resize events with deboucing and throttling capacity.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 73.4%
  • Vue 25.6%
  • HTML 1.0%