Releases: sampotts/plyr
Releases · sampotts/plyr
v3.4.0
- Accessibility improvements (see #905)
- Improvements to the way the controls work on iOS
- Demo code clean up
- YouTube quality selection removed due to their poor support for it. As a result, the
qualityrequestedevent has been removed - Controls spacing improvements
- Fix for pressed property missing with custom controls (Fixes #1062)
- Fix #1153: Captions language fallback (thanks @friday)
- Fix for setting pressed property of undefined (Fixes #1102)
v3.2.0
- Fullscreen fixes (thanks @friday)
- Menu fix for if speed not in config
- Menu z-index fix (thanks @danielsarin)
- i18n fix for missing "Normal" string (thanks @danielsarin)
- Safer check for active caption (thanks @Antonio-Laguna)
- Add custom property fallback (thanks @friday)
- Fixed bug for captions with no srclang and labels and improved logic (fixes #875)
- Fix for
playingfalse positive (fixes #898) - Fix for IE issue with navigator.language (thanks @nicolasthy) (fixes #893)
- Fix for Vimeo controls missing on iOS (thanks @verde-io) (fixes #807)
- Fix for double vimeo caption rendering (fixes #877)
v3.1.0
v3.0.3
- Vimeo offset tweak (fixes #826)
- Fix for .stop() method (fixes #819)
- Check for array for speed options (fixes #817)
- Restore as float (fixes #828)
- Fix for Firefox fullscreen oddness (Fixes #821)
- Improve Sprite checking (fixes #827)
- Fix fast-forward control (thanks @saadshahd)
- Fix the options link in the readme (thanks @DanielRuf)
v3.0.0
This is a massive release. A mostly complete rewrite in ES6. What started out as a few changes quickly snowballed. There's many breaking changes so be careful upgrading.
Big changes
- New settings menu complete with funky animations
- Ability to adjust speed of playback
- Ability to toggle caption language (HTML5 and Vimeo only)
- Ability to set YouTube quality (HTML5 will follow)
- Added support for Vimeo captions
- Added Picture-in-Picture support (Safari only)
- Added AirPlay support (again, Safari only)
- Added
playsinlinesupport for iOS 10+ - Soundcloud removed until I can work on a plugin framework
- Embedded players are now progressively enhanced - no more empty
<div>s!
Other stuff
- Now using SASS exclusively. Sorry, LESS folk it just made sense to maintain one method as SASS is what the cool kids use. It may come back if we work out an automated way to convert the SASS
- Moved to ES6. All the rage these days. You'll need to look at polyfills. The demo uses polyfill.io
- Added basic looping support
- Added an aspect ratio option for those that can't leave the 90s and want 4:3
controlshiddenandcontrolsshownevents added for when the controls show or hidequalityrequestedandqualitychangeevents for YouTube quality control (HTML5 will follow)- Volume is now
0to1as per HTML5 spec - No longer bodging a
<progress>behind the<input type="range">to make up for WebKit's lack of lower fill styling - Captions now render with line breaks as intended
- Captions now render without AJAX using the native events etc
- Added a fallback for getting YouTube video data incase
.getVideoData()disappears when one of their developers randomly deletes it again - Setup and building of the UI should be way "snappier"
- Click to toggle inverted time (e.g. 0:01 or -2:59 for a 3 minute video at 1 seconds) - new
toggleInvertandinvertTimeoptions - Added
autopauseoption for Vimeo - Added
mutedoption for you guessed it, muted playback - Restored the
.off()API method .play()will now return a promise to prevent that pesky uncaught promise issue in Chrome etc- Pressing and hold the seek bar no longer freezes all other updates of the UI
...plus loads of bug fixes.
Breaking changes
You gotta break eggs to make an omelette. Sadly, there's quite a few breaking changes:
- Setup now uses proper constructor, accepts a single selector/element/node and returns a single instance - much simpler than before
- Much of the API is now using getters and setters rather than methods (where it makes sense) to match the HTML5 API - see the docs for more info
- The data attributes for the embeds are now
data-plyr-provideranddata-plyr-embed-idto prevent compatibility issues. These can be changed underconfig.attributes.embedif required blankUrl->blankVideovolumeis now0to1as per HTML5 speckeyboardShorcuts(typo) is now justkeyboardloopis nowloop.activein preparation for loop enhancements laterhtmloption for custom controls removed in favour of thecontrolsoption which now accepts an array (to use built in controls) or a string of HTML for custom controls.classes->classNamesclasses.videoWrapper->classNames.videoclasses.embedWrapper->classNames.embedclasses.readyremovedclasses.setupremovedclasses.mutedremovedclasses.fullscreen.activeremoved in favour of the:fullscreenselectorselectors.html5removedselectors.embedremovedselectors.buttons.seek->selectors.inputs.seekselectors.volume.input->selectors.inputs.volumeselectors.volume.display->selectors.display.volumeselectors.currentTime->selectors.display.currentTimeselectors.duration->selectors.display.duration
Polyfilling
Because we're using the fancy new ES6 syntax, you will need to polyfill for vintage browsers if you want to use Plyr and still support them. Luckily there's a decent service for this that makes it painless, polyfill.io. Alternatively, you can use the prebuilt polyfilled build but bear in mind this is 20kb larger. I'd suggest working our your own polyfill strategy.