1. 两千条数据压进 Table 之后:我为什么改成分页切片
手上这个后台界面最早是把两千条记录一次性灌进 QML 的 Table,滚动条一拉,帧率肉眼可见地掉,切一次筛选要等半秒。后来换成「一次只取一页」的分页 Table,表格始终只持有当前页那几十条数据,滑动立刻跟手。Qt QML 是我这几年用得最顺的一套代码开发工具,写界面确实快,但快不代表可以不管数据量:分页组件管页码和每页条数,Table 只管渲染被切出来的那一段,两者之间的契约没定死,越界、删除错位、切页空白就会一个接一个冒出来。这里写的是一条完整链路——数据怎么造、页码怎么翻译成数组切片、勾选行怎么删、哪几个地方最容易翻车。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具选型:QML 分页表格为什么先定数据契约
2.1 让 Table 只吃一页,而不是吃全量
Table 的渲染成本基本正比于它拿到的行数。两千行全塞进去,哪怕可视区域只有十几行,delegate 实例、绑定表达式、布局计算都是按两千份在跑,滚动时的抖动不是玄学,是实打实的对象数量压在那儿。分页表格的思路很朴素:把「全量数据」留在数据层,UI 层任何时刻只持有当前页那一段。
这样做还有第二个好处——它逼着你把数据请求抽象出来。示例里用 serverArrs 模拟服务端缓存,用 requestGetData(pageIndex) 模拟一次分页请求。等真接后端接口时,改动点只有一个函数体内部:把 serverArrs.slice(beginIdex, endIndex) 换成一次网络请求的回调赋值,上层页码逻辑一行不用动。我见过不少项目先图省事直接绑全量数组,等数据涨到几万条再回头改,结果 Table 的列定义、选中逻辑、导出逻辑全都要跟着动,工作量翻好几倍。
所以这套组件的分工是清楚的:_pageBox 决定每页多少条,_pagination 决定当前第几页和总页数,Table 只负责显示 setAll 喂给它的那批行。三者之间靠两个数字通信——页码和每页条数,其余一律不共享。
2.2 serverArrs 的字段设计,id 单调是有原因的
先看模拟数据的构造。它不是随便凑几个字段,每个字段后面都有用途:
javascript复制// 模拟服务端缓存:一次造好 2000 条,后面按页取
property var serverArrs: []
Component.onCompleted: {
let size = 2000
serverArrs = []
let nameArr = ["王二", "张三", "李四", "小红", "小明", "老明"]
let age = 9
let addrIndx = 2518
for (let i = 0; i < size; ++i) {
serverArrs[i] = {
"id": i, // 单调递增,后面二分查找全靠它
"date": "2016-05-02",
"name": nameArr[i % 6], // 六个人循环,肉眼能核对切片对不对
"age": age,
"province": "上海",
"zip": "200333",
"addr": `上海市普陀区金沙江路 ${addrIndx} 弄`,
"select": false // 勾选状态跟着数据走,不放在 Table 里
}
age = (age + 3) % 100
addrIndx += 1
}
requestGetData(0) // 首屏永远先请求第 0 页
}
这段代码在 Component.onCompleted 里跑,页面构造完成时数据就绪,紧接着请求第 0 页。逐个参数说:size = 2000 是为了压出真实体量的问题,几百条看不出差别;nameArr[i % 6] 让姓名六选一循环,翻页时如果连续两页出现同样的名字分布,说明切片位置算错了,肉眼就能发现;age 从 9 开始每次加 3 再对 100 取余,保证每行年龄不同,方便确认「我点的确实是这一行」;addrIndx 从 2518 开始自增,地址尾号连续,验证排序用;select 字段一开始全 false,勾选状态存在数据里而不是存在 Table 的行号里,这是后面删除能对得上 id 的前提。
最关键的字段是 id。它等于循环下标,天然严格递增且不重复。二分查找要求数组按被查找的键有序,这个前提是整条删除链路的基石。如果 id 是随机生成或者从别处拷来的无序值,后面的 binarySearch 直接失效,现象就是点了删除没反应。
2.3 分页控件和 Table 的接口只有三个
两边通信其实只有三个动作:table.setAll(rows) 把一页数据灌进去;_pagination.count = n 告诉分页控件总共多少页;_pagination.updateIndex(pageIndex) 让控件高亮当前页。读取方向只有一个:_pageBox.model[_pageBox.currentIndex].sizePerPage 拿每页条数,_pagination.index 拿当前页码。
接口面越窄,出错的地方越少。我自己的习惯是,凡是跨组件的读写都收敛到这么几个属性上,不直接去改对方的内部 model。分页控件之前已经单独做过一版支持任意折叠页数的实现,Table 这层就只当成一块显示区域用,编辑能力直接关掉——这个组件只承担展示和筛选,不承担改数据,职责一分开,后面的选中逻辑反而简单了。
3. 页码到切片的翻译:requestGetData 的四个边界判断
3.1 每页条数从当前选中项实时取
javascript复制// 请求第 pageIndex 页的数据
function requestGetData(pageIndex) {
// 每页条数不是常量,跟着下拉框当前项走
let sizePerPage = _pageBox.model[_pageBox.currentIndex].sizePerPage
let beginIdex = pageIndex * sizePerPage
// 页码越界:回退到最后一页
if (beginIdex >= serverArrs.length) {
requestGetData(serverArrs.length / sizePerPage
+ (serverArrs.length % sizePerPage > 0 ? 1 : 0) - 1)
} else {
let endIndex = Math.min(beginIdex + sizePerPage, serverArrs.length)
table.setAll(serverArrs.slice(beginIdex, endIndex))
_pagination.count = serverArrs.length / sizePerPage
+ (serverArrs.length % sizePerPage > 0 ? 1 : 0)
_pagination.updateIndex(pageIndex)
}
}
sizePerPage 没有写成常量,而是每次从 _pageBox 的当前项里取。这意味着用户中途把每页 20 条改成 30 条,下一次请求自动按新粒度切片,不需要额外通知。代价是调用方必须记住:改了每页条数之后要重新请求一次(一般回到第 0 页),否则页面上显示的还是旧粒度切出来的那批数据,页码却按新粒度算了,两边对不上。
beginIdex 是这一页的起始下标,等于页码乘每页条数。这个乘法是整条链路的原点,所有偏移都从它推出来。
3.2 beginIdex 与 endIndex:右开区间别算错
endIndex = Math.min(beginIdex + sizePerPage, serverArrs.length) 这一行干两件事。一是正常情况下取 beginIdex + sizePerPage,二是最后一页不满时用数组长度兜住,避免 slice 越界返回空。Array.prototype.slice 的第二个参数是开区间,取不到,所以 2000 条、每页 20 条时,第 99 页是 slice(1980, 2000),正好 20 条,不多不少。
这里最容易犯的错是把 +1 或者 -1 加到 endIndex 上。我最早手写的时候写成 beginIdex + sizePerPage - 1,结果每页少一条,最后一页还漏掉末尾元素,翻到最后一页发现数据对不上号,查了半天才发现是右开区间理解反了。判断标准很简单:endIndex - beginIdex 应该恒等于当前页实际条数。
3.3 越界回退:一行递归兜住删除后的空页
if (beginIdex >= serverArrs.length) 这个分支不是预防性的摆设。最典型的触发路径是:停在最后一页,勾选并删掉该页所有行,数组长度缩短,当前页码乘以每页条数已经超过总长度,如果不兜,slice 返回空数组,用户看到一张空表,以为数据全没了。
回退的目标页用 ceil(总条数 / 每页条数) - 1 算,也就是最后一页的下标,然后递归调一次自己。写的时候要注意总条数为 0 的边界:0 / sizePerPage 是 0,取余也是 0,减 1 之后页码变成 -1,此时 beginIdex 是负的,不满足越界条件,会走进 else 分支,slice 拿到一个空数组,表格空白但不崩。所以如果业务上允许删到一条不剩,我会在这个函数最前面加一句长度为 0 时直接 table.setAll([]) 并 return,省掉这一轮负页码的绕路。
3.4 总页数的向上取整和页码同步
_pagination.count 用的是「整除结果 + 余数是否大于 0」。整除的情形(比如 2000 条、每页 20 条)结果是整数 100,没问题;不能整除时,这个写法会算出一个小数,比如每页 30 条时 2000 / 30 是 66.66…,加 1 变成 67.66…,分页控件拿到这种值可能画出多余的页码或者高亮错位。我一般的写法是 Math.floor(len / sizePerPage) + (len % sizePerPage > 0 ? 1 : 0),先取整再加补偿,结果一定是整数。
_pagination.updateIndex(pageIndex) 必须和 setAll 放在同一个分支里,两者是原子的:数据换了页码没换,用户会看到「第 3 页」高亮着但内容是第 4 页的;页码换了数据没换更糟,勾选删除会删到看不见的行。这两句紧挨着写,中间不要插异步逻辑。
4. 代码开发工具里的删除链路:二分查找加 splice 怎么配合
4.1 为什么按 id 查而不是按行号删
表格里的行号是视图层的概念,会随着排序、筛选、分页变化。用户勾选时拿到的是行对象,如果记下「第 3 行」再去删,中间只要发生过一次翻页或重新请求,第 3 行指向的东西就变了,删错数据是分分钟的事。所以删除必须基于稳定标识,这里就是 id。
id 单调递增还有一个额外好处:可以二分。两千条数据线性扫一遍找 id 也就两千次比较,不算慢,但当删除是批量操作、每删一条都要查一次时,二分把每次查找从 O(n) 降到 O(log n),批量删几十条的差距就出来了。代码里用的是标准二分,前提只有一个——数组按 id 升序。
4.2 binarySearch 的两个特判分支
javascript复制// 在按 id 升序排好的数组里找目标 id,找不到返回 -1
function binarySearch(arr, target) {
let start = 0
let end = arr.length - 1
// 只剩一条时 while 进不去,先处理掉
if (!end) {
return arr[0].id === target ? 0 : -1
}
// 两条时直接比,省一轮循环
if (end === 1) {
return arr[0].id === target ? 0 : (arr[1].id === target ? 1 : -1)
}
let middle
while (start <= end) {
middle = (start + end) / 2 | 0 // 位或 0,等价于向下取整
if (arr[middle].id === target) {
return middle
} else if (target > arr[middle].id) {
start = middle + 1
} else {
end = middle - 1
}
}
return -1
}
if (!end) 这个写法依赖 JavaScript 的隐式转换:数组长度为 1 时 end 是 0,假值,进这个分支;长度为 0 时 end 是 -1,也是真值(非零),会掉进下面的逻辑,arr[0] 是 undefined,访问 .id 直接抛异常。这是个隐藏的坑,稳妥写法是显式判断 arr.length === 0 先返回 -1。
end === 1 的分支是纯优化,两条数据时直接两次比较,省掉一次循环开销。真正干活的是 while:middle 用位或 0 向下取整,比 Math.floor 短也快;命中就返回下标,目标比中间值大就把 start 推到 middle + 1,小就把 end 收到 middle - 1,区间始终收缩,不会死循环。
4.3 removeData 的接口约定:传进来的必须是 id
javascript复制// 删除所有勾选行,然后重取当前页
function removeData(datas) {
for (let i = 0; i < datas.length; ++i) {
let idx = binarySearch(serverArrs, datas[i])
print("idx:", idx, i, datas[i]) // 排查时先看这行
if (idx >= 0) {
serverArrs.splice(idx, 1)
}
}
requestGetData(_pagination.index)
}
这段代码有一个没写在函数签名里的约定:datas 里的元素必须是 id 数字,不能是整行对象。因为 binarySearch 内部比的是 arr[middle].id === target,你传一个对象进去,永远不相等,返回恒为 -1,splice 一次都不执行。表现就是「勾了一堆行,点删除,界面纹丝不动」,而 print 里 idx 全是 -1。所以调用侧收集选中行时,要么直接收集 id,要么在传参前做一次 datas.map(row => row.id)。
splice(idx, 1) 从下标删除一个元素,后面的元素整体前移一位。因为每次循环都重新调 binarySearch 定位,而不是缓存一个会失效的下标,所以循环删除多条是安全的——这一点和「边遍历边删原数组」的错误写法有本质区别,后者会跳元素。
4.4 删除后重取当前页,而不是局部更新表格
循环结束后统一调 requestGetData(_pagination.index),把刷新放在循环外面。这个位置很关键:删三条就请求三次,页面会闪三下,真实接口场景下还会打出三次网络请求,白白浪费。放在循环外只刷一次,代价是删除过程中的中间状态用户看不到,不过批量删除本来就是一次性操作,没人关心中间态。
另外,重取用的是 _pagination.index 而不是删除前传进来的页码,原因是删除可能让当前页变空(比如这页只有两条,全删了),requestGetData 内部的越界回退会把它纠正到最后一页。如果这里写死一个页码常量,回退逻辑就绕过去了。
5. 避坑:分页 Table 组件最容易翻车的四件事
5.1 删到最后一页,表格突然一片空白
现象:停在第 100 页,勾选全部 20 行点删除,数据从 2000 掉到 1980,表格没内容了,页码还显示 100。
原因:beginIdex = 100 * 20 = 2000,而 serverArrs.length 已经是 1980,beginIdex >= length 成立,走进回退分支。如果回退分支没写,或者回退算错了页(比如忘了减 1,回退到 101 页),照样空白。
解决:回退页数用 ceil(len / sizePerPage) - 1,递归回自己一次;同时给长度为 0 的情况加短路,直接清空表格并返回。改完之后要专门测一次「删光最后一页」和「删到只剩一条」两个边界。
5.2 勾了行点删除,print 里 idx 全是 -1
现象:选中三行,点删除,控制台打印 idx: -1 -1 -1,数据一条没少。
原因:binarySearch 拿目标值和 arr[middle].id 比较,传进来的是整行对象时永远不等。另一个同源原因是数组本身没按 id 升序——二分只对有序数组成立,无序时它会随机返回 -1 或错的下标,后者更危险,会删掉不该删的行。
解决:调用 removeData 前统一转成 id 数组;数据生成或插入时保证 id 单调递增,如果 id 来自外部且无序,先按 id 排一次序再进 serverArrs。print 这行调试语句别急着删,留着能第一时间看出来是找不到还是删错了。
5.3 删三行刷三次,页码还乱跳
现象:批量删五行,表格闪五次,分页控件的高亮从第 3 页跳到第 1 页又跳回来。
原因:requestGetData 写在了 for 循环体里面,每删一条就重取一次。更糟的情况是循环里用的是删除前的页码,而每取一次都会调 updateIndex,页码被反复改写。
解决:把重取挪到循环结束后,只调一次,传 _pagination.index 让越界回退自己去纠正。判断标准很简单——一次用户操作只应该产生一次数据请求。
5.4 点行不进勾选,反而弹出编辑框
现象:想勾选某一行,点上去没反应,或者直接进了编辑态,选择框纹丝不动。
原因:Table 默认开着编辑能力,行点击被编辑逻辑先截走了。这个组件的定位是展示加筛选,根本不需要改数据。
解决:把编辑关掉,同时打开 selectRowTriggerEnable 选择-行触发模式,点击行的瞬间就完成勾选或取消勾选,不用先去点那个小复选框。这两件事要一起做,只关编辑不开选择触发,点行还是没反应;只开选择触发不关编辑,两者会抢同一个点击事件。
6. 交互验证:selectRowTriggerEnable 打开后怎么自测
交互层的改动最容易漏测,因为它不影响数据,只影响手感。关掉编辑、打开 selectRowTriggerEnable 之后,我一般按下面这张表走一遍,每项都手动点一次:
| 验证项 | 操作 | 预期 |
|---|---|---|
| 行点击勾选 | 点某行任意位置 | 该行立刻勾选,再点一次取消 |
| 多行勾选 | 连点三行 | 三行同时保持勾选,不清空前面的 |
| 跨页勾选 | 勾第 1 页两行,翻到第 2 页再勾一行 | 第 1 页的勾选状态还在(select 字段存在数据里) |
| 删除后刷新 | 勾两行点删除 | 只请求一次,当前页数据更新,勾选清空 |
| 切每页条数 | 从 20 改成 30 | 回到第 1 页,条数正确,总页数重算 |
跨页勾选这项特别值得测。因为 select 是挂在数据对象上的,翻页只是换了一批行对象给 Table,原来那批的 select 值没被动过,翻回来应该还是勾着的。如果翻回来丢了,说明勾选状态被存在 Table 的行号或者某个临时数组里了,得改回数据层。
每页条数切换是另一个高频漏测点。requestGetData 每次都从 _pageBox 当前项取 sizePerPage,所以切换之后必须再调一次 requestGetData(0),否则表格还是旧粒度切出来的数据,页码却已经按新粒度算了。我习惯在下拉框的 onCurrentIndexChanged 里直接补这一句,不依赖用户再去点一次分页。
还有一个我踩过的细节:_pagination.count 在不能整除时会算成小数,分页控件画出来的页码数量偶尔会多一个。改成 Math.floor 加余数补偿之后就没再出现过。这类问题在数据量刚好整除时完全看不出来,只有条数不是每页大小的整数倍时才暴露,测试数据最好特意造一个 2000 这种能被 20 整除、又能被 30 除不尽的量,两种情形一次覆盖。
从那以后,我每加一个分页表格,都先把「删光最后一页」和「切换每页条数」这两个动作各走一遍,再去看勾选和删除,血泪经验换来的顺序,能省掉大半返工。希望帮到你。
