# react-lazy-media

> Lazy load image, picture, video, and iframe media React components

Latest version **0.3.1** (published 2019-10-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install react-lazy-media
pnpm add react-lazy-media
yarn add react-lazy-media
bun add react-lazy-media
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.3.1 |
| Published | 2019-10-16 |
| First published | 2019-07-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 42.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 11 |
| Author | Sam Rubin |
| Maintainers | smrubin |
| Keywords | react, lazyload, lazy, load, image, video, picture, webp |

## Links

- npm: https://www.npmjs.com/package/react-lazy-media
- Repository: https://github.com/smrubin/react-lazy-media
- Homepage: https://github.com/smrubin/react-lazy-media#readme
- Issues: https://github.com/smrubin/react-lazy-media/issues
- npm.io page: https://npm.io/package/react-lazy-media

## Dependencies (4)

- [yall-js](https://npm.io/package/yall-js.md) ^3.1.5
- [classnames](https://npm.io/package/classnames.md) ^2.2.6
- [prop-types](https://npm.io/package/prop-types.md) ^15.7.2
- [intersection-observer](https://npm.io/package/intersection-observer.md) ^0.7.0

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 0.3.1 (latest) — 2019-10-16
- 0.3.0 — 2019-09-25
- 0.2.7 — 2019-08-06
- 0.2.6 — 2019-08-06
- 0.2.5 — 2019-08-06
- 0.2.4 — 2019-08-06
- 0.2.3 — 2019-08-06
- 0.2.2 — 2019-08-02
- 0.2.1 — 2019-08-01
- 0.2.0 — 2019-08-01
- 0.1.2 — 2019-07-31
- 0.1.1 — 2019-07-30
- 0.1.0 — 2019-07-30

## README

## react-lazy-media

[![npm](https://img.shields.io/npm/v/react-lazy-media.svg)](https://www.npmjs.com/package/react-lazy-media)
[![Build Status](https://travis-ci.com/smrubin/react-lazy-media.svg?branch=master)](https://travis-ci.com/smrubin/react-lazy-media)
[![GitHub license](https://img.shields.io/github/license/smrubin/react-lazy-media.svg)](https://github.com/smrubin/react-lazy-media/blob/master/LICENSE)

Lazy load image, picture, video, and iframe media React components. react-lazy-media uses [yall-js](https://github.com/malchata/yall.js) under the hood to handle lazy loading.

Polyfilled with the [Intersection Observer Polyfill](https://www.npmjs.com/package/intersection-observer)

<table>
  <tr>
    <td align="center">
      <img src="https://raw.github.com/alrra/browser-logos/39.2.2/src/chrome/chrome_48x48.png" alt="Chrome"><br>
      ✔
    </td>
    <td align="center">
      <img src="https://raw.github.com/alrra/browser-logos/39.2.2/src/firefox/firefox_48x48.png" alt="Firefox"><br>
      ✔
    </td>
    <td align="center">
      <img src="https://raw.github.com/alrra/browser-logos/39.2.2/src/safari/safari_48x48.png" alt="Safari"><br>
      6+
    </td>
    <td align="center">
      <img src="https://raw.github.com/alrra/browser-logos/39.2.2/src/edge/edge_48x48.png" alt="Edge"><br>
      ✔
    </td>
    <td align="center">
      <img src="https://raw.github.com/alrra/browser-logos/39.2.2/src/archive/internet-explorer_7-8/internet-explorer_7-8_48x48.png" alt="Internet Explorer"><br>
      10+
    </td>
    <td align="center">
      <img src="https://raw.github.com/alrra/browser-logos/39.2.2/src/opera/opera_48x48.png" alt="Opera"><br>
      ✔
    </td>
    <td align="center">
      <img src="https://raw.github.com/alrra/browser-logos/39.2.2/src/android/android_48x48.png" alt="Android"><br>
      4.4+
    </td>
  </tr>
</table>

### Installation and Usage:

```
npm i -S react-lazy-media
```

#### Include the Component:

```
import React from 'react'
import { LazyImage } from 'react-lazy-media'

class Component extends React.Component {

  render() {
    return (
      <LazyImage
        classes={['myLazyImage']}
        src={'./hero.png'}
      />
    );
  }
}
```

You can import `LazyImage` `LazyVideo` `LazyIframe` `LazyBackground` `LazyWebpPicture` respectively.

### Component Examples

#### Common

The following APIs are shared by every component.

| Name    | Type          | Default | Description                                                                              |
| ------- | ------------- | ------- | ---------------------------------------------------------------------------------------- |
| classes | Array<string> | `[]`    | Additional CSS classes (in addition to 'lazy' for the media element (img, video, iframe) |
| id      | string        | `''`    | id for the media element (img, video, iframe)                                            |

#### LazyImage

Lazy loads an image element. Supports loading a low-quality image placeholder.

| Name   | Type              | Default          | Description                                                                                          |
| ------ | ----------------- | ---------------- | ---------------------------------------------------------------------------------------------------- |
| alt    | string            | `[]`             | Alt text for the img                                                                                 |
| src    | string (Required) | `N/A - Required` | src for the img                                                                                      |
| width  | string            | `''`             | width for the img                                                                                    |
| height | string            | `''`             | height for the img                                                                                   |
| lqip   | string            | `''`             | src for a loq quality image placeholder. will always be loaded and then replaced with actual src img |

#### LazyBackground

Lazy loads a background image for a div.

| Name | Type              | Default          | Description                  |
| ---- | ----------------- | ---------------- | ---------------------------- |
| src  | string (Required) | `N/A - Required` | src for the background image |

#### LazyVideo

Lazy loads an HTML5 video.

| Name     | Type              | Default          | Description                                        |
| -------- | ----------------- | ---------------- | -------------------------------------------------- |
| src      | string (Required) | `N/A - Required` | src for the video                                  |
| width    | string            | `''`             | width for the video                                |
| height   | string            | `''`             | height for the video                               |
| poster   | string            | `''`             | poster image for the video (before it loads/plays) |
| controls | bool              | `true`           | whether or not the video should display controls   |
| preload  | bool              | `false`          | whether or not the video should be preloaded       |
| autoplay | bool              | `false`          | whether or not the video should autoplay           |
| loop     | bool              | `false`          | whether or not the video should loop               |
| muted    | bool              | `false`          | whether or not the video should be muted           |

#### LazyIframe

Lazy loads an iframe.

| Name | Type              | Default          | Description        |
| ---- | ----------------- | ---------------- | ------------------ |
| src  | string (Required) | `N/A - Required` | src for the iframe |

#### LazyWebpPicture

Lazy loads an HTML5 picture. Attempts to load a Webp version of the asset first, and falls back to original src. Most of the props are passed down to the `LazyImage` child of this component.

| Name   | Type              | Default          | Description                                                                                          |
| ------ | ----------------- | ---------------- | ---------------------------------------------------------------------------------------------------- |
| alt    | string            | `[]`             | Alt text for the img                                                                                 |
| src    | string (Required) | `N/A - Required` | src for the img                                                                                      |
| width  | string            | `''`             | width for the img                                                                                    |
| height | string            | `''`             | height for the img                                                                                   |
| lqip   | string            | `''`             | src for a loq quality image placeholder. will always be loaded and then replaced with actual src img |
| webp   | string            | `''`             | The webp src for the img. Will suffix the src prop of not provided (e.g. hero.png => hero.png.webp)  |

#### Todo

[] Add more configurable component: LazyPicture
[] Add code example for each component in readme

---
_Source: https://npm.io/package/react-lazy-media · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
