shuffle() V4

Mutates an array by randomizing the order of its elements.

const shuffledArray = utils.shuffle(array);

Parameters

Name Accepts
array Array

Returns

The mutated Array

shuffle() code example

import { utils, animate, stagger } from 'animejs';

const [ $shuffle ] = utils.$('button');
const squares = utils.$('.square');
const x = stagger('3.2rem');

// Initial squares x position
utils.set(squares, { x });

const shuffle = () => animate(utils.shuffle(squares), { x });

$shuffle.addEventListener('click', shuffle);
<div class="large row">
  <div class="square">A</div>
  <div class="square">B</div>
  <div class="square">C</div>
  <div class="square">D</div>
  <div class="square">E</div>
  <div class="square">F</div>
</div>
<div class="medium row">
  <fieldset class="controls">
    <button>Shuffle</button>
  </fieldset>
</div>
#utilities-shuffle .square {
  display: flex;
  justify-content: center;
  align-items: center;
  position: absolute;
  left: 0;
  top: 0;
  background-color: rgba(var(--rgb-current-1), .25);
}

#utilities-shuffle .docs-demo-template .square {
  opacity: 0;
}