看完你也想编写自己的 react 插件

摘要：清楚自己想要什么样的组件，就自己动手撸呗。咱们先来看看它的效果吧如果大家有时间，窝还是鼓励大家自己动手实现一些小插件。于是自己就琢磨能否继承使用方法同时保持特有组件特性。需要确保已安装。

副标题----为什么我要写这个 react 插件

图片懒加载是项目中常用的功能，然而现有 react 懒加载组件库，用着都不是很爽了 ?。概括一下有如下几点：

没有只针对 image 懒加载组件。多数组件库都内置了模块、组件、脚本、iframe 懒加载功能，而弱化了 image 懒加载功能。

不支持动画显示效果。

不灵活，可配置度不高。

placeholder 不能组件化。

不支持响应式图片( picture / srcset )。

react-lazyimg-component

清楚自己想要什么样的组件，就自己动手撸呗 ?。于是乎，react-lazyimg-component 就诞生了 ?。咱们先来看看它的效果吧：

singsong: 如果大家有时间，窝还是鼓励大家自己动手实现一些小插件。

PC 预览：

使劲猛击这里

手机预览(扫一扫)：

什么情况需要使用它 1. 小巧轻便，简单易用，基本无学习成本

在那个 jQuery 一统天下的年代，撸代码就用 jQuery 一把梭。其中
jQuery.lazyload 是一个很常用图片懒加载插件。 可能很多像我一样的小伙伴们，懒加载就直接上 jQuery.lazyload，早已习惯了 jQuery.lazyload 使用。 于是自己就琢磨能否继承 jQuery.lazyload 使用方法同时保持 react 特有组件特性。这样可以很快上手~?

singsong: 这里只是继承了 jQuery.lazyload 配置特性，不是完全继承。毕竟 jQuery 与现在主流的 MVVM 框架思想截然不同。

如果小伙伴们熟悉 jQuery.lazyload ， 完全没有学习成本直接上手 react-lazyimg-component 哈。 只说不是写，然并卵。那我们来看看它到底好用不：

安装

// npm
$> npm install react-lazyimg-component
// yarn
$> yarn add react-lazyimg-component

使用

// 引入
import Lazyimg, { withLazyimg } from "react-lazyimg-component";

// 调用
;

是不是很简单，有木有 ?。上述只是使用 react-lazyimg-component 的默认配置。 这里我们可以通过配置项来定制懒加载的行为：

// 引入 lazyimg
import Lazyimg, { withLazyimg } from "react-lazyimg-component";
// 引入 volecity.js
import "velocity-animate";
import "velocity-animate/velocity.ui";

// 配置
const config = {
  threshold: 100, // 指定触发阈值
  js_effect: "transition.fadeIn", // 支持 velocity.js 动画效果
};
// 基于配置项生成对应 Lazy 组件
const Lazy = withLazyimg(config);

// 调用
;

接下来我们来看看 react-lazyimg-component 都那些配置项：

threshold: 0, // 指定距离底部多少距离时触发加载
event: "scroll", // 指定触发事件，默认为"scroll"
js_effect: undefined, // 显示图片的js动画效果
css_effect: undefined, // 显示图片的css动画效果
container: window, // 指定容器，默认为window
parent: undefined, // 可以指定动画效果作用于元素的哪个父级元素
appear: null, // 元素出现在可视窗口时触发appear钩子函数
load: null,  // 元素图片的加载完后触发load钩子函数
error: null, // 图片加载出错时触发error钩子函数
node_type: "img", // 指定生成的节点类型，默认为"img"
placeholder: // 占位元素，除了支持普通的图片外，还支持react组件。
  "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAANSURBVBhXYzh8+PB/AAffA0nNPuCLAAAAAElFTkSuQmCC",

是不是很眼熟 ?，如果你熟悉 jquery.lazyload，那么你只需了解如下几个配置项即可：

js_effect: 指定元素显示的动画效果，基于velocity.js动画实现。使用之前需加载velocity.js。

css_effect: 指定元素显示的动画效果，基于animate.css动画实现。使用之前需安装animate.css。

parent: 用于指定动画效果作用于元素的哪个父级元素。可取值：

父元素的 selector 选择器（字符串）

父级层级 level（整数）

node_type: 指定 react 将生成的元素类型，默认为"img"。

placeholder: 占位元素，除了支持普通的图片外，还支持 react 组件。

2. 支持 velocity.js、animate.css 动画效果库，及自定动画效果。同时还支持动画效果作用于父级元素。

指定 js-effect 配置项来配置 velocity.js 动画效果

注意：js-effect 依赖于 velocity.js。需要确保 velocity.js 已加载。

// 引入 lazyimg
import Lazyimg, { withLazyimg } from "react-lazyimg-component";
// 引入 volecity.js
import "velocity-animate";
import "velocity-animate/velocity.ui";
// 配置
const config = {
  placeholder: "loading.svg",
  js_effect: "transition.fadeIn", // 支持 velocity.js 动画效果
};
const Lazy = withLazyimg(config);
// 调用
;

直接上效果了 ?

指定 css-effect 配置项来配置 animate.css 动画效果

注意：css-effect 依赖于 animate.css。需要确保 animate.css 已安装。

  // 配置
  const config = {
    js_effect="transition.flipXIn" // 不会生效
    css_effect={["animated", "rollIn"]} // 定制 css 动画效果
  };
  const Lazy = withLazyimg(config);
  // 调用
  ;

直接上效果了 ?

指定 parent 配置项指定父级元素动画效果

singsong: 为什么懒加载的动画效果只作用于目标元素，某些条件下作用于目标元素的父级元素会有意想不到效果哦 ?。

  // 指定动画效果作用于该父级元素