Vue Hooks Plus 中 useInfiniteScroll 的数据字段映射优化实践

背景介绍

在现代前端开发中，无限滚动（Infinite Scroll）是一个常见的交互模式，特别是在内容展示类应用中。Vue Hooks Plus 作为 Vue 生态中的实用工具库，提供了 useInfiniteScroll 这个强大的 Hook 来简化无限滚动功能的实现。

问题分析

在实际开发中，我们经常会遇到 API 返回的数据结构与 Hook 预期不一致的情况。具体到 useInfiniteScroll，它默认期望接收一个包含 list 字段的响应对象，但后端接口返回的数据可能使用不同的字段名（如 results、items 等）。

开发者通常需要额外封装一层 Promise 来适配数据结构：

useInfiniteScroll((d) => {
  return new Promise((resolve, reject) => {
    service({ data: { page: d.page + 1 } })
      .then((res) => {
        resolve({ list: res.results, ...res })
      })
      .catch(reject)
  })
})

这种处理方式虽然可行，但增加了代码的冗余度，降低了开发效率。

解决方案探讨

1. 直接映射方案

最直观的解决方案是在 Hook 的配置选项中增加字段映射功能：

useInfiniteScroll(
  (d) => service({ data: { page: d.page + 1 } }),
  { listDict: 'results' }
)

这种方案的优势在于：

• 代码简洁明了
• 减少不必要的 Promise 封装
• 保持 Hook 的灵活性

2. 开发者自行格式化方案

Vue Hooks Plus 维护团队建议开发者自行处理数据格式化，他们认为：

• 不同接口的数据结构差异较大
• 数组处理需要考虑多种边界情况
• 自行格式化可以保持更大的灵活性

示例实现：

const getList = async (d) => {
  const data = await service({ data: { page: d.page + 1 } })
  return { list: data.results, ...data }
}

useInfiniteScroll(getList)

最佳实践建议

1. 统一数据格式层：建议在项目架构中建立统一的数据格式转换层，而不是在每个使用 Hook 的地方单独处理。

2. 封装自定义 Hook：基于 useInfiniteScroll 封装项目特定的 Hook，内置常用的数据转换逻辑。

3. 考虑 TS 类型支持：如果使用 TypeScript，可以扩展 Hook 的类型定义来支持自定义字段映射。

总结

虽然 Vue Hooks Plus 的 useInfiniteScroll 目前没有内置字段映射功能，但开发者可以通过合理的架构设计来解决这个问题。无论是选择自行格式化数据还是封装自定义 Hook，核心目标都是保持代码的简洁性和可维护性。

对于希望 Hook 内置此功能的开发者，可以考虑向项目提交 PR 或继续参与社区讨论，推动功能的演进。