From 61e0a12c6a21debdf17bb15a7421f98d9654c2e3 Mon Sep 17 00:00:00 2001
From: Odboy <tianjun@odboy.cn>
Date: Wed, 16 Jul 2025 21:13:57 +0800
Subject: [PATCH] =?UTF-8?q?feat(frontend):=20=E6=96=B0=E5=A2=9E=E6=8B=96?=
 =?UTF-8?q?=E6=8B=BD=E8=A1=A8=E6=A0=BC=E7=BB=84=E4=BB=B6=E5=B9=B6=E4=BC=98?=
 =?UTF-8?q?=E5=8C=96=E6=95=B0=E6=8D=AE=E8=A1=A8=E6=A0=BC=E7=9B=B8=E5=85=B3?=
 =?UTF-8?q?=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 CuteDragTable组件，支持行拖拽排序功能
- 重构 CuteTable 组件，改为 CuteSimpleTable，简化功能
- 更新 README.md，添加新组件说明
- 优化 OneKeyCopy 组件，改名为 CuteOneKeyCopy
- 删除示例页面 cuteTableDemo.vue
---
 .../views/components/base/ClipboardDemo.vue   |  61 ------
 .../views/components/dev/CuteDragTable.vue    | 176 ++++++++++++++++++
 .../OneKeyCopy.vue => dev/CuteOneKeyCopy.vue} |   3 +-
 .../{CuteTable.vue => CuteSimpleTable.vue}    |  37 ++--
 cutejava-front/src/views/cuteTableDemo.vue    | 162 ----------------
 cutejava/README.md                            |   5 +-
 .../controller/SystemDictController.java      |   7 +-
 7 files changed, 208 insertions(+), 243 deletions(-)
 delete mode 100644 cutejava-front/src/views/components/base/ClipboardDemo.vue
 create mode 100644 cutejava-front/src/views/components/dev/CuteDragTable.vue
 rename cutejava-front/src/views/components/{base/OneKeyCopy.vue => dev/CuteOneKeyCopy.vue} (88%)
 rename cutejava-front/src/views/components/dev/{CuteTable.vue => CuteSimpleTable.vue} (83%)
 delete mode 100644 cutejava-front/src/views/cuteTableDemo.vue

