react框架引入第三方插件

原链接gitHub:GitHub - hustcc/echarts-for-react: ⛳ Apache ECharts components for React wrapper. 一个简单的 Apache echarts 的 React 封装。

import ReactECharts from 'echarts-for-react';
import * as echarts from 'echarts';

一、软件简介

echarts-for-react 是一个简单的 echarts (v3.0) 的 react 封装。

安装：

npm install echarts-for-react

运行demo:

git clone git@github.com:hustcc/echarts-for-react.git

npm install

npm start

案例：

import ReactEcharts from 'echarts-for-react';
import echarts from 'echarts';
<ReactEcharts
option={this.getOption()}
notMerge={true}
lazyUpdate={true}
onEvents={onEvents}
style={{width: '100%',height:'100%'}}
/>

二、使用步骤

下载

npm install --save echarts-for-react

引入

import ReactEcharts for 'echarts-for-react'

代码在render或return使用

<ReactEcharts 参数/>

参数

option:图表配置项，必填。

notMerge:默认false，合并。是否不跟之前设置的option合并。

lazyUpdata：默认false,立即更新。在option设置后，是否不立即更新。

style:默认{height:'300px'}。

className:DOM元素的style。

theme:在使用前需要注册。echarts.registerTheme('属性名'，属性值)。

onChartReady:当图表渲染完成，将会调用的方法。

loadingOption:加载动画的配置项。

showLoading:默认false，显示加载动画效果。

onEvents:绑定echarts事件，即通过echarts事件对象回调。

opts：ecahrt事件，通过ecahrts附加参数，将在echarts实例的初始化时被调用。

autoResize:默认true，当window resize决定是否去触发 this.resize。

ReactEcharts组件只有一个API。‘getEchartsInstance’此方法可获取echarts实例对象，从而调用echarts实例的所有API。

echart的一些参数options

官方文档：Documentation - Apache ECharts

一、概述

title:标题。

color:颜色配置。

tooltip:提示框配置。

toolBox:工具箱组件。

grid:调整图的位置，控制图标的大小。

xAxis:x轴配置。

yAxis:y轴配置。

legend:图例配置。

series:图表配置。

二、详细讲解

1.title:图表的title。

title标题的属性

2.tooltip:提示框配置

tooltip提示框的属性

3.grid:调整图的位置，控制图标的大小。

grid调整图的位置

4.xAxis:x轴配置。

5.yAxis:y轴配置。

x/y轴的参数

6.legend:图例配置。

legend图例配置

7.series:图表配置。

series图表的参数

三、常用的一些参数options

