docs: Update all files JSDoc.

This commit is contained in:
chiayin
2024-03-29 15:49:05 +08:00
parent 4ba71d1193
commit e391c9a237
55 changed files with 260 additions and 219 deletions

View File

@@ -2,9 +2,6 @@
<Sidebar :visible="sidebarState" :closeIcon="'pi pi-angle-right'" :modal="false" position="right" :dismissable="false" class="!w-[440px]" @hide="hide" @show="show">
<template #header>
<p class="pl-2 text-base font-bold text-neutral-900">Summary</p>
<!-- <ul class=" pl-4">
<li class="h1 text-neutral-900">Summary</li>
</ul> -->
</template>
<!-- header: summary -->
<div class="flex justify-start items-start">
@@ -183,7 +180,7 @@ export default {
methods: {
/**
* Number to percentage
* @param {number} val
* @param {number} val 原始數字
* @returns {string} 轉換完成的百分比字串
*/
getPercentLabel(val){
@@ -194,7 +191,7 @@ export default {
* setting stats data
* @param { object } data fetch API stats data
* @param { string } fileName file Name
* @returns { object } primaryStatData | secondaryStatData
* @returns { object } primaryStatData | secondaryStatData回傳 primaryStatData 或 secondaryStatData
*/
getStatData(data, fileName) {
return {
@@ -269,7 +266,6 @@ export default {
const secondaryFileName = await this.compareStore.getFileName(secondaryId)
this.primaryStatData = await this.getStatData(primaryData, primaryFileName);
this.secondaryStatData = await this.getStatData(secondaryData, secondaryFileName);
}
}
</script>

View File

@@ -284,7 +284,7 @@ export default {
methods: {
/**
* set progress bar width
* @param {number} value
* @param {number} value 百分比數字
* @returns {string} 樣式的寬度設定
*/
progressWidth(value){
@@ -292,7 +292,7 @@ export default {
},
/**
* Number to percentage
* @param {number} val
* @param {number} val 原始數字
* @returns {string} 轉換完成的百分比字串
*/
getPercentLabel(val){
@@ -301,7 +301,7 @@ export default {
},
/**
* Convert seconds to days
* @param {number} sec
* @param {number} sec 秒數
* @returns {number} day
*/
convertSecToDay(sec) {
@@ -309,7 +309,7 @@ export default {
},
/**
* Open Issues Modal.
* @param {number} no trace no
* @param {number} no trace 編號
*/
async openMore(no) {
// async await 解決非同步資料延遲傳遞導致未讀取到而出錯的問題
@@ -321,7 +321,7 @@ export default {
},
/**
* Open Loop Modal.
* @param {number} no trace no
* @param {number} no trace 編號
*/
async openLoopMore(no) {
// async await 解決非同步資料延遲傳遞導致未讀取到而出錯的問題
@@ -333,7 +333,7 @@ export default {
},
/**
* set conformance report data
* @param {object} data new watch's value
* @param {object} data new watch's value 監聽到後端傳來的報告 data
*/
setConformanceTempReportData(data){
let total = getNumberLabel(Object.values(data.counts).reduce((acc, val) => acc + val, 0));

View File

@@ -691,14 +691,14 @@ export default {
methods: {
/**
* get min total seconds
* @param {Number} e
* @param {Number} e 最小值總秒數
*/
minTotalSeconds(e) {
this.selectTimeRangeMin = e;
},
/**
* get min total seconds
* @param {Number} e
* @param {Number} e 最大值總秒數
*/
maxTotalSeconds(e) {
this.selectTimeRangeMax = e;
@@ -784,7 +784,7 @@ export default {
this.isSubmitTimeCfmCtEteSE = { base: {}, rule: {}};
},
/**
* @param {boolean} massage true | false 清空選單選項, 選擇的結果
* 清空選單的行為
*/
reset() {
// Results page Cover Plate(遮罩為 ture)
@@ -825,7 +825,6 @@ export default {
isEndSelected: true
};
}
},
/**
* Apply button 發送選項,取得 Check Id.

View File

@@ -32,6 +32,9 @@ export default {
}
},
methods: {
/**
* 將選取的 Activities 傳出去
*/
actListData() {
this.$emitter.emit('actListData', this.actList);
}

View File

@@ -33,6 +33,9 @@ export default {
},
},
methods: {
/**
* 將選取的 Activity 傳出去
*/
actRadioData() {
this.localSelect = null;
this.$emitter.emit('actRadioData', {

View File

@@ -40,7 +40,6 @@
</div>
</div>
</div>
</template>
<script>
import { sortNumEngZhtw } from '@/module/sortNumEngZhtw.js';

View File

@@ -99,6 +99,9 @@ export default {
}
},
methods: {
/**
* 切換 Rule Type 的選項時的行為
*/
changeRadio() {
this.selectedActivitySequence = 'Start & End';
this.selectedMode = 'Directly follows';
@@ -107,15 +110,27 @@ export default {
this.selectedActSeqFromTo = 'From';
this.$emitter.emit('isRadioChange', true); // Radio 切換時,資料要清空
},
/**
* 切換 Activity sequence 的選項時的行為
*/
changeRadioSeq() {
this.$emitter.emit('isRadioSeqChange',true);
},
/**
* 切換 Processing time 的選項時的行為
*/
changeRadioProcessScope() {
this.$emitter.emit('isRadioProcessScopeChange', true);
},
/**
* 切換 Process Scope 的選項時的行為
*/
changeRadioActSeqMore() {
this.$emitter.emit('isRadioActSeqMoreChange', true);
},
/**
* 切換 Activity Sequence 的選項時的行為
*/
changeRadioActSeqFromTo() {
this.$emitter.emit('isRadioActSeqFromToChange', true);
},

View File

@@ -143,28 +143,6 @@ export default {
},
},
methods: {
/**
* set Time Result Data
* @param {array} data
* @returns {array}
* timeResultData: [
* {
* id: 1,
* category: 'start', start|end|from|to
* task: '到院'
* },
* ]
*/
setTimeResultData(data) {
let result = data.map((item, index) => {
return {
id: index + 1,
category: item.category.replace(/^./, item.category[0].toUpperCase()),
task: item.task
}
});
return result;
},
/**
* All reset
*/

View File

@@ -202,8 +202,8 @@ export default {
methods: {
/**
* 設定 start and end 的 Radio Data
* @param {object} data cfmSeqStart | cfmSeqEnd | cfmPtEteSE | cfmPtPSE | cfmWtEteSE | cfmWtPSE | cfmCtEteSE
* @param {string} category start | end
* @param {object} data cfmSeqStart | cfmSeqEnd | cfmPtEteSE | cfmPtPSE | cfmWtEteSE | cfmWtPSE | cfmCtEteSE,傳入以上任一後端接到的 Activities 列表 Data。
* @param {string} category 'start' | 'end',傳入 'start' 或 'end'。
* @returns {array}
*/
setTaskData(data, category) {
@@ -213,9 +213,9 @@ export default {
},
/**
* 重新設定連動的 start and end 的 Radio Data
* @param {object} data cfmPtEteSE | cfmPtPSE | cfmWtEteSE | cfmWtPSE | cfmCtEteSE
* @param {string} category start | end
* @param {string} task task
* @param {object} data cfmPtEteSE | cfmPtPSE | cfmWtEteSE | cfmWtPSE | cfmCtEteSE,傳入以上任一後端接到的 Activities 列表 Data。
* @param {string} category 'start' | 'end',傳入 'start' 或 'end'。
* @param {string} task 已選擇的 Activity task
* @returns {array}
*/
setStartAndEndData(data, category, task) {
@@ -227,9 +227,9 @@ export default {
},
/**
* 重新設定 Activity sequence 連動的 start and end 的 Radio Data
* @param {object} data cfmSeqStart | cfmSeqEnd
* @param {string} category sources | sinks
* @param {string} task task
* @param {object} data cfmSeqStart | cfmSeqEnd,傳入以上任一後端接到的 Activities 列表 Data。
* @param {string} category 'sources' | 'sinks',傳入 'sources' 或 'sinks'。
* @param {string} task 已選擇的 Activity task
* @returns {array}
*/
setSeqStartAndEndData(data, category, task) {
@@ -239,7 +239,7 @@ export default {
},
/**
* select start list's task
* @param {event} e
* @param {event} e 觸發 input 的詳細事件
*/
selectStart(e) {
this.taskStart = e;
@@ -256,7 +256,7 @@ export default {
},
/**
* select End list's task
* @param {event} e
* @param {event} e 觸發 input 的詳細事件
*/
selectEnd(e) {
this.taskEnd = e;
@@ -283,7 +283,7 @@ export default {
},
/**
* Radio 切換時Start & End Data 連動改變
* @param {boolean} data true | false
* @param {boolean} data true | false傳入 true 或 false
*/
setResetData(data) {
if(data) {

View File

@@ -84,22 +84,22 @@ export default {
methods: {
/**
* get min total seconds
* @param {Number} e
* @param {Number} e 最小值總秒數
*/
minTotalSeconds(e) {
this.$emit('min-total-seconds', e);
},
/**
* get min total seconds
* @param {Number} e
* @param {Number} e 最大值總秒數
*/
maxTotalSeconds(e) {
this.$emit('max-total-seconds', e);
},
/**
* get Time Range(duration)
* @param {array} data API data
* @param {string} category act | single | double
* @param {array} data API dataActivity 列表
* @param {string} category 'act' | 'single' | 'double',傳入以上任一值。
* @param {string} task select Radio task or start
* @param {string} taskTwo end
* @returns {object} {min:12, max:345}

View File

@@ -12,18 +12,5 @@
export default {
name: 'ResultArrow',
props:['data', 'select'],
// data() {
// return {
// datadata: []
// }
// },
// watch: {
// data: function(newValue) {
// this.datadata = newValue;
// },
// select: function(newValue) {
// this.datadata = newValue;
// }
// }
}
</script>

View File

@@ -68,16 +68,16 @@ export default {
},
/**
* get min total seconds
* @param {Number} e
* @param {Number} e 元件傳來的最小值總秒數
*/
minTotalSeconds(e) {
minTotalSeconds(e) {
this.timeRangeMin = e;
this.updateMin = e;
this.$emit('min-total-seconds', e);
},
/**
* get min total seconds
* @param {Number} e
* @param {Number} e 元件傳來的最大值總秒數
*/
maxTotalSeconds(e) {
this.timeRangeMax = e;

View File

@@ -160,7 +160,7 @@ export default {
methods: {
/**
* Number to percentage
* @param {number} val
* @param {number} val 原始數字
* @returns {string} 轉換完成的百分比字串
*/
getPercentLabel(val){
@@ -169,7 +169,7 @@ export default {
},
/**
* set progress bar width
* @param {number} value
* @param {number} value 百分比數字
* @returns {string} 樣式的寬度設定
*/
progressWidth(value){
@@ -177,7 +177,7 @@ export default {
},
/**
* switch case data
* @param {number} id
* @param {number} id case id
*/
async switchCaseData(id) {
if(id == this.showTraceId) return;
@@ -262,7 +262,7 @@ export default {
},
/**
* 無限滾動: 監聽 scroll 有沒有滾到底部
* @param {element} event
* @param {element} event 監聽時回傳的事件
*/
handleScroll(event) {
if(this.maxItems || this.infiniteData.length < 20 || this.infiniteFinish === false) return;

View File

@@ -124,6 +124,7 @@ export default {
},
/**
* Element dragging started
* @param {event} evt input 傳入的事件
*/
onStart(evt) {
const lastChild = evt.to.lastChild.lastChild;
@@ -137,6 +138,7 @@ export default {
},
/**
* Element dragging ended
* @param {event} evt input 傳入的事件
*/
onEnd(evt) {
// 顯示拖曳元素

View File

@@ -30,7 +30,6 @@
</div>
</div>
</template>
<script>
import Search from '@/components/Search.vue';
@@ -68,6 +67,10 @@ export default {
}
},
methods: {
/**
* 將選取的 row 傳到父層
* @param {event} e input 傳入的事件
*/
onRowSelect(e) {
this.$emit('on-row-select', e)
}

View File

@@ -61,16 +61,30 @@ export default {
}
},
methods: {
/**
* 選擇 Row 的行為
*/
onRowSelect() {
this.$emit('on-row-select', this.select);
},
/**
* 取消選取 Row 的行為
*/
onRowUnselect() {
this.$emit('on-row-select', this.select);
},
/**
* 全選 Row 的行為
* @param {event} e input 傳入的事件
*/
onRowSelectAll(e) {
this.select = e.data;
this.$emit('on-row-select', this.select);
},
/**
* 取消全選 Row 的行為
* @param {event} e input 傳入的事件
*/
onRowUnelectAll(e) {
this.select = null;
this.$emit('on-row-select', this.select)

View File

@@ -327,7 +327,7 @@ export default {
},
/**
* 選取類別型 table 的全選項
* @param {event} e
* @param {event} e input 傳入的事件
*/
onRowSelectAll(e) {
this.selectedAttRange = e.data;
@@ -352,7 +352,7 @@ export default {
},
/**
* 切換 Attribute Name Radio
* @param {event} e
* @param {event} e input 傳入的事件
*/
switchAttNameRadio(e) {
this.selectedAttRange = null;
@@ -401,7 +401,7 @@ export default {
},
/**
* set progress bar width
* @param {number} value
* @param {number} value 百分比數字
* @returns {string} 樣式的寬度設定
*/
progressWidth(value){
@@ -409,7 +409,7 @@ export default {
},
/**
* Number to percentage
* @param {number} val
* @param {number} val 原始數字
* @returns {string} 轉換完成的百分比字串
*/
getPercentLabel(val){
@@ -429,7 +429,6 @@ export default {
/**
* 調整左邊遮罩大小
* @param {object} chart 取得 chart.js 資料
* @param {number} chart 取得 chart.js 資料
*/
resizeLeftMask(chart, from) {
const canvas = document.querySelector('#chartCanvasId canvas');
@@ -440,7 +439,7 @@ export default {
mask.style.height = `${chart.chartArea.height}px`;
},
/**
* 調整邊遮罩大小
* 調整邊遮罩大小
* @param {object} chart 取得 chart.js 資料
*/
resizeRightMask(chart, to) {
@@ -453,7 +452,6 @@ export default {
},
/**
* create chart
* @param {object} valueData 選取的 Attribute包含後端原始數據的 type、key
*/
createChart() {
const valueData = this.valueData;

View File

@@ -54,7 +54,7 @@ export default {
},
methods: {
/**
* @param {boolean} e ture | false
* @param {boolean} e ture | false可選 ture 或 false
* @param {numble} index rule's index
*/
isRule(e, index){
@@ -66,6 +66,7 @@ export default {
},
/**
* header:Funnel 刪除全部的 Funnel
* @param {numble|string} index rule's index 或 全部
*/
async deleteRule(index) {
if(index === 'all') {

View File

@@ -152,6 +152,10 @@ export default{
},
},
methods: {
/**
* 調整遮罩大小
* @param {object} chart 取得 chart.js 資料
*/
resizeMask(chart) {
let from = (this.selectArea[0] * 0.01) / (this.selectRange * 0.01);
let to = (this.selectArea[1] * 0.01) / (this.selectRange * 0.01);
@@ -160,6 +164,10 @@ export default{
this.resizeRightMask(chart, to);
}
},
/**
* 調整左邊遮罩大小
* @param {object} chart 取得 chart.js 資料
*/
resizeLeftMask(chart, from) {
const canvas = document.getElementById("chartCanvasId");
const mask = document.getElementById("chart-mask-left");
@@ -168,6 +176,10 @@ export default{
mask.style.top = `${canvas.offsetTop + chart.chartArea.top}px`;
mask.style.height = `${chart.chartArea.height}px`;
},
/**
* 調整右邊遮罩大小
* @param {object} chart 取得 chart.js 資料
*/
resizeRightMask(chart, to) {
const canvas = document.getElementById("chartCanvasId");
const mask = document.getElementById("chart-mask-right");
@@ -176,6 +188,9 @@ export default{
mask.style.top = `${canvas.offsetTop + chart.chartArea.top}px`;
mask.style.height = `${chart.chartArea.height}px`;
},
/**
* create chart
*/
createChart() {
const max = this.filterTimeframe.y_axis.max * 1.1;
const minX = this.timeFrameData[0]?.x;

View File

@@ -233,7 +233,7 @@ export default {
},
/**
* Number to percentage
* @param {number} val
* @param {number} val 原始數字
* @returns {string} 轉換完成的百分比字串
*/
getPercentLabel(val){
@@ -242,7 +242,7 @@ export default {
},
/**
* set progress bar width
* @param {number} value
* @param {number} value 百分比數字
* @returns {string} 樣式的寬度設定
*/
progressWidth(value){
@@ -250,7 +250,8 @@ export default {
},
/**
* switch case data
* @param {number} id
* @param {number} id case id
* @param {number} count 所有的 case 數量
*/
async switchCaseData(id, count) {
// 點同一筆 id 不要有動作
@@ -317,7 +318,7 @@ export default {
},
/**
* 無限滾動: 監聽 scroll 有沒有滾到底部
* @param {element} event
* @param {element} event 滾動傳入的事件
*/
handleScroll(event) {
if(this.infinitMaxItems || this.baseCases.length < 20 || this.infiniteFinish === false) return;

View File

@@ -300,7 +300,7 @@ export default {
},
/**
* Number to percentage
* @param {number} val
* @param {number} val 原始數字
* @returns {string} 轉換完成的百分比字串
*/
getPercentLabel(val){
@@ -309,7 +309,7 @@ export default {
},
/**
* set progress bar width
* @param {number} value
* @param {number} value 百分比數字
* @returns {string} 樣式的寬度設定
*/
progressWidth(value){
@@ -336,7 +336,7 @@ export default {
},
// 調整 filterStartData / filterEndData / filterStartToEndData / filterEndToStartData 的內容
/**
* @param {array} array filterStartToEnd / filterEndToStart
* @param {array} array filterStartToEnd / filterEndToStart,可傳入以上任一。
*/
setActData(array) {
let list = [];
@@ -379,7 +379,7 @@ export default {
this.selectFilterEnd = e.data;
},
/**
* @param {array} e Update List Seq
* @param {array} listSeq Update List Seq
*/
onUpdateListSeq(listSeq) {
this.listSeq = listSeq;
@@ -397,6 +397,9 @@ export default {
this.rowData = e.data;
}
},
/**
* @param {object} e object contains selected row's data
*/
endRow(e) {
this.selectFilterEndToStart = e.data;
if(this.isEndSelected === null || this.isEndSelected === true){
@@ -500,7 +503,7 @@ export default {
};
},
/**
* @param {boolean} massage true | false 清空選項
* @param {boolean} massage true | false 清空選項,可選以上任一。
*/
reset(massage) {
// Sequence
@@ -527,7 +530,9 @@ export default {
// 成功訊息
massage ? this.$toast.success('Filter cleared.') : null;
},
// header:Filter 發送選取的資料
/**
* header:Filter 發送選取的資料
*/
async submit(){
this.isLoading = true;
let data;

View File

@@ -255,7 +255,7 @@ export default {
},
/**
* Number to percentage
* @param {number} val
* @param {number} val 原始數字
* @returns {string} 轉換完成的百分比字串
*/
getPercentLabel(val){

View File

@@ -152,7 +152,7 @@ export default {
methods: {
/**
* Number to percentage
* @param {number} val
* @param {number} val 原始數字
* @returns {string} 轉換完成的百分比字串
*/
getPercentLabel(val){
@@ -161,7 +161,7 @@ export default {
},
/**
* set progress bar width
* @param {number} value
* @param {number} value 百分比數字
* @returns {string} 樣式的寬度設定
*/
progressWidth(value){
@@ -169,7 +169,8 @@ export default {
},
/**
* switch case data
* @param {number} id
* @param {number} id case id
* @param {number} count 總 case 數量
*/
async switchCaseData(id, count) {
// 點同一筆 id 不要有動作
@@ -246,7 +247,7 @@ export default {
},
/**
* 無限滾動: 監聽 scroll 有沒有滾到底部
* @param {element} event
* @param {element} event 滾動傳入的事件
*/
handleScroll(event) {
if(this.infinitMaxItems || this.cases.length < 20 || this.infiniteFinish === false) return;

View File

@@ -108,7 +108,7 @@ export default {
methods: {
/**
* switch map type
* @param {string} type processMap | bpmn
* @param {string} type 'processMap' | 'bpmn',可傳入以上任一。
*/
switchMapType(type) {
this.mapType = type;
@@ -116,7 +116,7 @@ export default {
},
/**
* switch curve style
* @param {string} style 直角 unbundled-bezier | taxi
* @param {string} style 直角 'unbundled-bezier' | 'taxi',可傳入以上任一。
*/
switchCurveStyles(style) {
this.curveStyle = style;
@@ -124,7 +124,7 @@ export default {
},
/**
* switch rank
* @param {string} rank 直向 TB | 橫向 LR
* @param {string} rank 直向 'TB' | 橫向 'LR',可傳入以上任一。
*/
switchRank(rank) {
this.rank = rank;
@@ -132,8 +132,8 @@ export default {
},
/**
* switch Data Layoer Type or Option.
* @param {string} e
* @param {string} type freq | duration
* @param {string} e 切換時傳入的選項
* @param {string} type 'freq' | 'duration',可傳入以上任一。
*/
switchDataLayerType(e, type){
let value = '';

View File

@@ -104,7 +104,7 @@ export default {
methods: {
/**
* Number to percentage
* @param {number} val
* @param {number} val 原始數字
* @returns {string} 轉換完成的百分比字串
*/
getPercentLabel(val){

View File

@@ -37,6 +37,10 @@ export default {
IconUploarding,
},
methods: {
/**
* 上傳的行為
* @param {event} event input 傳入的事件
*/
async upload(event) {
const fileInput = document.getElementById('uploadFiles');
const target = event.target;

View File

@@ -48,6 +48,9 @@ export default {
IconMember
},
methods: {
/**
* 登出的行為
*/
logOutButton() {
if ((this.$route.name === 'Map' || this.$route.name === 'CheckMap') && this.tempFilterId) {
// 傳給 Map通知 Sidebar 要關閉。

View File

@@ -82,11 +82,11 @@ export default {
showNavbarBreadcrumb: false,
navViewData:
{
// FILES: ['ALL', 'DISCOVER', 'COMPARE', 'DESIGN', 'SIMULATION'],
// 舉例:FILES: ['ALL', 'DISCOVER', 'COMPARE', 'DESIGN', 'SIMULATION'],
FILES: ['ALL', 'DISCOVER', 'COMPARE'],
// DISCOVER: ['MAP', 'CONFORMANCE', 'PERFORMANCE', 'DATA']
// 舉例:DISCOVER: ['MAP', 'CONFORMANCE', 'PERFORMANCE', 'DATA']
DISCOVER: ['MAP', 'CONFORMANCE', 'PERFORMANCE'],
// COMPARE: ['PROCESS MAP', 'DASHBOARD']
// 舉例:COMPARE: ['PROCESS MAP', 'DASHBOARD']
COMPARE: ['DASHBOARD']
},
navViewName: 'FILES',
@@ -130,6 +130,7 @@ export default {
methods: {
/**
* switch navbar item
* @param {event} event 選取 Navbar 選項後傳入的值
*/
switchNavItem(event) {
let type;

View File

@@ -148,12 +148,15 @@ export default {
},
},
methods: {
/**
* 關閉選單視窗
*/
onClose () {
this.openTimeSelect = false;
},
/**
* get focus element
* @param {event} event
* @param {event} event input 傳入的事件
*/
onFocus(event) {
this.lastInput = event.target;
@@ -161,7 +164,7 @@ export default {
},
/**
* when blur update input value and show number
* @param {event} event
* @param {event} event input 傳入的事件
*/
onBlur(event) {
let baseInputValue = event.target.value;
@@ -202,7 +205,7 @@ export default {
},
/**
* 上下箭頭時的行為
* @param {event} event
* @param {event} event input 傳入的事件
*/
onKeyUp(event) {
event.target.value = event.target.value.replace(/\D/g, '');
@@ -213,9 +216,9 @@ export default {
},
/**
* 上下箭頭時的行為
* @param {element} input
* @param {number} goUp
* @param {boolean} selectIt
* @param {element} input input 傳入的事件
* @param {number} goUp 上箭頭的鍵盤代號
* @param {boolean} selectIt 是否已執行
*/
actionUpDown(input, goUp, selectIt = false) {
const tUnit = input.dataset.tunit;
@@ -291,8 +294,8 @@ export default {
},
/**
* 設定 dhms 的數值
* @param {number} totalSeconds
* @param {string} size
* @param {number} totalSeconds 總秒數
* @param {string} size 'min' | 'max',可選以上任一,最大值或最小值
*/
secondToDate(totalSeconds, size) {
totalSeconds = parseInt(totalSeconds);