本页目录

滚动与列表迁移

设备列表或帮助文章需要在固定区域内滑动时,可以使用 scroll-view。从 WebView 迁移时,把原来用 overflow: auto 的区域换成滚动组件,给滚动区域设置明确的高度,并通过组件事件处理滚动。

Ray

import { ScrollView, Text, View } from '@ray-js/ray';

type DeviceListProps = {
  items: { id: string; name: string }[];
  loadNextPage: () => void;
};

export function DeviceList({ items, loadNextPage }: DeviceListProps) {
  return (
    <ScrollView className="results" scrollY lowerThreshold={60} onScrollToLower={loadNextPage}>
      {items.map(item => (
        <View key={item.id}><Text>{item.name}</Text></View>
      ))}
    </ScrollView>
  );
}

原生小程序

<scroll-view
  class="results"
  scroll-y="{{true}}"
  lower-threshold="{{60}}"
  bindscrolltolower="loadNextPage"
>
  <view ty:for="{{items}}" ty:key="id">
    <text>{{item.name}}</text>
  </view>
</scroll-view>
.results {
  height: 400rpx;
}

这里的 items 是页面数据,loadNextPage 是你的分页处理函数。当用户滚动到距底部 60 像素以内时,可以请求下一页。若列表内容高度没有超过容器,增加列表项后再试触底。

迁移分页、刷新和返回位置

  • 列表项用设备 ID 等稳定标识作为 key,分页追加时按这个标识去重。
  • 触底加载使用 Ray 的 onScrollToLower 或原生小程序的 bindscrolltolower,在处理函数中检查请求是否正在执行、是否还有下一页。请求失败时,允许用户重试。
  • 用 refresher-enabled 开启下拉刷新。在 refresherrefresh 事件中先把绑定到 refresher-triggered 的状态设为 true,再请求数据。请求成功或失败后,将它设为 false,收起刷新提示。
  • 页面需要恢复列表位置时,从滚动事件记录 scrollTop。重新创建页面后,等列表数据准备好,再把记录的位置传给 scroll-top。有内外两层滚动或弹层时,分别测试各区能否按预期滚动。