[BugFix][Harmony] fix the gesture problem of scroll container

when the contentSize < viewSize, needs to pass-through the touch gesture

lynx-family/lynx-website#329

issue:m-6746732509

AutoLand:release/3.4

(cherry picked from commit 1122cab0727f06b1736b3b3eb065b6860225bfe6)

Author: rAY-ooo

js_libraries/types/CHANGELOG.md

@@ -1,4 +1,6 @@
 # CHANGELOG
+## 3.5.2
+- Add `harmony-scroll-edge-effect` property for scroll container.
 
 ## 3.5.1
 - Add `frame` element types.

js_libraries/types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynx-js/types",
-  "version": "3.5.1",
+  "version": "3.5.2",
   "description": "",
   "keywords": [
     "lynx",

js_libraries/types/test/pages/list.test-d.tsx

@@ -0,0 +1,16 @@
+// Copyright 2025 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+
+import { assertType } from 'vitest';
+import { expectType } from 'tsd';
+import { IntrinsicElements } from '../../types';
+
+// Props Types Check
+let a;
+
+// Props Types Check
+{
+  <list harmony-scroll-edge-effect={false} />;
+  assertType<boolean | undefined>(a as IntrinsicElements['list']['harmony-scroll-edge-effect']);
+}

js_libraries/types/types/common/element/list.d.ts

@@ -970,6 +970,14 @@ export interface ListProps extends StandardProps {
    * @since 3.1
    */
   'experimental-batch-render-strategy'?: BatchRenderStrategy;
+  
+  /**
+   * When the content size of a component is smaller than the component itself, decide whether to enable scrolling.
+   * @defaultValue false
+   * @Harmony
+   * @since 3.4
+   */
+   'harmony-scroll-edge-effect'?: boolean | undefined;
 
   /**
    * Scroll event.

platform/harmony/lynx_harmony/src/main/cpp/ui/ui_list.cc

@@ -127,7 +127,7 @@ void UIList::OnPropUpdate(const std::string& name, const lepus::Value& value) {
   } else if (name == list::kEnableScrollBar) {
     SetScrollbar(value.Bool());
   } else if (name == list::kBounces && value.IsBool()) {
-    SetBounces(value.Bool());
+    SetBounces(value.Bool(), true);
   } else if (name == list::kNeedVisibleItemInfo && value.IsBool()) {
     enable_need_visible_item_info = value.Bool();
   } else if (name == list::kExperimentalUpdateStickyForDiff && value.IsBool()) {

platform/harmony/lynx_harmony/src/main/cpp/ui/ui_scroll.cc

@@ -314,7 +314,7 @@ void UIScroll::OnPropUpdate(const std::string& name,
   } else if (name == scroll::kEnableScrollBar && value.IsBool()) {
     SetScrollbar(value.Bool());
   } else if (name == scroll::kBounces && value.IsBool()) {
-    SetBounces(value.Bool());
+    SetBounces(value.Bool(), true);
   } else if (name == scroll::kLowerThreshold && value.IsNumber()) {
     lower_threshold_ = static_cast<int>(value.Number());
   } else if (name == scroll::kUpperThreshold && value.IsNumber()) {

platform/harmony/lynx_harmony/src/main/cpp/ui/utils/base_scroll_container.cc

@@ -14,6 +14,7 @@ BaseScrollContainer::BaseScrollContainer(LynxContext* context, int sign,
     : UIView(context, ARKUI_NODE_SCROLL, sign, tag) {
   SetNestedScroll(ARKUI_SCROLL_NESTED_MODE_SELF_FIRST);
   SetScrollbar(false);
+  SetBounces(false, true);
   overflow_ = {false, false};
 }
 
@@ -90,11 +91,12 @@ void BaseScrollContainer::SetScrollDirection(ArkUI_ScrollDirection direction) {
       node_, NODE_SCROLL_SCROLL_DIRECTION, static_cast<int>(direction));
 }
 
-void BaseScrollContainer::SetBounces(bool bounces) {
+void BaseScrollContainer::SetBounces(bool bounces, bool always_enabled) {
   NodeManager::Instance().SetAttributeWithNumberValue(
       node_, NODE_SCROLL_EDGE_EFFECT,
       static_cast<int32_t>(bounces ? ARKUI_EDGE_EFFECT_SPRING
-                                   : ARKUI_EDGE_EFFECT_NONE));
+                                   : ARKUI_EDGE_EFFECT_NONE),
+      static_cast<int32_t>(always_enabled));
 }
 
 void BaseScrollContainer::SetEnableScrollInteraction(
@@ -142,6 +144,9 @@ void BaseScrollContainer::OnPropUpdate(const std::string& name,
     } else {
       SetHorizontal(false);
     }
+  } else if (name == kScrollEdgeEffect && value.IsBool()) {
+    auto data = value.Bool();
+    SetBounces(data, data);
   } else {
     UIView::OnPropUpdate(name, value);
   }

platform/harmony/lynx_harmony/src/main/cpp/ui/utils/base_scroll_container.h

@@ -19,6 +19,7 @@ static constexpr const char* const kNestedScrollForwardOptions = "temporary-nest
 static constexpr const char* const kNestedScrollBackWardOptions =
     "temporary-nested-scroll-backward";
 static constexpr const char* const kScrollOrientation = "scroll-orientation";
+static constexpr const char* const kScrollEdgeEffect = "harmony-scroll-edge-effect";
 
 class BaseScrollContainer : public UIView {
  public:
@@ -45,7 +46,7 @@ class BaseScrollContainer : public UIView {
   void SetEnableScrollInteraction(bool enable_scroll_interaction);
   void SetScrollbar(bool enable_scroll_bar);
   void SetHorizontal(bool horizontal);
-  void SetBounces(bool bounces);
+  void SetBounces(bool bounces, bool always_enabled);
   virtual void UpdateContentSize(float width, float height) {
     content_width_ = width;
     content_height_ = height;