@a2simcode/ui 0.0.285 → 0.0.287

package/docs/components/table-panel.md

@@ -188,6 +188,19 @@
   </template>
 </Demo>
 
+## 选中数据远程拉取
+
+跨页选中时，未加载页的选中记录只有 ID、没有完整数据。开启 `remote-selection` 后，点击「仅选中」会按选中 ID 调用 `loadData`（参数携带 `ids` 逗号拼接的 ID 列表与 `field` rowKey 字段名）从接口拉取完整选中数据，保证未加载页的选中记录也能完整展示。需同时配置 `row-key`、`is-page` 和 `load-data`。
+
+<Demo :source-code="tablePanelRemoteSelectionCode">
+  <template #source>
+    <table-panel-remote-selection />
+  </template>
+  <template #description>
+    点击「设置跨页选中」选中第 1 页和第 3 页的各一条记录，再点击右上角「仅选中」：开启 <code>remote-selection</code> 后会携带 <code>ids</code> 与 <code>field</code> 调用 <code>loadData</code> 拉取完整选中数据，两条记录都能展示（未开启时只能展示已加载页的选中记录）。
+  </template>
+</Demo>
+
 ## 批量操作
 
 批量操作是多选功能的一种扩展使用方式，详见上面的"多选功能"章节中的"带批处理按钮的多选"部分。
@@ -303,6 +316,7 @@ import TablePanelBatchOperations from '../examples/table-panel/batch-operations.
 import TablePanelSubTableLazy from '../examples/table-panel/sub-table-lazy.vue'
 import TablePanelGetSelection from '../examples/table-panel/get-selection.vue'
 import TablePanelPaginationSelectStateKey from '../examples/table-panel/pagination-select-state-key.vue'
+import TablePanelRemoteSelection from '../examples/table-panel/remote-selection.vue'
 import TablePanelButtonVisibility from '../examples/table-panel/button-visibility.vue'
 import TablePanelModelValue from '../examples/table-panel/model-value.vue'
 import TablePanelCard from '../examples/table-panel/card.vue'
@@ -320,6 +334,7 @@ import tablePanelBatchOperationsCode from '../examples/table-panel/batch-operati
 import tablePanelSubTableLazyCode from '../examples/table-panel/sub-table-lazy.vue?raw'
 import tablePanelGetSelectionCode from '../examples/table-panel/get-selection.vue?raw'
 import tablePanelPaginationSelectStateKeyCode from '../examples/table-panel/pagination-select-state-key.vue?raw'
+import tablePanelRemoteSelectionCode from '../examples/table-panel/remote-selection.vue?raw'
 import tablePanelButtonVisibilityCode from '../examples/table-panel/button-visibility.vue?raw'
 import tablePanelModelValueCode from '../examples/table-panel/model-value.vue?raw'
 import tablePanelCardCode from '../examples/table-panel/card.vue?raw'

package/docs/examples/table-panel/remote-selection.vue

