A plugin for Video.js that enables keyboard hotkeys when the player has focus.
- Space bar toggles play/pause.
- Right and Left Arrow keys seek the video forwards and back.
- Up and Down Arrow keys increase and decrease the volume.
- M key toggles mute/unmute.
- F key toggles fullscreen off and on. (Does not work in Internet Explorer, it seems to be a limitation where scripts cannot request fullscreen without a mouse click)
- Double-clicking with the mouse toggles fullscreen off and on.
- Number keys from 0-9 skip to a percentage of the video. 0 is 0% and 9 is 90%.
Note: clicking any of the control buttons such as Play/Pause, Fullscreen, or Mute, will remove focus on the player
which appears to "break" the hotkeys. This is for accessibility reasons so that people who do not use or know about
the hotkeys can still properly use the Tab
key to highlight the control buttons and press space
to toggle them.
To restore focus, just click on the video, or an empty part of the control bar at the bottom of the video player.
To override this behaviour, set the flag alwaysCaptureHotkeys
to true
.
This will "fix" hotkeys. For accessibility, the Tab
key may be used in combination with the Enter
/Return
key to navigate and activate control buttons.
Include the plugin:
You can either load the current release:
<script src="//cdn.sc.gl/videojs-hotkeys/0.2/videojs.hotkeys.min.js"></script>
Or always load the latest version:
<script src="//cdn.sc.gl/videojs-hotkeys/latest/videojs.hotkeys.min.js"></script>
<script src="/path/to/videojs.hotkeys.js"></script>
Add hotkeys to your Videojs ready function. Check the Options section below for the available options and their meaning.
videojs('vidId').ready(function() {
this.hotkeys({
volumeStep: 0.1,
seekStep: 5
});
});
volumeStep
(decimal): The percentage to increase/decrease the volume level when using the Up and Down Arrow keys (default:0.1
)seekStep
(integer): The number of seconds to seek forward and backwards when using the Right and Left Arrow keys (default:5
)enableMute
(boolean): Enables the volume mute to be toggle by pressing the M key (default:true
)enableVolumeScroll
(boolean): Enables increasing/decreasing the volume by scrolling the mouse wheel (default:true
)enableFullscreen
(boolean): Enables toggling the video fullscreen by pressing the F key (default:true
)enableNumbers
(boolean): Enables seeking the video by pressing the number keys (defaulttrue
)alwaysCaptureHotkeys
(boolean): Forces the capture of hotkeys, even when control elements are focused. The Enter/Return key may be used instead to activate the control elements (default:false
)enableJogStyle
(boolean): Enables seeking the video in a broadcast-style jog by pressing the Up and Down Arrow keys.seekStep
will also need to be changed to get a proper broadcast-style jog. This feature and the changes for seekStep are explained a bit more in PR #12 (defaultfalse
) (Note: This isn't a feature for everyone, and enabling JogStyle will disable the volume hotkeys)
There are more options specifically for customizing hotkeys described below.
There are 2 methods available here. Simply overriding existing hotkeys, and creating new custom hotkeys.
Override functions are available for changing which, or adding additional, keys that are used as hotkeys to trigger an action.
Any override functions that you build must return a boolean.
true
if the matching key(s) were pressed, or false
if they were not.
playPauseKey
(function): This function can be used to override the Play/Pause toggle hotkey (Default key: Space)rewindKey
(function): This function can override the key for seeking backward/left in the video (Default key: Left Arrow)forwardKey
(function): This function can override the key for seeking forward/right in the video (Default key: Right Arrow)volumeUpKey
(function): This function can override the key for increasing the volume (Default key: Up Arrow)volumeDownKey
(function): This function can override the key for decreasing the volume (Default key: Down Arrow)muteKey
(function): This function can override the key for the volume muting toggle (Default key: M)fullscreenKey
(function): This function can override the key for the fullscreen toggle (Default key: F)
These allow you to change keys such as, instead of, or in addition to, "F" for Fullscreen, you can make Ctrl+Enter trigger fullscreen as well. Example usage:
videojs('vidId').ready(function() {
this.hotkeys({
volumeStep: 0.1,
fullscreenKey: function(event, player) {
// override fullscreen to trigger when pressing the F key or Ctrl+Enter
return ((e.which === 70) || (e.ctrlKey && e.which === 13));
}
});
});
customKeys
(object): Create an object containing 1 or more sub-objects. Each sub-object must contain akey
function andhandler
functionkey
(function): This function checks if the chosen keys were pressed. It must return a boolean,true
if the keys match.handler
(function): This function runs your custom code if the result of thekey
function wastrue
.
videojs('vidId').ready(function() {
this.hotkeys({
volumeStep: 0.1,
customKeys: {
// Create custom hotkeys
ctrldKey: {
key: function(e) {
// Toggle something with CTRL + D Key
return (e.ctrlKey && e.which === 68);
},
handler: function(player, options) {
// Using mute as an example
if (options.enableMute) {
player.muted(!player.muted());
}
}
}
}
});
});
There are more usage examples available in the source code of the example file.