0.1.0 • Published 10 months ago

irrigation-component v0.1.0

Weekly downloads
-
License
-
Repository
-
Last release
10 months ago

irrigation-component

水利小工具 :)

此项目新增功能模块规范

步骤

1.在/src/components 下新创建文件夹(小驼峰),文件夹下新建同名vue组件(大驼峰) 2.修改index.js与main.js 将自己的组件引入

规范

1.组件传参,需要考虑用户不传参的默认值,根据具体情况,可以在prop中写入default或者在代码中写入判断

LegendDynamic 图例

参数

如非特殊标明,均可非必填

属性类型描述备注
expendAllboolean(true)是否需要全部展开按钮
checkboxobject内置折叠面板是否有复选框{rainStation: true,Reservoirs: true,smallReservoirs: true,hydrometricStation: true,waterLevelStation: true,riskLevel: true,isosurface: true,}
legendAbbrboolean(true)是否需要缩略图标非必填
imgAbbrstring缩略图标图片路径
legendWidthnumber整个图例宽度
liWidthnumber每项图例的宽度通过调节 legendWidth 与 liWidth 可控制每行多少个图例
legendBorderboolean(true)是否需要图例外部的边框样式
legendToolboolean(true)是否需要标题栏
legendTitlestring标题名称
closeBtnboolean(true)是否需要关闭按钮
commonListObject(默认全部展示非选中)下方多选折叠面板详细格式见下方,不传展示全部面板,传空对象则为空
commonLegendShowboolean(true)是否展示下方折叠面板
legendListarray自定义图标数组详细格式如下
collapseListarray折叠面板图标数组(绑定方式为v-model:collapseList="collapseList")每新增一个折叠面板,数组中多一个对象,collapseList每个对象中的legendList同下
数据格式:
collapseList:[{
				title: "风险等级",
				key:"riskLevel",
				checked: false,
				checkbox:true,//是否需要复选框
				indeterminate:true,//是否部分选中状态(为true时,优先级在checked上)
				legendList: [],//写法同legendList
			},
            {
				title: "风险等级",
				key:"riskLevel",
				checked: false,
				checkbox:false,
				legendList: [],//写法同legendList
			}],

其中legendList格式如下:

属性类型(默认值)描述备注
srcstring每项图例左侧是图片src/colorCircular/colorBlock/value此四个属性可单独或同时使用
colorCircularstring每项图例左侧是圆形色块同上
colorBlockstring每项图例左侧是方形色块同上
valuestring每项图例左侧是文字同上
uncheckedboolean(true)是否选中图片当以上src/colorCircular/colorBlock属性存在时,额外提供此参数实现点击图例置灰及显示的功能(true:图片路径为 src,false:图片路径为unCheckedSrc)
uncheckedSrcstring非选中的图片路径当同时存在src及unchecked参数时,需要此属性展示未选择展示图片
changeboolean是否需要切换图例图片参数为false时,点击图例图片不会切换,默认可以不传

其中commonList格式如下:

属性类型(默认值)描述备注
rainStationArray雨量站共六项,图例是否选中默认值,false,true,true,false,true,false,true为未选中灰色,true为选中彩色,若数组数量不对,则全置为灰色
ReservoirsArray大中型水库共四项
smallReservoirsArray小型水库共四项
hydrometricStationArray水文站共三项
waterLevelStationArray水位站共三项
riskLevelArray风险等级共三项
isosurfaceArray等值面共六项

插槽

left //在图例外层提供插槽
content  //在图例标题栏与内容直接提供插槽

事件

closeLegend //关闭图标点击事件
legendAbbrClick //缩略图图标点击事件
liClick //单项图例点击事件
checkItem //折叠面板多选按钮点击事件

雨量过程图组件-AccumulatedRainfall

参数

属性类型(默认值)描述备注
rainDataObject雨量过程数据其中对象包含的属性为下表字段 对象中的属性除了时间(tm)若不需要可以不传
searchShowBoolean是否展示查询框用于外层div较小时
commonlyTMBoolean是否展示常用时间
beginTimeString开始时间无数据是传''空字符串
endTimeString结束时间无数据是传''空字符串
isPartBoolean是否部分展示为true时 默认展示前六条数据

rainData属性详情

rainData属性类型(默认值)描述备注
drpArray降雨量无数据时请传[]空数组
totalDrpArray累计降雨量无数据时请传[]空数组
drpForecastArray预报降雨量无数据时请传[]空数组
totalDrpForecastArray预报累计降雨量无数据时请传[]空数组
tmArray时间无数据时请传[]空数组 数组内格式为'yyyy-mm-dd HH:mm:ss','yyyy-mm-dd HH:mm:ss'
tmCurrentString当前时间格式为'yyyy-mm-dd HH:mm:ss'(无数据时请传''空字符串)

