1
0
mirror of https://github.com/videojs/video.js.git synced 2024-12-14 11:23:30 +02:00
Video.js - open source HTML5 video player
Go to file
2017-03-02 11:15:49 -05:00
.github chore(docs): Documentation Linting and TOC generation (#3841) 2016-12-20 16:55:59 -05:00
build chore: change accessibility test in grunt.js to remove unnecessary warning message. (#4143) 2017-03-02 11:15:49 -05:00
docs feat(lang): French translation update (#4118) 2017-02-22 14:25:53 -05:00
lang feat(lang): French translation update (#4118) 2017-02-22 14:25:53 -05:00
sandbox chore(sandbox): Use Elephants Dream video files from CDN for the sandbox/descriptions.html.example. (#4137) 2017-02-27 13:53:32 -05:00
src fix: early play should wait for player ready, even if source is available (#4134) 2017-03-02 11:15:06 -05:00
test chore: increase browserstack/karma timeouts, dispose player in tests (#4135) 2017-02-28 15:02:18 -05:00
.babelrc test: fix tests (#3953) 2017-01-19 11:17:46 -05:00
.editorconfig Added .editorconfig and travis CI badge 2012-12-11 14:33:42 -08:00
.gitignore @gkatsev updated build system to open es5 folder for bundles and dist folder other users. closes #3445 2016-08-17 17:16:41 -04:00
.jsdoc.json docs(jsdoc): introduce a jsdoc template and build on publish (#3910) 2017-01-24 11:26:39 -05:00
.npmignore @gkatsev updated build system to open es5 folder for bundles and dist folder other users. closes #3445 2016-08-17 17:16:41 -04:00
.remarkignore chore(docs): Documentation Linting and TOC generation (#3841) 2016-12-20 16:55:59 -05:00
.remarkrc.js chore(docs): Documentation Linting and TOC generation (#3841) 2016-12-20 16:55:59 -05:00
.travis.yml @misteroneill enabled and updated videojs-standard and fixed an issue with linting. closes #3508 2016-08-11 18:33:34 -04:00
bower.json @DatTran fixed bower paths. Fixes #2740. closes #2775 2015-11-20 17:22:49 -05:00
CHANGELOG.md v5.16.0 2017-01-12 14:54:11 -05:00
COLLABORATOR_GUIDE.md chore: fix typo in collaborator guide (#3931) 2017-01-11 11:26:54 -05:00
composer.json Added a composer.json for PHP packages. closes #1241 2014-06-13 17:01:11 -07:00
contrib.json chore(release): add es5 folder to the tagged commit (#3913) 2017-01-04 10:59:20 -05:00
CONTRIBUTING.md docs: Expand testing info in CONTRIBUTING.md (#4020) 2017-02-02 11:19:01 -05:00
Gruntfile.js @gkatsev updated build system to open es5 folder for bundles and dist folder other users. closes #3445 2016-08-17 17:16:41 -04:00
LICENSE More build and testing cleanup. Also some reorganization. 2015-04-02 11:33:51 -07:00
package.json feat: update videojs-vtt.js and wrap native cues in TextTrack (#4115) 2017-02-27 13:52:01 -05:00
README.md chore(docs): Documentation Linting and TOC generation (#3841) 2016-12-20 16:55:59 -05:00

Video.js logo

Video.js - HTML5 Video Player

Build Status Coverage Status Slack Status

NPM

Video.js is a web video player built from the ground up for an HTML5 world. It supports HTML5 and Flash video, as well as YouTube and Vimeo (through plugins). It supports video playback on desktops and mobile devices. This project was started mid 2010, and the player is now used on over 50,000 100,000 200,000 400,000 websites.

Quick Start

Thanks to the awesome folks over at Fastly, there's a free, CDN hosted version of Video.js that anyone can use. Add these tags to your document's <head>:

<link href="//vjs.zencdn.net/5.11/video-js.min.css" rel="stylesheet">
<script src="//vjs.zencdn.net/5.11/video.min.js"></script>

For the latest URLs, check out the Getting Started page on our website.

Next, using Video.js is as simple as creating a <video> element, but with an additional data-setup attribute. At a minimum, this attribute must have a value of '{}', but it can include any Video.js options - just make sure it contains valid JSON!

<video
    id="my-player"
    class="video-js"
    controls
    preload="auto"
    poster="//vjs.zencdn.net/v/oceans.png"
    data-setup='{}'>
  <source src="//vjs.zencdn.net/v/oceans.mp4" type="video/mp4"></source>
  <source src="//vjs.zencdn.net/v/oceans.webm" type="video/webm"></source>
  <source src="//vjs.zencdn.net/v/oceans.ogv" type="video/ogg"></source>
  <p class="vjs-no-js">
    To view this video please enable JavaScript, and consider upgrading to a
    web browser that
    <a href="http://videojs.com/html5-video-support/" target="_blank">
      supports HTML5 video
    </a>
  </p>
</video>

When the page loads, Video.js will find this element and automatically setup a player in its place.

If you don't want to use automatic setup, you can leave off the data-setup attribute and initialize a <video> element manually using the videojs function:

var player = videojs('my-player');

The videojs function also accepts an options object and a callback to be invoked when the player is ready:

var options = {};

var player = videojs('my-player', options, function onPlayerReady() {
  videojs.log('Your player is ready!');

  // In this context, `this` is the player that was created by Video.js.
  this.play();

  // How about an event listener?
  this.on('ended', function() {
    videojs.log('Awww...over so soon?!');
  });
});

If you're ready to dive in, the Getting Started page and documentation are the best places to go for more information. If you get stuck, head over to our Slack channel!

Contributing

Video.js is a free and open source library, and we appreciate any help you're willing to give - whether it's fixing bugs, improving documentation, or suggesting new features. Check out the contributing guide for more!

Video.js uses BrowserStack for compatibility testing.

License

Video.js is licensed under the Apache License, Version 2.0.