Added tooltip option (Fixes #50)

Fixes #36

changelog.md

@@ -1,14 +1,20 @@
 # Changelog
 
+## 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 +23,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

@@ -38,7 +38,7 @@ This is the default `html` option from `plyr.js`.
         "</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,7 +50,7 @@ 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>",
@@ -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-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} 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-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: {  }});

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.24/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.24/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.24/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,13 @@
 		<!-- 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,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.24/sprite.svg");
 		</script>
 
 		<!-- Plyr core script -->
-		<script src="//cdn.plyr.io/1.0.22/plyr.js"></script>
+		<script src="//cdn.plyr.io/1.0.24/plyr.js"></script>
 
 		<!-- Docs script -->
-		<script src="//cdn.plyr.io/1.0.22/docs.js"></script>
+		<script src="//cdn.plyr.io/1.0.24/docs.js"></script>
 	</body>
 </html>

docs/src/js/docs.js

@@ -11,7 +11,8 @@ plyr.setup({
 	html: 	templates.controls.render({}),
 	captions: {
 		defaultActive: true
-	}
+	},
+	tooltips: true
 });
 
 // Google analytics 

docs/src/templates/controls.html

@@ -16,7 +16,7 @@
 		</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,7 +28,7 @@
 		</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>
@@ -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>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "plyr",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "description": "A simple HTML5 media player using custom controls",
   "homepage": "http://plyr.io",
   "main": "gulpfile.js",

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 5.7KB 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.24/plyr.js` to `https://cdn.plyr.io/1.0.24/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.24/plyr.css">
-<script src="//cdn.plyr.io/1.0.21/plyr.js"></script>
+<script src="//cdn.plyr.io/1.0.24/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.24/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>Two properties; <code>enabled</code> which toggles if fullscreen should be enabled (if the browser supports it). The default value is <code>true</code>. Also an extra property called <code>fallback</code> which will enable a full window view for older browsers. 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>✖&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; iPhone forces the native player for `<video>` so no customisation possible
 
-&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">`)
+
+&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,6 +1,6 @@
 // ==========================================================================
 // Plyr
-// plyr.js v1.0.22
+// plyr.js v1.0.24
 // https://github.com/sampotts/plyr
 // License: The MIT License (MIT)
 // ==========================================================================
@@ -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,6 +52,9 @@
             stopped:            "stopped",
             playing:            "playing",
             muted:              "muted",
+            loading:            "loading",
+            tooltip:            "player-tooltip",
+            hidden:             "sr-only",
             captions: {
                 enabled:        "captions-enabled",
                 active:         "captions-active"
@@ -67,7 +72,8 @@
             fallback:           true
         },
         storage: {
-            enabled:            true
+            enabled:            true,
+            key:                "plyr_volume"
         },
         html: (function() {
             return [
@@ -89,7 +95,7 @@
                         "</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,7 +107,7 @@
                         "</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>",
@@ -126,7 +132,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>"
@@ -552,6 +558,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
@@ -626,7 +644,7 @@
             player.media.removeAttribute("controls");
 
             // Set media type
-            player.type = (player.media.tagName.toLowerCase() == "video" ? "video" : "audio");
+            player.type = (player.media.tagName == "VIDEO" ? "video" : "audio");
 
             // Add type class
             _toggleClass(player.container, config.classes[player.type], true);
@@ -940,7 +958,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;
@@ -994,6 +1012,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, 
@@ -1232,6 +1263,9 @@
 
             // Handle native play/pause
             _on(player.media, "play pause", _checkPlaying);
+
+            // Loading
+            _on(player.media, "waiting canplay seeked", _checkLoading);
         }
 
         function _init() {
@@ -1321,6 +1355,13 @@
             // Get the current element
             var element = elements[i];
 
+            // Disabled for <video> for iPhone
+            // Since it doesn't allow customisation
+            if (element.querySelectorAll("audio, video")[0].tagName === "VIDEO" 
+                && /iPhone/i.test(navigator.userAgent)) {
+                continue;
+            }
+
             // Setup a player instance and add to the element
             if(typeof element.plyr === "undefined") { 
                 element.plyr = new Plyr(element);

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-playing-bg: 		@blue;
 @progress-buffered-bg: 		@gray;
+@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/
@@ -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,6 +261,54 @@
 		}
 	}
 
+	// 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 {
@@ -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'] {

src/sass/plyr.scss

@@ -21,13 +21,21 @@ $controls-bg: 				$gray-dark;
 $control-bg-hover: 			$blue;
 $control-color: 			$gray-light;
 $control-color-inactive: 	$gray;
-$control-color-focus: 		#fff;
 $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-playing-bg: 		$blue;
 $progress-buffered-bg: 		$gray;
+$progress-loading-size: 	40px;
+$progress-loading-bg: 		rgba(0,0,0, .15);
 
 // Range
 $volume-track-height: 		6px;
@@ -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()
@@ -91,7 +104,7 @@ $bp-captions-large: 		768px; // When captions jump to the larger font size
 @mixin seek-thumb() {
 	background: transparent;
 	border: 0;
-	width: 2px;
+	width: ($control-spacing * 2);
 	height: $control-spacing;
 }
 @mixin seek-track() {
@@ -119,7 +132,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/
@@ -252,6 +264,54 @@ $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 {
@@ -350,6 +410,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'] {