事件

timeChange // 时间选择事件,必需声明,返回数据格式为 ['开始时间','结束时间']

雨量过程图组件-AccumulatedRainfallV2

参数

属性类型(默认值)描述备注
rainDataObject雨量过程数据其中对象包含的属性为下表字段 对象中的属性除了时间(tm)若不需要可以不传
searchShowBoolean是否展示查询框用于外层div较小时
queryObject查询条件
shortcutsString结束时间无数据是传''空字符串
isPartBoolean/Number是否部分展示为数字时 默认展示前n条数据
shotcutParse2RangeFunctionshortcut选中后转化为时间范围的换算方法,默认为当前时刻向前推算选中的时长function(value: Number): beginTime, endDate {}
beforeRenderFunction该方法在调用 echart.setOption 之前调用,接受到的参数是组装好的echarts options数据,返回的数据会被传入到 echart.setOption 中,支持返回一个 Promise ,resolve的参数会被传入到 echart.setOption 中。用来对echarts配置进行修改,从而实现组件的特殊化定制;

query属性 | 属性 | 类型(默认值) |描述|备注| | ---- | ---- | ---- | ---- | |query.beginTime| String| 结束时间| 无数据是传''空字符串 | |query.endTime| String| 结束时间| 无数据是传''空字符串 |

shortcuts属性 | 属性 | 类型(默认值) |描述|备注| | ---- | ---- | ---- | ---- | |value| String| 值| | |label| String| 显示文字| |

rainData属性详情

rainData属性类型(默认值)描述备注
drpArray降雨量无数据时请传[]空数组
totalDrpArray累计降雨量无数据时请传[]空数组
drpForecastArray预报降雨量无数据时请传[]空数组
totalDrpForecastArray预报累计降雨量无数据时请传[]空数组
tmArray时间无数据时请传[]空数组 数组内格式为'yyyy-mm-dd HH:mm:ss','yyyy-mm-dd HH:mm:ss'
tmCurrentString当前时间格式为'yyyy-mm-dd HH:mm:ss'(无数据时请传''空字符串)

slot插槽 | 插槽名 | 说明 | | ---- | ----------- | |query| 自定义筛选的条件,作用域回传 query, shortcuts|

事件

timeChange // 时间选择事件,必需声明,返回数据格式为 ['开始时间','结束时间']

水位流量过程线组件-StageDischargeLine

参数

属性类型(默认值)描述备注
stageDischargeDataObject水位流量过程数据其中对象包含的属性为下表字段 对象中的属性除了时间(tm)若不需要可以不传
searchShowBoolean是否展示查询框用于外层div较小时
commonlyTMBoolean是否展示常用时间
isFacingBoolean是否贴到Y轴
beginTimeString开始时间无数据是传''空字符串
endTimeString结束时间无数据是传''空字符串
selectLegendObject图例选中状态自定义图例选中状态格式{'api预报水位': false, '预报水位': true} 默认为全部选中状态
precisionNumber水位线y轴在取整时舍进位的精度,非必传默认值为5比如最高水位xMax传入211.36,会根据精度换算到215
beforeRenderFunction该方法在调用 echart.setOption 之前调用,接受到的参数是组装好的echarts options数据,返回的数据会被传入到 echart.setOption 中,支持返回一个 Promise ,resolve的参数会被传入到 echart.setOption 中。用来对echarts配置进行修改,从而实现组件的特殊化定制;
validPropsFunction该方法在接收到stageDischargeData和其发生改变时执行,接收参数是 stageDischargeData。组件内增加了对 保证水位 和 警戒水位的验证,未传入用 ElMessage 给出警告提示(该方法为了快速支持已引用部分的快速验证)。为了实现组件默认支持全部验证又允许部分组件对某一项进行验证。

stageDischargeData属性详情

