uni-z-paging 2.8.7版本发布：布局优化与功能增强

项目简介

uni-z-paging 是一款专为uni-app开发的高性能分页组件，它为开发者提供了强大的列表分页功能支持。该组件特别优化了在移动端应用中的表现，能够轻松处理大数据量的列表渲染，同时提供了丰富的自定义选项和事件监听能力，帮助开发者快速构建流畅的列表页面。

版本亮点

1. 新增仅布局模式

在2.8.7版本中，组件新增了layout-only属性，这一特性允许开发者仅使用uni-z-paging的基础布局结构，而不启用其内置的分页功能。这对于需要自定义分页逻辑但又想利用组件优秀布局结构的场景非常有用。

使用示例：

<z-paging layout-only>
  <!-- 自定义内容 -->
</z-paging>

2. 手动触发二楼功能

新增的goF2方法为开发者提供了更灵活的控制能力，可以手动触发进入"二楼"效果。这个功能特别适合需要根据特定业务条件（如用户交互或数据状态）来触发二楼展示的场景。

3. 滚动方向监听

新版本增加了@scrollDirectionChange事件，能够精确监听列表滚动方向的改变。这对于实现根据滚动方向显示/隐藏导航栏等交互效果非常有帮助。

4. 样式自定义增强

通过新增的paging-class属性，开发者可以直接为z-paging组件设置class，使得样式定制更加方便直接，无需再通过额外的包装元素来实现样式覆盖。

5. 键盘高度变化监听

新增的addKeyboardHeightChangeListener方法允许开发者手动添加键盘高度变化的监听，这对于需要精确控制输入框与键盘交互的场景尤为重要。

问题修复与优化

滚动定位准确性提升

修复了scrollIntoViewById方法在存在slot=top或局部区域滚动时定位不准确的问题，现在无论页面结构如何复杂，滚动到指定元素都能精确定位。

底部安全区域处理优化

重构了底部安全区域的处理逻辑，采用占位view的方式替代原有方案。这一改进带来了以下优势：

• 处理方案更加灵活
• 支持自定义底部安全区域颜色
• 兼容性更好
• 性能更优

兼容性提升

特别优化了对nvue+vue3环境下waterfall布局的支持，使得在更广泛的环境中使用瀑布流布局成为可能。

类型定义规范化

对TypeScript类型定义中的style类型进行了规范化约束，提高了代码的健壮性和开发体验。

升级建议

对于正在使用uni-z-paging的项目，建议尽快升级到2.8.7版本以获取这些改进和新增功能。特别是对于有以下需求的开发者：

• 需要自定义分页逻辑但想复用布局结构的项目
• 需要精确控制二楼显示时机的场景
• 需要根据滚动方向实现复杂交互的应用
• 在nvue+vue3环境中使用瀑布流布局的开发者

升级过程通常只需更新依赖版本即可，大部分改进和新增功能都是向后兼容的，不会影响现有功能的使用。