wkjp-list-page 1.0.22 → 1.0.23

package/README.md

@@ -89,7 +89,7 @@ deviceListApi(params) {
 **情况：** 运营想自定义表头、列太多想藏起来。  
 **默认：** **`columns` 达到 10 列及以上**（可用 **`column-config-auto-min`** 改阈值）时，表格最右侧自动出现 **表头设置** 齿轮；悬停齿轮显示 **「配置字段」** 提示（可用 **`column-config-tooltip`** 修改）。  
 **可选：** `:enable-column-config="true"` 强制开启；`:enable-column-config="false"` 强制关闭。  
-**作用：** 弹层内可 **搜索字段**、**显示/未显示** 分组、开关显隐、拖拽排序；**复选框列（`type: selection`）不出现在设置里**且表格始终保留；**固定列**左侧显示「固定」且不可拖不可关。点 **确认** 后才会作用到表格并触发 **`columns-change`**，点 **取消** / 关闭 / 再次点齿轮则放弃本次修改。
+**作用：** 弹层内可 **搜索字段**、**显示/未显示** 分组、开关显隐、拖拽排序；**复选框列（`type: selection`）不出现在设置里**且表格始终保留；列上 **`showInColumnConfig: false`** 可排除在表头设置外（表格仍显示该列）；**固定列**左侧显示「固定」且不可拖不可关。点 **确认** 后才会作用到表格并触发 **`columns-change`**，点 **取消** / 关闭 / 再次点齿轮则放弃本次修改。
 
 ### 2.2 不想要「查询」按钮，或想改按钮上的字
 
@@ -344,6 +344,8 @@ deviceListTransformList(list) {
 | `emptyText` / `defaultText` | 空值时显示文案；**`emptyText` 优先**；都不设则用 **`cell-empty-text`**（默认 `--`）。 |
 | `width` / `minWidth` | 显式指定后不再自动算宽；仍可配合上面的 tooltip 规则。 |
 | `showOverflowTooltip` | 显式 `true` / `false` 时优先于自动规则。 |
+| `showInColumnConfig` | 是否出现在 **表头设置** 弹层，默认 **`true`**；为 **`false`** 时不出现在设置里（不可被用户隐藏），表格仍渲染。兼容 **`columnConfigShow`**。 |
+| `configFixed` | 在表头设置中视为固定列，不可拖、不可关（常与 `fixed` 联用）。 |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wkjp-list-page",
-  "version": "1.0.22",
+  "version": "1.0.23",
   "description": "Vue2 + ElementUI CommonListPage component",
   "main": "src/index.js",
   "module": "src/index.js",

package/src/components/CommonListPage.vue

@@ -368,9 +368,14 @@ export default {
     showQueryButton: { type: Boolean, default: true },
     /** 主查询按钮文案 */
     queryButtonText: { type: String, default: "查询" },
-    /** 是否显示「清除查询」按钮（在查询按钮右侧）：将 `filters` 恢复为进入页面时的快照并重新查询 */
+    /** 是否显示「重置」按钮（在查询按钮右侧）：将 `filters` 恢复为进入页面时的快照 */
     showClearQueryButton: { type: Boolean, default: true },
-    clearQueryButtonText: { type: String, default: "清除查询" },
+    clearQueryButtonText: { type: String, default: "重置" },
+    /**
+     * 点击「重置」后是否自动 `fetchList`。默认 **true**：恢复查询条件后重新拉表。
+     * 带「请选择…再查询」等前置校验的页面请设为 **false**，仅重置条件不请求。
+     */
+    fetchOnClearQuery: { type: Boolean, default: true },
     /**
      * 搜索区折叠：显式 `true` / `false` 强制开/关；
      * 未传时 **`searchOption` 超过 `searchVisibleMax`（默认 6）** 自动显示「展开查询」。
@@ -440,7 +445,7 @@ export default {
       columnConfigPanelMaxHeight: null,
       configColumns: [],
       appliedColumns: [],
-      /** 进入页时 filters 的快照，用于「清除查询」 */
+      /** 进入页时 filters 的快照，用于「重置」 */
       initialFiltersSnapshot: null,
       initialFiltersCaptured: false
     };
@@ -654,9 +659,12 @@ export default {
     isBuiltinCellColumn(col) {
       return col && ["selection", "index", "expand"].indexOf(col.type) !== -1;
     },
-    /** 复选框列不参与表头设置 */
+    /** 复选框、展开列及 showInColumnConfig:false 不参与表头设置 */
     isConfigPanelColumn(col) {
-      return col && col.type !== "selection";
+      if (!col) return false;
+      if (col.type === "selection" || col.type === "expand") return false;
+      if (col.showInColumnConfig === false) return false;
+      return true;
     },
     textDisplayLength(text) {
       return String(text == null ? "" : text).length;
@@ -732,7 +740,11 @@ export default {
     captureInitialFilters() {
       if (this.initialFiltersCaptured || !this.filters) return;
       try {
-        this.initialFiltersSnapshot = JSON.parse(JSON.stringify(this.filters));
+        const snap = {};
+        Object.keys(this.filters).forEach((key) => {
+          snap[key] = this.cloneFilterValue(this.filters[key]);
+        });
+        this.initialFiltersSnapshot = snap;
         this.initialFiltersCaptured = true;
       } catch (e) {
         this.initialFiltersSnapshot = null;
@@ -751,14 +763,34 @@ export default {
       const snap = this.initialFiltersSnapshot;
       const f = this.filters;
       if (!snap || !f) return;
-      Object.keys(snap).forEach((key) => {
-        this.$set(f, key, this.cloneFilterValue(snap[key]));
+      Object.keys(f).forEach((key) => {
+        const val = Object.prototype.hasOwnProperty.call(snap, key)
+          ? snap[key]
+          : undefined;
+        this.$set(f, key, this.cloneFilterValue(val));
+      });
+    },
+    resetListWithoutFetch() {
+      this.innerPagination.page = 1;
+      this.innerTableData = [];
+      this.innerPagination.total = 0;
+      this.syncPaginationToFilters();
+      this.$emit("fetched", {
+        list: [],
+        total: 0,
+        page: this.innerPagination.page,
+        pageSize: this.innerPagination.pageSize,
+        raw: null,
       });
     },
     handleClearQueryClick() {
       this.applyInitialFiltersSnapshot();
-      this.fetchList({ resetPage: true });
       this.$emit("clear-query");
+      if (this.fetchOnClearQuery) {
+        this.fetchList({ resetPage: true });
+      } else {
+        this.resetListWithoutFetch();
+      }
     },
     resolveValue(item) {
       if (Object.prototype.hasOwnProperty.call(item, "value")) return item.value;