stageDischargeData属性类型(默认值)描述备注
drpArray降雨量无数据时请传[]空数组
drpForecastArray预报降雨量无数据时请传[]空数组
zArray监测水位无数据时请传[]空数组
qArray监测流量无数据时请传[]空数组
zForecastArray预报水位无数据时请传[]空数组
zForecastAPIArrayapi预报水位无数据时请传[]空数组
zForecastXAJArray新安江预报水位无数据时请传[]空数组
zForecastSKBYArray时空变源预报水位无数据时请传[]空数组
qForecastArray预报流量无数据时请传[]空数组
qForecastAPIArrayapi预报流量无数据时请传[]空数组
qForecastXAJArray新安江预报流量无数据时请传[]空数组
qForecastSKBYArray时空变源预报流量无数据时请传[]空数组
tmArray时间无数据时请传[]空数组 数组内格式为'yyyy-mm-dd HH:mm:ss','yyyy-mm-dd HH:mm:ss'
tmCurrentString当前时间格式为'yyyy-mm-dd HH:mm:ss'(无数据时请传''空字符串)
zWarnString警戒水位无数据时请传''空字符串
zGuaranteeString保证水位无数据时请传''空字符串
zMaxString水位轴最大水位无数据时请传''空字符串
zMinString水位轴最小水位无数据时请传''空字符串

事件

timeChange // 时间选择事件,必需声明,返回数据格式为 ['开始时间','结束时间']

水库水位流量过程线组件-StageDischargeLineReservoir

参数

属性类型(默认值)描述备注
stageDischargeDataObject水位流量过程数据其中对象包含的属性为下表字段 对象中的属性除了时间(tm)若不需要可以不传
searchShowBoolean是否展示查询框用于外层div较小时
commonlyTMBoolean是否展示常用时间
isFacingBoolean是否贴到Y轴
beginTimeString开始时间无数据是传''空字符串
endTimeString结束时间无数据是传''空字符串
selectLegendObject图例选中状态自定义图例选中状态格式{'api预报水位': false, '预报水位': true} 默认为全部选中状态
axleInfoArrayy轴位置信息{ type: 'z',position: 'left',offset: 0 },{ type: 'q',position: 'right',offset: 0 },{ type: 'rain',position: 'right',offset: 45,nameLocation: 'start' },
precisionNumber水位线y轴在取整时舍进位的精度,非必传默认值为5比如最高水位xMax传入211.36,会根据精度换算到215
beforeRenderFunction该方法在调用 echart.setOption 之前调用,接受到的参数是组装好的echarts options数据,返回的数据会被传入到 echart.setOption 中,支持返回一个 Promise ,resolve的参数会被传入到 echart.setOption 中。用来对echarts配置进行修改,从而实现组件的特殊化定制;
validPropsFunction该方法在接收到stageDischargeData和其发生改变时执行,接收参数是 stageDischargeData。组件内增加了对 汛限水位、允许壅高水位 和 警戒水位的验证,未传入用 ElMessage 给出警告提示(该方法为了快速支持已引用部分的快速验证)。为了实现组件默认支持全部验证又允许部分组件对某一项进行验证。

stageDischargeData属性详情

stageDischargeData属性类型(默认值)描述备注
drpArray面降雨量无数据时请传[]空数组
zArray库水位无数据时请传[]空数组
qInArray入库流量无数据时请传[]空数组
qOutArray出库流量无数据时请传[]空数组
zForecastArray预报库水位无数据时请传[]空数组
qInForecastArray预报入库流量无数据时请传[]空数组
qOutForecastArray预报出库流量无数据时请传[]空数组
tmArray时间无数据时请传[]空数组 数组内格式为'yyyy-mm-dd HH:mm:ss','yyyy-mm-dd HH:mm:ss'
tmCurrentString当前时间格式为'yyyy-mm-dd HH:mm:ss'(无数据时请传''空字符串)
zLimitString汛限水位无数据时请传''空字符串
zDesign / allRaiseLevString允许壅高水位无数据时请传''空字符串
zCheck / warningStagString警戒水位无数据时请传''空字符串
allMaxLevString允许最高水位无数据时请传''空字符串
zMaxString水位轴最大水位无数据时请传''空字符串
zMinString水位轴最小水位无数据时请传''空字符串

axleInfo属性详情

axleInfo属性类型(默认值)描述备注
typeStringy轴类型z: 水位 q: 流量 rain: 雨量 必填
positionStringy轴位置left: 左边 right: 右边 必填
offsetNumber偏移距离默认0 非必填
nameLocationString标签位置start: 轴开始位置 end: 轴结束位置

事件

timeChange // 时间选择事件,必需声明,返回数据格式为 ['开始时间','结束时间']

断面横剖面组件-CrossSection

参数

属性类型(默认值)描述备注
crossSectionDataObject断面横剖面数据其中对象包含的属性为下表字段

crossSectionData属性详情

crossSectionData属性类型(默认值)描述备注
stageInfoArray水位信息格式为[{name: '水位流量关系曲线', z: '113.000', '113.500',...}] 其中 name为曲线名称 z为水位数据
zString当前水位无数据时请传''空字符串
qString当前流量无数据时请传''空字符串
zWarnString警戒水位无数据时请传''空字符串
zGuaranteeString保证水位无数据时请传''空字符串
sectionArray断面数据无数据时请传[]空数组 格式为{ elevation: 175.882, startingDistance: 0.0, remark: '起点' },{ elevation: 175.892, startingDistance: 4.078, remark: null }

