2018 你不能错过的 react 插件

#1

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

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

  • 没有只针对 image 懒加载组件。多数组件库都内置了模块、组件、脚本、iframe 懒加载功能,而弱化了 image 懒加载功能。
  • 不支持动画显示效果。
  • 不灵活,可配置度不高。
  • placeholder 不能组件化。
  • 不支持响应式图片( picture / srcset )。

react-lazyimg-component

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

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

  • PC 预览:

使劲猛击这里

  • 手机预览(扫一扫):

qrcode

什么情况需要使用它

1. 小巧轻便,简单易用,基本无学习成本

jq

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

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';

// 调用
<Lazyimg
  className="lazy"
  src={'http://zhansingsong.github.io/lazyimg/22.4582fc71.jpg'}
/>;

是不是很简单,有木有 :stuck_out_tongue_closed_eyes:。上述只是使用 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);

// 调用
<Lazy
  className="lazy"
  src={'http://zhansingsong.github.io/lazyimg/22.4582fc71.jpg'}
/>;

接下来我们来看看 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',

是不是很眼熟 :smile:,如果你熟悉 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.jsanimate.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);
// 调用
<Lazy
  className="lazy"
  src={'http://zhansingsong.github.io/lazyimg/22.4582fc71.jpg'}
/>;

直接上效果了 :stuck_out_tongue_closed_eyes:

  • 指定 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);
  // 调用
  <Lazy
    className="lazy"
    src={'http://zhansingsong.github.io/lazyimg/22.4582fc71.jpg'}
  />;

直接上效果了 :stuck_out_tongue_closed_eyes:

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

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

<div className="example">
  // 指定动画效果作用于该父级元素
  <Title title="父级动画效果" className="sub" />
  <div className="example-img">
    <Lazyimg
      className="lazy"
      src={'http://zhansingsong.github.io/lazyimg/22.4582fc71.jpg'}
      css_effect={['animated', 'flipInY']} // 定制 css 动画效果
      parent=".example" // 指定父级元素选择器,也可以指定父级层级level:2
    />
  </div>
</div>

直接上效果了 :stuck_out_tongue_closed_eyes:

3. react 组件式 placeholder

singsong: 传统的 placeholder 通常都是由图片来代替,为什么不能用组件来定制,这样可扩展性更高。完全可以摆脱设计师的束缚,咋们开发自由发挥:hushed:! 想想有木有有点小鸡冻 :stuck_out_tongue_closed_eyes:~~~~~~

  • 先定义 placeholder 组件
import React from 'react';
import './style.scss';
export default props => {
  let { className, text, img, children } = props;
  return (
    <div
      className={['placeholder', className]
        .filter(item => {
          if (item) {
            return item;
          }
        })
        .join(' ')}
    >
      {img && <img src={img} className="placeholder-img" />}
      {text && <span className="placeholder-text">{children || text}</span>}
    </div>
  );
};
  • 指定 placeholder 配置项为上述定义的 placeholder 组件
// 配置
const Lazy = withLazyimg({
  js_effect: 'transition.perspectiveDownIn',
  placeholder: <Placeholder img={require('./loading.svg')} />,
});
// 调用
<Lazy
  className="lazy"
  src={'http://zhansingsong.github.io/lazyimg/22.4582fc71.jpg'}
/>;

直接上效果了 :stuck_out_tongue_closed_eyes:

…省略好多字…等级太低,只能发5个链接和5张图片… 猛击查看完整文章吧---------->

#2

import 完这个插件报一下错,请问怎么回事

vconsole.min.js:7 Unexpected identifier
/Users/**/node_modules/react-lazyimg-component/lib/index.js:9
import React, { Component } from ‘react’;
^^^^^

SyntaxError: Unexpected identifier
at new Script (vm.js:74:7)
at createScript (vm.js:246:10)
at Object.runInThisContext (vm.js:298:10)
at Module._compile (internal/modules/cjs/loader.js:670:28)
at Module._compile (/Users//node_modules/source-map-support/source-map-support.js:492:25)
at Module._extensions…js (internal/modules/cjs/loader.js:713:10)
at Object._module2.default._extensions.(anonymous function) [as .js] (/Users/
/node_modules/require-hacker/babel-transpiled-modules/require hacker.js:293:60)
at Module.load (internal/modules/cjs/loader.js:612:32)
at tryModuleLoad (internal/modules/cjs/loader.js:551:12)
at Function.Module._load (internal/modules/cjs/loader.js:543:3)

#3

提示是说不支持ES6 module,你可以使用babel解决

#4

刷新后定位到底部,就无法正常加载图片了

先加载一遍,再滑动到底部,再刷新页面,此时停留在底部,但是图片都没有加载,这个时候向下滑动出来也不会加载,除非针对每张图片滑动到底边时才会加载
应该是判断条件有些问题