xt-element-ui 2.2.1 → 2.2.3

package/src/components/xt-flow/flowable-parser.js

@@ -0,0 +1,244 @@
+/**
+ * Flowable 工作流数据格式化工具
+ *
+ * 原生 Flowable 数据格式示例：
+ * {
+ *   "id": "75001",
+ *   "processInstanceId": "25001",
+ *   "taskId": "50001",
+ *   "taskName": "部门经理审批",
+ *   "assignee": "张三",
+ *   "startTime": "2024-01-01T10:00:00",
+ *   "endTime": "2024-01-01T10:30:00",
+ *   "deleteReason": null,
+ *   "type": "startEvent" | "userTask" | "endEvent"
+ * }
+ *
+ * 历史任务（HistoricTaskInstance）：
+ * {
+ *   "id": "50001",
+ *   "name": "部门经理审批",
+ *   "assignee": "张三",
+ *   "startTime": "2024-01-01T10:00:00",
+ *   "endTime": "2024-01-01T10:30:00",
+ *   "deleteReason": "rejected",
+ *   "durationInMillis": 1800000
+ * }
+ */
+
+// 默认待办节点
+const DEFAULT_PENDING_NODE = {
+  status: 'pending',
+  name: '待处理',
+  assignee: '--',
+  createTime: null,
+  comment: '等待审批中...'
+}
+
+/**
+ * 解析 Flowable 原始数据为 xt-flow 组件格式
+ * @param {Array} rawData - Flowable 返回的原始数据
+ * @param {Object} options
+ * @param {Object} options.pendingNode - 自定义待办节点数据
+ * @param {Boolean} options.autoPending - 是否自动追加待办节点（默认 true）
+ * @returns {Array} 标准化后的节点数组
+ */
+export function parseFlowData(rawData, options = {}) {
+  const { pendingNode = null, autoPending = true } = options
+
+  if (!rawData || !rawData.length) {
+    return []
+  }
+
+  const nodes = rawData
+    .filter((item) => {
+      // 过滤掉 startEvent 和无效数据
+      if (item.type === 'startEvent') return false
+      // 过滤掉没有任务名称的节点
+      if (!item.name && !item.taskName && !item.activityName) return false
+      return true
+    })
+    .map((item) => {
+      const node = {
+        id: item.id || item.taskId || '',
+        name: item.name || item.taskName || item.activityName || '',
+        assignee: item.assignee || '',
+        createTime: item.startTime || item.createTime || '',
+        endTime: item.endTime || '',
+        status: inferStatus(item),
+        comment: item.comment || item.deleteReason || '',
+        duration: formatDuration(item.durationInMillis || item.duration),
+        // 保留原始数据用于插槽扩展
+        raw: item
+      }
+      return node
+    })
+
+  // 自动追加待办节点
+  if (autoPending && nodes.length > 0) {
+    const lastNode = nodes[nodes.length - 1]
+    // 如果最后一个节点不是 pending 状态，追加待办节点
+    if (lastNode.status !== 'pending') {
+      const pending = pendingNode || DEFAULT_PENDING_NODE
+      nodes.push({
+        id: 'pending',
+        name: pending.name || '待处理',
+        assignee: pending.assignee || '--',
+        createTime: pending.createTime || null,
+        endTime: null,
+        status: 'pending',
+        comment: pending.comment || '',
+        duration: '',
+        raw: pending
+      })
+    }
+  }
+
+  return nodes
+}
+
+/**
+ * 推断节点状态
+ * @param {Object} item - Flowable 原始数据项
+ * @returns {String} 状态值
+ */
+function inferStatus(item) {
+  const deleteReason = (item.deleteReason || '').toLowerCase()
+
+  // 根据 deleteReason 判断
+  if (deleteReason.includes('reject') || deleteReason.includes('驳回')) {
+    return 'rejected'
+  }
+  if (deleteReason.includes('delegate') || deleteReason.includes('委托')) {
+    return 'delegated'
+  }
+  if (deleteReason.includes('transfer') || deleteReason.includes('转办')) {
+    return 'transferred'
+  }
+  if (deleteReason.includes('revoke') || deleteReason.includes('撤回') || deleteReason.includes('recall')) {
+    return 'recalled'
+  }
+  if (deleteReason.includes('cancel') || deleteReason.includes('取消')) {
+    return 'cancelled'
+  }
+
+  // 有结束时间且无驳回原因 → 通过
+  if (item.endTime && !item.deleteReason) {
+    return 'approved'
+  }
+
+  // 无结束时间 → 待办中
+  if (!item.endTime) {
+    return 'pending'
+  }
+
+  return 'approved'
+}
+
+/**
+ * 格式化时长
+ * @param {Number} millis - 毫秒数
+ * @returns {String} 格式化后的时长
+ */
+function formatDuration(millis) {
+  if (!millis && millis !== 0) return ''
+
+  const totalSeconds = Math.floor(millis / 1000)
+  if (totalSeconds < 60) {
+    return `${totalSeconds}秒`
+  }
+
+  const minutes = Math.floor(totalSeconds / 60)
+  if (minutes < 60) {
+    return `${minutes}分钟`
+  }
+
+  const hours = Math.floor(minutes / 60)
+  const remainMinutes = minutes % 60
+  if (hours < 24) {
+    return remainMinutes > 0 ? `${hours}小时${remainMinutes}分钟` : `${hours}小时`
+  }
+
+  const days = Math.floor(hours / 24)
+  const remainHours = hours % 24
+  return remainHours > 0 ? `${days}天${remainHours}小时` : `${days}天`
+}
+
+/**
+ * 格式化时间字符串
+ * @param {String} timeStr - 时间字符串
+ * @param {String} format - 格式
+ * @returns {String} 格式化后的时间
+ */
+export function formatFlowTime(timeStr, format) {
+  if (!timeStr) return ''
+
+  try {
+    const d = new Date(timeStr)
+    if (isNaN(d.getTime())) return timeStr
+
+    const year = d.getFullYear()
+    const month = String(d.getMonth() + 1).padStart(2, '0')
+    const day = String(d.getDate()).padStart(2, '0')
+    const hour = String(d.getHours()).padStart(2, '0')
+    const minute = String(d.getMinutes()).padStart(2, '0')
+    const second = String(d.getSeconds()).padStart(2, '0')
+
+    return format
+      .replace('YYYY', year)
+      .replace('MM', month)
+      .replace('DD', day)
+      .replace('HH', hour)
+      .replace('mm', minute)
+      .replace('ss', second)
+  } catch (e) {
+    return timeStr
+  }
+}
+
+/**
+ * 生成模拟审批链数据（用于开发和演示）
+ * @param {Number} count - 节点数量
+ * @returns {Array} 模拟数据
+ */
+export function createMockFlowData(count = 7) {
+  const statuses = ['approved', 'approved', 'approved', 'rejected', 'pending', 'transferred', 'approved']
+  const names = [
+    '提交申请', '直属领导审批', '部门经理审批',
+    '总监审批', 'HR 审批', '总经理审批', '流程结束'
+  ]
+  const assignees = ['张三', '李四', '王五', '赵六', '钱七', '孙八', '周九']
+  const comments = [
+    '', '同意', '同意', '驳回：请补充材料后重新提交',
+    '', '', '同意'
+  ]
+
+  const now = new Date()
+  const result = []
+
+  for (let i = 0; i < Math.min(count, names.length); i++) {
+    const startTime = new Date(now.getTime() - (count - i) * 3600000)
+    const endTime = statuses[i] === 'pending'
+      ? null
+      : new Date(startTime.getTime() + 1800000)
+
+    result.push({
+      id: `flow-${i + 1}`,
+      name: names[i],
+      assignee: assignees[i],
+      status: statuses[i],
+      createTime: startTime.toISOString(),
+      endTime: endTime ? endTime.toISOString() : null,
+      comment: comments[i],
+      duration: endTime ? '30分钟' : ''
+    })
+  }
+
+  return result
+}
+
+export default {
+  parseFlowData,
+  formatFlowTime,
+  createMockFlowData
+}