section数组中对象属性详情

属性类型(默认值)描述备注
startingDistanceNumber起点距
elevationNumber高程
remarkString备注无数据时请传''空字符串

水位流量关系曲线组件-StageDischargeRelation

参数

属性类型(默认值)描述备注
stageDischargeDataObject水位流量关系曲线数据其中对象包含的属性为下表字段

stageDischargeData属性详情

stageDischargeData属性类型(默认值)描述备注
stageInfoArray水位信息格式为[{name: '水位流量关系曲线', z: '113.000', '113.500',...}] 其中 name为曲线名称 z为水位数据
qArray流量无数据时请传[]空数组
zWarnString警戒水位无数据时请传''空字符串
zGuaranteeString保证水位无数据时请传''空字符串

水位库容曲线组件-StorageCurve

参数

属性类型(默认值)描述备注
storageCurveDataObject水位库容曲线数据其中对象包含的属性为下表字段

storageCurveData属性详情

storageCurveData属性类型(默认值)描述备注
zArray水位无数据时请传[]空数组
capacityArray库容无数据时请传[]空数组
unitObject水位库容单位默认: { z: "m", capacity: "万m³" }

水库剖面图组件-ReservoirProfile

参数

属性类型(默认值)描述备注
profileDataObject水库剖面数据其中对象包含的属性为下表字段
titleShowBoolean是否展示标题

profileData属性详情

profileData属性类型(默认值)描述备注
zNumber当前水位无数据时请传0
zForecastNumber预报最高水位无数据时请传0
maxZNumber最高水位无数据时请传0
zCheckNumber警戒水位无数据时请传0
zDesignNumber允许壅高水位无数据时请传0
crestElevationNumber坝顶高程无数据时请传0
zLimitNumber汛限水位无数据时请传0
zDeadNumber死水位无数据时请传0
zNormalNumber正常蓄水位无数据时请传0
zXunqianLimitNumber汛前水位无数据时请传0
zXunzhongLimitNumber汛中水位无数据时请传0
zXunmoLimitNumber汛末水位无数据时请传0
timeForecastString预报最高水位时间格式为'yyyy-mm-dd HH:mm:ss' 无数据时请传''
colorString标题字体颜色格式为'#ffffff' 无数据时请传''或者null

水库剖面图组件-ReservoirCrossSection

参数

属性类型(默认值)描述备注
profileDataObject水库剖面数据其中对象包含的属性为下表字段
titleShowBoolean是否展示标题

profileData属性详情

profileData属性类型(默认值)描述备注
zNumber当前水位无数据时请传0
zForecastNumber预报最高水位无数据时请传0
zCheckNumber警戒水位无数据时请传0
zDesignNumber允许壅高水位无数据时请传0
crestElevationNumber坝顶高程无数据时请传0
zLimitNumber汛限水位无数据时请传0
timeForecastString预报最高水位时间格式为'yyyy-mm-dd HH:mm:ss' 无数据时请传''
colorString标题字体颜色格式为'#ffffff' 无数据时请传''或者null

水库剖面图组件-ReservoirCrossSectionImg

参数

属性类型(默认值)描述备注
profileDataObject水库剖面数据其中对象包含的属性为下表字段
titleShowBoolean是否展示标题

profileData属性详情

profileData属性类型(默认值)描述备注
zNumber当前水位无数据时请传0
zForecastNumber预报最高水位无数据时请传0
zCheckNumber警戒水位无数据时请传0
zDesignNumber允许壅高水位无数据时请传0
crestElevationNumber坝顶高程无数据时请传0
zLimitNumber汛限水位无数据时请传0
zAllowNumber允许最高水位无数据时请传0
pondageNumber蓄水量无数据时请传0
controlNumber防洪库容无数据时请传0
retentionNumber拦洪库容无数据时请传0
regulationNumber调洪库容无数据时请传0
timeForecastString预报最高水位时间格式为'yyyy-mm-dd HH:mm:ss' 无数据时请传''
colorString标题字体颜色格式为'#ffffff' 无数据时请传''或者null

雨量同期对比组件-RainfallSynchronization

参数

属性类型(默认值)描述备注
rainDataObject雨量同期数据其中对象包含的属性为下表字段 对象中的属性除了时间(tm)若不需要可以不传
searchShowBoolean是否展示查询框用于外层div较小时
commonlyTMBoolean是否展示常用时间
beginTimeString开始时间无数据是传''空字符串
endTimeString结束时间无数据是传''空字符串