@@ -0,0 +1,159 @@
+<template>
+  <div style="margin-bottom: 10px; display: flex; gap: 8px; align-items: center">
+    <j-button type="primary" label="设置跨页选中" @click="setAllSelected" />
+    <span style="color: #606266; font-size: 13px"
+      >设置跨页选中后，点击表格右上角「仅选中」按钮，将按选中 ID 从接口拉取完整选中数据</span
+    >
+  </div>
+  <div style="position: relative; width: 100%; height: 500px">
+    <j-table-panel
+      ref="tablePanelRef"
+      row-key="orderId"
+      is-multiple
+      select-state-key="selected"
+      remote-selection
+      :columns="columns"
+      :load-data="loadData"
+      :is-page="true"
+      :page-size="10"
+      @select="handleSelect"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue'
+
+const tablePanelRef = ref()
+// 外部维护选中的 ID 集合
+const selectedIds = ref(new Set<string>())
+
+// 选中变化时用事件携带的 keys（跨页选中的完整 ID 列表）整体同步
+const handleSelect = ({ keys }: { keys: string[] }) => {
+  selectedIds.value = new Set(keys)
+}
+
+// 程序化设置跨页选中（ORD-000001 在第 1 页，ORD-000030 在第 3 页）
+const ids = ['ORD-000001', 'ORD-000030']
+const setAllSelected = () => {
+  selectedIds.value = new Set(ids)
+  // 按 ID 设置跨页选中，选中计数立即生效（无需等待对应页数据加载）
+  tablePanelRef.value?.setSelectionById?.(ids)
+  // 刷新表格，loadData 会根据 selectedIds 标记 selected 字段
+  tablePanelRef.value?.refreshData?.()
+}
+
+const columns = ref([
+  {
+    id: 'orderId',
+    type: '',
+    config: {
+      label: '订单号',
+      width: 150,
+    },
+  },
+  {
+    id: 'customerId',
+    type: '',
+    config: {
+      label: '客户编号',
+      width: 120,
+    },
+  },
+  {
+    id: 'productName',
+    type: '',
+    config: {
+      label: '产品名称',
+    },
+  },
+  {
+    id: 'category',
+    type: '',
+    config: {
+      label: '类别',
+      width: 120,
+    },
+  },
+  {
+    id: 'region',
+    type: '',
+    config: {
+      label: '区域',
+      width: 100,
+    },
+  },
+  {
+    id: 'sales',
+    type: '',
+    config: {
+      label: '销售额',
+      width: 100,
+      align: 'right',
+    },
+  },
+])
+
+// 生成模拟数据
+const generateMockData = (count: number): Record<string, any>[] => {
+  const categories = ['办公用品', '科技产品', '家具']
+  const regions = ['华东', '华南', '华北', '华中', '西南', '西北']
+  const data: Record<string, any>[] = []
+
+  for (let i = 1; i <= count; i++) {
+    data.push({
+      orderId: `ORD-${String(i).padStart(6, '0')}`,
+      customerId: `CUS-${String(Math.floor(Math.random() * 10000)).padStart(5, '0')}`,
+      productName: `产品名称 ${i}`,
+      category: categories[Math.floor(Math.random() * categories.length)],
+      region: regions[Math.floor(Math.random() * regions.length)],
+      sales: (Math.random() * 10000).toFixed(2),
+    })
+  }
+
+  return data
+}
+
+const allData = generateMockData(100)
+
+// 模拟后端分页接口
+// 开启 remote-selection 时，点击「仅选中」会携带 ids（选中 ID 逗号拼接）与 field（rowKey 字段名）调用本方法，按 ID 返回完整选中数据
+const loadData = async (params: Record<string, any>) => {
+  return new Promise((resolve) => {
+    setTimeout(() => {
+      // 仅选中（remote-selection）：按 ids 返回完整选中数据，实际使用中由后端按 ID 列表查询
+      if (params.ids) {
+        const idSet = new Set(String(params.ids).split(','))
+        const selectedData = allData.filter((item) => idSet.has(item[params.field]))
+        selectedData.forEach((item) => {
+          item.selected = true
+        })
+        resolve({
+          rows: selectedData,
+          records: selectedData.length,
+        })
+        return
+      }
+
+      const { pagination } = params
+      const { rows, page } = pagination || { rows: 10, page: 1 }
+      const start = (page - 1) * rows
+      const end = start + rows
+
+      // 获取当前页数据
+      const pageData = allData.slice(start, end)
+
+      // 根据 selectedIds 标记 selected 字段
+      // select-state-key="selected" 会让表格自动根据此字段初始化选中状态
+      pageData.forEach((item) => {
+        item.selected = selectedIds.value.has(item.orderId)
+      })
+
+      resolve({
+        rows: pageData,
+        records: allData.length,
+      })
+    }, 300)
+  })
+}
+</script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2simcode/ui",
-  "version": "0.0.285",
+  "version": "0.0.287",
   "description": "A Vue 3 UI Component Library",
   "type": "module",
   "main": "./dist/simcode-ui.umd.js",