← Attention

Buzz

The element vibrates rapidly in short bursts, buzz-buzz, like a phone ringing on silent.

MMumcalling…

How to use it

  1. Paste the snippet just before </head>.
  2. Add data-buzz to any element. It buzzes once when it scrolls into view.
  3. Add data-loop to keep buzzing, like an incoming call.

Options

Add any of these attributes to the same element.

data-distanceHow far it shakes, in px. Default 3.
data-angleHow far it twists, in degrees. Default 2.
data-burstsHow many buzzes. Default 2.
data-durationHow long each buzz lasts. Default 420 ms.
data-gapPause between buzzes. Default 180 ms.
data-delayWait before the first buzz. Default 0 ms.
data-loopBuzz again every so often while it’s on screen.
data-everyRest between rounds, when looping. Default 1000 ms.
data-hoverAlso play it when the pointer moves over the element or it’s tapped.

Call animacious.buzz(el) to buzz it from your own code, for example when a notification arrives.

1 · Snippet
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/bundles/anime.umd.min.js"></script>
<script>
  (function () {
    // Buzz: the element vibrates rapidly in short bursts, buzz-buzz, like a
    // phone ringing on silent.
    // Usage: <div data-buzz>…</div>
    // Optional: data-distance (px it shakes, default 3), data-angle (degrees it
    // twists, default 2), data-bursts (how many buzzes, default 2),
    // data-duration (ms of each buzz, default 420), data-gap (ms between buzzes,
    // default 180), data-delay (ms before the first buzz), data-loop (buzz again
    // every so often while in view), data-every (ms of rest between loops,
    // default 1000), data-hover (also buzz on hover or tap).
    // Script use: animacious.buzz(el) buzzes it from code.
    var DEFAULTS = { distance: 3, angle: 2, bursts: 2, duration: 420, gap: 180, delay: 0, every: 1000 };

    function on(v) { return v !== undefined && v !== 'false'; }
    function reduced() { return window.matchMedia('(prefers-reduced-motion: reduce)').matches; }

    function play(el, done) {
      var s = el._bzz;
      if (s.busy) { if (done) s.after = done; return; }
      if (reduced()) { if (done) done(); return; }
      s.busy = true;
      var d = el.dataset;
      function finish() {
        s.busy = false;
        var after = s.after;
        s.after = null;
        if (done) done();
        if (after) after();
      }
      var x = d.distance === undefined ? DEFAULTS.distance : +d.distance;
      var a = d.angle === undefined ? DEFAULTS.angle : +d.angle;
      var bursts = Math.max(1, Math.round(+d.bursts || DEFAULTS.bursts));
      var burst = +d.duration || DEFAULTS.duration;
      var gap = d.gap === undefined ? DEFAULTS.gap : +d.gap;
      var total = bursts * burst + (bursts - 1) * gap;
      var p = { t: 0 };
      anime.animate(p, {
        t: total,
        duration: total,
        ease: 'linear',
        onUpdate: function () {
          var t = p.t % (burst + gap);
          var x0 = 0, a0 = 0;
          if (t < burst) {
            // Fast shake, eased in and out at the ends of each buzz.
            var env = Math.sin((t / burst) * Math.PI);
            env = Math.min(1, env * 2.5);
            x0 = x * env * Math.sin(t * Math.PI / 20);
            a0 = a * env * Math.sin(t * Math.PI / 20 + 1.3);
          }
          el.style.transform = 'translateX(' + x0.toFixed(2) + 'px) rotate(' + a0.toFixed(2) + 'deg)';
        },
        onComplete: function () {
          el.style.transform = '';
          finish();
        }
      });
    }

    function cycle(el) {
      var s = el._bzz;
      play(el, function () {
        if (!on(el.dataset.loop)) return;
        clearTimeout(s.timer);
        s.timer = setTimeout(function () {
          if (s.visible) cycle(el);
          else s.waiting = true;
        }, +el.dataset.every || DEFAULTS.every);
      });
    }

    function init() {
      var io = new IntersectionObserver(function (entries) {
        entries.forEach(function (e) {
          var s = e.target._bzz;
          s.visible = e.isIntersecting;
          if (!e.isIntersecting) return;
          if (!s.started) {
            s.started = true;
            setTimeout(function () { cycle(e.target); }, +e.target.dataset.delay || DEFAULTS.delay);
          } else if (s.waiting) {
            s.waiting = false;
            cycle(e.target);
          }
        });
      }, { threshold: 0.2 });
      document.querySelectorAll('[data-buzz]').forEach(function (el) {
        if (el._bzz) return;
        el._bzz = {};
        if (on(el.dataset.hover)) {
          el.addEventListener('pointerenter', function () { play(el); });
          el.addEventListener('pointerdown', function () { play(el); });
        }
        if (!reduced()) io.observe(el);
      });
    }

    window.animacious = window.animacious || {};
    window.animacious.buzz = function (el) { if (el._bzz) play(el); };
    if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', init);
    else init();
  })();
</script>
2 · Your HTML
<div class="phone" data-buzz>…</div>

<!-- or three short buzzes, repeating: -->
<div class="phone" data-buzz data-bursts="3" data-duration="250" data-loop>…</div>