xt-element-ui 2.2.2 → 2.2.4

package/src/components/xt-date-picker/style/index.scss

@@ -1,64 +1,89 @@
 
 @import '../../../styles/variables.scss';
 .xt-date-picker-container {
-    display: inline-block;
-    width: 100%;
-    
-  }
-  .xt-date .el-date-editor .el-input__inner {
-    background-color: var(--xt-fill-color-blank);
-    border-color: var(--xt-border-color);
-    color: var(--xt-text-color-regular);
-    font-size: var(--xt-font-size-base, 14px);
-    border-radius: var(--xt-border-radius-small, 4px);
-    height: var(--xt-input-height);
-    line-height: var(--xt-input-height);
-    padding: 0 15px;
+  display: inline-block;
+  width: 100%;
+  --xt-input-height: 32px;
+}
+.xt-date .el-date-editor .el-input__inner {
+  background-color: var(--xt-fill-color-blank);
+  border-color: var(--xt-border-color);
+  color: var(--xt-text-color-regular);
+  font-size: var(--xt-font-size-base, 14px);
+  border-radius: var(--xt-border-radius-small, 4px);
+  height: var(--xt-input-height);
+  line-height: var(--xt-input-height);
+  padding: 0 30px;
+}
+.xt-date-dimension {
+  margin-bottom: 8px;
+}
+
+.xt-date-picker-wrapper {
+  display: inline-block;
 }
-  .xt-date-dimension {
-    margin-bottom: 8px;
-  }
   
-  .xt-date-picker-wrapper {
-    display: inline-block;
+
+
+
+.quarter-panel {
+  padding: 10px;
+
+  .quarter-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 10px;
+  }
+
+  .quarter-list {
+    display: grid;
+    grid-template-columns: repeat(2, 1fr);
+    gap: 8px;
   }
-  
 
+  .quarter-item {
+    text-align: center;
+    padding: 8px 0;
+    border: 1px solid #e4e7ed;
+    border-radius: 4px;
+    cursor: pointer;
+  }
 
+  .quarter-item.active {
+    background: #409eff;
+    color: #fff;
+    border-color: #409eff;
+  }
 
-.date-picker {
-    .quarter-panel {
-      padding: 10px;
-    }
-  
-    .quarter-header {
-      display: flex;
-      align-items: center;
-      justify-content: space-between;
-      margin-bottom: 10px;
-    }
-  
-    .quarter-list {
-      display: grid;
-      grid-template-columns: repeat(2, 1fr);
-      gap: 8px;
-    }
-  
-    .quarter-item {
-      text-align: center;
-      padding: 8px 0;
-      border: 1px solid #e4e7ed;
-      border-radius: 4px;
-      cursor: pointer;
-    }
-  
-    .quarter-item.active {
-      background: #409eff;
-      color: #fff;
-      border-color: #409eff;
-    }
+  ::v-deep .base-date-popper {
+    border-radius: 4px;
+  }
+}
   
-    ::v-deep .base-date-popper {
-      border-radius: 4px;
-    }
-  }
+.range-picker {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 8px;
+  width: 100%;
+}
+.range-picker .el-date-editor {
+  flex: 1;
+  min-width: 130px;
+}
+.split {
+  flex-shrink: 0;
+  padding: 0 4px;
+}
+/* 手机/窄侧边栏自动竖向排列 */
+@media (max-width: 360px) {
+  .range-picker {
+    flex-direction: column;
+    align-items: stretch;
+  }
+  .split {
+    text-align: center;
+    margin: 4px 0;
+  }
+}

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>