|  | @@ -1,24 +1,138 @@
 | 
	
		
			
				|  |  | -# vue-big-screen-plugin
 | 
	
		
			
				|  |  | +## 一、项目描述
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -## Project setup
 | 
	
		
			
				|  |  | -```
 | 
	
		
			
				|  |  | -npm install
 | 
	
		
			
				|  |  | -```
 | 
	
		
			
				|  |  | +- [**Vue2 版本请点击这里查看**](https://gitee.com/MTrun/big-screen-vue-datav)
 | 
	
		
			
				|  |  | +- [**React 版本请点击这里查看,全新界面超级好看!!!(o ゚ v ゚)ノ**](https://gitee.com/MTrun/react-big-screen)
 | 
	
		
			
				|  |  | +- 这里一个基于 Vue3、TypeScript、DataV、ECharts 框架的 " **数据大屏项目** ",使用 '.vue' 和 '.tsx' 文件实现界面,支持数据动态刷新渲染、内部DataV、ECharts图表都支持自由替换。组件详情请点击下方 ECharts 和 DataV 文档。
 | 
	
		
			
				|  |  | +- 项目按照 1920*1080 比例设计,支持任何尺寸的同比例缩放。
 | 
	
		
			
				|  |  | +- 项目封装的 ECharts 区域使用了全部引入的方式,增加了打包体积,在实际运用中请使用 **按需引入**。
 | 
	
		
			
				|  |  | +- 拉取项目之后,建议按照自己的功能区域重命名文件,现以简单的位置进行区分。
 | 
	
		
			
				|  |  | +- 项目环境:@vue/cli-4.5.13、DataV-2.10、Echarts-5.1.1、Npm-6.14.6、Node-v14.16。
 | 
	
		
			
				|  |  | +- 请拉取 master 分支的代码,其余分支是开发分支。
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -### Compiles and hot-reloads for development
 | 
	
		
			
				|  |  | -```
 | 
	
		
			
				|  |  | -npm run serve
 | 
	
		
			
				|  |  | -```
 | 
	
		
			
				|  |  | +友情链接:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -### Compiles and minifies for production
 | 
	
		
			
				|  |  | -```
 | 
	
		
			
				|  |  | -npm run build
 | 
	
		
			
				|  |  | +1.  [Vue3 官方文档](https://composition-api.vuejs.org/zh/api.html#setup)
 | 
	
		
			
				|  |  | +2.  [DataV 官方文档](http://datav.jiaminghi.com/guide/)
 | 
	
		
			
				|  |  | +3.  [echarts 实例](https://echarts.apache.org/examples/zh/index.html),[echarts API 文档](https://echarts.apache.org/zh/api.html#echarts)
 | 
	
		
			
				|  |  | +4.  [项目 gitee 地址(国内速度快)](https://gitee.com/MTrun/vue-big-screen-plugin)
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +项目展示
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +## 二、主要文件介绍
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +| 文件                | 作用/功能                                                              |
 | 
	
		
			
				|  |  | +| ------------------- | --------------------------------------------------------------------- |
 | 
	
		
			
				|  |  | +| main.js             | 主目录文件,引入 Echart/DataV 等文件                                    |
 | 
	
		
			
				|  |  | +| utils               | 工具函数与 mixins 函数等                                                |
 | 
	
		
			
				|  |  | +| views/ index.vue    | 项目主结构                                                             |
 | 
	
		
			
				|  |  | +| views/其余文件       | 界面各个区域组件(按照位置来命名)                                       |
 | 
	
		
			
				|  |  | +| assets              | 静态资源目录,放置 logo 与背景图片                                       |
 | 
	
		
			
				|  |  | +| assets / style.scss | 通用 CSS 文件,全局项目快捷样式调节                                      |
 | 
	
		
			
				|  |  | +| assets / index.scss | Index 界面的 CSS 文件                                                  |
 | 
	
		
			
				|  |  | +| components/echart   | 所有 echart 图表(按照位置来命名)                                      |
 | 
	
		
			
				|  |  | +| common/...          | 全局封装的 ECharts 和 flexible 插件代码(适配屏幕尺寸,可定制化修改)     |
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +## 三、使用介绍
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +### 启动项目
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +需要提前安装好 `nodejs` 与 `yarn`,下载项目后在项目主目录下运行 `yarn` 拉取依赖包。安装完依赖包之后然后使用 `vue-cli` 或者直接使用命令`npm run serve`,就可以启动项目,启动项目后最好是手动全屏查看(按 F11)。如果编译项目的时候提示没有 DataV 框架的依赖,输入 `npm install @jiaminghi/data-view` 或者 `yarn add @jiaminghi/data-view` 进行手动安装。
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +如果安装完依赖 @jiaminghi 报错 `<template v-for> key should be placed on the <template> tag` 类似的bug,就把此工程目录下的 `other_modules/@jiaminghi.rar` 解压并替换掉 node_modules 里面的同名文件,我已经给作者提了 Issues 希望大家拉取的时候没有这个错误
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +### 封装组件渲染图表
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +所有的 ECharts 图表渲染都是基于 `components/echart/index.tsx` 封装组件创建的,已经对数据和屏幕改动进行了监听,能够动态渲染图表数据和大小。
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +项目配置了默认的 ECharts 图表样式,文件地址:`common/echart/style/theme.js`,地图数据在同父级别的 map 文件夹下。
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +封装的渲染图表组件支持传入以下参数,可根据业务需求自行添加/删除。
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +|参数名称              | 类型      | 作用/功能                      |
 | 
	
		
			
				|  |  | +| -------------------| --------- | ------------------------------|
 | 
	
		
			
				|  |  | +| id                 | String    | 唯一 id(非必填,使用 ref 指定节点)|
 | 
	
		
			
				|  |  | +| className          | String    | class样式名称(非必填)                 |
 | 
	
		
			
				|  |  | +| options            | Object    | ECharts 配置(必填)                   |
 | 
	
		
			
				|  |  | +| height             | String    | 图表高度(必填)                    |
 | 
	
		
			
				|  |  | +| width              | String    | 图表宽度(必填)                    |
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +### 全局封装与使用
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +### 复用图表组件
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +复用图表组件案例为中间部分的 `任务通过率与任务达标率` 模块,两个图表类似,区别在于颜色和主要渲染数据。只需要传入对应的唯一 id 和样式,然后在复用的组件 `components/echart/center/centerChartRate` 里进行接收并在对应位置赋值即可。
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +如:在调用处 `views/center.vue` 里去定义好数据并传入组件
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +```js
 | 
	
		
			
				|  |  | +//组件调用
 | 
	
		
			
				|  |  | +<span>今日任务通过率</span>
 | 
	
		
			
				|  |  | +<chart :id="rate[0].id" :tips="rate[0].tips" :colorObj="rate[0].colorData" />
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +<span>今日任务达标率</span>
 | 
	
		
			
				|  |  | +<chart :id="rate[1].id" :tips="rate[1].tips" :colorObj="rate[1].colorData" />
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +...
 | 
	
		
			
				|  |  | +import Chart from "@/components/echart/center/centerChartRate";
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +data() {
 | 
	
		
			
				|  |  | +  return {
 | 
	
		
			
				|  |  | +    rate: [
 | 
	
		
			
				|  |  | +      {
 | 
	
		
			
				|  |  | +        id: "centerRate1",
 | 
	
		
			
				|  |  | +        tips: 60,
 | 
	
		
			
				|  |  | +        ...
 | 
	
		
			
				|  |  | +      },
 | 
	
		
			
				|  |  | +      {
 | 
	
		
			
				|  |  | +        id: "centerRate2",
 | 
	
		
			
				|  |  | +        tips: 40,
 | 
	
		
			
				|  |  | +        colorData: {
 | 
	
		
			
				|  |  | +          ...
 | 
	
		
			
				|  |  | +        }
 | 
	
		
			
				|  |  | +      }
 | 
	
		
			
				|  |  | +    ]
 | 
	
		
			
				|  |  | +  }
 | 
	
		
			
				|  |  | +}
 | 
	
		
			
				|  |  |  ```
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -### Lints and fixes files
 | 
	
		
			
				|  |  | +### 更换边框
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +边框是使用了 DataV 自带的组件,只需要去 views 目录下去寻找对应的位置去查找并替换就可以,具体的种类请去 DavaV 官网查看
 | 
	
		
			
				|  |  | +如:
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +```html
 | 
	
		
			
				|  |  | +<dv-border-box-1></dv-border-box-1>
 | 
	
		
			
				|  |  | +<dv-border-box-2></dv-border-box-2>
 | 
	
		
			
				|  |  | +<dv-border-box-3></dv-border-box-3>
 | 
	
		
			
				|  |  |  ```
 | 
	
		
			
				|  |  | -npm run lint
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +### 更换图表
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +直接进入 `components/echart` 下的文件修改成你要的 echarts 模样,可以去[echarts 官方社区](https://gallery.echartsjs.com/explore.html#sort=rank~timeframe=all~author=all)里面查看案例。
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +### 屏幕适配
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +### 请求数据
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +现在的项目未使用前后端数据请求,建议使用 axios 进行数据请求,在 main.js 位置进行全局配置。
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +- axios 的 main.js 配置参考范例(因人而异)
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +```js
 | 
	
		
			
				|  |  | +import axios from 'axios';
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +//把方法放到vue的原型上,这样就可以全局使用了
 | 
	
		
			
				|  |  | +Vue.prototype.$http = axios.create({
 | 
	
		
			
				|  |  | +  //设置20秒超时时间
 | 
	
		
			
				|  |  | +  timeout: 20000,
 | 
	
		
			
				|  |  | +  baseURL: 'http://172.0.0.1:80080', //这里写后端地址
 | 
	
		
			
				|  |  | +});
 | 
	
		
			
				|  |  |  ```
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -### Customize configuration
 | 
	
		
			
				|  |  | -See [Configuration Reference](https://cli.vuejs.org/config/).
 | 
	
		
			
				|  |  | +## 四、更新情况
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +## 五、其余
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +这个项目是个人的作品,难免会有问题和 BUG,如果有问题请进行评论,我也会尽力去更新,自己也在前端学习的路上,欢迎交流,非常感谢!
 |