Added tooltip option (Fixes #50)

changelog.md

@@ -1,17 +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
+- 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)
@@ -20,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.23/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.23/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.23/docs.css">
+		<link rel="stylesheet" href="//cdn.plyr.io/1.0.24/docs.css">
 	</head>
 	<body>
 		<header>
@@ -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.23/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.23/plyr.js"></script>
+		<script src="//cdn.plyr.io/1.0.24/plyr.js"></script>
 
 		<!-- Docs script -->
-		<script src="//cdn.plyr.io/1.0.23/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.23",
+  "version": "1.0.24",
   "description": "A simple HTML5 media player using custom controls",
   "homepage": "http://plyr.io",
   "main": "gulpfile.js",

readme.md

@@ -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.23/plyr.js` to `https://cdn.plyr.io/1.0.23/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.23/plyr.css">
+<link rel="stylesheet" href="//cdn.plyr.io/1.0.24/plyr.css">
-<script src="//cdn.plyr.io/1.0.23/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.23/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. 
@@ -192,6 +192,12 @@ You can pass the following options to the setup method.
     <td><code>true</code></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>
@@ -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 <code>false</code>.</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;<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>
+    <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>

src/js/plyr.js

@@ -1,6 +1,6 @@
 // ==========================================================================
 // Plyr
-// plyr.js v1.0.23
+// 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']",
@@ -51,6 +53,8 @@
             playing:            "playing",
             muted:              "muted",
             loading:            "loading",
+            tooltip:            "player-tooltip",
+            hidden:             "sr-only",
             captions: {
                 enabled:        "captions-enabled",
                 active:         "captions-active"
@@ -68,7 +72,8 @@
             fallback:           true
         },
         storage: {
-            enabled:            true
+            enabled:            true,
+            key:                "plyr_volume"
         },
         html: (function() {
             return [
@@ -90,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>",
@@ -102,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>",
@@ -127,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>"
@@ -553,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
@@ -941,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;

src/less/plyr.less

@@ -23,6 +23,13 @@
 @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;
@@ -119,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/
@@ -227,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;
 		}
@@ -254,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 {
@@ -308,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;
 

src/sass/plyr.scss

@@ -23,6 +23,13 @@ $control-color: 			$gray-light;
 $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;
@@ -125,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/
@@ -258,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 {