plyr README

The project's README from github.com/sampotts/plyr. As one markdown file: README.md.

Plyr is a simple, lightweight, accessible and customizable HTML5, YouTube and Vimeo media player that supports modern browsers.

Checkout the demo - Donate - Slack - Video hosting

npm version Gitpod Ready-to-Code Financial Contributors on Open Collective

Screenshot of Plyr

Features

Demos

You can try Plyr in Codepen using our minimal templates: HTML5 video, HTML5 audio, YouTube, Vimeo. For Streaming we also have example integrations with: Dash.js, Hls.js and Shaka Player

Quick setup

HTML

Plyr extends upon the standard HTML5 media element markup so that's all you need for those types.

HTML5 Video

<video id="player" playsinline controls data-poster="/path/to/poster.jpg">
  <source src="/path/to/video.mp4" type="video/mp4" />
  <source src="/path/to/video.webm" type="video/webm" />

  <!-- Captions are optional -->
  <track kind="captions" label="English captions" src="/path/to/captions.vtt" srclang="en" default />
</video>

Note: The poster image should be specified using data-poster. This is to prevent it being downloaded twice. If you're sure the image will be cached, you can still use the poster attribute for true progressive enhancement.

HTML5 Audio

<audio id="player" controls>
  <source src="/path/to/audio.mp3" type="audio/mp3" />
  <source src="/path/to/audio.ogg" type="audio/ogg" />
</audio>

For YouTube and Vimeo players, Plyr uses progressive enhancement to enhance the default <iframe> embeds. Below are some examples. The plyr__video-embed classname will make the embed responsive. You can add the autoplay, loop, hl (YouTube only) and playsinline (YouTube only) query parameters to the URL and they will be set as config options automatically. For YouTube, the origin should be updated to reflect the domain you're hosting the embed on, or you can opt to omit it.

YouTube

We recommend progressive enhancement with the embedded players. You can elect to use an <iframe> as the source element (which Plyr will progressively enhance) or a bog standard <div> with two essential data attributes - data-plyr-provider and data-plyr-embed-id.

<div class="plyr__video-embed" id="player">
  <iframe
    src="https://www.youtube.com/embed/bTqVqk7FSmY?origin=https://plyr.io&amp;iv_load_policy=3&amp;modestbranding=1&amp;playsinline=1&amp;showinfo=0&amp;rel=0&amp;enablejsapi=1"
    allowfullscreen
    allowtransparency
    allow="autoplay"
  ></iframe>
</div>

Note: The plyr__video-embed classname will make the player a responsive 16:9 (most common) iframe embed. When plyr itself kicks in, your custom ratio config option will be used.

Or the <div> non progressively enhanced method:

<div id="player" data-plyr-provider="youtube" data-plyr-embed-id="bTqVqk7FSmY"></div>

Note: The data-plyr-embed-id can either be the video ID or URL for the media.

Vimeo

Much the same as YouTube above.

<div class="plyr__video-embed" id="player">
  <iframe
    src="https://player.vimeo.com/video/76979871?loop=false&amp;byline=false&amp;portrait=false&amp;title=false&amp;speed=true&amp;transparent=0&amp;gesture=media"
    allowfullscreen
    allowtransparency
    allow="autoplay"
  ></iframe>
</div>

Or the <div> non progressively enhanced method:

<div id="player" data-plyr-provider="vimeo" data-plyr-embed-id="76979871"></div>

JavaScript

You can use Plyr as an ES6 module as follows:

import Plyr from 'plyr';

const player = new Plyr('#player');

Alternatively you can include the plyr.js script before the closing </body> tag and then in your JS create a new instance of Plyr as below.

<script src="path/to/plyr.js"></script>
<script>
  const player = new Plyr('#player');
</script>

See initialising for more information on advanced setups.

You can use our CDN (provided by Cloudflare) for the JavaScript. There's 2 versions; one with and one without polyfills. My recommendation would be to manage polyfills separately as part of your application but to make life easier you can use the polyfilled build.

<script src="https://cdn.plyr.io/3.8.4/plyr.js"></script>

...or...

<script src="https://cdn.plyr.io/3.8.4/plyr.polyfilled.js"></script>

CSS

Include the plyr.css stylesheet into your <head>.

<link rel="stylesheet" href="path/to/plyr.css" />