1.举例

    //1.标题
    title : {
        show:true, //显示策略，默认值true,可选为：true（显示） | false（隐藏）
        text: '主标题', //主标题文本，'\n'指定换行
        link:'', //主标题文本超链接,默认值true
        target: null, //指定窗口打开主标题超链接，支持'self' | 'blank'，不指定等同为'blank'（新窗口）
        subtext: '副标题', //副标题文本，'\n'指定换行
        sublink: '', //副标题文本超链接
        subtarget: null, //指定窗口打开副标题超链接，支持'self' | 'blank'，不指定等同为'blank'（新窗口）
        x:'center' //水平安放位置，默认为'left'，可选为：'center' | 'left' | 'right' | {number}（x坐标，单位px）
        y: 'top', //垂直安放位置，默认为top，可选为：'top' | 'bottom' | 'center' | {number}（y坐标，单位px）
        textAlign: null ,//水平对齐方式，默认根据x设置自动调整，可选为： left' | 'right' | 'center
        backgroundColor: 'rgba(0,0,0,0)', //标题背景颜色，默认'rgba(0,0,0,0)'透明
        borderColor: '#ccc', //标题边框颜色,默认'#ccc'
        borderWidth: 0, //标题边框线宽，单位px，默认为0（无边框）
        padding: 5, //标题内边距，单位px，默认各方向内边距为5，接受数组分别设定上右下左边距
        itemGap: 10, //主副标题纵向间隔，单位px，默认为10
        textStyle: { //主标题文本样式{"fontSize": 18,"fontWeight": "bolder","color": "#333"}
            fontFamily: 'Arial, Verdana, sans...',
            fontSize: 12,
            fontStyle: 'normal',
            fontWeight: 'normal',
        },
        subtextStyle: {//副标题文本样式{"color": "#aaa"}
            fontFamily: 'Arial, Verdana, sans...',
            fontSize: 12,
            fontStyle: 'normal',
            fontWeight: 'normal',
        },
        zlevel: 0, //一级层叠控制。默认0,每一个不同的zlevel将产生一个独立的canvas，相同zlevel的组件或图标将在同一个canvas上渲染。zlevel越高越靠顶层，canvas对象增多会消耗更多的内存和性能，并不建议设置过多的zlevel，大部分情况可以通过二级层叠控制z实现层叠控制。
        z: 6, //二级层叠控制，默认6,同一个canvas（相同zlevel）上z越高约靠顶层。
    },
    //2.提示框，鼠标悬浮交互时的信息提示
    tooltip : {
        trigger: 'item',
        formatter: "{a} <br/>{b} : {c} ({d}%)"
    },
    //3.图例，每个图表最多仅有一个图例
    legend: {
        orient: 'vertical',
        left: 'left',
        data: ['第一部分','第二部分','第三部分','第四部分']
    },
    // 4.图表,每个系列通过 type 决定自己的图表类型
    series : [
        {
            name: '访问',
            type: 'pie',
            radius : '62%',
            center: ['50%', '65%'],/
            minAngle:'15',
            data:[
                {name:"第一部分",value:4},
                {name:"第二部分",value:7},
                {name:"第三部分",value:3},
                {name:"第四部分",value:1},
            ],
            itemStyle: {
                normal:{
                    label:{
                        show:true,
                        formatter: "{b} :\n  {c} \n ({d}%)",
                        position:"inner"
                    }
                }
            }
        }
    ],
};

2.tooltip图表摸上去的工具提示框的formatter的a/b/c/d的代表的含义不一样

大屏的一些配置

一、背景概述

农业项目的首页要展示一些可视化数据，会考虑放置场景，例如大屏、电脑、笔记本等。考虑适配、以及大屏显示效果。

二、实现思路：布局考虑flex+rem，左右侧占比考虑使用百分数。

宽高可使用vw/vh,但是需要设置最小宽高度，以免小屏压缩排班错位。

字体尺寸使用rem。

Echarts图标尺寸使用echartsSize转换。

三、实现步骤

(一)、概述

px转换rem，使用转换插件flexible.js。

安装px2rem-loader

npm install px2rem-loader --save-dev

配置px2rem-loader

其它注意事项。

注意说明:
1、有关px的样式不能写内联样式(style),只能写class
2、最外层图层宽高可使用100vw，100vh。内部模块视情况而定(可采用百分比或者px)，建议高度使用vh。
3、自适应屏幕的前提需要保证最终大屏尺寸完整适配，在兼容其他设备屏幕适配。
4、文字的大小，图片的大小不能默认适配，必须设置宽高尺寸，文字尺寸，不然无法转换rem。切换大屏尺寸大小不会改变。

(二)、详细解释

flexible.js文件和安装的插件一样吗？

