介绍

组件库基于Vue，主要用于构建大屏（全屏）数据展示页面即数据可视化，具有多种类型组件可供使用：

  • 边框

带有不同边框的容器

  • 装饰

用来点缀页面效果，增加视觉效果

  • 图表

图表组件基于Charts封装，轻量，易用

  • 其他

飞线图/水位图/轮播表/…

用前必看

使用前应阅读以下提示，这样出现相应问题后可以快速解决。

::: tip 兼容性 组件库的开发和调试都使用Chrome浏览器，没有时间和精力做其他浏览器的兼容，尤其是IE。

所以请使用Chrome浏览器。 :::

::: warning 宽高异常 组件的默认宽高都是100%，可以根据父容器宽高进行自适应，但在某些情况下组件宽高可能表现异常，这种情况一般是因为组件的父容器宽高发生了变化，而组件没有侦知这一变化，你可以在组件上绑定key值，在更改父容器宽高且页面完成重绘后（使用$nextTick），更新key值，使组件强制刷新，以获取正确宽高。 :::

::: danger 状态更新 避免你的组件更新了数据后，状态却不刷新，也就是没变化，请务必看这里

组件props均未设置deep监听，刷新props时，请直接生成新的props对象（基础数据类型除外），或完成赋值操作后使用ES6拓展运算符生成新的props对象（this.someProps = { ...this.someProps }）。 :::

具体更新数据示例

<<< @/docs/guide/vueDemo/update.vue

创建Vue项目

组件库依赖vue，要想使用它，创建一个Vue项目当然是必须的，如果已有Vue项目或使用UMD版开发可跳过此步骤。

安装Vue/Cli

  • npm安装
  1. npm i -g @vue/cli
  • yarn安装
  1. yarn global add @vue/cli

创建Vue项目

  1. vue create datav-project

Vue/Cli官网

安装

  1. cd datav-project

在Vue项目下进行组件库安装。

  • npm安装
  1. npm install @jiaminghi/data-view
  • yarn安装
  1. yarn add @jiaminghi/data-view

使用

  1. // 将自动注册所有组件为全局组件
  2. import dataV from '@jiaminghi/data-view'
  4. Vue.use(dataV)

按需引入

按需引入仅支持基于ES module的tree shaking，按需引入示例如下：

  1. import { borderBox1 } from '@jiaminghi/data-view'
  3. Vue.use(borderBox1)

UMD版

UMD版可直接使用script标签引入，UMD版文件下载请移步UMD，引入后将自动把所有组件注册为Vue全局组件，引入DataV前请确保已引入Vue。

<<< @/docs/guide/umdExample.html