ngx-lite-video

ngx-lite-video is an Angular package that provides lazy loading capabilities for embedded iframes from popular video sharing platforms like YouTube and Vimeo. The package is designed to optimize the loading of embedded videos, improving page load times and reducing data usage.

The package is built specifically for Angular, utilizing Angular's onpush change detection strategy for efficient rendering and updating of video components. It also includes features such as customizable lazy loading thresholds and options for controlling video playback and display.

This package requires a minimum of Angular version 13 and rxjs version 7.2 to function properly.

Try it yourself by measuring the performance on Demo page

Key Features

• Lazy loads embedded iframes for YouTube and Vimeo videos
• Built specifically for Angular
• Uses Angular OnPush change detection for optimized performance
• Customizable options including video quality, start time, and more
• Provides a seamless user experience by loading videos only when needed

Install

npm install ngx-lite-video --save

Once installed, import the module that you wish to use in your desired module

@NgModule({
  //...
  imports: [
    //...
    NgxLiteVimeoModule, // Vimeo lite module
    NgxLiteYoutubeModule, // YouTube lite module
  ],
})
export class YourModule {}

Usage

To use ngx-lite-video, add the 'ngx-lite-youtube'/'ngx-lite-vimeo' component to your template and configure its properties as needed:

<!-- YouTube Component -->
<ngx-lite-youtube videoId="Ys7xdebd66Y"></ngx-lite-youtube>

<!-- Vimeo Component -->
<ngx-lite-vimeo videoId="786570322"></ngx-lite-vimeo>

Custom styles

To override styling create a class in global style.scss file & provide it to styleClass attribute

For more detailed examples see Demo page

API

YouTube Attributes

| Property | Type | Default | Description | | --------------- | ------- | --------- | -------------------------------------------- | | videoId | string | undefined | Video ID to be viewed | | videoTitle | string | undefined | Title to be displayed in lazy mode | | hasControls | boolean | false | Shows/hides video controls in iframe | | loop | boolean | false | Enables video looping | | allowFullScreen | boolean | true | Enables/disables fullscreen button in iframe | | start | number | undefined | Sets starting video time (in seconds) | | end | number | undefined | Sets ending video time (in seconds) | | styleClass | string | undefined | External styling class | | thumbQuality | 'sd', 'medium', 'high', 'max' | 'high' | Lazy image quality |

Vimeo Attributes

| Property | Type | Default | Description | | ------------ | ------------------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | videoId | string | undefined | Video ID to be viewed | | thumbQuality | 'sd', 'medium', 'high', 'max' | 'high' | Lazy image quality | | showTitle | boolean | false | Enables/disables showing title in lazy mode | | hasControls | boolean | false | Shows/hides video controls in iframe | | loop | boolean | false | Enables video looping | | isBackground | boolean | false | Enables vimeo background mode, please refer to https://developer.vimeo.com/player/sdk/embed | | styleClass | string | undefined | External styling class |

Contributing

Contributions are welcome. You can start by creating new Issue with proposal or bug report.

License

ngx-lite-video is an open source package released under the MIT license. See the LICENSE file for more information.