(function(win, lib) {
  let doc = win.document
  let docEl = doc.documentElement
  let metaEl = doc.querySelector('meta[name="viewport"]')
  let flexibleEl = doc.querySelector('meta[name="flexible"]')
  let dpr = 0
  let scale = 0
  let tid
  let flexible = lib.flexible || (lib.flexible = {})

  if (metaEl) {
    console.warn('将根据已有的meta标签来设置缩放比例')
    let match = metaEl.getAttribute('content').match(/initial\-scale=([\d\.]+)/)
    if (match) {
      scale = parseFloat(match[1])
      dpr = parseInt(1 / scale)
    }
  } else if (flexibleEl) {
    let content = flexibleEl.getAttribute('content')
    if (content) {
      let initialDpr = content.match(/initial\-dpr=([\d\.]+)/)
      let maximumDpr = content.match(/maximum\-dpr=([\d\.]+)/)
      if (initialDpr) {
        dpr = parseFloat(initialDpr[1])
        scale = parseFloat((1 / dpr).toFixed(2))
      }
      if (maximumDpr) {
        dpr = parseFloat(maximumDpr[1])
        scale = parseFloat((1 / dpr).toFixed(2))
      }
    }
  }

  if (!dpr && !scale) {
    let isAndroid = win.navigator.appVersion.match(/android/gi)
    let isIPhone = win.navigator.appVersion.match(/iphone/gi)
    let devicePixelRatio = win.devicePixelRatio
    if (isIPhone) {
      // iOS下，对于2和3的屏，用2倍的方案，其余的用1倍方案
      if (devicePixelRatio >= 3 && (!dpr || dpr >= 3)) {
        dpr = 3
      } else if (devicePixelRatio >= 2 && (!dpr || dpr >= 2)) {
        dpr = 2
      } else {
        dpr = 1
      }
    } else {
      // 其他设备下，仍旧使用1倍的方案
      dpr = 1
    }
    scale = 1 / dpr
  }

  docEl.setAttribute('data-dpr', dpr)
  if (!metaEl) {
    metaEl = doc.createElement('meta')
    metaEl.setAttribute('name', 'viewport')
    metaEl.setAttribute('content', 'initial-scale=' + scale + ', maximum-scale=' + scale + ', minimum-scale=' + scale + ', user-scalable=no')
    if (docEl.firstElementChild) {
      docEl.firstElementChild.appendChild(metaEl)
    } else {
      let wrap = doc.createElement('div')
      wrap.appendChild(metaEl)
      doc.write(wrap.innerHTML)
    }
  }

  function refreshRem() {
    let width = docEl.getBoundingClientRect().width
    if (width / dpr > 540) {
      width = width * dpr
    }
    let rem = width / 10
    docEl.style.fontSize = rem + 'px'
    flexible.rem = win.rem = rem
  }

  win.addEventListener('resize', function() {
    clearTimeout(tid)
    tid = setTimeout(refreshRem, 300)
  }, false)
  win.addEventListener('pageshow', function(e) {
    if (e.persisted) {
      clearTimeout(tid)
      tid = setTimeout(refreshRem, 300)
    }
  }, false)

  if (doc.readyState === 'complete') {
    doc.body.style.fontSize = 12 * dpr + 'px'
  } else {
    doc.addEventListener('DOMContentLoaded', function(e) {
      doc.body.style.fontSize = 12 * dpr + 'px'
    }, false)
  }


  refreshRem()

  flexible.dpr = win.dpr = dpr
  flexible.refreshRem = refreshRem
  flexible.rem2px = function(d) {
    let val = parseFloat(d) * this.rem
    if (typeof d === 'string' && d.match(/rem$/)) {
      val += 'px'
    }
    return val
  }
  flexible.px2rem = function(d) {
    let val = parseFloat(d) / this.rem
    if (typeof d === 'string' && d.match(/px$/)) {
      val += 'rem'
    }
    return val
  }

})(window, window['lib'] || (window['lib'] = {}))

2.在根目录新建config-override.js文件

代码配置flexible的文件：

/**
 * 一、配置flexible文件
 *   由于react未暴露webpack文件。有两种方法
 *   1. 通过npm run eject命令可以将隐藏的wabpack文件暴露出来，但此方法不可逆
 *   2. 通过 react-app-rewired 插件来覆盖配置文件
 * 二、在根目录新建config-override.js文件
 */
