Fixed bug with caption toggle, hide controls in fullscreen

- Enter now works on checkboxes within the controls

changelog.md

@@ -1,14 +1,38 @@
 # Changelog
 
+## v1.0.29
+- Added option to hide controls on fullscreen (default `true`) while palying, after 1s. Pause, mouse hover on progress, or focus on a child control re-shows the controls. On touch a tap of the video (which plays/pauses the video by default) is required. (Fixes #47)
+- Fixed a bug with caption toggle in 1.0.28
+
+## v1.0.28
+- Added API support for browsers that don't have full plyr support (pretty much <=IE9 and `<video>` on iPhone/iPod)
+
+## v1.0.27
+- Keyboard accessibility improvements (Fixes #66)
+
+## v1.0.26
+- Fixes for SASS (cheers @brunowego)
+- Indentation reset to 4 spaces
+
+## v1.0.25
+- Fixes for iOS volume controls (hidden)
+- Classnames for left/right controls changed
+
+## v1.0.24
+- Added tooltip option to display labels as tooltips (Fixes #50)
+
+## v1.0.23
+- Handling loading states in the UI (Fixes #36)
+
 ## v1.0.22
 - Added support() API method for checking mimetype support
-- Added source() API method for setting media source(s)
+- Added source() API method for setting media source(s) (Fixes #44)
 - Added poster() API method for setting poster source
 - Refactored captions logic for manual captions
 
 ## v1.0.21
-- Added an <input type="range"> for seeking to improve experience (and support dragging)
+- Added an <input type="range"> for seeking to improve experience (and support dragging) (Fixes #40, #42)
-- Icons for restart and captions improved (and some IDs changed)
+- Icons for restart and captions improved (and some IDs changed) (Fixes #49)
 
 ## v1.0.20
 - Default controls included (Fixes #45)
@@ -17,7 +41,7 @@
 - License changed to MIT
 
 ## v1.0.19
-- Fixed firefox fullscreen issue (#38)
+- Fixed firefox fullscreen issue (Fixes #38)
 
 ## v1.0.18
 - Added CDN references

controls.md

@@ -31,14 +31,14 @@ This is the default `html` option from `plyr.js`.
             "<span>0</span>% buffered",
         "</progress>",
     "</div>",
-    "<span class='player-controls-playback'>",
+    "<span class='player-controls-left'>",
         "<button type='button' data-player='restart'>",
             "<svg><use xlink:href='#icon-restart'></use></svg>",
             "<span class='sr-only'>Restart</span>",
         "</button>",
         "<button type='button' data-player='rewind'>",
             "<svg><use xlink:href='#icon-rewind'></use></svg>",
-            "<span class='sr-only'>Rewind {seektime} seconds</span>",
+            "<span class='sr-only'>Rewind {seektime} secs</span>",
         "</button>",
         "<button type='button' data-player='play'>",
             "<svg><use xlink:href='#icon-play'></use></svg>",
@@ -50,14 +50,14 @@ This is the default `html` option from `plyr.js`.
         "</button>",
         "<button type='button' data-player='fast-forward'>",
             "<svg><use xlink:href='#icon-fast-forward'></use></svg>",
-            "<span class='sr-only'>Fast forward {seektime} seconds</span>",
+            "<span class='sr-only'>Forward {seektime} secs</span>",
         "</button>",
         "<span class='player-time'>",
             "<span class='sr-only'>Time</span>",
             "<span class='player-duration'>00:00</span>",
         "</span>",
     "</span>",
-    "<span class='player-controls-sound'>",
+    "<span class='player-controls-right'>",
         "<input class='inverted sr-only' id='mute{id}' type='checkbox' data-player='mute'>",
         "<label id='mute{id}' for='mute{id}'>",
             "<svg class='icon-muted'><use xlink:href='#icon-muted'></use></svg>",
@@ -75,7 +75,7 @@ This is the default `html` option from `plyr.js`.
         "<button type='button' data-player='fullscreen'>",
             "<svg class='icon-exit-fullscreen'><use xlink:href='#icon-exit-fullscreen'></use></svg>",
             "<svg><use xlink:href='#icon-enter-fullscreen'></use></svg>",
-            "<span class='sr-only'>Toggle fullscreen</span>",
+            "<span class='sr-only'>Toggle Fullscreen</span>",
         "</button>",
     "</span>",
 "</div>"].join("\n");

docs/dist/templates.js

@@ -1,2 +1,2 @@
     var templates = {};
-    templates['controls'] = new Hogan.Template({code: function (c,p,i) { var t=this;t.b(i=i||"");t.b("<div class=\"player-controls\">");t.b("\n" + i);t.b("	<div class=\"player-progress\">");t.b("\n" + i);t.b("		<label for=\"seek{id}\" class=\"sr-only\">Seek</label>");t.b("\n" + i);t.b("		<input id=\"seek{id}\" class=\"player-progress-seek\" type=\"range\" min=\"0\" max=\"100\" step=\"0.5\" value=\"0\" data-player=\"seek\">");t.b("\n" + i);t.b("		<progress class=\"player-progress-played\" max=\"100\" value=\"0\">");t.b("\n" + i);t.b("			<span>0</span>% played");t.b("\n" + i);t.b("		</progress>");t.b("\n" + i);t.b("		<progress class=\"player-progress-buffer\" max=\"100\" value=\"0\">");t.b("\n" + i);t.b("			<span>0</span>% buffered");t.b("\n" + i);t.b("		</progress>");t.b("\n" + i);t.b("	</div>");t.b("\n" + i);t.b("	<span class=\"player-controls-playback\">");t.b("\n" + i);t.b("		<button type=\"button\" data-player=\"restart\">");t.b("\n" + i);t.b("			<svg><use xlink:href=\"#icon-restart\"></use></svg>");t.b("\n" + i);t.b("			<span class=\"sr-only\">Restart</span>");t.b("\n" + i);t.b("		</button>");t.b("\n" + i);t.b("		<button type=\"button\" data-player=\"rewind\">");t.b("\n" + i);t.b("			<svg><use xlink:href=\"#icon-rewind\"></use></svg>");t.b("\n" + i);t.b("			<span class=\"sr-only\">Rewind {seektime} seconds</span>");t.b("\n" + i);t.b("		</button>");t.b("\n" + i);t.b("		<button type=\"button\" data-player=\"play\">");t.b("\n" + i);t.b("			<svg><use xlink:href=\"#icon-play\"></use></svg>");t.b("\n" + i);t.b("			<span class=\"sr-only\">Play</span>");t.b("\n" + i);t.b("		</button>");t.b("\n" + i);t.b("		<button type=\"button\" data-player=\"pause\">");t.b("\n" + i);t.b("			<svg><use xlink:href=\"#icon-pause\"></use></svg>");t.b("\n" + i);t.b("			<span class=\"sr-only\">Pause</span>");t.b("\n" + i);t.b("		</button>");t.b("\n" + i);t.b("		<button type=\"button\" data-player=\"fast-forward\">");t.b("\n" + i);t.b("			<svg><use xlink:href=\"#icon-fast-forward\"></use></svg>");t.b("\n" + i);t.b("			<span class=\"sr-only\">Fast forward {seektime} seconds</span>");t.b("\n" + i);t.b("		</button>");t.b("\n" + i);t.b("		<span class=\"player-time\">");t.b("\n" + i);t.b("			<span class=\"sr-only\">Time</span>");t.b("\n" + i);t.b("			<span class=\"player-duration\">00:00</span>");t.b("\n" + i);t.b("		</span>");t.b("\n" + i);t.b("	</span>");t.b("\n" + i);t.b("	<span class=\"player-controls-sound\">");t.b("\n" + i);t.b("		<input class=\"inverted sr-only\" id=\"mute{id}\" type=\"checkbox\" data-player=\"mute\">");t.b("\n" + i);t.b("		<label id=\"mute{id}\" for=\"mute{id}\">");t.b("\n" + i);t.b("			<svg class=\"icon-muted\"><use xlink:href=\"#icon-muted\"></use></svg>");t.b("\n" + i);t.b("			<svg><use xlink:href=\"#icon-volume\"></use></svg>");t.b("\n" + i);t.b("			<span class=\"sr-only\">Toggle Mute</span>");t.b("\n" + i);t.b("		</label>");t.b("\n");t.b("\n" + i);t.b("		<label for=\"volume{id}\" class=\"sr-only\">Volume</label>");t.b("\n" + i);t.b("		<input id=\"volume{id}\" class=\"player-volume\" type=\"range\" min=\"0\" max=\"10\" step=\"0.5\" value=\"0\" data-player=\"volume\">");t.b("\n");t.b("\n" + i);t.b("		<input class=\"sr-only\" id=\"captions{id}\" type=\"checkbox\" data-player=\"captions\">");t.b("\n" + i);t.b("		<label for=\"captions{id}\">");t.b("\n" + i);t.b("			<svg class=\"icon-captions-on\"><use xlink:href=\"#icon-captions-on\"></use></svg>");t.b("\n" + i);t.b("			<svg><use xlink:href=\"#icon-captions-off\"></use></svg>");t.b("\n" + i);t.b("			<span class=\"sr-only\">Toggle Captions</span>");t.b("\n" + i);t.b("		</label>");t.b("\n");t.b("\n" + i);t.b("		<button type=\"button\" data-player=\"fullscreen\">");t.b("\n" + i);t.b("			<svg class=\"icon-exit-fullscreen\"><use xlink:href=\"#icon-exit-fullscreen\"></use></svg>");t.b("\n" + i);t.b("			<svg><use xlink:href=\"#icon-enter-fullscreen\"></use></svg>");t.b("\n" + i);t.b("			<span class=\"sr-only\">Toggle fullscreen</span>");t.b("\n" + i);t.b("		</button>");t.b("\n" + i);t.b("	</span>");t.b("\n" + i);t.b("</div>");return t.fl(); },partials: {}, subs: {  }});
+    templates['controls'] = new Hogan.Template({code: function (c,p,i) { var t=this;t.b(i=i||"");t.b("<div class=\"player-controls\">");t.b("\n" + i);t.b("    <div class=\"player-progress\">");t.b("\n" + i);t.b("        <label for=\"seek{id}\" class=\"sr-only\">Seek</label>");t.b("\n" + i);t.b("        <input id=\"seek{id}\" class=\"player-progress-seek\" type=\"range\" min=\"0\" max=\"100\" step=\"0.5\" value=\"0\" data-player=\"seek\">");t.b("\n" + i);t.b("        <progress class=\"player-progress-played\" max=\"100\" value=\"0\">");t.b("\n" + i);t.b("            <span>0</span>% played");t.b("\n" + i);t.b("        </progress>");t.b("\n" + i);t.b("        <progress class=\"player-progress-buffer\" max=\"100\" value=\"0\">");t.b("\n" + i);t.b("            <span>0</span>% buffered");t.b("\n" + i);t.b("        </progress>");t.b("\n" + i);t.b("    </div>");t.b("\n" + i);t.b("    <span class=\"player-controls-left\">");t.b("\n" + i);t.b("        <button type=\"button\" data-player=\"restart\">");t.b("\n" + i);t.b("            <svg><use xlink:href=\"#icon-restart\"></use></svg>");t.b("\n" + i);t.b("            <span class=\"sr-only\">Restart</span>");t.b("\n" + i);t.b("        </button>");t.b("\n" + i);t.b("        <button type=\"button\" data-player=\"rewind\">");t.b("\n" + i);t.b("            <svg><use xlink:href=\"#icon-rewind\"></use></svg>");t.b("\n" + i);t.b("            <span class=\"sr-only\">Rewind {seektime} secs</span>");t.b("\n" + i);t.b("        </button>");t.b("\n" + i);t.b("        <button type=\"button\" data-player=\"play\">");t.b("\n" + i);t.b("            <svg><use xlink:href=\"#icon-play\"></use></svg>");t.b("\n" + i);t.b("            <span class=\"sr-only\">Play</span>");t.b("\n" + i);t.b("        </button>");t.b("\n" + i);t.b("        <button type=\"button\" data-player=\"pause\">");t.b("\n" + i);t.b("            <svg><use xlink:href=\"#icon-pause\"></use></svg>");t.b("\n" + i);t.b("            <span class=\"sr-only\">Pause</span>");t.b("\n" + i);t.b("        </button>");t.b("\n" + i);t.b("        <button type=\"button\" data-player=\"fast-forward\">");t.b("\n" + i);t.b("            <svg><use xlink:href=\"#icon-fast-forward\"></use></svg>");t.b("\n" + i);t.b("            <span class=\"sr-only\">Forward {seektime} secs</span>");t.b("\n" + i);t.b("        </button>");t.b("\n" + i);t.b("        <span class=\"player-time\">");t.b("\n" + i);t.b("            <span class=\"sr-only\">Time</span>");t.b("\n" + i);t.b("            <span class=\"player-duration\">00:00</span>");t.b("\n" + i);t.b("        </span>");t.b("\n" + i);t.b("    </span>");t.b("\n" + i);t.b("    <span class=\"player-controls-right\">");t.b("\n" + i);t.b("        <input class=\"inverted sr-only\" id=\"mute{id}\" type=\"checkbox\" data-player=\"mute\">");t.b("\n" + i);t.b("        <label id=\"mute{id}\" for=\"mute{id}\">");t.b("\n" + i);t.b("            <svg class=\"icon-muted\"><use xlink:href=\"#icon-muted\"></use></svg>");t.b("\n" + i);t.b("            <svg><use xlink:href=\"#icon-volume\"></use></svg>");t.b("\n" + i);t.b("            <span class=\"sr-only\">Toggle Mute</span>");t.b("\n" + i);t.b("        </label>");t.b("\n");t.b("\n" + i);t.b("        <label for=\"volume{id}\" class=\"sr-only\">Volume</label>");t.b("\n" + i);t.b("        <input id=\"volume{id}\" class=\"player-volume\" type=\"range\" min=\"0\" max=\"10\" step=\"0.5\" value=\"0\" data-player=\"volume\">");t.b("\n");t.b("\n" + i);t.b("        <input class=\"sr-only\" id=\"captions{id}\" type=\"checkbox\" data-player=\"captions\">");t.b("\n" + i);t.b("        <label for=\"captions{id}\">");t.b("\n" + i);t.b("            <svg class=\"icon-captions-on\"><use xlink:href=\"#icon-captions-on\"></use></svg>");t.b("\n" + i);t.b("            <svg><use xlink:href=\"#icon-captions-off\"></use></svg>");t.b("\n" + i);t.b("            <span class=\"sr-only\">Toggle Captions</span>");t.b("\n" + i);t.b("        </label>");t.b("\n");t.b("\n" + i);t.b("        <button type=\"button\" data-player=\"fullscreen\">");t.b("\n" + i);t.b("            <svg class=\"icon-exit-fullscreen\"><use xlink:href=\"#icon-exit-fullscreen\"></use></svg>");t.b("\n" + i);t.b("            <svg><use xlink:href=\"#icon-enter-fullscreen\"></use></svg>");t.b("\n" + i);t.b("            <span class=\"sr-only\">Toggle Fullscreen</span>");t.b("\n" + i);t.b("        </button>");t.b("\n" + i);t.b("    </span>");t.b("\n" + i);t.b("</div>");return t.fl(); },partials: {}, subs: {  }});

docs/error.html

@@ -6,7 +6,7 @@
         <meta name="viewport" content="width=device-width, initial-scale=1">
 
         <!-- Docs styles -->
-		<link rel="stylesheet" href="//cdn.plyr.io/1.0.22/docs.css">
+        <link rel="stylesheet" href="//cdn.plyr.io/1.0.29/docs.css">
     </head>
     <body>
         <main>

docs/index.html

@@ -8,10 +8,10 @@
         <meta name="viewport" content="width=device-width, initial-scale=1">
 
         <!-- Styles -->
-		<link rel="stylesheet" href="//cdn.plyr.io/1.0.22/plyr.css">
+        <link rel="stylesheet" href="//cdn.plyr.io/1.0.29/plyr.css">
 
         <!-- Docs styles -->
-		<link rel="stylesheet" href="//cdn.plyr.io/1.0.22/docs.css">
+        <link rel="stylesheet" href="//cdn.plyr.io/1.0.29/docs.css">
     </head>
     <body>
         <header>
@@ -29,7 +29,7 @@
                         <source src="//cdn.selz.com/plyr/1.0/movie.webm" type="video/webm">
                         
                         <!-- Text track file -->
-						<track kind="captions" label="English" srclang="en" src="//cdn.selz.com/plyr/1.0/movie_en_captions.vtt" default>
+                        <track kind="captions" label="English" srclang="en" src="//cdn.selz.com/plyr/1.0/en.vtt" default>
                         
                         <!-- Fallback for browsers that don't support the <video> element -->
                         <div>
@@ -67,13 +67,29 @@
         <!-- Load SVG defs -->
         <!-- You should bundle all SVG/Icons into one file using a build tool such as gulp and svg store -->
         <script>
-		(function(d,p){var a=new XMLHttpRequest(),b=d.body;a.open("GET",p,!0);a.send();a.onload=function(){var c=d.createElement("div");c.style.display="none";c.innerHTML=a.responseText;b.insertBefore(c,b.childNodes[0])}})(document,"//cdn.plyr.io/1.0.22/sprite.svg");
+        (function(d, u){
+            var a = new XMLHttpRequest(),
+                b = d.body;
+
+            // Check for CORS support
+            // If you're loading from same domain, you can remove the if statement
+            if("withCredentials" in a) {
+                a.open("GET", u, true);
+                a.send();
+                a.onload = function(){
+                    var c = d.createElement("div");
+                    c.style.display="none";
+                    c.innerHTML = a.responseText;
+                    b.insertBefore(c, b.childNodes[0]);
+                }
+            }
+        })(document, "https://cdn.plyr.io/1.0.29/sprite.svg");
         </script>
 
         <!-- Plyr core script -->
-		<script src="//cdn.plyr.io/1.0.22/plyr.js"></script>
+        <script src="//cdn.plyr.io/1.0.29/plyr.js"></script>
 
         <!-- Docs script -->
-		<script src="//cdn.plyr.io/1.0.22/docs.js"></script>
+        <script src="//cdn.plyr.io/1.0.29/docs.js"></script>
     </body>
 </html>

docs/src/templates/controls.html

@@ -9,14 +9,14 @@
             <span>0</span>% buffered
         </progress>
     </div>
-	<span class="player-controls-playback">
+    <span class="player-controls-left">
         <button type="button" data-player="restart">
             <svg><use xlink:href="#icon-restart"></use></svg>
             <span class="sr-only">Restart</span>
         </button>
         <button type="button" data-player="rewind">
             <svg><use xlink:href="#icon-rewind"></use></svg>
-			<span class="sr-only">Rewind {seektime} seconds</span>
+            <span class="sr-only">Rewind {seektime} secs</span>
         </button>
         <button type="button" data-player="play">
             <svg><use xlink:href="#icon-play"></use></svg>
@@ -28,14 +28,14 @@
         </button>
         <button type="button" data-player="fast-forward">
             <svg><use xlink:href="#icon-fast-forward"></use></svg>
-			<span class="sr-only">Fast forward {seektime} seconds</span>
+            <span class="sr-only">Forward {seektime} secs</span>
         </button>
         <span class="player-time">
             <span class="sr-only">Time</span>
             <span class="player-duration">00:00</span>
         </span>
     </span>
-	<span class="player-controls-sound">
+    <span class="player-controls-right">
         <input class="inverted sr-only" id="mute{id}" type="checkbox" data-player="mute">
         <label id="mute{id}" for="mute{id}">
             <svg class="icon-muted"><use xlink:href="#icon-muted"></use></svg>
@@ -56,7 +56,7 @@
         <button type="button" data-player="fullscreen">
             <svg class="icon-exit-fullscreen"><use xlink:href="#icon-exit-fullscreen"></use></svg>
             <svg><use xlink:href="#icon-enter-fullscreen"></use></svg>
-			<span class="sr-only">Toggle fullscreen</span>
+            <span class="sr-only">Toggle Fullscreen</span>
         </button>
     </span>
 </div>

gulpfile.js

@@ -22,7 +22,8 @@ var fs 			= require("fs"),
     s3          = require("gulp-s3"),
     gzip        = require("gulp-gzip"),
     replace     = require("gulp-replace"),
-	open 		= require("gulp-open");
+    open        = require("gulp-open"),
+    size        = require("gulp-size");
 
 var root = __dirname,
 paths = {
@@ -223,6 +224,10 @@ gulp.task("cdn", function () {
 
     // Upload to CDN 
     gulp.src(paths.upload)
+        .pipe(size({
+            showFiles: true,
+            gzip: true
+        }))
         .pipe(rename(function (path) {
             path.dirname = path.dirname.replace(".", version);
         }))
@@ -234,6 +239,11 @@ gulp.task("cdn", function () {
 gulp.task("docs", function () {
     console.log("Uploading " + version + " docs to " + aws.docs.bucket);
 
+    // Replace versioned files in readme.md
+    gulp.src([root + "/readme.md"])
+        .pipe(replace(cdnpath, aws.cdn.bucket + "/" + version))
+        .pipe(gulp.dest(root));
+
     // Replace versioned files in *.html
     gulp.src([paths.docs.root + "*.html"])
         .pipe(replace(cdnpath, aws.cdn.bucket + "/" + version))

package.json

@@ -1,6 +1,6 @@
 {
   "name": "plyr",
-  "version": "1.0.22",
+  "version": "1.0.29",
   "description": "A simple HTML5 media player using custom controls",
   "homepage": "http://plyr.io",
   "main": "gulpfile.js",
@@ -18,6 +18,7 @@
     "gulp-replace": "^0.5.3",
     "gulp-s3": "^0.3.0",
     "gulp-sass": "^1.3.3",
+    "gulp-size": "^1.2.1",
     "gulp-svgmin": "^1.0.0",
     "gulp-svgstore": "^5.0.0",
     "gulp-uglify": "~0.3.1",

readme.md

@@ -10,7 +10,7 @@ We wanted a lightweight, accessible and customisable media player that just supp
 
 ## Features
 - **Accessible** - full support for captions and screen readers.
-- **Lightweight** - just 5.3KB minified and gzipped.
+- **Lightweight** - just 6KB minified and gzipped.
 - **Customisable** - make the player look how you want with the markup you want.
 - **Semantic** - uses the *right* elements. `<input type="range">` for volume and `<progress>` for progress and well, `<button>`s for buttons. There's no `<span>` or `<a href="#">` button hacks.
 - **Responsive** - as you'd expect these days.
@@ -38,7 +38,7 @@ If you have any cool ideas or features, please let me know by [creating an issue
 
 Check `docs/index.html` and `docs/dist/docs.js` for an example setup. 
 
-**Heads up**, the example `index.html` file needs to be served from a webserver (such as Apache, Nginx, IIS or similar) unless you change the file sources to include http or https. e.g. change `//cdn.plyr.io/1.0.21/plyr.js` to `https://cdn.plyr.io/1.0.21/plyr.js`
+**Heads up**, the example `index.html` file needs to be served from a webserver (such as Apache, Nginx, IIS or similar) unless you change the file sources to include http or https. e.g. change `//cdn.plyr.io/1.0.29/plyr.js` to `https://cdn.plyr.io/1.0.29/plyr.js`
 
 ### Bower
 If bower is your thang, you can grab Plyr using:
@@ -51,11 +51,11 @@ More info on setting up dependencies can be found in the [Bower Docs](http://bow
 If you want to use our CDN, you can use the following. HTTPS (SSL) is supported.
 
 ```html
-<link rel="stylesheet" href="//cdn.plyr.io/1.0.21/plyr.css">
+<link rel="stylesheet" href="//cdn.plyr.io/1.0.29/plyr.css">
-<script src="//cdn.plyr.io/1.0.21/plyr.js"></script>
+<script src="//cdn.plyr.io/1.0.29/plyr.js"></script>
 ```
 
-You can also access the `sprite.svg` file at `//cdn.plyr.io/1.0.21/sprite.svg`.
+You can also access the `sprite.svg` file at `//cdn.plyr.io/1.0.29/sprite.svg`.
 
 ### CSS
 If you want to use the default css, add the `plyr.css` file from /dist into your head, or even better use `plyr.less` or `plyr.sass` file included in `/src` in your build to save a request. 
@@ -190,13 +190,19 @@ You can pass the following options to the setup method.
     <td><code>click</code></td>
     <td>Boolean</td>
     <td><code>true</code></td>
-    <td>Click (or tap) will toggle pause/play of a `<video>`.</td>
+    <td>Click (or tap) will toggle pause/play of a <code>&lt;video&gt;</code>.</td>
+  </tr>
+  <tr>
+    <td><code>tooltips</code></td>
+    <td>Boolean</td>
+    <td><code>false</code></td>
+    <td>Display control labels as tooltips on :hover &amp; :focus (by default, the labels are screen reader only).</td>
   </tr>
   <tr>
     <td><code>selectors</code></td>
     <td>Object</td>
     <td>&mdash;</td>
-    <td>See `plyr.js` in `/src` for more info. The only option you might want to change is `player` which is the hook used for Plyr, the default is `.player`.</td>
+    <td>See <code>plyr.js</code> in <code>/src</code> for more info. The only option you might want to change is <code>player</code> which is the hook used for Plyr, the default is <code>.player</code>.</td>
   </tr>
   <tr>
     <td><code>classes</code></td>
@@ -208,19 +214,19 @@ You can pass the following options to the setup method.
     <td><code>captions</code></td>
     <td>Object</td>
     <td>&mdash;</td>
-    <td>This currently contains one property `defaultActive` which toggles if captions should be on by default. The default value is `false`.</td>
+    <td>One property <code>defaultActive</code> which toggles if captions should be on by default. The default value is <code>false</code>.</td>
   </tr>
   <tr>
     <td><code>fullscreen</code></td>
     <td>Object</td>
     <td>&mdash;</td>
-    <td>This currently contains two properties; `enabled` which toggles if fullscreen should be enabled (if the browser supports it). The default value is `true`. Also an extra property called `fallback` which will enable a 'full window' view for older browsers. The default value is `true`.</td>
+    <td>Three properties; <code>enabled</code> which toggles if fullscreen should be enabled (if the browser supports it). The default value is <code>true</code>. A <code>fallback</code> property which will enable a full window view for older browsers. The default value is <code>true</code>. A <code>hideControls</code> property which will hide the controls when fullscreen is active and the video is playing, after 1s. The controls reappear on hover of the progress bar (mouse), focusing a child control or pausing the video (by tap/click of video if `click` is `true`). The default value is <code>true</code>.</td>
   </tr>
   <tr>
     <td><code>storage</code></td>
     <td>Object</td>
     <td>&mdash;</td>
-    <td>This currently contains one property `enabled` which toggles if local storage should be enabled (if the browser supports it). The default value is `true`. This enables storing user settings, currently it only stores volume but more will be added later.</td>
+    <td>Two properties; <code>enabled</code> which toggles if local storage should be enabled (if the browser supports it). The default value is `true`. This enables storing user settings, currently it only stores volume but more will be added later. The second property <code>key</code> is the key used for the local storage. The default is <code>plyr_volume</code> until more settings are stored.</td>
   </tr>
  </tbody>
 </table>
@@ -301,18 +307,18 @@ Here's a list of the methods supported:
       Set the media source.
       <br><br> 
       <strong>string</strong><br>
-      <em>.source("/path/to/video.mp4")</em><br>
+      <code>.source("/path/to/video.mp4")</code><br>
-      This will set the "src" attribute on the `video` or `audio` element.
+      This will set the <code>src</code> attribute on the <code>video</code> or <code>audio</code> element.
       <br><br>
       <strong>array</strong><br>
-      <em>.source([{ src: "/path/to/video.webm", type: "video/webm", ...more attributes... }, { src: "/path/to/video.mp4", type: "video/mp4", ...more attributes... }])</em><br>
+      <code>.source([{ src: "/path/to/video.webm", type: "video/webm", ...more attributes... }, { src: "/path/to/video.mp4", type: "video/mp4", ...more attributes... }])`</code><br>
       This will inject a child `source` element for every element in the array with the specified attributes. `src` is the only required attribute although adding `type` is recommended as it helps the browser decide which file to download and play. 
     </td>
   </tr>
     <tr>
     <td><code>poster(...)</code></td>
     <td>String</td>
-    <td>Set the poster url. This is supported for the `video` element only.</td>
+    <td>Set the poster url. This is supported for the <code>video</code> element only.</td>
   </tr>
  </tbody>
 </table>
@@ -349,19 +355,21 @@ Fullscreen in Plyr is supported for all browsers that [currently support it](htt
   </thead>
   <tbody>
     <tr>
+      <td>✔&sup1;</td>
       <td>✔</td>
       <td>✔</td>
       <td>✔</td>
-      <td>✔</td>
+      <td>API&sup2;</td>
-      <td>✖&sup1;</td>
+      <td>✔&sup3;</td>
-      <td>✔&sup2;</td>
     </tr>
   </tbody>
 </table>
 
-&sup1; Native player used (no support for `<progress>` or `<input type="range">`)
+&sup1; Mobile Safari on the iPhone forces the native player for `<video>` so no useful customisation is possible. `<audio>` elements have volume controls disabled.
 
-&sup2; IE10 has no native fullscreen support, fallback can be used (see options)
+&sup2; Native player used (no support for `<progress>` or `<input type="range">`) but the API is supported (v1.0.28+)
+
+&sup3; IE10 has no native fullscreen support, fallback can be used (see options)
 
 The `enabled` option can be used to disable certain User Agents. For example, if you don't want to use Plyr for smartphones, you could use: 
 

src/js/plyr.js

@@ -1,7 +1,7 @@
 // ==========================================================================
 // Plyr
-// plyr.js v1.0.22
+// plyr.js v1.0.29
-// https://github.com/sampotts/plyr
+// https://github.com/selz/plyr
 // License: The MIT License (MIT)
 // ==========================================================================
 // Credits: http://paypal.github.io/accessible-html5-video-player/
@@ -20,9 +20,11 @@
         seekTime:               10,
         volume:                 5,
         click:                  true,
+        tooltips:               false,
         selectors: {
             container:          ".player",
             controls:           ".player-controls",
+            labels:             "[data-player] .sr-only, label .sr-only",
             buttons: {
                 seek:           "[data-player='seek']",
                 play:           "[data-player='play']",
@@ -50,13 +52,18 @@
             stopped:            "stopped",
             playing:            "playing",
             muted:              "muted",
+            loading:            "loading",
+            tooltip:            "player-tooltip",
+            hidden:             "sr-only",
+            hover:              "hover",
             captions: {
                 enabled:        "captions-enabled",
                 active:         "captions-active"
             },
             fullscreen: {
                 enabled:        "fullscreen-enabled",
-                active:         "fullscreen-active"
+                active:         "fullscreen-active",
+                hideControls:   "fullscreen-hide-controls"
             }
         },
         captions: {
@@ -64,10 +71,12 @@
         },
         fullscreen: {
             enabled:            true,
-            fallback:           true
+            fallback:           true,
+            hideControls:       true
         },
         storage: {
-            enabled:            true
+            enabled:            true,
+            key:                "plyr_volume"
         },
         html: (function() {
             return [
@@ -82,14 +91,14 @@
                             "<span>0</span>% buffered",
                         "</progress>",
                     "</div>",
-                    "<span class='player-controls-playback'>",
+                    "<span class='player-controls-left'>",
                         "<button type='button' data-player='restart'>",
                             "<svg><use xlink:href='#icon-restart'></use></svg>",
                             "<span class='sr-only'>Restart</span>",
                         "</button>",
                         "<button type='button' data-player='rewind'>",
                             "<svg><use xlink:href='#icon-rewind'></use></svg>",
-                            "<span class='sr-only'>Rewind {seektime} seconds</span>",
+                            "<span class='sr-only'>Rewind {seektime} secs</span>",
                         "</button>",
                         "<button type='button' data-player='play'>",
                             "<svg><use xlink:href='#icon-play'></use></svg>",
@@ -101,14 +110,14 @@
                         "</button>",
                         "<button type='button' data-player='fast-forward'>",
                             "<svg><use xlink:href='#icon-fast-forward'></use></svg>",
-                            "<span class='sr-only'>Fast forward {seektime} seconds</span>",
+                            "<span class='sr-only'>Forward {seektime} secs</span>",
                         "</button>",
                         "<span class='player-time'>",
                             "<span class='sr-only'>Time</span>",
                             "<span class='player-duration'>00:00</span>",
                         "</span>",
                     "</span>",
-                    "<span class='player-controls-sound'>",
+                    "<span class='player-controls-right'>",
                         "<input class='inverted sr-only' id='mute{id}' type='checkbox' data-player='mute'>",
                         "<label id='mute{id}' for='mute{id}'>",
                             "<svg class='icon-muted'><use xlink:href='#icon-muted'></use></svg>",
@@ -126,7 +135,7 @@
                         "<button type='button' data-player='fullscreen'>",
                             "<svg class='icon-exit-fullscreen'><use xlink:href='#icon-exit-fullscreen'></use></svg>",
                             "<svg><use xlink:href='#icon-enter-fullscreen'></use></svg>",
-                            "<span class='sr-only'>Toggle fullscreen</span>",
+                            "<span class='sr-only'>Toggle Fullscreen</span>",
                         "</button>",
                     "</span>",
                 "</div>"
@@ -145,7 +154,7 @@
     // Unfortunately, due to mixed support, UA sniffing is required
     function _browserSniff() {
         var nAgt = navigator.userAgent,
-            browserName = navigator.appName,
+            name = navigator.appName,
             fullVersion = ""+parseFloat(navigator.appVersion),
             majorVersion = parseInt(navigator.appVersion,10),
             nameOffset,
@@ -154,22 +163,22 @@
 
         // MSIE 11
         if ((navigator.appVersion.indexOf("Windows NT") !== -1) && (navigator.appVersion.indexOf("rv:11") !== -1)) {
-            browserName = "IE";
+            name = "IE";
             fullVersion = "11;";
         }
         // MSIE
         else if ((verOffset=nAgt.indexOf("MSIE")) !== -1) {
-            browserName = "IE";
+            name = "IE";
             fullVersion = nAgt.substring(verOffset+5);
         }
         // Chrome
         else if ((verOffset=nAgt.indexOf("Chrome")) !== -1) {
-            browserName = "Chrome";
+            name = "Chrome";
             fullVersion = nAgt.substring(verOffset+7);
         }
         // Safari
         else if ((verOffset=nAgt.indexOf("Safari")) !== -1) {
-            browserName = "Safari";
+            name = "Safari";
             fullVersion = nAgt.substring(verOffset+7);
             if ((verOffset=nAgt.indexOf("Version")) !== -1) {
                 fullVersion = nAgt.substring(verOffset+8);
@@ -177,15 +186,15 @@
         }
         // Firefox
         else if ((verOffset=nAgt.indexOf("Firefox")) !== -1) {
-            browserName = "Firefox";
+            name = "Firefox";
             fullVersion = nAgt.substring(verOffset+8);
         }
         // In most other browsers, "name/version" is at the end of userAgent 
         else if ( (nameOffset=nAgt.lastIndexOf(" ")+1) < (verOffset=nAgt.lastIndexOf("/")) ) {
-            browserName = nAgt.substring(nameOffset,verOffset);
+            name = nAgt.substring(nameOffset,verOffset);
             fullVersion = nAgt.substring(verOffset+1);
-            if (browserName.toLowerCase()==browserName.toUpperCase()) {
+            if (name.toLowerCase()==name.toUpperCase()) {
-                browserName = navigator.appName;
+                name = navigator.appName;
             }
         }
         // Trim the fullVersion string at semicolon/space if present
@@ -201,14 +210,19 @@
             fullVersion = ""+parseFloat(navigator.appVersion); 
             majorVersion = parseInt(navigator.appVersion,10);
         }
+
         // Return data
-        return [browserName, majorVersion];
+        return {
+            name:       name, 
+            version:    majorVersion, 
+            ios:        /(iPad|iPhone|iPod)/g.test(navigator.platform)
+        };
     }
 
     // Check for mime type support against a player instance
     // Credits: http://diveintohtml5.info/everything.html 
     // Related: http://www.leanbackplayer.com/test/h5mt.html
-    function _support(player, mimeType) {    
+    function _supportMime(player, mimeType) {    
         var media = player.media;
 
         // Only check video types for video players
@@ -306,6 +320,17 @@
     function _toggleHandler(element, events, callback, toggle) {
         events = events.split(" ");
 
+        // If a nodelist is passed, call itself on each node
+        if(element instanceof NodeList) {
+            for (var x = 0; x < element.length; x++) {
+                if (element[x] instanceof Node) {
+                    _toggleHandler(element[x], arguments[1], arguments[2], arguments[3]);
+                }
+            }
+            return;
+        }
+
+        // If a single node is passed, bind the event listener
         for (var i = 0; i < events.length; i++) {
             element[toggle ? "addEventListener" : "removeEventListener"](events[i], callback, false);
         }
@@ -321,6 +346,32 @@
         _toggleHandler(element, events, callback, false);
     }
 
+    // Trigger event
+    function _triggerEvent(element, event) {
+        // Create faux event
+        var fauxEvent = document.createEvent("MouseEvents");
+
+        // Set the event type
+        fauxEvent.initEvent(event, true, true);
+
+        // Dispatch the event
+        element.dispatchEvent(fauxEvent);
+    }
+
+    // Toggle checkbox
+    function _toggleCheckbox(event) {
+        // Only listen for return key
+        if(event.keyCode && event.keyCode != 13) {
+            return true;
+        }
+
+        // Toggle the checkbox
+        event.target.checked = !event.target.checked;
+
+        // Trigger change event
+        _triggerEvent(event.target, "change");
+    }
+
     // Get percentage
     function _getPercentage(current, max) {
         if(current === 0 || max === 0 || isNaN(current) || isNaN(max)) {
@@ -445,7 +496,7 @@
         // Seek the manual caption time and update UI
         function _seekManualCaptions(time) {
             // If it's not video, or we're using textTracks, bail.
-            if (player.usingTextTracks || player.type !== "video") {
+            if (player.usingTextTracks || player.type !== "video" || !player.supported.full) {
                 return;
             }
 
@@ -485,7 +536,7 @@
 
             if (config.captions.defaultActive) {
                 _toggleClass(player.container, config.classes.captions.active, true);
-                player.buttons.captions.setAttribute("checked", "checked");
+                player.buttons.captions.checked = true;
             }
         }
 
@@ -552,6 +603,18 @@
 
             // Inject into the container
             player.container.insertAdjacentHTML("beforeend", html);
+
+            // Setup tooltips
+            if(config.tooltips) {
+                var labels = _getElements(config.selectors.labels);
+
+                for (var i = labels.length - 1; i >= 0; i--) {
+                    var label = labels[i];
+
+                    _toggleClass(label, config.classes.hidden, false);
+                    _toggleClass(label, config.classes.tooltip, true);
+                }
+            }
         }
 
         // Find the UI controls and store references
@@ -567,9 +630,12 @@
                 player.buttons.restart          = _getElement(config.selectors.buttons.restart);
                 player.buttons.rewind           = _getElement(config.selectors.buttons.rewind);
                 player.buttons.forward          = _getElement(config.selectors.buttons.forward);
+                player.buttons.fullscreen       = _getElement(config.selectors.buttons.fullscreen);
+
+                // Inputs
                 player.buttons.mute             = _getElement(config.selectors.buttons.mute);
                 player.buttons.captions         = _getElement(config.selectors.buttons.captions);
-                player.buttons.fullscreen       = _getElement(config.selectors.buttons.fullscreen);
+                player.checkboxes               = _getElements("[type='checkbox']");
 
                 // Progress
                 player.progress = {};
@@ -596,6 +662,7 @@
             }
             catch(e) {
                 _log("It looks like there's a problem with your controls html. Bailing.", true);
+
                 return false;
             }
         }
@@ -614,26 +681,28 @@
 
         // Setup media
         function _setupMedia() {
-            player.media = player.container.querySelectorAll("audio, video")[0];
-
             // If there's no media, bail
             if(!player.media) {
                 _log("No audio or video element found!", true);
                 return false;
             }
 
+            
+            if(player.supported.full) {
                 // Remove native video controls
                 player.media.removeAttribute("controls");
         
-            // Set media type
-            player.type = (player.media.tagName.toLowerCase() == "video" ? "video" : "audio");
-
                 // Add type class
                 _toggleClass(player.container, config.classes[player.type], true);
 
                 // If there's no autoplay attribute, assume the video is stopped and add state class
                 _toggleClass(player.container, config.classes.stopped, (player.media.getAttribute("autoplay") === null));
             
+                // Add iOS class
+                if(player.browser.ios) {
+                    _toggleClass(player.container, "ios", true);
+                }
+
                 // Inject the player wrapper
                 if(player.type === "video") {
                     // Create the wrapper div
@@ -646,6 +715,7 @@
                     // Cache the container
                     player.videoContainer = wrapper;
                 }
+            }
 
             // Autoplay
             if(player.media.getAttribute("autoplay") !== null) {
@@ -709,10 +779,10 @@
                     _showCaptions(player);
 
                     // If IE 10/11 or Firefox 31+ or Safari 7+, don"t use native captioning (still doesn"t work although they claim it"s now supported)
-                    if ((player.browserName === "IE" && player.browserMajorVersion === 10) || 
+                    if ((player.browser.name === "IE" && player.browser.version === 10) || 
-                            (player.browserName === "IE" && player.browserMajorVersion === 11) || 
+                            (player.browser.name === "IE" && player.browser.version === 11) || 
-                            (player.browserName === "Firefox" && player.browserMajorVersion >= 31) || 
+                            (player.browser.name === "Firefox" && player.browser.version >= 31) || 
-                            (player.browserName === "Safari" && player.browserMajorVersion >= 7)) {
+                            (player.browser.name === "Safari" && player.browser.version >= 7)) {
                         // Debugging
                         _log("Detected IE 10/11 or Firefox 31+ or Safari 7+.");
 
@@ -784,7 +854,7 @@
                     }
 
                     // If Safari 7+, removing track from DOM [see "turn off native caption rendering" above]
-                    if (player.browserName === "Safari" && player.browserMajorVersion >= 7) {
+                    if (player.browser.name === "Safari" && player.browser.version >= 7) {
                         _log("Safari 7+ detected; removing track from DOM.");
 
                         // Find all <track> elements
@@ -814,6 +884,11 @@
                 else {
                     _log("Fullscreen not supported and fallback disabled.");
                 }
+
+                // Set control hide class hook
+                if(config.fullscreen.hideControls) {
+                    _toggleClass(player.container, config.classes.fullscreen.hideControls, true);
+                }
             }   
         }
 
@@ -870,7 +945,11 @@
             }
 
             // Set the current time
+            // Try/catch incase the media isn't set and we're calling seek() from source() and IE moans
+            try {
                 player.media.currentTime = targetTime.toFixed(1);
+            }
+            catch(e) {}
 
             // Logging
             _log("Seeking to " + player.media.currentTime + " seconds");
@@ -940,7 +1019,7 @@
             // Use default if needed
             if(typeof volume === "undefined") {
                 if(config.storage.enabled && _storage().supported) {
-                    volume = window.localStorage.plyr_volume || config.volume;
+                    volume = window.localStorage[config.storage.key] || config.volume;
                 }
                 else {
                     volume = config.volume;
@@ -951,8 +1030,15 @@
                 volume = 10;
             }
 
+            // If the controls are there
+            if(player.supported.full) {
                 player.volume.value = volume;
+            }
+
+            // Set the player volume
             player.media.volume = parseFloat(volume / 10);
+
+            // Update the UI
             _checkMute();
 
             // Store the volume in storage
@@ -964,29 +1050,35 @@
         // Mute
         function _toggleMute(muted) {
             // If the method is called without parameter, toggle based on current value
-            if(typeof active === "undefined") {
+            if(typeof muted === "undefined") {
                 muted = !player.media.muted;
+            }
+
+            // If the controls are there
+            if(player.supported.full) {
                 player.buttons.mute.checked = muted;
             }
 
+            // Set mute on the player
             player.media.muted = muted;
+
+            // Update UI
             _checkMute();
         }
 
         // Toggle captions
-        function _toggleCaptions(active) { 
+        function _toggleCaptions(show) { 
-            // If the method is called without parameter, toggle based on current value
+            if(!player.supported.full) {
-            if(typeof active === "undefined") {
+                return;
-                active = (player.container.className.indexOf(config.classes.captions.active) === -1);
-                player.buttons.captions.checked = active;
             }
 
-            if (active) {
+            // If the method is called without parameter, toggle based on current value
-                _toggleClass(player.container, config.classes.captions.active, true);
+            if(typeof show === "undefined") {
-            } 
+                show = (player.container.className.indexOf(config.classes.captions.active) === -1);
-            else {
+                player.buttons.captions.checked = show;
-                _toggleClass(player.container, config.classes.captions.active);
             }
+
+            _toggleClass(player.container, config.classes.captions.active, show);
         }
 
         // Check mute state
@@ -994,6 +1086,19 @@
             _toggleClass(player.container, config.classes.muted, (player.media.volume === 0 || player.media.muted));
         }
 
+        // Check if media is loading
+        function _checkLoading(event) {
+            var loading = (event.type === "waiting");
+
+            // Clear timer
+            clearTimeout(player.loadingTimer);
+
+            // Timer to prevent flicker when seeking
+            player.loadingTimer = setTimeout(function() {
+                _toggleClass(player.container, config.classes.loading, loading);
+            }, (loading ? 250 : 0));
+        }
+
         // Update <progress> elements
         function _updateProgress(event) {
             var progress    = player.progress.played.bar, 
@@ -1103,9 +1208,6 @@
             // Restart
             _seek();
 
-            // Update the UI
-            _checkPlaying();
-
             // Remove current sources
             _removeSources();
 
@@ -1124,9 +1226,14 @@
                 }
             }
 
+            if(player.supported.full) {
                 // Reset time display
                 _timeUpdate();
 
+                // Update the UI
+                _checkPlaying();
+            }
+
             // Re-load sources
             player.media.load();
 
@@ -1181,7 +1288,53 @@
             _on(player.buttons.fullscreen, "click", _toggleFullscreen);
 
             // Handle user exiting fullscreen by escaping etc
+            if(fullscreen.supportsFullScreen) {
                 _on(document, fullscreen.fullScreenEventName, _toggleFullscreen);
+            }
+            
+            // Time change on media
+            _on(player.media, "timeupdate seeking", _timeUpdate);
+
+            // Update manual captions
+            _on(player.media, "timeupdate", _seekManualCaptions);
+
+            // Seek 
+            _on(player.buttons.seek, "change input", _seek);
+
+            // Captions
+            _on(player.buttons.captions, "change", function() { 
+                console.log(this.checked);
+                _toggleCaptions(this.checked);
+            });
+
+            // Handle the media finishing
+            _on(player.media, "ended", function() {
+                // Clear 
+                if(player.type === "video") {
+                    player.captionsContainer.innerHTML = "";
+                }
+
+                // Reset UI
+                _checkPlaying();
+            });
+
+            // Check for buffer progress
+            _on(player.media, "progress", _updateProgress);
+
+            // Also check on start of playing
+            _on(player.media, "playing", _updateProgress);
+
+            // Handle native mute
+            _on(player.media, "volumechange", _checkMute);
+
+            // Handle native play/pause
+            _on(player.media, "play pause", _checkPlaying);
+
+            // Loading
+            _on(player.media, "waiting canplay seeked", _checkLoading);
+
+            // Toggle checkboxes on return key (as they look like buttons)
+            _on(player.checkboxes, "keyup", _toggleCheckbox);
 
             // Click video
             if(player.type === "video" && config.click) {
@@ -1199,66 +1352,46 @@
                 });
             }
 
-            // Time change on media
+            // Bind to mouse hover 
-            _on(player.media, "timeupdate seeking", _timeUpdate);
+            if(config.fullscreen.hideControls) {
-
+                _on(player.controls, "mouseenter mouseleave", function(event) {
-            // Update manual captions
+                    _toggleClass(player.controls, config.classes.hover, (event.type === "mouseenter"));
-            _on(player.media, "timeupdate", _seekManualCaptions);
+                })
-
-            // Seek 
-            _on(player.buttons.seek, "change input", _seek);
-
-            // Captions
-            _on(player.buttons.captions, "click", function() { 
-                _toggleCaptions(this.checked);
-            });
-
-            // Clear captions at end of video
-            _on(player.media, "ended", function() {
-                if(player.type === "video") {
-                    player.captionsContainer.innerHTML = "";
             }
-                _checkPlaying();
-            });
-
-            // Check for buffer progress
-            _on(player.media, "progress", _updateProgress);
-
-            // Also check on start of playing
-            _on(player.media, "playing", _updateProgress);
-
-            // Handle native mute
-            _on(player.media, "volumechange", _checkMute);
-
-            // Handle native play/pause
-            _on(player.media, "play pause", _checkPlaying);
         }
 
         function _init() {
             // Setup the fullscreen api 
             fullscreen = _fullscreen();
 
-            // Sniff 
+            // Sniff out the browser
-            player.browserInfo = _browserSniff();
+            player.browser = _browserSniff();
-            player.browserName = player.browserInfo[0];
-            player.browserMajorVersion = player.browserInfo[1];
 
-            // Debug info
+            // Get the media element
-            _log(player.browserName + " " + player.browserMajorVersion);
+            player.media = player.container.querySelectorAll("audio, video")[0];
 
-            // If IE8, stop customization (use fallback)
+            // Set media type
-            // If IE9, stop customization (use native controls)
+            player.type = player.media.tagName.toLowerCase();
-            if (player.browserName === "IE" && (player.browserMajorVersion === 8 || player.browserMajorVersion === 9) ) {
+
-                _log("Browser not suppported.", true);
+            // Check for full support
+            player.supported = api.supported(player.type);
+
+            // If no native support, bail
+            if(!player.supported.basic) {
                 return false;
             }
 
+            // Debug info
+            _log(player.browser.name + " " + player.browser.version);
+
             // Setup media
             _setupMedia();
 
             // Generate random number for id/for attribute values for controls
             player.random = Math.floor(Math.random() * (10000));
 
+            // If there's full support
+            if(player.supported.full) {
                 // Inject custom controls
                 _injectControls();
 
@@ -1283,7 +1416,13 @@
                 _listeners();
             }
 
-        _init();
+            // Successful setup
+            return true;
+        }
+
+        if(!_init()) {
+            return {};
+        }
 
         return {
             media:              player.media,
@@ -1298,10 +1437,42 @@
             toggleCaptions:     _toggleCaptions,
             source:             _parseSource,
             poster:             _updatePoster,
-            support:            function(mimeType) { return _support(player, mimeType); }
+            support:            function(mimeType) { return _supportMime(player, mimeType); }
         }
     }
 
+    // Check for support 
+    api.supported = function(type) {
+        var browser = _browserSniff(),
+            oldIE   = (browser.name === "IE" && browser.version <= 9),
+            iPhone  = /iPhone|iPod/i.test(navigator.userAgent),
+            audio   = !!document.createElement("audio").canPlayType,
+            video   = !!document.createElement("video").canPlayType,
+            basic, full;
+
+        switch (type) {
+            case "video": 
+                basic = video;
+                full  = (basic && (!oldIE && !iPhone));
+                break;
+
+            case "audio": 
+                basic = audio;
+                full  = (basic && !oldIE);
+                break; 
+
+            default:
+                basic = (audio && video);
+                full  = (basic && !oldIE);
+                break;                
+        }
+
+        return {
+            basic:  basic,
+            full:   full
+        };
+    }
+
     // Expose setup function
     api.setup = function(options){
         // Extend the default options with user specified
@@ -1309,12 +1480,13 @@
 
         // If enabled carry on
         // You may want to disable certain UAs etc
-        if(!config.enabled) {
+        if(!config.enabled || !api.supported().basic) {
             return false;
         }
 
         // Get the players 
-        var elements = document.querySelectorAll(config.selectors.container), players = [];
+        var elements    = document.querySelectorAll(config.selectors.container), 
+            players     = [];
 
         // Create a player instance for each element
         for (var i = elements.length - 1; i >= 0; i--) {
@@ -1323,7 +1495,11 @@
 
             // Setup a player instance and add to the element
             if(typeof element.plyr === "undefined") { 
-                element.plyr = new Plyr(element);
+                // Create new instance
+                var instance = new Plyr(element);
+
+                // Set plyr to false if setup failed
+                element.plyr = (Object.keys(instance).length ? instance : false);
             }
 
             // Add to return array
@@ -1332,4 +1508,5 @@
 
         return players;
     }
+
 }(this.plyr = this.plyr || {}));

src/less/plyr.less

@@ -23,10 +23,19 @@
 @control-color-inactive:    @gray;
 @control-color-hover:       #fff;
 
+// Tooltips
+@tooltip-bg:                @controls-bg;
+@tooltip-color:             #fff;
+@tooltip-padding:           @control-spacing;   
+@tooltip-arrow-size:        5px;
+@tooltip-radius:            3px;
+
 // Progress
-@progress-bg: 				lighten(@gray, 10%);
+@progress-bg:               rgba(red(@gray), green(@gray), blue(@gray), .2);
 @progress-playing-bg:       @blue;
-@progress-buffered-bg: 		@gray;
+@progress-buffered-bg:      rgba(red(@gray), green(@gray), blue(@gray), .25);
+@progress-loading-size:     40px;
+@progress-loading-bg:       rgba(0,0,0, .15);
 
 // Volume
 @volume-track-height:       6px;
@@ -59,13 +68,18 @@
     &:after { content: ""; display: table; }
     &:after { clear: both; }
 }
-
 // Tab focus styles
 .tab-focus() {
     outline: thin dotted #000;
     outline-offset: 0;
 }
 
+// Animation
+// ---------------------------------------
+@keyframes progress {
+    to { background-position: @progress-loading-size 0; }
+}
+
 // <input type="range"> styling
 // ---------------------------------------
 .volume-thumb() {
@@ -86,7 +100,7 @@
 .seek-thumb() {
     background: transparent;
     border: 0;
-	width: 2px;
+    width: (@control-spacing * 2);
     height: @control-spacing;
 }
 .seek-track() {
@@ -112,7 +126,6 @@
     position: relative;
     max-width: 100%;
     min-width: 290px;
-	overflow: hidden; // For the controls
 
     // border-box everything
     // http://paulirish.com/2012/box-sizing-border-box-ftw/
@@ -166,21 +179,21 @@
         .clearfix();
         .font-smoothing();
         position: relative;
-		padding: (@control-spacing * 2) @control-spacing @control-spacing;
+        padding: @control-spacing;
         background: @controls-bg;
         line-height: 1;
         text-align: center;
 
         // Layout
-		&-sound {
+        &-right {
             display: block;
             margin: @control-spacing auto 0;
         }
         @media (min-width: @bp-control-split) {
-			&-playback {
+            &-left {
                 float: left;
             }
-			&-sound {
+            &-right {
                 float: right;
                 margin-top: 0;
             }
@@ -220,10 +233,11 @@
             overflow: hidden;
         }
         
+        // Specificity for overriding .inverted
         button:focus,
         button:hover,
-		input:focus + label,
+        [type="checkbox"]:focus + label,
-		input + label:hover {
+        [type="checkbox"] + label:hover {
             background: @control-bg-hover;
             color: @control-color-hover;
         }
@@ -247,11 +261,59 @@
         }
     }
 
+    // Tooltips
+    &-tooltip {
+        visibility: hidden;
+        position: absolute;
+        z-index: 2;
+        bottom: 100%;
+        margin-bottom: @tooltip-padding;
+        padding: @tooltip-padding (@tooltip-padding * 1.5);
+
+        opacity: 0;
+        background: @tooltip-bg;
+        border-radius: @tooltip-radius;
+        color: @tooltip-color;
+        font-size: @font-size-small;
+        line-height: 1.5;
+        font-weight: 600;
+
+        transform: translate(-50%, (@tooltip-padding * 3));
+        transition: transform .2s .2s ease, opacity .2s .2s ease;
+
+        &::after {
+            content: "";
+            display: block;
+            position: absolute;
+            left: 50%;
+            bottom: -@tooltip-arrow-size;
+            margin-left: -@tooltip-arrow-size;
+            width: 0;
+            height: 0;
+            transition: inherit;
+            border-style: solid;
+            border-width: @tooltip-arrow-size @tooltip-arrow-size 0 @tooltip-arrow-size;
+            border-color: @controls-bg transparent transparent;
+        }
+    }
+    label:hover .player-tooltip,
+    input:focus + label .player-tooltip, 
+    button:hover .player-tooltip,
+    button:focus .player-tooltip {
+        visibility: visible;
+        opacity: 1;
+        transform: translate(-50%, 0);
+    }
+    label:hover .player-tooltip,
+    button:hover .player-tooltip {
+        z-index: 3;
+    }
+
     // Player progress
     // <progress> element
     &-progress {
         position: absolute;
-		top: 0;
+        bottom: 100%;
         left: 0;
         right: 0;
         width: 100%;
@@ -301,7 +363,7 @@
         // <input[type='range']> element
         // Specificity is for bootstrap compatibility
         &-seek[type=range] {
-			z-index: 3;
+            z-index: 4;
             cursor: pointer;
             outline: 0;
 
@@ -345,6 +407,24 @@
         }
     }
 
+    // Loading state
+    &.loading .player-progress-buffer {
+        animation: progress 1s linear infinite;
+        background-size: @progress-loading-size @progress-loading-size;
+        background-repeat: repeat-x;
+        background-color: @progress-buffered-bg;
+        background-image: linear-gradient(
+            -45deg, 
+            @progress-loading-bg 25%, 
+            transparent 25%, 
+            transparent 50%, 
+            @progress-loading-bg 50%, 
+            @progress-loading-bg 75%,
+            transparent 75%, 
+            transparent);
+        color: transparent;
+    }
+
     // States
     &-controls [data-player='pause'],
     &.playing .player-controls [data-player='play'] {
@@ -417,6 +497,20 @@
         }
     }
 
+    // Hide sound controls on iOS
+    // It's not supported to change volume using JavaScript:
+    // https://developer.apple.com/library/safari/documentation/AudioVideo/Conceptual/Using_HTML5_Audio_Video/Device-SpecificConsiderations/Device-SpecificConsiderations.html
+    &.ios &-volume,
+    &.ios [data-player='mute'],
+    &.ios [data-player='mute'] + label,
+    &-audio.ios &-controls-right {
+        display: none;
+    }
+    // Center buttons so it looks less odd
+    &-audio.ios &-controls-left {
+        float: none;
+    }
+
     // Full screen mode
     &-fullscreen,
     &.fullscreen-active {
@@ -430,13 +524,13 @@
         z-index: 10000000;
         background: #000;
 
+        video {
+            height: 100%;
+        }
         .player-video-wrapper {
             height: 100%;
             width: 100%;
 
-			video {
-				height: 100%;
-			}
             .player-captions {
                 top: auto;
                 bottom: 90px;
@@ -455,6 +549,17 @@
             left: 0;
             right: 0;
         }
+
+        // Hide controls when playing in full screen
+        &.fullscreen-hide-controls.playing .player-controls {
+            transform: translateY(100%) translateY(@control-spacing / 2);
+            transition: transform .3s 1s ease;
+
+            &.hover {
+                transform: translateY(0);
+                transition-delay: 0;
+            }
+        }
     }
 
     // Change icons on state change
@@ -481,10 +586,4 @@
     &.fullscreen-enabled [data-player='fullscreen'] + label {
         display: inline-block;
     }
-
-	// Full browser view hides toggle
-	&-fullscreen [data-player='fullscreen'],
-	&-fullscreen [data-player='fullscreen'] + label {
-		display: none !important;
-	}
 }

src/sass/plyr.scss

@@ -21,15 +21,23 @@ $controls-bg: 				$gray-dark;
 $control-bg-hover:        $blue;
 $control-color:           $gray-light;
 $control-color-inactive:  $gray;
-$control-color-focus: 		#fff;
 $control-color-hover:     #fff;
 
-// Progress
+// Tooltips
-$progress-bg: 				lighten($gray, 10%);
+$tooltip-bg:              $controls-bg;
-$progress-playing-bg: 		$blue;
+$tooltip-color:           #fff;
-$progress-buffered-bg: 		$gray;
+$tooltip-padding:         $control-spacing;
+$tooltip-arrow-size:      5px;
+$tooltip-radius:          3px;
 
-// Range
+// Progress
+$progress-bg:             rgba(red($gray), green($gray), blue($gray), .2);
+$progress-playing-bg:     $blue;
+$progress-buffered-bg:    rgba(red($gray), green($gray), blue($gray), .25);
+$progress-loading-size:   40px;
+$progress-loading-bg:     rgba(0,0,0, .15);
+
+// Volume
 $volume-track-height:     6px;
 $volume-track-bg:         $gray;
 $volume-thumb-height:     ($volume-track-height * 2);
@@ -61,7 +69,6 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
     &:after { content: ""; display: table; }
     &:after { clear: both; }
 }
-
 // Tab focus styles
 @mixin tab-focus()
 {
@@ -69,6 +76,12 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
     outline-offset: 0;
 }
 
+// Animation
+// ---------------------------------------
+@keyframes progress {
+    to { background-position: $progress-loading-size 0; }
+}
+
 // <input type="range"> styling
 // ---------------------------------------
 @mixin volume-thumb()
@@ -88,28 +101,30 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
     border: 0;
     border-radius: ($volume-track-height / 2);
 }
-@mixin seek-thumb() {
+@mixin seek-thumb()
+{
     background: transparent;
     border: 0;
-	width: 2px;
+    width: ($control-spacing * 2);
     height: $control-spacing;
 }
-@mixin seek-track() {
+@mixin seek-track()
+{
     background: none;
     border: 0;
 }
 
 // Font smoothing
 // ---------------------------------------
-@mixin font-smoothing($mode: on) when ($mode = on)
+@mixin font-smoothing($mode: on)
 {
+    @if $mode == 'on' {
         -moz-osx-font-smoothing: grayscale;
         -webkit-font-smoothing: antialiased;
-}
+    } @else if $mode == 'off' {
-@mixin font-smoothing($mode: on) when ($mode = off)
-{
         -moz-osx-font-smoothing: auto;
         -webkit-font-smoothing: subpixel-antialiased;
+    }
 }
 
 // Styles
@@ -119,7 +134,6 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
     position: relative;
     max-width: 100%;
     min-width: 290px;
-	overflow: hidden; // For the controls
 
     // border-box everything
     // http://paulirish.com/2012/box-sizing-border-box-ftw/
@@ -173,21 +187,21 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
         @include clearfix();
         @include font-smoothing();
         position: relative;
-		padding: ($control-spacing * 2) $control-spacing $control-spacing;
+        padding: $control-spacing;
         background: $controls-bg;
         line-height: 1;
         text-align: center;
 
         // Layout
-		&-sound {
+        &-right {
             display: block;
             margin: $control-spacing auto 0;
         }
         @media (min-width: $bp-control-split) {
-			&-playback {
+            &-left {
                 float: left;
             }
-			&-sound {
+            &-right {
                 float: right;
                 margin-top: 0;
             }
@@ -226,16 +240,19 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
             background: transparent;
             overflow: hidden;
         }
-		input:focus + label,
+
-		button:focus {
+        // Specificity for overriding .inverted
-			@include tab-focus();
+        button:focus,
-			color: $control-color-focus;
-		}
         button:hover,
-		input + label:hover {
+        [type="checkbox"]:focus + label,
+        [type="checkbox"] + label:hover {
             background: $control-bg-hover;
             color: $control-color-hover;
         }
+        button:focus,
+        input:focus + label {
+            outline: 0;
+        }
         .icon-exit-fullscreen,
         .icon-muted,
         .icon-captions-on {
@@ -252,11 +269,59 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
         }
     }
 
+    // Tooltips
+    &-tooltip {
+        visibility: hidden;
+        position: absolute;
+        z-index: 2;
+        bottom: 100%;
+        margin-bottom: $tooltip-padding;
+        padding: $tooltip-padding ($tooltip-padding * 1.5);
+
+                opacity: 0;
+        background: $tooltip-bg;
+        border-radius: $tooltip-radius;
+        color: $tooltip-color;
+        font-size: $font-size-small;
+        line-height: 1.5;
+        font-weight: 600;
+
+        transform: translate(-50%, ($tooltip-padding * 3));
+                transition: transform .2s .2s ease, opacity .2s .2s ease;
+
+        &::after {
+            content: "";
+            display: block;
+            position: absolute;
+            left: 50%;
+            bottom: -$tooltip-arrow-size;
+            margin-left: -$tooltip-arrow-size;
+            width: 0;
+            height: 0;
+            transition: inherit;
+            border-style: solid;
+            border-width: $tooltip-arrow-size $tooltip-arrow-size 0 $tooltip-arrow-size;
+            border-color: $controls-bg transparent transparent;
+        }
+    }
+    label:hover .player-tooltip,
+    input:focus + label .player-tooltip,
+    button:hover .player-tooltip,
+    button:focus .player-tooltip {
+        visibility: visible;
+        opacity: 1;
+        transform: translate(-50%, 0);
+    }
+    label:hover .player-tooltip,
+    button:hover .player-tooltip {
+        z-index: 3;
+    }
+
     // Player progress
     // <progress> element
     &-progress {
         position: absolute;
-		top: 0;
+        bottom: 100%;
         left: 0;
         right: 0;
         width: 100%;
@@ -270,8 +335,9 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
             left: 0;
             top: 0;
             width: 100%;
-			height: 100%;
+            height: $control-spacing;
             margin: 0;
+            padding: 0;
             vertical-align: top;
 
             -webkit-appearance: none;
@@ -279,7 +345,6 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
             border: none;
             background: transparent;
         }
-
         &-buffer[value],
         &-played[value] {
             &::-webkit-progress-bar {
@@ -306,7 +371,7 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
         // <input[type='range']> element
         // Specificity is for bootstrap compatibility
         &-seek[type=range] {
-			z-index: 3;
+            z-index: 4;
             cursor: pointer;
             outline: 0;
 
@@ -350,6 +415,24 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
         }
     }
 
+    // Loading state
+    &.loading .player-progress-buffer {
+        animation: progress 1s linear infinite;
+        background-size: $progress-loading-size $progress-loading-size;
+        background-repeat: repeat-x;
+        background-color: $progress-buffered-bg;
+        background-image: linear-gradient(
+            -45deg,
+            $progress-loading-bg 25%,
+            transparent 25%,
+            transparent 50%,
+            $progress-loading-bg 50%,
+            $progress-loading-bg 75%,
+            transparent 75%,
+            transparent);
+            color: transparent;
+    }
+
     // States
     &-controls [data-player='pause'],
     &.playing .player-controls [data-player='play'] {
@@ -363,6 +446,7 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
     // <input[type='range']> element
     // Specificity is for bootstrap compatibility
     &-volume[type=range] {
+        display: inline-block;
         vertical-align: middle;
         -webkit-appearance: none;
         -moz-appearance: none;
@@ -374,20 +458,20 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
 
         // Webkit
         &::-webkit-slider-runnable-track {
-			@include range-track();
+            @include volume-track();
         }
         &::-webkit-slider-thumb {
             -webkit-appearance: none;
             margin-top: -(($volume-thumb-height - $volume-track-height) / 2);
-			@include range-thumb();
+            @include volume-thumb();
         }
 
         // Mozilla
         &::-moz-range-track {
-			@include range-track();
+            @include volume-track();
         }
         &::-moz-range-thumb {
-			@include range-thumb();
+            @include volume-thumb();
         }
 
         // Microsoft
@@ -400,10 +484,10 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
         }
         &::-ms-fill-lower,
         &::-ms-fill-upper {
-			@include range-track();
+            @include volume-track();
         }
         &::-ms-thumb {
-			@include range-thumb();
+            @include volume-thumb();
         }
 
         &:focus {
@@ -421,6 +505,20 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
         }
     }
 
+    // Hide sound controls on iOS
+    // It's not supported to change volume using JavaScript:
+    // https://developer.apple.com/library/safari/documentation/AudioVideo/Conceptual/Using_HTML5_Audio_Video/Device-SpecificConsiderations/Device-SpecificConsiderations.html
+    &.ios &-volume,
+    &.ios [data-player='mute'],
+    &.ios [data-player='mute'] + label,
+    &-audio.ios &-controls-right {
+        display: none;
+    }
+    // Center buttons so it looks less odd
+    &-audio.ios &-controls-left {
+        float: none;
+    }
+
     // Full screen mode
     &-fullscreen,
     &.fullscreen-active {
@@ -434,13 +532,13 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
         z-index: 10000000;
         background: #000;
 
+        video {
+            height: 100%;
+        }
         .player-video-wrapper {
             height: 100%;
             width: 100%;
 
-			video {
-				height: 100%;
-			}
             .player-captions {
                 top: auto;
                 bottom: 90px;
@@ -459,6 +557,17 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
             left: 0;
             right: 0;
         }
+
+        // Hide controls when playing in full screen
+        &.fullscreen-hide-controls.playing .player-controls {
+            transform: translateY(100%) translateY($control-spacing / 2);
+            transition: transform .3s 1s ease;
+
+            &.hover {
+                transform: translateY(0);
+                transition-delay: 0;
+            }
+        }
     }
 
     // Change icons on state change