If you want to use our CDN (provided by Cloudflare) for the default CSS, you can use the following:

<link rel="stylesheet" href="https://cdn.plyr.io/3.8.4/plyr.css" />

SVG Sprite

The SVG sprite is loaded automatically from our CDN (provided by Cloudflare). To change this, see the options below. For reference, the CDN hosted SVG sprite can be found at https://cdn.plyr.io/3.8.4/plyr.svg.

Self hosting

If you don't want to create a build system to include Plyr as an npm module, you can use the pre-built files. You have a few options:

Ads

Plyr has partnered up with vi.ai to offer monetization options for your videos. Getting setup is easy:

Any questions regarding the ads can be sent straight to vi.ai and any issues with rendering raised through GitHub issues.

If you do not wish to use Vi, you can set your own ads.tagUrl option.

Advanced

Customizing the CSS

If you want to change any design tokens used for the rendering of the player, you can do so using CSS Custom Properties.

Here's a list of the properties and what they are used for:

Name Description Default / Fallback
--plyr-color-main The primary UI color. #f03c15 #00b3ff
--plyr-video-background The background color of video and poster wrappers for using alpha channel videos and poster images. rgba(0, 0, 0, 1)
--plyr-focus-visible-color The color used for the focus styles when an element is :focus-visible (keyboard focused). --plyr-color-main
--plyr-badge-background The background color for badges in the menu. #4a5464 #4a5464
--plyr-badge-text-color The text color for badges. #ffffff #ffffff
--plyr-badge-border-radius The border radius used for badges. 2px
--plyr-captions-background The color for the background of captions. rgba(0, 0, 0, 0.8)
--plyr-captions-text-color The color used for the captions text. #ffffff #ffffff
--plyr-control-icon-size The size of the icons used in the controls. 18px
--plyr-control-spacing The space between controls (sometimes used in a multiple - e.g. 10px / 2 = 5px). 10px
--plyr-control-padding The padding inside controls. --plyr-control-spacing * 0.7 (7px)
--plyr-control-radius The border radius used on controls. 3px
--plyr-control-toggle-checked-background The background color used for checked menu items. --plyr-color-main
--plyr-video-controls-background The background for the video controls. linear-gradient(rgba(0, 0, 0, 0), rgba(0, 0, 0, 0.75))
--plyr-video-control-color The text/icon color for video controls. #ffffff #ffffff
--plyr-video-control-color-hover The text/icon color used when video controls are :hover, :focus and :focus-visible (equivalent). #ffffff #ffffff
--plyr-video-control-background-hover The background color used when video controls are :hover, :focus and :focus-visible (equivalent). --plyr-color-main
--plyr-audio-controls-background The background for the audio controls. #ffffff #ffffff
--plyr-audio-control-color The text/icon color for audio controls. #4a5464 #4a5464
--plyr-audio-control-color-hover The text/icon color used when audio controls are :hover, :focus and :focus-visible (equivalent). #ffffff #ffffff
--plyr-audio-control-background-hover The background color used when video controls are :hover, :focus and :focus-visible (equivalent). --plyr-color-main
--plyr-menu-background The background color for menus. rgba(255, 255, 255, 0.9)
--plyr-menu-color The text/icon color for menu items. #4a5464 #4a5464
--plyr-menu-shadow The shadow used on menus. 0 1px 2px rgba(0, 0, 0, 0.15)
--plyr-menu-radius The border radius on the menu. 4px
--plyr-menu-arrow-size The size of the arrow on the bottom of the menu. 6px
--plyr-menu-item-arrow-color The color of the arrows in the menu. #728197 #728197
--plyr-menu-item-arrow-size The size of the arrows in the menu. 4px
--plyr-menu-border-color The border color for the bottom of the back button in the top of the sub menu pages. #dcdfe5 #dcdfe5
--plyr-menu-border-shadow-color The shadow below the border of the back button in the top of the sub menu pages. #ffffff #ffffff
--plyr-progress-loading-size The size of the stripes in the loading state in the scrubber. 25px
--plyr-progress-loading-background The background color on the loading state in the scrubber. rgba(35, 40, 47, 0.6)
--plyr-video-progress-buffered-background The fill color for the buffer indication in the scrubber for video. rgba(255, 255, 255, 0.25)
--plyr-audio-progress-buffered-background The fill color for the buffer indication in the scrubber for audio. rgba(193, 200, 209, 0.6)
--plyr-range-thumb-height The height of the scrubber handle/thumb. 13px
--plyr-range-thumb-background The background of the scrubber handle/thumb. #ffffff #ffffff
--plyr-range-thumb-shadow The shadow of the scrubber handle/thumb. 0 1px 1px rgba(215, 26, 18, 0.15), 0 0 0 1px rgba(215, 26, 18, 0.2)
--plyr-range-thumb-active-shadow-width The width of the shadow when the scrubber handle/thumb is :active (pressed). 3px
--plyr-range-track-height The height of the scrubber/progress track. 5px
--plyr-range-fill-background The fill color of the scrubber/progress. --plyr-color-main
--plyr-video-range-track-background The background of the scrubber/progress. --plyr-video-progress-buffered-background
--plyr-video-range-thumb-active-shadow-color The color of the shadow when the video scrubber handle/thumb is :active (pressed). rgba(255, 255, 255, 0.5)
--plyr-audio-range-track-background The background of the scrubber/progress. --plyr-video-progress-buffered-background
--plyr-audio-range-thumb-active-shadow-color The color of the shadow when the audio scrubber handle/thumb is :active (pressed). rgba(215, 26, 18, 0.1)
--plyr-tooltip-background The background color for tooltips. rgba(255, 255, 255, 0.9)
--plyr-tooltip-color The text color for tooltips. #4a5464 #4a5464
--plyr-tooltip-padding The padding for tooltips. `calc(

plyr (sampotts/plyr)

Searching Database…

30K ·GitHub
Plyr
这是什么?Plyr 是一个简单、轻量、无障碍且可自定义的 HTML5、YouTube 和 Vimeo 媒体播放器,支持各种现代浏览器。
它是要加到我自己网页里的库,还是托管服务?是一个 JavaScript 库:你引入 plyr.css 和 plyr.js——可以通过 npm 模块、普通的 script 标签或 Cloudflare 托管的 CDN——然后在你的媒体元素上初始化 Plyr。
怎么在页面上添加一个播放器?对于 HTML5 视频和音频,只需按标准写法写媒体标签——Plyr 会在其基础上进行扩展(封面图可用 data-poster)。对于 YouTube 和 Vimeo,让 Plyr 对默认嵌入代码做渐进式增强,或者设置 data-plyr-provider 和 data-plyr-embed-id 属性。
它需要 jQuery 或某个框架吗?不需要——Plyr 用原生 ES6 JavaScript 编写,不依赖 jQuery 或任何框架;如果你需要支持旧版浏览器,还有一个做了 polyfill 的 CDN 版本。
它还在积极维护吗?没有——Plyr 已被弃用,官方推荐改用 Video.js 10,目前只提供安全更新,所以在基于它开发新项目之前要先权衡一下。
它能播放哪些媒体来源?主要格式的 HTML5 视频和音频、YouTube 和 Vimeo 嵌入,另外通过 hls.js、Shaka Player 和 dash.js 还支持自适应流媒体——README 里每种都有示例集成。
我能用自己的代码控制播放和监听事件吗?可以——它提供一套统一的 API,涵盖播放/暂停、音量、进度跳转等操作,事件在 HTML5、YouTube 和 Vimeo 之间也做了统一处理,你完全不用去碰它们各自不同的播放器 API。
我能让播放器配合我自己网站的设计风格吗?可以——所有样式都通过 CSS Custom Properties(自定义属性)控制(主题色、控件间距、字幕颜色、菜单等),你可以使用自己的标记结构,还提供了 Sass 源码方便集成到构建流程中。
播放器内置了哪些功能?带全窗口兜底的全屏模式、键盘快捷键、画中画、playsinline 内联播放、实时倍速调节、支持屏幕阅读器的多条 VTT 字幕轨道、预览缩略图,以及控件的多语言(i18n)支持。
What are similar projects?video.js, react-player, material, sweetalert2, bootstrap-table, shoelace, fathom, draft-js
Which topics is it in?media-player, video-player, subtitles, youtube, accessibility, i18n, javascript-library, audio, streaming, customization, deprecated, css
Creator
sampotts
Size
65.1 MB
Stars
30K
Updated
CommitOct 07Releasev3.8.5Oct 06
Age
11y
Commits · 90 Days