更新记录

1.0.0（2026-04-10）

uni-app 原生感滚动容器组件（Vue 页面使用 .vue，nvue 页面自动使用同名 .nvue）。

平台兼容性

native-scroll

uni-app 原生感滚动容器组件（Vue 页面使用 .vue，nvue 页面自动使用同名 .nvue）。

安装与使用

• 下载/导入到项目后，目录应为：uni_modules/native-scroll/
• 在页面里直接使用组件（支持 easycom 自动引入）：

<template>
  <native-scroll height="100%" :virtual="true" :virtualList="list" :virtualItemHeight="60">
    <template #item="{ item, index }">
      <view :id="'row_' + index">{{ index }} - {{ item.title }}</view>
    </template>
  </native-scroll>
</template>

全局滚动（mode="global"）

当你希望组件跟随页面滚动（而不是自己内部 overflow/scroll-view）时：

<script setup>
import { useNativeScrollPage } from '@/uni_modules/native-scroll/composables/useNativeScrollPage'
const { pageScrollTop } = useNativeScrollPage()
</script>

<template>
  <native-scroll mode="global" :pageScrollTop="pageScrollTop">
    <!-- content -->
  </native-scroll>
</template>

nvue / weex 优化

• native-scroll.nvue 在 mode="local" 下默认优先 scroller 渲染。
• 当 virtual=true 且 weexUseList=true（默认）时自动切到 list，利用 list 容器在长列表场景的渲染优势。
• 如需强制只用 scroller，可设置 :weexUseList="false"。