This documentation is for an outdated version of Video.js. See documentation for the current release.

Skins

Base Skin

The base Video.js skin is made using HTML and CSS (although we use the Sass preprocessor), and by default these styles are added to the DOM for you! That means you can build a custom skin by simply taking advantage of the cascading aspect of CSS and overriding the styles you'd like to change.

If you don't want Video.js to inject the base styles for you, you can disable it by setting window.VIDEOJS_NO_BASE_THEME = true before Video.js is loaded. Keep in mind that without these base styles enabled, you'll need to manually include them.

Video.js does not currently include the base skin automatically yet, so, this option isn't necessary.

Default style elements

Video.js uses a couple of style elements dynamically, specifically, there's a default styles element as well as a player dimensions style element. They are used to provide extra default flexiblity with styling the player. However, in some cases, like if a user has the HEAD tag managed by React, users do not want this. When window.VIDEOJS_NO_DYNAMIC_STYLE is set to true, video.js will not include these element in the page. This means that default dimensions and configured player dimensions will not be applied. For example, the following player will end up having a width and height of 0 when initialized if window.VIDEOJS_NO_DYNAMIC_STYLE === true:

<video width="600" height="300"></video>

Player#width and Player#height

When VIDEOJS_NO_DYNAMIC_STYLE is set, Player#width and Player#height will apply any width and height that is set directly to the video element (or whatever element the current tech uses).

Icons

You can view all of the icons available in the base theme by renaming and viewing icons.html.example in the sandbox directory.

Customization

When you create a new skin, the easiest way to get started is to simply override the base Video.js theme. You should include a new class matching the name of your theme, then just start overriding!

.vjs-skin-hotdog-stand { color: #FF0000; }
.vjs-skin-hotdog-stand .vjs-control-bar { background: #FFFF00; }
.vjs-skin-hotdog-stand .vjs-play-progress { background: #FF0000; }

This would take care of the major areas of the skin (play progress, the control bar background, and icon colors), but you can skin any other aspect. Our suggestion is to use a browser such as Firefox and Chrome, and use the developer tools to inspect the different elements and see what you'd like to change and what classes to target when you do so.

More custom skins will be available for download soon. If you have one you like you can share it by forking this example on CodePen.io, and adding a link on the Skins wiki page.