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 tosetup()
the references to all instances would have been added to the container, creating issues. I would recommend using the return value fromsetup()
or the newget()
method to access the instance. - Players will always be wrapped in their own div now - this makes
setup()
anddestroy()
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 elementgetMedia()
to get the players media element (<video>
,<audio>
or empty<div>
for YouTube and Vimeo)getEmbed()
to access the YouTube or Vimeo API directlygetType()
to get the type of the playerisReady()
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 eventsstop()
to, you guessed it, stop the player
destroy()
now works correctly for YouTube and Vimeo (fixes #272)- New
destroyed
event whendestroy()
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)