rainData属性详情

rainData属性类型(默认值)描述备注
historyMaxArray历史同期降雨无数据时请传[]空数组
lastSamePeriodArray去年同期降雨无数据时请传[]空数组
currentValueArray当前降雨无数据时请传[]空数组
tmArray时间无数据时请传[]空数组 数组内格式为'yyyy-mm-dd HH:mm:ss','yyyy-mm-dd HH:mm:ss'

闸门状态组件-SluiceStatus

参数

属性类型(默认值)描述备注
sluiceDataArray闸门状态数据
sluiceTitleString站点名称

sluiceData属性详情

sluiceData属性类型(默认值)描述备注
HeightString闸门开度10为100%
STCDString站点编码
TMString时间

河道纵剖面组件-RiverLongitudinalProfile

参数

属性类型(默认值)描述备注
riverDataObject河道纵剖面数据

riverData属性详情

riverData属性类型(默认值)描述备注
nameString断面点名称
elevationArray河底高程
leftElevationArray左岸高程
rightElevationArray右岸高程
waterLeverArray水位信息
markPointArray河道站点位样式信息{ name:'',value:'',xAxis:6,yAxis:254.469,itemStyle:{color:'#00effe'} }

河道纵剖面组件(动态水位)-RiverLongitudinalProfileDynamic

参数

属性类型(默认值)描述备注
riverDataObject河道纵剖面数据

riverData属性详情

riverData属性类型(默认值)描述备注
nameString断面点名称
elevationArray河底高程
leftElevationArray左岸高程
rightElevationArray右岸高程
waterLeverArray水位信息{tm: '2021-07-18 08:00:00',z: [] tm:时间 z:当前时间对应的各个站点的水位信息
markPointArray河道站点位样式信息{ name:'',value:'',xAxis:6,yAxis:254.469,itemStyle:{color:'#00effe'} }

行政区站点状态统计组件-DistrictStatistics

参数

属性类型(默认值)描述备注
districtDataArray行政区站点状态数据 {highRisk:2,mediumRisk:2,name:'济南市',lowRisk:12,noRisk:8,adcd:'370100'}
styleInfoArray行政区统计状态类别数据 {name: '超警戒',key: 'highRisk',color: '#FF0000',}

districtData属性详情

districtData属性类型(默认值)描述备注
highRiskNumber超警戒可自定义属性名称
mediumRiskNumber超允许壅高可自定义属性名称
lowRiskNumber超汛限可自定义属性名称
noRiskNumber正常可自定义属性名称
nameString行政区名称
adcdString行政区编码

styleInfo属性详情

styleInfo属性类型(默认值)描述备注
nameString属性名称
keyString属于key值对应districtData中自定义的属于名称
colorString系列颜色
fontColorString系列label文字颜色

事件

distClick // 行政区点击事件,必需声明,返回数据格式为 {adnm: 行政区名称,adcd: 行政区编码}

水库纳雨能力统计组件-RainfallCapacityStatistics

参数

属性类型(默认值)描述备注
rainfallCapacityDataArray水库纳雨能力数据{ limitLevel1:2,limitLevel2:2,name:'济南市',limitLevel3:12,designLevel1:8,designLevel2:8,designLevel3:2,adcd:'370100' }

rainfallCapacityData属性详情

rainfallCapacityData属性类型(默认值)描述备注
limitLevel1Number距汛限水位小于100mm
limitLevel2Number距汛限水位100mm~200mm
limitLevel3Number距汛限水位大于200mm
designLevel1Number距允许壅高水位小于100mm
designLevel2Number距允许壅高水位100mm~200mm
designLevel3Number距允许壅高水位大于200mm
nameString行政区名称
adcdString行政区编码

事件

distClick // 行政区点击事件,必需声明,返回数据格式为 {adnm: 行政区名称,adcd: 行政区编码}

调度对比组件-CompareLineCustom

参数

属性类型(默认值)描述备注
currentDispatchListArray调度数据
compareLineDataArray过程线数据
pmtNumber过程线类型1 水库 2 河道站
lengendWidthNumber水库图例宽度
lengendWidthRiverNumber河道站图例宽度
panelWidthNumber面板宽度
offsetLeft2Number水库图例左边距
offsetLeft2RiverNumber河道站图例左边距
drpLeftNumber面降雨量图例左边距

Project setup

npm install

Compiles and hot-reloads for development

npm run serve

Compiles and minifies for production

npm run build

Lints and fixes files

npm run lint

Customize configuration

See Configuration Reference.