sampotts/plyr v2.0.0

on GitHub

This version contains several potential _breaking changes_:

• setup() has been reverted to pre v1.8.0 behaviour; meaning it will return the instance rather than the element. This is because the reference to the instance is no longer added to the original element (see below).
• The reference to the plyr instance is now added to the media element rather than original container. This is because if a container with multiple children was passed to setup() the references to all instances would have been added to the container, creating issues. I would recommend using the return value from setup() or the new get() method to access the instance.
• Players will always be wrapped in their own div now - this makes setup() and destroy() cleaner. This may break any custom styling based on DOM position.
• Players no longer seek to 0 on 'ended' - this is to fix a bug with Microsoft Edge as it triggers 'ended' on media change for whatever reason. They'll never change ;-)

And some other changes and bug fixes:

• New get() method on the global plyr object to get all instances inside a container
• New API methods:
  • getOriginal() to get the original, unmodified element plyr was setup on (<video>, <audio> or empty <div> for YouTube and Vimeo)
  • getContainer() to get the players outer wrapper element
  • getMedia() to get the players media element (<video>, <audio> or empty <div> for YouTube and Vimeo)
  • getEmbed() to access the YouTube or Vimeo API directly
  • getType() to get the type of the player
  • isReady() to determine if an instance has completed setup and necessary APIs are loaded (for YouTube / Vimeo)
  • on() to provide an easy way to listen to events
  • stop() to, you guessed it, stop the player
• destroy() now works correctly for YouTube and Vimeo (fixes #272)
• New destroyed event when destroy() has completed (original element is passed as event.target)
• Default volume is now 10 (max) rather than 5
• Sprite is only loaded once (fixes #259)
• Fixes for Vimeo post message bugs on source change or destroy (fixes #318)
• Save caption state in storage (fixes #311)
• Added keyboard shortcuts to the current focused player (with keyboardShortcuts boolean option to disable) (fixes #309)
• Fix for captions bug (fixes #332)
• Change to AMD (fixes #298)