diff --git a/cutejava-front/src/views/components/base/ClipboardDemo.vue b/cutejava-front/src/views/components/base/ClipboardDemo.vue
deleted file mode 100644
index c979eb49..00000000
--- a/cutejava-front/src/views/components/base/ClipboardDemo.vue
+++ /dev/null
@@ -1,61 +0,0 @@
-<template>
-  <div>
-    <el-divider>clipboard版</el-divider>
-    <span>{{ msg }}</span>
-    <div id="btn" @click="copy">复制</div>
-    <el-divider>OneKeyCopy组件版</el-divider>
-    <one-key-copy style="margin-left: 10pt" :content.sync="msg" />
-  </div>
-</template>
-<script>
-import Clipboard from 'clipboard'
-import { Message } from 'element-ui'
-import OneKeyCopy from '@/views/components/base/OneKeyCopy.vue'
-export default {
-  components: { OneKeyCopy },
-  data() {
-    return {
-      msg: '来复制我吧'
-    }
-  },
-  methods: {
-    // 复制方法
-    copy() {
-      const that = this
-      const clipboard = new Clipboard('#btn', {
-        text(trigger) {
-          console.log(trigger)
-          // 返回字符串
-          return that.msg
-        }
-      })
-      // 复制成功
-      clipboard.on('success', (e) => {
-        Message.success('复制成功')
-        console.log(e, '复制成功')
-        clipboard.destroy()
-      })
-      // //复制失败
-      clipboard.on('error', (e) => {
-        Message.error('复制失败')
-        console.log(e, '复制失败')
-        clipboard.destroy()
-      })
-    }
-  }
-}
-</script>
-<style scoped>
-#btn {
-  display: inline-block;
-  padding: 3px 12px;
-  border-radius: 6px;
-  background-color: #eee;
-  color: #333;
-  cursor: pointer;
-}
-#btn:active {
-  background-color: #ddd;
-  color: #666;
-}
-</style>
diff --git a/cutejava-front/src/views/components/dev/CuteDragTable.vue b/cutejava-front/src/views/components/dev/CuteDragTable.vue
new file mode 100644
index 00000000..dbe2065d
--- /dev/null
+++ b/cutejava-front/src/views/components/dev/CuteDragTable.vue
@@ -0,0 +1,176 @@
+<template>
+  <div>
+    <el-table
+      ref="table"
+      v-loading="crud.loading"
+      stripe
+      empty-text="暂无数据"
+      :row-key="crud.primaryKey"
+      fit
+      :data="crud.dataSource"
+      style="width: 100%;"
+      height="450"
+      max-height="450"
+      @selection-change="onTableSelectionChange"
+    >
+      <el-table-column v-if="mode === 'multi'" type="selection" width="55" />
+      <el-table-column v-for="(column, index) in crud.columns" :key="index" :label="column.label" :prop="column.prop" :formatter="column.formatter ? column.formatter : null" />
+      <el-table-column v-if="crud.operateColumn" :width="crud.operateColumn.width" label="操作" :formatter="crud.operateColumn.formatter" :fixed="crud.operateColumn.fixed" />
+    </el-table>
+    <el-pagination
+      :current-page="pageProps.current"
+      :page-sizes="[10, 20, 50]"
+      :page-size="pageProps.pageSize"
+      layout="total, sizes, prev, pager, next"
+      :total="pageProps.total"
+      @size-change="(size) => crud.onPageChange(pageProps.current, size, pageProps.total)"
+      @current-change="(current) => crud.onPageChange(current, pageProps.pageSize, pageProps.total)"
+    />
+  </div>
+</template>
+
+<script>
+import Sortable from 'sortablejs'
+export default {
+  name: 'CuteDragTable',
+  props: {
+    primaryKey: {
+      type: String,
+      required: true,
+      default: null
+    },
+    columns: {
+      type: Array,
+      required: true,
+      default: null
+    },
+    operateColumn: {
+      type: Object,
+      required: true,
+      default: null
+    },
+    dataSource: {
+      type: Array,
+      required: false,
+      default: null
+    },
+    fetch: {
+      type: Function,
+      required: false,
+      default: null
+    },
+    paramsTransform: {
+      type: Function,
+      required: false,
+      default: null
+    },
+    responseTransform: {
+      type: Function,
+      required: false,
+      default: null
+    },
+    mode: {
+      type: String,
+      required: false,
+      default: 'none'
+    },
+    pageProps: {
+      type: Object,
+      required: true,
+      default: function() {
+        return {
+          current: 1,
+          pageSize: 10,
+          total: 0
+        }
+      }
+    }
+  },
+  data() {
+    return {
+      crud: {
+        loading: false,
+        primaryKey: this.primaryKey ? this.primaryKey : 'id',
+        columns: this.columns && this.columns.length > 0 ? this.columns : [],
+        operateColumn: this.operateColumn,
+        fetchUrl: null,
+        dataSource: this.dataSource && this.dataSource.length > 0 ? this.dataSource : [],
+        onPageChange: (currentPage, pageSize) => {
+          this.pageProps.current = currentPage
+          this.pageProps.pageSize = pageSize
+          console.log('on-page-change', currentPage, pageSize)
+          // this.$emit('onPageChange', currentPage, pageSize, total)
+          this.refresh()
+        }
+      }
+    }
+  },
+  mounted() {
+    this.initData()
+  },
+  methods: {
+    refresh() {
+      this.initData()
+      this.initDragTable()
+    },
+    async initData() {
+      // 以dataSource属性为准
+      if (this.dataSource) {
+        this.crud.dataSource = this.dataSource
+        return
+      }
+      let params = {}
+      // 自定义请求参数
+      if (this.paramsTransform) {
+        params = this.paramsTransform(this.pageProps)
+      }
+      if (this.fetch) {
+        try {
+          this.crud.loading = true
+          // 请求远程数据
+          const response = await this.fetch(params)
+          // console.error('response', response)
+          // { content: [], totalElements: 0 }
+          // 转换为表格所需要的数据
+          if (this.responseTransform) {
+            return this.responseTransform(response)
+          }
+          if (response && response.totalElements && response.content) {
+            this.pageProps.total = response.totalElements
+            this.crud.dataSource = response.content
+          }
+          return response
+        } finally {
+          this.crud.loading = false
+        }
+      }
+    },
+    onTableSelectionChange(selection) {
+      this.$emit('selection-change', selection)
+    },
+    initDragTable() {
+      const that = this
+      const table = that.$refs.table.$el.querySelectorAll('.el-table__body-wrapper > table > tbody')[0]
+      Sortable.create(table, {
+        animation: 1000,
+        onEnd({ newIndex, oldIndex }) {
+          // 拖拽排序数据
+          that.crud.dataSource.splice(newIndex, 0, that.crud.dataSource.splice(oldIndex, 1)[0])
+          const newArray = that.crud.dataSource.slice(0)
+          that.crud.dataSource = [] // 必须有此步骤，不然拖拽后回弹
+          that.$nextTick(function() {
+            that.crud.dataSource = newArray // 重新赋值，用新数据来刷新视图
+            this.updateOrderNum(that.crud.dataSource)// 更改列表中的序号，使序号1.2.3.4.....显示，不然就是行拖拽后乱序显示如:3.2.4.1...
+          })
+        }
+      })
+    },
+    updateOrderNum(data) {
+      data.forEach((item, index) => {
+        item.orderNum = index + 1
+      })
+    }
+  }
+}
+</script>
+
diff --git a/cutejava-front/src/views/components/base/OneKeyCopy.vue b/cutejava-front/src/views/components/dev/CuteOneKeyCopy.vue
similarity index 88%
rename from cutejava-front/src/views/components/base/OneKeyCopy.vue
rename to cutejava-front/src/views/components/dev/CuteOneKeyCopy.vue
index 15873401..02454b87 100644
--- a/cutejava-front/src/views/components/base/OneKeyCopy.vue
+++ b/cutejava-front/src/views/components/dev/CuteOneKeyCopy.vue
@@ -1,7 +1,6 @@
 <!-- 一键复制组件 -->
 <!-- 使用方式： <one-key-copy style="margin-left: 10pt" :content.sync="data" /> -->
 <template>