package/src/components/xt-flow/index.js

@@ -0,0 +1,8 @@
+import './style/index.scss'
+import XtFlow from './index.vue'
+
+XtFlow.install = function(Vue) {
+  Vue.component(XtFlow.name, XtFlow)
+}
+
+export default XtFlow

package/src/components/xt-flow/index.vue

@@ -0,0 +1,226 @@
+<template>
+  <div class="xt-flow" :class="rootClasses">
+    <div
+      v-for="(node, index) in displayNodes"
+      :key="node.id || index"
+      class="xt-flow__node"
+      :class="nodeClasses(node, index)"
+    >
+      <!-- 时间线左侧 -->
+      <div class="xt-flow__timeline">
+        <!-- 节点图标 -->
+        <div class="xt-flow__icon" :class="`xt-flow__icon--${node.status}`">
+          <slot name="node-avatar" :node="node" :index="index">
+            <span class="xt-flow__icon-dot"></span>
+          </slot>
+        </div>
+        <!-- 连接线 -->
+        <div
+          v-if="index < displayNodes.length - 1"
+          class="xt-flow__line"
+          :class="[
+            `xt-flow__line--${node.status}`,
+            { 'xt-flow__line--dashed': node.status === 'rejected' }
+          ]"
+        ></div>
+      </div>
+
+      <!-- 节点内容 -->
+      <div class="xt-flow__body">
+        <div class="xt-flow__header">
+          <span class="xt-flow__title">
+            <slot name="node" :node="node" :index="index">
+              {{ node.name || node.title }}
+            </slot>
+          </span>
+          <span class="xt-flow__status" :class="`xt-flow__status--${node.status}`">
+            {{ statusText(node.status) }}
+          </span>
+        </div>
+
+        <div class="xt-flow__meta">
+          <template v-if="node.assignee">
+            <span class="xt-flow__assignee">
+              <slot name="assignee" :node="node" :index="index">
+                <span class="xt-flow__assignee-icon">👤</span>
+                {{ node.assignee }}
+              </slot>
+            </span>
+          </template>
+          <template v-if="node.createTime || node.endTime">
+            <span class="xt-flow__time">
+              {{ formatTime(node) }}
+            </span>
+          </template>
+          <template v-if="node.duration">
+            <span class="xt-flow__duration">
+              {{ node.duration }}
+            </span>
+          </template>
+        </div>
+
+        <div v-if="node.comment || node.description" class="xt-flow__desc">
+          <slot name="node-desc" :node="node" :index="index">
+            <template v-if="node.status === 'rejected' && node.comment">
+              <span class="xt-flow__desc-label">驳回原因：</span>
+            </template>
+            <template v-else-if="node.comment">
+              <span class="xt-flow__desc-label">审批意见：</span>
+            </template>
+            {{ node.comment || node.description }}
+          </slot>
+        </div>
+
+        <div v-if="$scopedSlots['node-action']" class="xt-flow__actions">
+          <slot name="node-action" :node="node" :index="index"></slot>
+        </div>
+      </div>
+    </div>
+
+    <!-- 折叠/展开触发器 -->
+    <div
+      v-if="isCollapsible && collapsed"
+      class="xt-flow__collapse"
+      @click="toggleCollapse"
+    >
+      <slot name="expand-trigger">
+        <span class="xt-flow__collapse-text">
+          展开全部 {{ totalCount }} 条审批记录
+          <span class="xt-flow__collapse-arrow">▼</span>
+        </span>
+      </slot>
+    </div>
+    <div
+      v-if="isCollapsible && !collapsed"
+      class="xt-flow__collapse"
+      @click="toggleCollapse"
+    >
+      <slot name="collapse-trigger">
+        <span class="xt-flow__collapse-text">
+          收起
+          <span class="xt-flow__collapse-arrow xt-flow__collapse-arrow--up">▲</span>
+        </span>
+      </slot>
+    </div>
+  </div>
+</template>
+
+<script>
+import { parseFlowData, formatFlowTime } from './flowable-parser'
+
+export default {
+  name: 'XtFlow',
+
+  props: {
+    // 数据源：数组格式，支持 Flowable 原始格式或自定义格式
+    data: {
+      type: Array,
+      default: () => []
+    },
+    // 是否自动折叠长审批链
+    collapse: {
+      type: Boolean,
+      default: true
+    },
+    // 折叠前可见节点数
+    collapseCount: {
+      type: Number,
+      default: 5
+    },
+    // 圆角风格：square 方形 / round 圆形
+    rounded: {
+      type: String,
+      default: 'square',
+      validator: (val) => ['square', 'round'].includes(val)
+    },
+    // 数据格式：flowable 原生 / custom 自定义
+    format: {
+      type: String,
+      default: 'flowable',
+      validator: (val) => ['flowable', 'custom'].includes(val)
+    },
+    // 时间格式（仅在 format='flowable' 时生效）
+    timeFormat: {
+      type: String,
+      default: 'YYYY-MM-DD HH:mm:ss'
+    },
+    // 自定义状态文本映射
+    statusMap: {
+      type: Object,
+      default: () => ({
+        approved: '已通过',
+        rejected: '已驳回',
+        pending: '待审批',
+        transferred: '已转办',
+        delegated: '已委托',
+        recalled: '已撤回',
+        started: '已发起',
+        cancelled: '已取消'
+      })
+    }
+  },
+
+  data() {
+    return {
+      collapsed: true
+    }
+  },
+
+  computed: {
+    rootClasses() {
+      return [
+        `xt-flow--${this.rounded}`
+      ]
+    },
+
+    parsedData() {
+      if (this.format === 'flowable') {
+        return parseFlowData(this.data)
+      }
+      return this.data
+    },
+
+    totalCount() {
+      return this.parsedData.length
+    },
+
+    isCollapsible() {
+      return this.collapse && this.totalCount > this.collapseCount
+    },
+
+    displayNodes() {
+      if (!this.isCollapsible || !this.collapsed) {
+        return this.parsedData
+      }
+      return this.parsedData.slice(0, this.collapseCount)
+    }
+  },
+
+  methods: {
+    nodeClasses(node, index) {
+      return [
+        `xt-flow__node--${node.status}`,
+        {
+          'xt-flow__node--last': index === this.displayNodes.length - 1,
+          'xt-flow__node--first': index === 0
+        }
+      ]
+    },
+
+    statusText(status) {
+      return this.statusMap[status] || status
+    },
+
+    formatTime(node) {
+      if (this.format === 'flowable') {
+        return formatFlowTime(node.createTime || node.endTime, this.timeFormat)
+      }
+      return node.createTime || node.endTime || ''
+    },
+
+    toggleCollapse() {
+      this.collapsed = !this.collapsed
+    }
+  }
+}
+</script>