Merge branch 'master' of github.com:processing/p5.js

Author: Lauren McCarthy

lib/addons/p5.dom.js

@@ -2008,6 +2008,53 @@
    *
    * @method loop
    * @return {Object|p5.Element}
+   * @example
+   * <div><code>
+   * //Clicking the canvas will loop
+   * //the audio sample until the user
+   * //clicks again to stop it
+   *
+   * //We will store the p5.MediaElement
+   * //object in here
+   * var ele;
+   *
+   * //while our audio is playing,
+   * //this will be set to true
+   * var sampleIsLooping = false;
+   *
+   * function setup() {
+   *   //Here we create a p5.MediaElement object
+   *   //using the createAudio() function.
+   *   ele = createAudio('assets/lucky_dragons_-_power_melody.mp3');
+   *   background(200);
+   *   textAlign(CENTER);
+   *   text("Click to loop!", width/2, height/2);
+   * }
+   *
+   * function mouseClicked() {
+   *   //here we test if the mouse is over the
+   *   //canvas element when it's clicked
+   *   if(mouseX >= 0 && mouseX <= width &&
+   *     mouseY >= 0 && mouseY <= height) {
+   *     background(200);
+   *
+   *     if(sampleIsLooping == false) {
+   *       //loop our sound element until we
+   *       //call ele.stop() on it.
+   *       ele.loop();
+   *
+   *       sampleIsLooping = true;
+   *       text("Click to stop!", width/2, height/2);
+   *     } else {
+   *       ele.stop();
+   *
+   *       sampleIsLooping = false;
+   *       text("Click to loop!", width/2, height/2);
+   *     }
+   *   }
+   * }
+   *
+   * </code></div>
    */
   p5.MediaElement.prototype.loop = function() {
     this.elt.setAttribute('loop', true);