useTable.ts 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146
  1. import { Table } from "./interface";
  2. import { reactive, computed, toRefs } from "vue";
  3. /**
  4. * @description table 页面操作方法封装
  5. * @param {Function} api 获取表格数据 api 方法 (必传)
  6. * @param {Object} initParam 获取数据初始化参数 (非必传,默认为{})
  7. * @param {Boolean} isPageable 是否有分页 (非必传,默认为true)
  8. * @param {Function} dataCallBack 对后台返回的数据进行处理的方法 (非必传)
  9. * */
  10. export const useTable = (
  11. api?: (params: any) => Promise<any>,
  12. initParam: object = {},
  13. isPageable: boolean = true,
  14. dataCallBack?: (data: any) => any,
  15. requestError?: (error: any) => void
  16. ) => {
  17. const state = reactive<Table.StateProps>({
  18. // 表格数据
  19. tableData: [],
  20. // 分页数据
  21. pageable: {
  22. // 当前页数
  23. pageNum: 1,
  24. // 每页显示条数
  25. pageSize: 10,
  26. // 总条数
  27. total: 0
  28. },
  29. // 查询参数(只包括查询)
  30. searchParam: {},
  31. // 初始化默认的查询参数
  32. searchInitParam: {},
  33. // 总参数(包含分页和查询参数)
  34. totalParam: {}
  35. });
  36. /**
  37. * @description 分页查询参数(只包括分页和表格字段排序,其他排序方式可自行配置)
  38. * */
  39. const pageParam = computed({
  40. get: () => {
  41. return {
  42. pageNum: state.pageable.pageNum,
  43. pageSize: state.pageable.pageSize
  44. };
  45. },
  46. set: (newVal: any) => {
  47. console.log("我是分页更新之后的值", newVal);
  48. }
  49. });
  50. /**
  51. * @description 获取表格数据
  52. * @return void
  53. * */
  54. const getTableList = async () => {
  55. if (!api) return;
  56. try {
  57. // 先把初始化参数和分页参数放到总参数里面
  58. Object.assign(state.totalParam, initParam, isPageable ? pageParam.value : {});
  59. let { data } = await api({ ...state.searchInitParam, ...state.totalParam });
  60. dataCallBack && (data = dataCallBack(data));
  61. // 无分页时 requestApi 仍常返回 { list, total },不能直接赋给表格(el-table 需要数组,否则会 data.reduce 报错)
  62. if (isPageable) {
  63. state.tableData = Array.isArray(data?.list) ? data.list : [];
  64. state.pageable.total = data?.total ?? 0;
  65. } else {
  66. state.tableData = Array.isArray(data) ? data : Array.isArray(data?.list) ? data.list : [];
  67. }
  68. } catch (error) {
  69. requestError && requestError(error);
  70. }
  71. };
  72. /**
  73. * @description 更新查询参数
  74. * @return void
  75. * */
  76. const updatedTotalParam = () => {
  77. state.totalParam = {};
  78. // 处理查询参数,可以给查询参数加自定义前缀操作
  79. let nowSearchParam: Table.StateProps["searchParam"] = {};
  80. // 防止手动清空输入框携带参数(这里可以自定义查询参数前缀)
  81. for (let key in state.searchParam) {
  82. // 某些情况下参数为 false/0 也应该携带参数
  83. if (state.searchParam[key] || state.searchParam[key] === false || state.searchParam[key] === 0) {
  84. nowSearchParam[key] = state.searchParam[key];
  85. }
  86. }
  87. Object.assign(state.totalParam, nowSearchParam);
  88. };
  89. /**
  90. * @description 表格数据查询
  91. * @return void
  92. * */
  93. const search = () => {
  94. state.pageable.pageNum = 1;
  95. updatedTotalParam();
  96. getTableList();
  97. };
  98. /**
  99. * @description 表格数据重置
  100. * @return void
  101. * */
  102. const reset = () => {
  103. state.pageable.pageNum = 1;
  104. // 重置搜索表单的时,如果有默认搜索参数,则重置默认的搜索参数
  105. state.searchParam = { ...state.searchInitParam };
  106. updatedTotalParam();
  107. getTableList();
  108. };
  109. /**
  110. * @description 每页条数改变
  111. * @param {Number} val 当前条数
  112. * @return void
  113. * */
  114. const handleSizeChange = (val: number) => {
  115. state.pageable.pageNum = 1;
  116. state.pageable.pageSize = val;
  117. getTableList();
  118. };
  119. /**
  120. * @description 当前页改变
  121. * @param {Number} val 当前页
  122. * @return void
  123. * */
  124. const handleCurrentChange = (val: number) => {
  125. state.pageable.pageNum = val;
  126. getTableList();
  127. };
  128. return {
  129. ...toRefs(state),
  130. getTableList,
  131. search,
  132. reset,
  133. handleSizeChange,
  134. handleCurrentChange,
  135. updatedTotalParam
  136. };
  137. };