HarmonyOS 鸿蒙Next中上架自检提示缺少滑动动效

这个属于体验规范优化的选项。上线审核过不过看情况。 参考：

class MyDataSource implements IDataSource {
  private list: number[] = [];

  constructor(list: number[]) {
    this.list = list;
  }

  totalCount(): number {
    return this.list.length;
  }

  getData(index: number): number {
    return this.list[index];
  }

  registerDataChangeListener(): void {
  }

  unregisterDataChangeListener() {
  }
}

@Entry
@Component
export struct SwiperExample {
  private swiperController: SwiperController = new SwiperController();
  private data: MyDataSource = new MyDataSource([]);
  @State traY: number = 0;
  @State index: number = 0;

  aboutToAppear(): void {
    let list: number[] = [];
    for (let i = 1; i <= 10; i++) {
      list.push(i);
    }
    this.data = new MyDataSource(list);
  }

  build() {
    Column({ space: 5 }) {
      Swiper(this.swiperController) {
        LazyForEach(this.data, (item: string) => {
          Text(item.toString())
            .width('90%')
            .height(400)
            .backgroundColor(0xAFEEEE)
            .textAlign(TextAlign.Center)
            .fontSize(30)
            .translate({
              y: this.traY   // 偏移设置为捕获到的偏移量
            });
        }, (item: string) => item);
      }
      .backgroundColor(Color.Orange)
      .onChange((index: number) => {
        this.index = index;
      })
      .loop(false)
      .vertical(true)
      .effectMode(EdgeEffect.None) // 禁用内置边缘效果
      .parallelGesture(
        PanGesture({ direction: PanDirection.Vertical })
          .onActionUpdate((event) => {
            // 这里控制滑动距离，第一个往下滑
            if (this.index == 0 && event.offsetY < 160) {
              this.traY = event.offsetY;
            }
            // 这里控制滑动距离，最后一个往上滑
            if (this.index == this.data.totalCount() - 1 && event.offsetY > -160) {
              this.traY = event.offsetY;
            }
          })
          .onActionEnd(() => {
            animateToImmediately({
              duration: 100, // 这里可以控制回弹速度
              curve: Curve.EaseOut,
              iterations: 1,
              playMode: PlayMode.Normal,
            }, () => {
              this.traY = 0;
            });
          })
      );
    }.width('100%')
    .margin({ top: 50 });
  }
}

这个不是让你“额外加一个 Swiper 组件”。

而是：

你当前页面里的可滑动组件（这里检测到是 Swiper），在滑动到边界时，没有“边界反馈动效”。

也就是：

回弹
橡皮筋效果
边缘阻尼
overscroll效果

这些系统推荐的滑动反馈没生效。

⸻

你截图里：

控件类型：[Swiper]

说明：

问题就是你当前页面里的：

Swiper()

不是缺少组件。

⸻

HarmonyOS 自检这里主要检查：

滑到头/尾时
用户有没有“已经到边界”的感知

比如：

• 微微回弹
• 阻尼
• 边缘拉伸
• spring动画

否则会认为：

缺少反馈动效

⸻

最常见原因：

1、关闭了边缘效果

比如：

.edgeEffect(EdgeEffect.None)

或者：

.disableSwipe(true)

之类。

⸻

2、Swiper嵌套导致事件被吃掉

尤其：

Navigation
Tabs
Swiper
Scroll
List

多层嵌套。

有时候：

父组件把边界事件吞了

就没有回弹。

⸻

3、自定义手势冲突

如果用了：

PanGesture
onTouch

自己处理滑动，

系统默认 spring 效果可能失效。

⸻

4、使用了旧版本API行为

HarmonyOS 5 以后：

很多滚动组件默认行为有变化。

有些旧代码：

以前有回弹
升级后没了

很常见。

⸻

推荐处理方式（重点）

Swiper 建议显式开启边界效果：

Swiper() {

}
.edgeEffect(EdgeEffect.Spring)

或者：

.edgeEffect(EdgeEffect.Fade)

推荐：

EdgeEffect.Spring

最符合系统规范。

⸻

如果是 Scroll/List：

同样：

.edgeEffect(EdgeEffect.Spring)

⸻

官方很多示例其实都默认用了：

EdgeEffect.Spring

只是文档没特别强调。

⸻

另外一个重点：

如果你是：

Swiper + Tabs

有时候：

.loop(false)

在边界页不会有明显反馈。

可以加：

.cachedCount()

并避免复杂嵌套。

⸻

你这个场景建议优先检查：

Swiper()
  .edgeEffect(EdgeEffect.Spring)

很多时候就过自检了。

⸻

一句话总结：

自检提示的意思不是让你新增 Swiper，而是你当前页面中的 Swiper 在滑动到边界时缺少系统推荐的回弹/阻尼反馈效果。一般给可滑动组件增加 edgeEffect(EdgeEffect.Spring) 就能解决。