const { override, addPostcssPlugins } = require('customize-cra');
const path = require('path'); //配置别名
module.exports = override(
  /**
   * 对大屏的插件进行配置1，可选
   */
  addPostcssPlugins([
    require('postcss-px2rem-exclude'),
    {
      remUnit: 75, //设计图大小
      remPrecision: 2, //只转换到两位小数
      exclude: /node_modules/i, //插件不需要转rem
    },
  ]),
  /**
   * 对大屏的插件进行配置2，可选
   */
  require('@njleonzhang/postcss-px-to-rem')({
    unitToConvert: 'px',
    viewportwidth: 1920, //视口的宽度。
    unitPrecision: 3, //允许REN单位增长到的十进制数。
    selecterBlackList: ['.ignore', '.hairines'], //（数组）要忽略的选择器的一个minPixelValue:1,//（数字）设置要替换的最小像素值。
    mediaQuery: false, // 允许在媒体查询中转换px。
  }),

  /**
   * React + typescript 配置别名
   * 1.在`config-overrides.js`中配置
   * 2.创建`tsconfig.extend.json`文件
   * 3.配置`tsconfig.json`
   */
  addWebpackAlias({
    '@': path.resolve(__dirname, './src'),
    '@components': path.resolve(__dirname, './src/components'),
    '@pages': path.resolve(__dirname, './src/pages'),
    '@utils': path.resolve(__dirname, './src/utils'),
    '@assets': path.resolve(__dirname, './src/assets'),
    '@app': path.resolve(__dirname, './src/app'),
  }),
);

二、Echarts适配方案实现思路:

(一)、实现思路

1、画布的大小可设置百分比，让画布随着父视图改变，也可设置px。

2、Echarts 文字大小，布局位置可按函数(echartsSize）转换。

(二)、实现步骤(Vue框架)

/* Echarts图表字体、间距自适应  */
// 以设计稿1920为例
export const echartsSize = (size, defalteWidth = 1920) => {
  let clientWidth = window.innerWidth || document.documentElement.clientWidth || document.body.clientWidth
  if (!clientWidth) return size
  let scale = (clientWidth / defalteWidth)
  return Number((size * scale).toFixed(3))
}
// 将其挂载到原型链上，方便全局可使用
Vue.prototype.echartsSize = echartsSize

(三)、使用举例

使用说明案列：

fontSize: this.echartsSize(12),

radius: [this.echartsSize(30), this.echartsSize(140)],

二、媒体查询px转vh vw

(一)、实现思路

使用@mixin @include

(二)、实现代码：

$defalteWidth: 1920;  // 设计尺寸
$defalteHeight: 1080;
$widthScale: 100/$defalteWidth;
$heightScale: 100/$defalteHeight;
@mixin height($radius) {
    height:($radius*heightScale)*1vh;
  }
  @mixin line-height($radius) {
    // line-height: $radius;
    line-height:($radius*heightScale)*1vh;
  }
  @mixin width($radius) {
    // width: $radius;
    width:($radius*defalteWidth)*1vw;
  }
  @mixin p-l($radius) {
    // padding-left: $radius;
    padding-left:($radius*defalteWidth)*1vw;
  }
  @mixin p-r($radius) {
    // padding-right: $radius;
    padding-right:($radius*defalteWidth)*1vw;
  }
  @mixin p-t($radius) {
    // padding-top: $radius;
    padding-top:($radius*defalteWidth)*1vh;
  }
  @mixin p-b($radius) {
    // padding-bottom: $radius;
    padding-bottom:($radius*defalteWidth)*1vh;
  }
  @mixin m-l($radius) {
    // margin-left: $radius;
     margin-left:($radius*defalteWidth)*1vw;
  }
  @mixin m-r($radius) {
    // margin-right: $radius;
    margin-right:($radius*defalteWidth)*1vw;
  }
  @mixin m-t($radius) {
    // margin-top: $radius;
    margin-top:($radius*defalteWidth)*1vh;
  }
  @mixin m-b($radius) {
    // margin-bottom: $radius;
    margin-bottom:($radius*defalteWidth)*1vh;
  }
  @mixin top($radius) {
    // margin-bottom: $radius;
    top:($radius*defalteWidth)*1vh;
  }
  @mixin bottom($radius) {
    // margin-bottom: $radius;
    bottom:($radius*defalteWidth)*1vh;
  }
  @mixin right($radius) {
    // margin-bottom: $radius;
    right:($radius*defalteWidth)*1vh;
  }
  @mixin left($radius) {
    // margin-bottom: $radius;
    left:($radius*defalteWidth)*1vh;
  }
 // 自行添加需要的属性