-  <!--  <el-tooltip class="item" effect="dark" content="复制" placement="right-end">-->
   <el-button
     v-clipboard:copy="content"
     v-clipboard:success="onCopy"
@@ -9,11 +8,11 @@
     size="mini"
     icon="el-icon-document-copy"
   />
-  <!--  </el-tooltip>-->
 </template>
 
 <script>
 export default {
+  name: 'CuteOneKeyCopy',
   props: {
     content: {
       type: String,
diff --git a/cutejava-front/src/views/components/dev/CuteTable.vue b/cutejava-front/src/views/components/dev/CuteSimpleTable.vue
similarity index 83%
rename from cutejava-front/src/views/components/dev/CuteTable.vue
rename to cutejava-front/src/views/components/dev/CuteSimpleTable.vue
index 762e30c3..a1e2457b 100644
--- a/cutejava-front/src/views/components/dev/CuteTable.vue
+++ b/cutejava-front/src/views/components/dev/CuteSimpleTable.vue
@@ -18,13 +18,13 @@
       <el-table-column v-if="crud.operateColumn" :width="crud.operateColumn.width" label="操作" :formatter="crud.operateColumn.formatter" :fixed="crud.operateColumn.fixed" />
     </el-table>
     <el-pagination
-      :current-page="crud.pageProps.current"
+      :current-page="pageProps.current"
       :page-sizes="[10, 20, 50]"
-      :page-size="crud.pageProps.pageSize"
+      :page-size="pageProps.pageSize"
       layout="total, sizes, prev, pager, next"
-      :total="crud.pageProps.total"
-      @size-change="(size) => crud.onPageChange(crud.pageProps.current, size, crud.pageProps.total)"
-      @current-change="(current) => crud.onPageChange(current, crud.pageProps.pageSize, crud.pageProps.total)"
+      :total="pageProps.total"
+      @size-change="(size) => crud.onPageChange(pageProps.current, size, pageProps.total)"
+      @current-change="(current) => crud.onPageChange(current, pageProps.pageSize, pageProps.total)"
     />
   </div>
 </template>
@@ -32,7 +32,7 @@
 <script>
 
 export default {
-  name: 'CuteTable',
+  name: 'CuteSimpleTable',
   props: {
     primaryKey: {
       type: String,
@@ -73,6 +73,17 @@ export default {
       type: String,
       required: false,
       default: 'none'
+    },
+    pageProps: {
+      type: Object,
+      required: true,
+      default: function() {
+        return {
+          current: 1,
+          pageSize: 10,
+          total: 0
+        }
+      }
     }
   },
   data() {
@@ -84,16 +95,12 @@ export default {
         operateColumn: this.operateColumn,
         fetchUrl: null,
         dataSource: this.dataSource && this.dataSource.length > 0 ? this.dataSource : [],
-        pageProps: {
-          current: 1,
-          pageSize: 10,
-          total: 0
-        },
         onPageChange: (currentPage, pageSize) => {
-          this.crud.pageProps.current = currentPage
-          this.crud.pageProps.pageSize = pageSize
+          this.pageProps.current = currentPage
+          this.pageProps.pageSize = pageSize
           console.log('on-page-change', currentPage, pageSize)
           // this.$emit('onPageChange', currentPage, pageSize, total)
+          this.refresh()
         }
       }
     }
@@ -114,7 +121,7 @@ export default {
       let params = {}
       // 自定义请求参数
       if (this.paramsTransform) {
-        params = this.paramsTransform(this.crud.pageProps)
+        params = this.paramsTransform(this.pageProps)
       }
       if (this.fetch) {
         try {
@@ -128,7 +135,7 @@ export default {
             return this.responseTransform(response)
           }
           if (response && response.totalElements && response.content) {
-            this.crud.pageProps.total = response.totalElements
+            this.pageProps.total = response.totalElements
             this.crud.dataSource = response.content
           }
           return response
diff --git a/cutejava-front/src/views/cuteTableDemo.vue b/cutejava-front/src/views/cuteTableDemo.vue
deleted file mode 100644
index df14e63f..00000000
--- a/cutejava-front/src/views/cuteTableDemo.vue
+++ /dev/null
@@ -1,162 +0,0 @@
-<template>
-  <div class="app-container">
-    <!-- 工具栏 -->
-    <div class="head-container">
-      <el-form
-        ref="searchForm"
-        :inline="true"
-        :model="form.model"
-        label-position="right"
-        label-width="80px"
-        :rules="form.rules"
-      >
-        <el-form-item label="模糊查询" prop="blurry">
-          <el-input v-model="form.model.blurry" clearable />
-        </el-form-item>
-        <el-form-item>
-          <el-button type="primary" @click="onFormSubmit('searchForm')">查询</el-button>
-          <el-button @click="onFormReset('searchForm')">重置</el-button>
-        </el-form-item>
-        <el-form-item>
-          <el-button type="primary" @click="onCreateClick">创建XXX</el-button>
-        </el-form-item>
-      </el-form>
-    </div>
-    <!-- 表格渲染 -->
-    <!-- fetch: 获取远程数据 -->
-    <!-- params-transform: 组装查询参数 -->
-    <!-- responseTransform: 组装表格对象。对响应结果做处理 -->
-    <!-- primary-key: 主键 -->
-    <!-- columns: 表格列 -->
-    <!-- operate-column: 表格操作列 -->
-    <!-- data-source: 数据源。当data-source不为空时，以data-source的数据为主 -->
-    <!-- mode: 模式。不传默认，传multi为多选 -->
-    <!-- @selection-change: 当且仅当mode为multi时启用 -->
-    <cute-table
-      ref="instance"
-      :fetch="curd.fetch"
-      :params-transform="curd.paramsTransform"
-      primary-key="id"
-      :columns="curd.columns"
-      :operate-column="curd.operateColumn"
-      :data-source="curd.dataSource"
-    />
-    <cute-form-dialog ref="createForm" :form="createForm" title="创建XXX" @submit="onCreateFormSubmit">
-      <el-form-item label="活动名称" prop="name" label-width="100px">
-        <el-input v-model="createForm.model.name" placeholder="请输入" style="width: 100%" />
-      </el-form-item>
-      <el-form-item label="活动区域" prop="region" label-width="100px">
-        <el-select v-model="createForm.model.region" placeholder="请选择" style="width: 100%">
-          <el-option label="区域一" value="shanghai" />
-          <el-option label="区域二" value="beijing" />
-        </el-select>
-      </el-form-item>
-    </cute-form-dialog>
-  </div>
-</template>
-
-<script>
-import CuteTable from '@/views/components/dev/CuteTable'
-import { DateUtil } from '@/utils/myUtil'
-import DictService from '@/api/system/dict'
-import CuteFormDialog from '@/views/components/dev/CuteFormDialog.vue'
-
-export default {
-  name: 'ListDemo',
-  components: { CuteFormDialog, CuteTable },
-  data() {
-    return {
-      form: {
-        model: {
-          blurry: ''
-        },
-        rules: {}
-      },
-      curd: {
-        paramsTransform: (pageProps) => {
-          const values = this.form.model
-          return {
-            page: pageProps.current,
-            size: pageProps.pageSize,
-            args: {
-              ...values
-            }
-          }
-        },
-        fetch: async(queryParams) => {
-          return await DictService.queryPageDict(queryParams)
-        },
-        columns: [
-          { prop: 'name', label: '名称' },
-          { prop: 'description', label: '描述' },
-          { prop: 'createTime', label: '创建时间', formatter: DateUtil.formatRowDateTime },
-          { prop: 'createBy', label: '创建人' }
-        ],
-        operateColumn: {
-          width: '150',
-          fixed: 'right',
-          formatter: (row, column, cellValue, index) => {
-            return (<div>
-              <el-button type='text' onClick={() => {
-                console.log('编辑')
-              }}>编辑
-              </el-button>
-              <el-button type='text' onClick={() => {
-                console.log('删除')
-              }}>删除
-              </el-button>
-            </div>)
-          }
-        }
-      },
-      createForm: {
-        model: {
-          name: '',
-          region: ''
-        },
-        rules: {
-          name: [
-            { required: true, message: '请输入活动名称', trigger: 'blur' },
-            { min: 3, max: 5, message: '长度在 3 到 5 个字符', trigger: 'blur' }
-          ],
-          region: [
-            { required: true, message: '请选择活动区域', trigger: 'change' }
-          ]
-        }
-      }
-    }
-  },
-  mounted() {
-    this.initData()
-  },
-  methods: {
-    initData() {
-      this.$refs.instance.refresh()
-    },
-    onFormSubmit(formName) {
-      const that = this
-      that.$refs[formName].validate((valid) => {
-        if (valid) {
-          that.$refs.instance.refresh()
-        } else {
-          return false
-        }
-      })
-    },
-    onFormReset(formName) {
-      try {
-        this.$refs[formName].resetFields()
-      } catch (e) {
-        console.error(e)
-      }
-    },
-    onCreateClick() {
-      this.$refs.createForm.show()
-    },
-    onCreateFormSubmit(values) {
-      console.error('formValues', values)
-    }
-  }
-}
-</script>
-
diff --git a/cutejava/README.md b/cutejava/README.md
index 696400d8..907ef08e 100644
--- a/cutejava/README.md
+++ b/cutejava/README.md
@@ -54,8 +54,9 @@ https://github.com/odboy-tianjun/cutejava
 
 #### 丰富的自定义组件
 
-- CuteTable
-- CuteFormDialog
+- CuteSimpleTable 简单表格
+- CuteDragTable 支持拖拽的表格
+- CuteFormDialog 支持表单的对话框
 
 #### 系统模块
 
diff --git a/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java b/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java
index 57fb3d1b..c511bbab 100644
--- a/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java
+++ b/cutejava/cutejava-module-system/src/main/java/cn/odboy/system/controller/SystemDictController.java
@@ -46,8 +46,13 @@ public class SystemDictController {
     @PostMapping
     @PreAuthorize("@el.check('dict:list')")
     public ResponseEntity<CsResultVo<List<SystemDictTb>>> queryDictByArgs(@Validated @RequestBody CsPageArgs<SystemQueryDictArgs> args) {
+        Page<SystemDictTb> page;
         SystemQueryDictArgs criteria = args.getArgs();
-        Page<SystemDictTb> page = new Page<>(criteria.getPage(), criteria.getSize());
+        if (args.getSize() != null) {
+            page = new Page<>(args.getPage(), args.getSize());
+        } else {
+            page = new Page<>(criteria.getPage(), criteria.getSize());
+        }
         return new ResponseEntity<>(systemDictService.queryDictByArgs(criteria, page), HttpStatus.OK);
     }