@lynx-js/lynx-ui-scroll-view 3.140.1 → 3.143.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +19 -0
- package/SKILL.md +168 -0
- package/dist/hooks/useBounce.d.ts +2 -2
- package/dist/hooks/useBounce.d.ts.map +1 -1
- package/dist/hooks/useBounce.jsx.map +1 -1
- package/package.json +8 -7
- package/src/hooks/useBounce.tsx +3 -2
- package/tsconfig.docs.json +0 -7
- package/tsconfig.json +0 -14
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,24 @@
|
|
|
1
1
|
# @lynx-js/lynx-ui-scroll-view
|
|
2
2
|
|
|
3
|
+
## 3.143.0
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Include missing README/CHANGELOG/SKILL/LICENSE files in published tarballs and exclude test and workspace-only config files. ([#404](https://github.com/lynx-family/lynx-ui/pull/404))
|
|
8
|
+
- Updated dependencies [[`29beec7`](https://github.com/lynx-family/lynx-ui/commit/29beec7b241026010b83c417f7e1d1c961cd4f09)]:
|
|
9
|
+
- @lynx-js/lynx-ui-common@3.143.0
|
|
10
|
+
- @lynx-js/lynx-ui-lazy-component@3.143.0
|
|
11
|
+
|
|
12
|
+
## 3.142.0
|
|
13
|
+
|
|
14
|
+
### Patch Changes
|
|
15
|
+
|
|
16
|
+
- Accept React 18 and newer types. ReactLynx still defines the compatible versions for each app. ([#383](https://github.com/lynx-family/lynx-ui/pull/383))
|
|
17
|
+
|
|
18
|
+
- Updated dependencies [[`49cb3c5`](https://github.com/lynx-family/lynx-ui/commit/49cb3c5b20d9346ff0f8b314367b4c8e354d195d)]:
|
|
19
|
+
- @lynx-js/lynx-ui-common@3.142.0
|
|
20
|
+
- @lynx-js/lynx-ui-lazy-component@3.142.0
|
|
21
|
+
|
|
3
22
|
## 3.140.1
|
|
4
23
|
|
|
5
24
|
### Patch Changes
|
package/SKILL.md
ADDED
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
# lynx-ui-scroll-view SKILL
|
|
2
|
+
|
|
3
|
+
`ScrollView` is a general-purpose scroll container used to display content that exceeds the viewport in either vertical or horizontal direction. For massive datasets, prefer `List` or `FeedList` to ensure performance.
|
|
4
|
+
|
|
5
|
+
## 1. Core Capabilities
|
|
6
|
+
|
|
7
|
+
- **Vertical and Horizontal Scrolling**: Supports vertical (`scrollOrientation = 'vertical'`) and horizontal (`scrollOrientation = 'horizontal'`) scrolling.
|
|
8
|
+
- **Native Scroll Architecture**: `enableNewArch` defaults to `true` on Lynx SDK 4.3 and newer and to `false` on earlier versions. The new architecture uses native bounces across Android, iOS, and Harmony; set the prop explicitly to override the SDK-based default.
|
|
9
|
+
- **BounceableOptions**: Supports edge rubber-band and bounce effects, configurable via:
|
|
10
|
+
- `enableBounces`: enable/disable edge bounce
|
|
11
|
+
- `singleSidedBounce`: select bounce side (`'upper' | 'lower' | 'both'`)
|
|
12
|
+
- `alwaysBouncing`: allow bouncing even when content does not exceed the viewport
|
|
13
|
+
- `startBounceTriggerDistance` / `endBounceTriggerDistance`: threshold distance to trigger `onScrollToBounces`
|
|
14
|
+
- `onScrollToBounces(info)`: callback when reaching upper/lower edge (`info.direction` is `'upper' | 'lower'`)
|
|
15
|
+
- `enableBounceEventInFling`: trigger bounce events during inertial fling
|
|
16
|
+
- `validAnimationVersion`: compatibility switch to use `setTimeout` instead of `requestAnimationFrame` on lower Lynx versions
|
|
17
|
+
|
|
18
|
+
## 2. AI Coding Guide
|
|
19
|
+
|
|
20
|
+
### Minimal Usable Example
|
|
21
|
+
|
|
22
|
+
```tsx
|
|
23
|
+
import { ScrollView } from '@lynx-js/lynx-ui'
|
|
24
|
+
|
|
25
|
+
function BasicScrollView() {
|
|
26
|
+
return (
|
|
27
|
+
<ScrollView
|
|
28
|
+
scrollOrientation='vertical'
|
|
29
|
+
style={{ height: '300px', width: '100%' }}
|
|
30
|
+
>
|
|
31
|
+
<view style={{ height: '800px', background: 'lightgray' }}>
|
|
32
|
+
<text>Very long content...</text>
|
|
33
|
+
</view>
|
|
34
|
+
</ScrollView>
|
|
35
|
+
)
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Wrapper Usage (Flex Layout)
|
|
40
|
+
|
|
41
|
+
When you need `flex` layout, add a wrapper as the first child of `ScrollView`, and apply `flex` styles on that wrapper:
|
|
42
|
+
|
|
43
|
+
Also make sure the direct child of `ScrollView` is larger than the `ScrollView` viewport on the scrolling axis. Otherwise, the content does not overflow and the `ScrollView` will not scroll.
|
|
44
|
+
|
|
45
|
+
```tsx
|
|
46
|
+
import { ScrollView } from '@lynx-js/lynx-ui'
|
|
47
|
+
|
|
48
|
+
function FlexWrapperExample() {
|
|
49
|
+
return (
|
|
50
|
+
<ScrollView scrollOrientation='vertical' style={{ height: '240px' }}>
|
|
51
|
+
{/* 第一层:wrapper view(设置 flex) */}
|
|
52
|
+
<view style={{ display: 'flex', flexDirection: 'row', gap: '8px' }}>
|
|
53
|
+
<view
|
|
54
|
+
className='card'
|
|
55
|
+
style={{ width: '100px', height: '100px', background: 'skyblue' }}
|
|
56
|
+
/>
|
|
57
|
+
<view
|
|
58
|
+
className='card'
|
|
59
|
+
style={{ width: '100px', height: '100px', background: 'salmon' }}
|
|
60
|
+
/>
|
|
61
|
+
<view
|
|
62
|
+
className='card'
|
|
63
|
+
style={{ width: '100px', height: '100px', background: 'khaki' }}
|
|
64
|
+
/>
|
|
65
|
+
</view>
|
|
66
|
+
</ScrollView>
|
|
67
|
+
)
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### Recommended Prompt Formula
|
|
72
|
+
|
|
73
|
+
> **Scenario Description** + **Scroll Configuration (direction, events)** + **Content and Style**
|
|
74
|
+
|
|
75
|
+
**Example Prompt:**
|
|
76
|
+
|
|
77
|
+
- "Create a vertically scrollable `ScrollView` with a height of 400px. The content within it has a total height of 1000px."
|
|
78
|
+
- "Implement a `ScrollView` that triggers a ‘load more’ function when scrolled to the bottom, using `onScrollToLower`."
|
|
79
|
+
- "Create a `ScrollView` and a ‘Back to Top’ button. When the button is clicked, smoothly scroll back to the top."
|
|
80
|
+
|
|
81
|
+
## 3. Use Cases & Best Practices
|
|
82
|
+
|
|
83
|
+
### Vertical Scrolling
|
|
84
|
+
|
|
85
|
+
```tsx
|
|
86
|
+
import { ScrollView } from '@lynx-js/lynx-ui'
|
|
87
|
+
|
|
88
|
+
function VerticalScrollView() {
|
|
89
|
+
return (
|
|
90
|
+
<ScrollView scrollY={true} style={{ height: '200px' }}>
|
|
91
|
+
<view style={{ height: '500px' }}>
|
|
92
|
+
{/* ... Long content ... */}
|
|
93
|
+
</view>
|
|
94
|
+
</ScrollView>
|
|
95
|
+
)
|
|
96
|
+
}
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
**Example Path**: `apps/examples/src/ScrollView/Basic/index.tsx`
|
|
100
|
+
|
|
101
|
+
### Horizontal Scrolling
|
|
102
|
+
|
|
103
|
+
```tsx
|
|
104
|
+
import { ScrollView } from '@lynx-js/lynx-ui'
|
|
105
|
+
|
|
106
|
+
function HorizontalScrollView() {
|
|
107
|
+
return (
|
|
108
|
+
<ScrollView scrollOrientation='horizontal' style={{ width: '100%' }}>
|
|
109
|
+
<view style={{ flexDirection: 'row' }}>
|
|
110
|
+
{[...Array(10)].map((_, i) => <view key={i} className='card' />)}
|
|
111
|
+
</view>
|
|
112
|
+
</ScrollView>
|
|
113
|
+
)
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
**Example Path**: `apps/examples/src/ScrollView/Basic/index.tsx`
|
|
118
|
+
|
|
119
|
+
### Listening for Scroll to Bottom (Load More)
|
|
120
|
+
|
|
121
|
+
```tsx
|
|
122
|
+
import { ScrollView } from '@lynx-js/lynx-ui'
|
|
123
|
+
|
|
124
|
+
function LoadMoreScrollView() {
|
|
125
|
+
const loadMore = () => {
|
|
126
|
+
console.log('Reached the bottom, loading more data...')
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
return (
|
|
130
|
+
<ScrollView
|
|
131
|
+
scrollY={true}
|
|
132
|
+
style={{ height: '300px' }}
|
|
133
|
+
onScrollToLower={loadMore}
|
|
134
|
+
lower-threshold='50'
|
|
135
|
+
>
|
|
136
|
+
{/* ... list content ... */}
|
|
137
|
+
</ScrollView>
|
|
138
|
+
)
|
|
139
|
+
}
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
**Example Path**: `apps/examples/src/ScrollView/Event/index.tsx`
|
|
143
|
+
|
|
144
|
+
### 4. FAQ
|
|
145
|
+
|
|
146
|
+
**Q: Why can't my `ScrollView` scroll?**
|
|
147
|
+
|
|
148
|
+
A: `ScrollView` needs a determined boundary. Set a fixed size (e.g., `height: '300px'`) or place it in a flex container and use `flex: 1`. Also ensure the direct child of `ScrollView` is larger than the viewport on the scrolling axis. For example, a vertical `ScrollView` with `height: '300px'` needs a direct child taller than `300px`; otherwise it will not scroll.
|
|
149
|
+
|
|
150
|
+
**Q: `ScrollView` inside `Popup` causes drag conflicts?**
|
|
151
|
+
|
|
152
|
+
A: Pass the `main-thread:gesture` object provided by `Popup` to `ScrollView`'s `main-thread:gesture` for proper gesture arbitration.
|
|
153
|
+
|
|
154
|
+
**Q: Long lists stutter with `ScrollView` + `.map()`?**
|
|
155
|
+
|
|
156
|
+
A: Use `List` or `FeedList` for large datasets; they provide virtualization and view reuse. `ScrollView` suits limited content scenarios.
|
|
157
|
+
|
|
158
|
+
**Q: How to implement “Back to Top”?
|
|
159
|
+
|
|
160
|
+
A: Maintain a scroll position state and programmatically set `scroll-top` (or use native APIs) on interaction.
|
|
161
|
+
|
|
162
|
+
**Q: How to use flex layout inside `ScrollView`?**
|
|
163
|
+
|
|
164
|
+
A: The first-level direct child of `ScrollView` is constrained to `display: linear`. If you need `flex`, add a wrapper `view` as the first child and apply all flex-related styles to that wrapper.
|
|
165
|
+
|
|
166
|
+
## 5. Sub components
|
|
167
|
+
|
|
168
|
+
`ScrollView` is a container component. Its direct child elements are the scrollable content. There are no named child components.
|
|
@@ -16,7 +16,7 @@ export interface BounceableBasicProps {
|
|
|
16
16
|
validAnimationVersion?: boolean;
|
|
17
17
|
onScrollToBounces?: (e: ScrollToBouncesInfo) => void;
|
|
18
18
|
}
|
|
19
|
-
export interface
|
|
19
|
+
export interface UseBounceOptions {
|
|
20
20
|
bounceableOptions: BounceableBasicProps;
|
|
21
21
|
debugLog?: boolean;
|
|
22
22
|
enableRTL?: boolean;
|
|
@@ -42,5 +42,5 @@ export interface BounceHandlers {
|
|
|
42
42
|
}
|
|
43
43
|
/** @deprecated Use `BounceHandlers` instead. */
|
|
44
44
|
export type bounceHandlers = BounceHandlers;
|
|
45
|
-
export declare function useBounce(options:
|
|
45
|
+
export declare function useBounce(options: UseBounceOptions): BounceHandlers;
|
|
46
46
|
//# sourceMappingURL=useBounce.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"useBounce.d.ts","sourceRoot":"","sources":["../../src/hooks/useBounce.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE1E,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,OAAO,CAAA;IACtB,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAClC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAEjC,eAAe,CAAC,EAAE,GAAG,CAAA;IAErB,eAAe,CAAC,EAAE,GAAG,CAAA;IACrB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,iBAAiB,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAAA;IACtE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,iBAAiB,CAAC,EAAE,CAAC,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,oBAAoB,CAAA;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,iBAAiB,EAAE,UAAU,GAAG,YAAY,CAAA;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,4BAA4B,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,KAAK,IAAI,CAAA;IACpE,0BAA0B,EAAE,MAAM,IAAI,CAAA;IACtC,2BAA2B,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,KAAK,IAAI,CAAA;IACnE,8BAA8B,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IAC5D,wBAAwB,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACtD,eAAe,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAC9C,kBAAkB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IACjD,eAAe,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAC9C,kBAAkB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;CAClD;AAED,gDAAgD;
|
|
1
|
+
{"version":3,"file":"useBounce.d.ts","sourceRoot":"","sources":["../../src/hooks/useBounce.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE1E,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,OAAO,CAAA;IACtB,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAClC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAEjC,eAAe,CAAC,EAAE,GAAG,CAAA;IAErB,eAAe,CAAC,EAAE,GAAG,CAAA;IACrB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,iBAAiB,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAAA;IACtE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,iBAAiB,CAAC,EAAE,CAAC,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,oBAAoB,CAAA;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,iBAAiB,EAAE,UAAU,GAAG,YAAY,CAAA;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,4BAA4B,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,KAAK,IAAI,CAAA;IACpE,0BAA0B,EAAE,MAAM,IAAI,CAAA;IACtC,2BAA2B,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,KAAK,IAAI,CAAA;IACnE,8BAA8B,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IAC5D,wBAAwB,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACtD,eAAe,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAC9C,kBAAkB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IACjD,eAAe,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAC9C,kBAAkB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;CAClD;AAED,gDAAgD;AAEhD,MAAM,MAAM,cAAc,GAAG,cAAc,CAAA;AAE3C,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CA0yBnE"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hooks/useBounce.jsx","sources":["../../src/hooks/useBounce.tsx"],"sourcesContent":["// Copyright 2026 The Lynx Authors. All rights reserved.\n// Licensed under the Apache License Version 2.0 that can be found in the\n// LICENSE file in the root directory of this source tree.\n\nimport { runOnBackground, useMainThreadRef } from '@lynx-js/react'\n\nimport { log, mtsLog, selectorMT } from '@lynx-js/lynx-ui-common'\nimport type { CommonEvent, MainThread, ScrollEvent } from '@lynx-js/types'\n\nexport interface ScrollToBouncesInfo {\n direction: 'upper' | 'lower'\n}\n\nexport interface BounceableBasicProps {\n enableBounces: boolean\n enableBounceEventInFling?: boolean\n startBounceTriggerDistance?: number\n endBounceTriggerDistance?: number\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- expected dynamic callback\n upperBounceItem?: any\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- expected dynamic callback\n lowerBounceItem?: any\n alwaysBouncing?: boolean\n singleSidedBounce?: 'upper' | 'lower' | 'both' | 'iOSBounces' | 'none'\n estimatedHeight?: number\n estimatedWidth?: number\n validAnimationVersion?: boolean\n onScrollToBounces?: (e: ScrollToBouncesInfo) => void\n}\n\nexport interface useBounceOptions {\n bounceableOptions: BounceableBasicProps\n debugLog?: boolean\n enableRTL?: boolean\n /**\n * idSelector of scroll container\n */\n id?: string\n /**\n * scroll direction\n */\n scrollOrientation: 'vertical' | 'horizontal'\n}\n\nexport interface BounceHandlers {\n 'main-thread:bindtouchstart': (event: MainThread.TouchEvent) => void\n 'main-thread:bindtouchend': () => void\n 'main-thread:bindtouchmove': (event: MainThread.TouchEvent) => void\n 'main-thread:bindlayoutchange': (event: CommonEvent) => void\n 'main-thread:bindscroll': (event: ScrollEvent) => void\n onUpperExposure: (_event: CommonEvent) => void\n onUpperDisexposure: (_event: CommonEvent) => void\n onLowerExposure: (_event: CommonEvent) => void\n onLowerDisexposure: (_event: CommonEvent) => void\n}\n\n/** @deprecated Use `BounceHandlers` instead. */\nexport type bounceHandlers = BounceHandlers\n\nexport function useBounce(options: useBounceOptions): BounceHandlers {\n // Control the damping coefficient during rubber effect. The smaller it is, the harder the spring effect.\n const rubberC = useMainThreadRef(0.55)\n // Control the fling deceleration coefficient during dropdown. The smaller it is, the faster it stops.\n const flingDeceleratingRate = useMainThreadRef(0.99)\n // The rebound coefficient during bounce back, the larger it is, the faster the rebound speed.\n const beta = useMainThreadRef(15)\n\n const debugLogEnabled = Boolean(options.debugLog)\n\n const singleSidedBounce = useMainThreadRef(\n options.bounceableOptions.singleSidedBounce ?? 'both',\n )\n\n // The starting point of current touch procedure\n const startTouch = useMainThreadRef<MainThread.TouchEvent['touches'] | null>(\n null,\n )\n // Record the previous touch and clear it on touchEnd. If current is not empty, then it means that the scrollable object is being dragged.\n const prevTouch = useMainThreadRef<MainThread.TouchEvent['touches'] | null>(\n null,\n )\n\n // Current scroll velocity.\n const scrollVelocity = useMainThreadRef(0)\n // Current bouncing position.\n const bouncingPositionInfo = useMainThreadRef({})\n\n // If reaches edge and bouncing starts during dragging, save the touch point and calculate later touch delta for rubberEffect.\n const startBouncingTouch = useMainThreadRef<\n MainThread.TouchEvent['touches'] | null\n >(null)\n // If reaches edge and bouncing starts during dragging, save current bouncingPosition and continues rubberEffect's calculation from this point.\n const startTouchBouncingDelta = useMainThreadRef({})\n // when touch starts during bouncing, save current bouncingPosition and continues rubberEffect's calculation from this point.\n const bouncingTouchStartPosition = useMainThreadRef({})\n\n // Used to record the previous scroll position and calculate current scroll velocity.\n const prevScroll = useMainThreadRef({})\n\n // scroll container's basic info.\n const height = useMainThreadRef(\n options.bounceableOptions.estimatedHeight\n ?? SystemInfo.pixelHeight / SystemInfo.pixelRatio,\n )\n const width = useMainThreadRef(\n options.bounceableOptions.estimatedWidth\n ?? SystemInfo.pixelWidth / SystemInfo.pixelRatio,\n )\n const scrollX = useMainThreadRef(0)\n const scrollY = useMainThreadRef(0)\n\n // Flags for ending bouncing animation.\n const touchEndFrameEnableFlag = useMainThreadRef(false)\n const touchingEndBouncingBackEnableFlag = useMainThreadRef(false)\n const flingEndWithBouncingEnableFlag = useMainThreadRef(false)\n\n // Flags for reaches upper/lower edge.\n // When content's size is smaller than viewport, these two flags are both true.\n const toUpper = useMainThreadRef(false)\n const toLower = useMainThreadRef(false)\n\n // Read from props\n const containerID = options.id ?? 'bounceableContainer'\n const { enableBounces, onScrollToBounces } = options.bounceableOptions\n const alwaysBouncing = options.bounceableOptions.alwaysBouncing ?? false\n const scrollOrientation = options.scrollOrientation ?? 'vertical'\n const enableRTL = useMainThreadRef(options.enableRTL ?? false)\n const enableBounceEventInFling =\n options.bounceableOptions.enableBounceEventInFling ?? true\n const startBounceTriggerDistance =\n options.bounceableOptions.startBounceTriggerDistance ?? 0\n const endBounceTriggerDistance =\n options.bounceableOptions.endBounceTriggerDistance ?? 0\n // Temporary workaround as requestAnimationFrame will crash below Lynx 2.15.2.\n const temporaryValidVersionCheckForRAF = useMainThreadRef(\n options.bounceableOptions.validAnimationVersion ?? false,\n )\n log(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] init, enableBounces: ${enableBounces}, orientation: ${scrollOrientation}, enableRTL: ${\n options.enableRTL ?? false\n }`,\n )\n\n const bouncingStatus = {\n inScrollingRange: 0,\n upperBouncing: 1,\n lowerBouncing: 2,\n noBouncing: 3,\n alwaysBouncing: 4,\n }\n\n function isVertical() {\n 'main thread'\n return scrollOrientation === 'vertical'\n }\n\n function threshold() {\n 'main thread'\n return 1.0 / Number(SystemInfo.pixelRatio)\n }\n\n function normalizedHorizontalValue(value: number) {\n 'main thread'\n return enableRTL.current ? -value : value\n }\n\n function isAndroid() {\n 'main thread'\n return SystemInfo.platform === 'Android'\n }\n\n function isEmpty(obj: Record<string, unknown>) {\n 'main thread'\n return !obj || Object.keys(obj).length === 0\n }\n\n function enableScroll(enable: boolean) {\n 'main thread'\n // Android will trigger scroll during bouncing, cancel it while bouncing.\n if (isAndroid()) {\n selectorMT(containerID)?.setAttribute('enable-scroll', enable)\n }\n }\n\n // Clear all temps when a touch procedure ends.\n function clearTouchInfo() {\n 'main thread'\n mtsLog(debugLogEnabled, '[lynx-ui-scroll-view][useBounce] clear touch info')\n startTouch.current = null\n bouncingTouchStartPosition.current = 0\n prevTouch.current = null\n startBouncingTouch.current = null\n startTouchBouncingDelta.current = 0\n }\n\n // Temporary workaround as requestAnimationFrame will crash below Lynx 2.15.2.\n function customRequestAnimationFrame(animationFunc: () => void) {\n 'main thread'\n if (temporaryValidVersionCheckForRAF.current) {\n requestAnimationFrame(animationFunc)\n } else {\n setTimeout(animationFunc, 8)\n }\n }\n\n // Calculate current touch delta based on 'startPoint'. The startPoint here should be startBouncingTouch which means this bouncing effect happens during a touch procedure.\n function getCurrentDelta(event: MainThread.TouchEvent) {\n 'main thread'\n if (startTouch.current !== null) {\n if (startBouncingTouch.current === null) {\n return scrollOrientation === 'vertical'\n ? event.touches[0].pageY - startTouch.current[0].pageY\n : normalizedHorizontalValue(\n event.touches[0].pageX - startTouch.current[0].pageX,\n )\n } else {\n return scrollOrientation === 'vertical'\n ? event.touches[0].pageY - startBouncingTouch.current[0].pageY\n : normalizedHorizontalValue(\n event.touches[0].pageX - startBouncingTouch.current[0].pageX,\n )\n }\n }\n return 0\n }\n\n // Key bouncing status judgement.\n function getBouncingStatus() {\n 'main thread'\n // @ts-expect-error Expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const currentPosition = bouncingPositionInfo.current?.bouncingOffset ?? 0\n if (Boolean(toUpper.current) && Boolean(toLower.current)) {\n return alwaysBouncing\n ? bouncingStatus.alwaysBouncing\n : bouncingStatus.noBouncing\n }\n\n // upper bouncing\n const initialLayoutPosition = 0\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] get bouncing status, initialLayoutPosition: ${initialLayoutPosition}, currentPosition: ${currentPosition}`,\n )\n\n if (currentPosition > initialLayoutPosition) {\n return bouncingStatus.upperBouncing\n }\n\n // bottom bouncing\n if (currentPosition < initialLayoutPosition) {\n return bouncingStatus.lowerBouncing\n }\n return bouncingStatus.inScrollingRange\n }\n\n // Whether fling and bouncing back step should be triggered.\n function shouldBounceWhenTouchEnd(status: number) {\n 'main thread'\n if (\n status === bouncingStatus.inScrollingRange\n || status === bouncingStatus.noBouncing\n ) {\n return false\n }\n\n if (\n status === bouncingStatus.upperBouncing\n || status === bouncingStatus.lowerBouncing\n ) {\n return true\n }\n\n if (status === bouncingStatus.alwaysBouncing) {\n return alwaysBouncing\n }\n return false\n }\n\n // Use translate to implement real bouncing effect\n function bouncingSetStyle(offset: number) {\n 'main thread'\n if (Number.isNaN(Number(offset))) {\n mtsLog(\n true,\n '[lynx-ui-scroll-view][useBounce] ERROR! bouncingOffset is NaN',\n )\n return\n }\n // update bouncingPositionInfo first\n if (isEmpty(bouncingPositionInfo.current)) {\n // @ts-expect-error expected\n bouncingPositionInfo.current.velocity = 0\n } else {\n // @ts-expect-error expected\n const timeDiff = Date.now() - bouncingPositionInfo.current.timeStamp\n // @ts-expect-error expected\n const offsetDiff = offset - bouncingPositionInfo.current.bouncingOffset\n || 0\n if (timeDiff > 0) {\n // @ts-expect-error expected\n bouncingPositionInfo.current.velocity = offsetDiff / timeDiff\n }\n // If timeDiff <= 0, we keep the previous velocity to maintain momentum continuity.\n }\n // @ts-expect-error expected\n bouncingPositionInfo.current.bouncingOffset = offset\n // @ts-expect-error expected\n bouncingPositionInfo.current.timeStamp = Date.now()\n // When bouncing effect ends, clear startTouch and bouncingTouchStartPosition\n if (offset === 0 && prevTouch.current !== null) {\n startTouch.current = prevTouch.current\n bouncingTouchStartPosition.current = {}\n }\n // trigger translate\n if (isVertical()) {\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] apply transform, orientation: vertical, rawOffset: ${offset}, containerTransform: translateY(${offset}px)`,\n )\n selectorMT(containerID)?.setStyleProperty(\n 'transform',\n `translateY(${offset}px)`,\n )\n selectorMT(`${containerID}-upperBounceWrapper`)?.setStyleProperty(\n 'transform',\n `translateY(${offset}px)`,\n )\n selectorMT(`${containerID}-lowerBounceWrapper`)?.setStyleProperty(\n 'transform',\n `translateY(${offset}px)`,\n )\n } else {\n const visualOffset = enableRTL.current ? -offset : offset\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] apply transform, orientation: horizontal, rawOffset: ${offset}, enableRTL: ${\n String(enableRTL.current)\n }, visualOffset: ${visualOffset}, containerTransform: translateX(${visualOffset}px)`,\n )\n selectorMT(containerID)?.setStyleProperty(\n 'transform',\n `translateX(${visualOffset}px)`,\n )\n selectorMT(`${containerID}-upperBounceWrapper`)?.setStyleProperty(\n 'transform',\n `translateX(${visualOffset}px)`,\n )\n selectorMT(`${containerID}-lowerBounceWrapper`)?.setStyleProperty(\n 'transform',\n `translateX(${visualOffset}px)`,\n )\n }\n }\n\n function onScrollToBouncesJS(info: ScrollToBouncesInfo) {\n if (enableBounces && onScrollToBounces) {\n onScrollToBounces(info)\n }\n }\n\n // send the scrollToBounces event\n function triggerScrollToBouncesEvent(isUpper: boolean) {\n 'main thread'\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] trigger scrollToBounces, direction: ${\n isUpper ? 'upper' : 'lower'\n }`,\n )\n\n const info: ScrollToBouncesInfo = {\n direction: isUpper ? 'upper' : 'lower',\n }\n runOnBackground(onScrollToBouncesJS)(info)\n }\n\n function rubberEffect(isNegative: 1 | -1, delta: number) {\n 'main thread'\n const scrollViewFrameSize = isVertical() ? height.current : width.current\n // If the touchStartPosition is not zero, it means this rubber effect happens during a touch or another bouncing effect. So the real 'start delta' should be recalculated.\n const touchStartPosition = Math.abs(\n Number(\n isEmpty(startTouchBouncingDelta.current)\n ? bouncingTouchStartPosition.current\n : startTouchBouncingDelta.current,\n ),\n )\n // This deltaYForTouchStartPosition is the inverse function of rubberEffect function\n const deltaYForTouchStartPosition =\n (scrollViewFrameSize * touchStartPosition)\n / ((scrollViewFrameSize - touchStartPosition) * rubberC.current) || 0\n // Here it calculate the next touchDelta. deltaYForNextPosition = (touch point where bouncing happens + corresponding touch delta where previous bouncing position locates)\n // This isNegative is used to handle the upper/lower bounce. RubberEffect function is different in the range (-inf,0) and [0, inf). We only use the [0, inf) part.\n const deltaYForNextPosition = bouncingTouchStartPosition.current\n ? deltaYForTouchStartPosition + isNegative * delta\n : isNegative * delta\n // Real calculation. Note that we don't use the raw touchDelta for calculating, instead, we use deltaYForNextPosition.\n const rubberBandingDistance = Math.max(\n 0,\n (1.0\n - 1.0\n / ((deltaYForNextPosition * rubberC.current) / scrollViewFrameSize\n + 1.0))\n * scrollViewFrameSize,\n )\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] rubber effect, scrollViewFrameSize: ${scrollViewFrameSize}, touchStartPosition: ${touchStartPosition}, deltaYForTouchStartPosition: ${deltaYForTouchStartPosition}, deltaYForNextPosition: ${deltaYForNextPosition}, rubberBandingDistance: ${rubberBandingDistance}`,\n )\n\n bouncingSetStyle(isNegative * rubberBandingDistance)\n }\n\n function triggerRubberEffectIfCrossingEdge(event: MainThread.TouchEvent) {\n 'main thread'\n const delta = getCurrentDelta(event)\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] check crossing edge, delta: ${delta}, toUpper: ${\n String(toUpper.current)\n }, toLower: ${String(toLower.current)}`,\n )\n\n // Crossing top range\n if (\n toUpper.current === true && delta > 0\n && (singleSidedBounce.current === 'both'\n || singleSidedBounce.current === 'upper')\n ) {\n enableScroll(false)\n rubberEffect(delta > 0 ? 1 : -1, delta)\n }\n\n // Crossing bottom range\n if (\n toLower.current === true && delta < 0\n && (singleSidedBounce.current === 'both'\n || singleSidedBounce.current === 'lower')\n ) {\n enableScroll(false)\n rubberEffect(delta > 0 ? 1 : -1, delta)\n }\n enableScroll(true)\n }\n\n // return true if scrollToBounces should be sent\n function isOverTriggerDistance() {\n 'main thread'\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const bouncingTop: number = bouncingPositionInfo.current.bouncingOffset ?? 0\n const triggerDistance =\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset > 0\n ? startBounceTriggerDistance\n : endBounceTriggerDistance\n const delta = Math.abs(bouncingTop) - Math.abs(triggerDistance)\n return delta > threshold()\n }\n\n function bouncingBack() {\n 'main thread'\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] fling forward end',\n )\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] bounce back starts',\n )\n\n // step3: bounce back\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const C1 = bouncingPositionInfo.current.bouncingOffset ?? 0\n const startTime = Date.now()\n const touchingEndBouncingBackFrame = () => {\n if (Boolean(touchingEndBouncingBackEnableFlag.current) === false) {\n return\n }\n const currentTime = Date.now() - startTime\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touching end bouncing back frame',\n )\n\n // critical damping\n const C2 = beta.current * C1\n const easedDistance = (C1 + C2 * (currentTime / 1000))\n * Math.pow(Math.E, -beta.current * (currentTime / 1000))\n bouncingSetStyle(easedDistance)\n if (Math.abs(easedDistance) < threshold()) {\n // Make sure it backs to 0\n bouncingSetStyle(0)\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] bounce back ends',\n )\n } else {\n customRequestAnimationFrame(touchingEndBouncingBackFrame)\n }\n }\n\n customRequestAnimationFrame(touchingEndBouncingBackFrame)\n touchingEndBouncingBackEnableFlag.current = true\n }\n\n // bindtouchstart. Save startTouch and bouncingPosition if a bouncing effect is happening.\n function bounceableTouchStart(event: MainThread.TouchEvent) {\n 'main thread'\n startTouch.current = event.touches\n mtsLog(debugLogEnabled, '[lynx-ui-scroll-view][useBounce] touch start')\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n bouncingTouchStartPosition.current =\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset ?? 0\n // reset all animation flags. No animation should play during a touch.\n touchEndFrameEnableFlag.current = false\n touchingEndBouncingBackEnableFlag.current = false\n flingEndWithBouncingEnableFlag.current = false\n }\n\n function bounceableTouchMove(event: MainThread.TouchEvent) {\n 'main thread'\n prevTouch.current = event.touches\n if (startTouch.current === null) {\n // It means current situation is illegal. A touchMove event happens without a touchStart event beforehand. Or a touchMove event happens after a touchEnd event.\n mtsLog(true, '[lynx-ui-scroll-view][useBounce] ERROR! touch not started')\n } else {\n const delta = getCurrentDelta(event)\n const currentBouncingStatus = getBouncingStatus()\n // Judge the status and trigger rubberEffect. The TouchMove should only consider rubberEffect and nothing else.\n switch (currentBouncingStatus) {\n case bouncingStatus.upperBouncing: {\n enableScroll(false)\n rubberEffect(1, delta)\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touch move upper bouncing',\n )\n break\n }\n case bouncingStatus.lowerBouncing: {\n enableScroll(false)\n rubberEffect(-1, delta)\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touch move lower bouncing',\n )\n break\n }\n case bouncingStatus.alwaysBouncing: {\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touch move always bouncing',\n )\n if (alwaysBouncing) {\n triggerRubberEffectIfCrossingEdge(event)\n }\n break\n }\n case bouncingStatus.inScrollingRange: {\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touch move in scrolling range',\n )\n triggerRubberEffectIfCrossingEdge(event)\n break\n }\n default:\n break\n }\n }\n }\n\n // bindtouchend. In touchEnd event the fling forward animation and bouncingBack animation should be triggered if necessary.\n function bounceableTouchEnd() {\n 'main thread'\n // Reset the state. The touch information should be reset, and we should no longer ban the enable-scroll.\n clearTouchInfo()\n enableScroll(true)\n mtsLog(debugLogEnabled, '[lynx-ui-scroll-view][useBounce] touch end')\n if (shouldBounceWhenTouchEnd(getBouncingStatus())) {\n const startTime = Date.now()\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const dragEndVelocity = bouncingPositionInfo.current?.velocity\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const dragEndPosition = bouncingPositionInfo.current?.bouncingOffset ?? 0\n // Send scrolltobounces event.\n if (isOverTriggerDistance()) {\n triggerScrollToBouncesEvent(\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset > 0,\n )\n }\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n let currentVelocity: number = dragEndVelocity\n const touchEndProcessFrame = () => {\n if (Boolean(touchEndFrameEnableFlag.current) === false) {\n return\n }\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touch end process frame',\n )\n if (Math.abs(currentVelocity) <= threshold()) {\n // If the velocity is already under threshold, skip fling and start step3: bounce back.\n bouncingBack()\n } else {\n // If the drag end with a velocity, start fling to consume it.\n // step 2: fling down\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] fling down start',\n )\n // This function is obtained by integrating the velocity function with a deceleration rate of flingDeceleratingRate.\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const distance: number = dragEndPosition\n + (dragEndVelocity\n * (Math.pow(\n flingDeceleratingRate.current,\n Date.now() - startTime,\n )\n - 1))\n / Math.log(flingDeceleratingRate.current)\n bouncingSetStyle(distance)\n currentVelocity = dragEndVelocity\n * Math.pow(flingDeceleratingRate.current, Date.now() - startTime)\n if (touchEndFrameEnableFlag.current) {\n customRequestAnimationFrame(touchEndProcessFrame)\n }\n }\n }\n customRequestAnimationFrame(touchEndProcessFrame)\n touchEndFrameEnableFlag.current = true\n }\n }\n\n // Save the bindscroll info and calculate velocity.\n function bounceableHandleScroll(event: ScrollEvent) {\n 'main thread'\n scrollX.current = event.detail.scrollLeft\n scrollY.current = event.detail.scrollTop\n if (!isEmpty(prevScroll.current)) {\n const prev = prevScroll.current as {\n timestamp: number\n detail: { scrollTop: number, scrollLeft: number }\n }\n const timeDuration = Date.now() - prev.timestamp\n if (timeDuration > 0) {\n const deltaY = isVertical()\n ? event.detail.scrollTop - prev.detail.scrollTop\n : normalizedHorizontalValue(\n event.detail.scrollLeft - prev.detail.scrollLeft,\n )\n const velocity = deltaY / timeDuration\n if (Number.isFinite(velocity)) {\n scrollVelocity.current = velocity\n }\n }\n }\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] handle scroll near edge, scrollLeft: ${event.detail.scrollLeft}, scrollTop: ${event.detail.scrollTop}, velocity: ${scrollVelocity.current}`,\n )\n prevScroll.current = event\n }\n\n function onUpperDisexposure(_event: CommonEvent) {\n 'main thread'\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] upper disexposure',\n )\n toUpper.current = false\n }\n\n // Handle scrolltoupper event.\n function onUpperExposure(_event: CommonEvent) {\n 'main thread'\n mtsLog(debugLogEnabled, '[lynx-ui-scroll-view][useBounce] upper exposure')\n toUpper.current = true\n if (\n singleSidedBounce.current !== 'upper'\n && singleSidedBounce.current !== 'both'\n ) {\n return\n }\n if (prevScroll.current) {\n // reaches edge during touch\n startBouncingTouch.current = prevTouch.current\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n startTouchBouncingDelta.current =\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset ?? 0\n } else if (Math.abs(scrollVelocity.current) > threshold()) {\n // reaches edge during fling\n const velocity = scrollVelocity.current\n let currentVelocity = velocity\n const startTime = Date.now()\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] fling to upper event start, velocity: ${velocity}`,\n )\n let sentScrollToBouncesEvent = false // only sent scrollToBounces once\n const flingEndWithBouncingFrame = () => {\n if (Boolean(flingEndWithBouncingEnableFlag.current) === false) {\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] flingEndWithBouncingEnableFlag early return',\n )\n return\n }\n if (Math.abs(currentVelocity) <= threshold()) {\n flingEndWithBouncingEnableFlag.current = false\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] fling to upper event end',\n )\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] bouncing to upper event start',\n )\n bouncingBack()\n } else {\n // step 1: fling\n const distance = (currentVelocity\n * (Math.pow(flingDeceleratingRate.current, Date.now() - startTime)\n - 1))\n / Math.log(flingDeceleratingRate.current)\n bouncingSetStyle(-distance)\n if (!sentScrollToBouncesEvent && isOverTriggerDistance()) {\n triggerScrollToBouncesEvent(\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset > 0,\n )\n sentScrollToBouncesEvent = true\n }\n currentVelocity = velocity\n * Math.pow(flingDeceleratingRate.current, Date.now() - startTime)\n if (flingEndWithBouncingEnableFlag.current) {\n customRequestAnimationFrame(flingEndWithBouncingFrame)\n }\n }\n }\n customRequestAnimationFrame(flingEndWithBouncingFrame)\n flingEndWithBouncingEnableFlag.current = true\n }\n }\n\n function onLowerDisexposure(_event: CommonEvent) {\n 'main thread'\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] lower disexposure',\n )\n toLower.current = false\n }\n\n function onLowerExposure(_event: CommonEvent) {\n 'main thread'\n mtsLog(debugLogEnabled, '[lynx-ui-scroll-view][useBounce] lower exposure')\n toLower.current = true\n if (\n singleSidedBounce.current !== 'lower'\n && singleSidedBounce.current !== 'both'\n ) {\n return\n }\n // reaches lower during dragging\n if (prevTouch.current !== null) {\n startBouncingTouch.current = prevTouch.current\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n startTouchBouncingDelta.current =\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset ?? 0\n } else if (enableBounceEventInFling && scrollVelocity.current > 0) {\n const velocity = scrollVelocity.current\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] lower velocity: ${velocity}`,\n )\n\n // scroll to end with velocity, start bouncing effect\n if (Math.abs(velocity) > threshold()) {\n let currentVelocity = velocity\n const startTime = Date.now()\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] fling to lower event start, velocity: ${velocity}`,\n )\n let sentScrollToBouncesEvent = false // only sent scrollToBounces once\n const flingEndWithBouncingFrame = () => {\n if (Boolean(flingEndWithBouncingEnableFlag.current) === false) {\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] flingEndWithBouncingEnableFlag early return',\n )\n return\n }\n if (Math.abs(currentVelocity) <= threshold()) {\n flingEndWithBouncingEnableFlag.current = false\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] fling to lower event end',\n )\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] bouncing to lower event start',\n )\n bouncingBack()\n } else {\n // step 1: fling\n const distance = (currentVelocity\n * (Math.pow(\n flingDeceleratingRate.current,\n Date.now() - startTime,\n )\n - 1))\n / Math.log(flingDeceleratingRate.current)\n bouncingSetStyle(-distance)\n if (!sentScrollToBouncesEvent && isOverTriggerDistance()) {\n triggerScrollToBouncesEvent(\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset > 0,\n )\n sentScrollToBouncesEvent = true\n }\n currentVelocity = velocity\n * Math.pow(flingDeceleratingRate.current, Date.now() - startTime)\n if (flingEndWithBouncingEnableFlag) {\n customRequestAnimationFrame(flingEndWithBouncingFrame)\n }\n }\n }\n customRequestAnimationFrame(flingEndWithBouncingFrame)\n flingEndWithBouncingEnableFlag.current = true\n }\n }\n }\n\n // Used to get the size of scroll container.\n function bounceableLayoutChange(event: CommonEvent) {\n 'main thread'\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n height.current = (isAndroid() ? event.params?.height : event.detail?.height)\n ?? 0\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n width.current = (isAndroid() ? event.params?.width : event.detail?.width)\n ?? 0\n }\n\n return {\n 'main-thread:bindtouchstart': bounceableTouchStart,\n 'main-thread:bindtouchend': bounceableTouchEnd,\n 'main-thread:bindtouchmove': bounceableTouchMove,\n 'main-thread:bindlayoutchange': bounceableLayoutChange,\n 'main-thread:bindscroll': bounceableHandleScroll,\n onUpperExposure,\n onUpperDisexposure,\n onLowerExposure,\n onLowerDisexposure,\n }\n}\n"],"names":["useBounce","options","rubberC","useMainThreadRef","flingDeceleratingRate","beta","debugLogEnabled","Boolean","singleSidedBounce","startTouch","prevTouch","scrollVelocity","bouncingPositionInfo","startBouncingTouch","startTouchBouncingDelta","bouncingTouchStartPosition","prevScroll","height","SystemInfo","width","scrollX","scrollY","touchEndFrameEnableFlag","touchingEndBouncingBackEnableFlag","flingEndWithBouncingEnableFlag","toUpper","toLower","containerID","enableBounces","onScrollToBounces","alwaysBouncing","scrollOrientation","enableRTL","enableBounceEventInFling","startBounceTriggerDistance","endBounceTriggerDistance","temporaryValidVersionCheckForRAF","log","bouncingStatus","isVertical","threshold","Number","normalizedHorizontalValue","value","isAndroid","isEmpty","obj","Object","enableScroll","enable","selectorMT","clearTouchInfo","mtsLog","customRequestAnimationFrame","animationFunc","requestAnimationFrame","setTimeout","getCurrentDelta","event","getBouncingStatus","currentPosition","initialLayoutPosition","shouldBounceWhenTouchEnd","status","bouncingSetStyle","offset","timeDiff","Date","offsetDiff","visualOffset","String","onScrollToBouncesJS","info","triggerScrollToBouncesEvent","isUpper","runOnBackground","rubberEffect","isNegative","delta","scrollViewFrameSize","touchStartPosition","Math","deltaYForTouchStartPosition","deltaYForNextPosition","rubberBandingDistance","triggerRubberEffectIfCrossingEdge","isOverTriggerDistance","bouncingTop","triggerDistance","bouncingBack","C1","startTime","touchingEndBouncingBackFrame","currentTime","C2","easedDistance","bounceableTouchStart","bounceableTouchMove","currentBouncingStatus","bounceableTouchEnd","dragEndVelocity","dragEndPosition","currentVelocity","touchEndProcessFrame","distance","bounceableHandleScroll","prev","timeDuration","deltaY","velocity","onUpperDisexposure","_event","onUpperExposure","sentScrollToBouncesEvent","flingEndWithBouncingFrame","onLowerDisexposure","onLowerExposure","bounceableLayoutChange"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"hooks/useBounce.jsx","sources":["../../src/hooks/useBounce.tsx"],"sourcesContent":["// Copyright 2026 The Lynx Authors. All rights reserved.\n// Licensed under the Apache License Version 2.0 that can be found in the\n// LICENSE file in the root directory of this source tree.\n\nimport { runOnBackground, useMainThreadRef } from '@lynx-js/react'\n\nimport { log, mtsLog, selectorMT } from '@lynx-js/lynx-ui-common'\nimport type { CommonEvent, MainThread, ScrollEvent } from '@lynx-js/types'\n\nexport interface ScrollToBouncesInfo {\n direction: 'upper' | 'lower'\n}\n\nexport interface BounceableBasicProps {\n enableBounces: boolean\n enableBounceEventInFling?: boolean\n startBounceTriggerDistance?: number\n endBounceTriggerDistance?: number\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- expected dynamic callback\n upperBounceItem?: any\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- expected dynamic callback\n lowerBounceItem?: any\n alwaysBouncing?: boolean\n singleSidedBounce?: 'upper' | 'lower' | 'both' | 'iOSBounces' | 'none'\n estimatedHeight?: number\n estimatedWidth?: number\n validAnimationVersion?: boolean\n onScrollToBounces?: (e: ScrollToBouncesInfo) => void\n}\n\nexport interface UseBounceOptions {\n bounceableOptions: BounceableBasicProps\n debugLog?: boolean\n enableRTL?: boolean\n /**\n * idSelector of scroll container\n */\n id?: string\n /**\n * scroll direction\n */\n scrollOrientation: 'vertical' | 'horizontal'\n}\n\nexport interface BounceHandlers {\n 'main-thread:bindtouchstart': (event: MainThread.TouchEvent) => void\n 'main-thread:bindtouchend': () => void\n 'main-thread:bindtouchmove': (event: MainThread.TouchEvent) => void\n 'main-thread:bindlayoutchange': (event: CommonEvent) => void\n 'main-thread:bindscroll': (event: ScrollEvent) => void\n onUpperExposure: (_event: CommonEvent) => void\n onUpperDisexposure: (_event: CommonEvent) => void\n onLowerExposure: (_event: CommonEvent) => void\n onLowerDisexposure: (_event: CommonEvent) => void\n}\n\n/** @deprecated Use `BounceHandlers` instead. */\n// eslint-disable-next-line @typescript-eslint/naming-convention -- Preserve the deprecated public alias for compatibility.\nexport type bounceHandlers = BounceHandlers\n\nexport function useBounce(options: UseBounceOptions): BounceHandlers {\n // Control the damping coefficient during rubber effect. The smaller it is, the harder the spring effect.\n const rubberC = useMainThreadRef(0.55)\n // Control the fling deceleration coefficient during dropdown. The smaller it is, the faster it stops.\n const flingDeceleratingRate = useMainThreadRef(0.99)\n // The rebound coefficient during bounce back, the larger it is, the faster the rebound speed.\n const beta = useMainThreadRef(15)\n\n const debugLogEnabled = Boolean(options.debugLog)\n\n const singleSidedBounce = useMainThreadRef(\n options.bounceableOptions.singleSidedBounce ?? 'both',\n )\n\n // The starting point of current touch procedure\n const startTouch = useMainThreadRef<MainThread.TouchEvent['touches'] | null>(\n null,\n )\n // Record the previous touch and clear it on touchEnd. If current is not empty, then it means that the scrollable object is being dragged.\n const prevTouch = useMainThreadRef<MainThread.TouchEvent['touches'] | null>(\n null,\n )\n\n // Current scroll velocity.\n const scrollVelocity = useMainThreadRef(0)\n // Current bouncing position.\n const bouncingPositionInfo = useMainThreadRef({})\n\n // If reaches edge and bouncing starts during dragging, save the touch point and calculate later touch delta for rubberEffect.\n const startBouncingTouch = useMainThreadRef<\n MainThread.TouchEvent['touches'] | null\n >(null)\n // If reaches edge and bouncing starts during dragging, save current bouncingPosition and continues rubberEffect's calculation from this point.\n const startTouchBouncingDelta = useMainThreadRef({})\n // when touch starts during bouncing, save current bouncingPosition and continues rubberEffect's calculation from this point.\n const bouncingTouchStartPosition = useMainThreadRef({})\n\n // Used to record the previous scroll position and calculate current scroll velocity.\n const prevScroll = useMainThreadRef({})\n\n // scroll container's basic info.\n const height = useMainThreadRef(\n options.bounceableOptions.estimatedHeight\n ?? SystemInfo.pixelHeight / SystemInfo.pixelRatio,\n )\n const width = useMainThreadRef(\n options.bounceableOptions.estimatedWidth\n ?? SystemInfo.pixelWidth / SystemInfo.pixelRatio,\n )\n const scrollX = useMainThreadRef(0)\n const scrollY = useMainThreadRef(0)\n\n // Flags for ending bouncing animation.\n const touchEndFrameEnableFlag = useMainThreadRef(false)\n const touchingEndBouncingBackEnableFlag = useMainThreadRef(false)\n const flingEndWithBouncingEnableFlag = useMainThreadRef(false)\n\n // Flags for reaches upper/lower edge.\n // When content's size is smaller than viewport, these two flags are both true.\n const toUpper = useMainThreadRef(false)\n const toLower = useMainThreadRef(false)\n\n // Read from props\n const containerID = options.id ?? 'bounceableContainer'\n const { enableBounces, onScrollToBounces } = options.bounceableOptions\n const alwaysBouncing = options.bounceableOptions.alwaysBouncing ?? false\n const scrollOrientation = options.scrollOrientation ?? 'vertical'\n const enableRTL = useMainThreadRef(options.enableRTL ?? false)\n const enableBounceEventInFling =\n options.bounceableOptions.enableBounceEventInFling ?? true\n const startBounceTriggerDistance =\n options.bounceableOptions.startBounceTriggerDistance ?? 0\n const endBounceTriggerDistance =\n options.bounceableOptions.endBounceTriggerDistance ?? 0\n // Temporary workaround as requestAnimationFrame will crash below Lynx 2.15.2.\n const temporaryValidVersionCheckForRAF = useMainThreadRef(\n options.bounceableOptions.validAnimationVersion ?? false,\n )\n log(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] init, enableBounces: ${enableBounces}, orientation: ${scrollOrientation}, enableRTL: ${\n options.enableRTL ?? false\n }`,\n )\n\n const bouncingStatus = {\n inScrollingRange: 0,\n upperBouncing: 1,\n lowerBouncing: 2,\n noBouncing: 3,\n alwaysBouncing: 4,\n }\n\n function isVertical() {\n 'main thread'\n return scrollOrientation === 'vertical'\n }\n\n function threshold() {\n 'main thread'\n return 1.0 / Number(SystemInfo.pixelRatio)\n }\n\n function normalizedHorizontalValue(value: number) {\n 'main thread'\n return enableRTL.current ? -value : value\n }\n\n function isAndroid() {\n 'main thread'\n return SystemInfo.platform === 'Android'\n }\n\n function isEmpty(obj: Record<string, unknown>) {\n 'main thread'\n return !obj || Object.keys(obj).length === 0\n }\n\n function enableScroll(enable: boolean) {\n 'main thread'\n // Android will trigger scroll during bouncing, cancel it while bouncing.\n if (isAndroid()) {\n selectorMT(containerID)?.setAttribute('enable-scroll', enable)\n }\n }\n\n // Clear all temps when a touch procedure ends.\n function clearTouchInfo() {\n 'main thread'\n mtsLog(debugLogEnabled, '[lynx-ui-scroll-view][useBounce] clear touch info')\n startTouch.current = null\n bouncingTouchStartPosition.current = 0\n prevTouch.current = null\n startBouncingTouch.current = null\n startTouchBouncingDelta.current = 0\n }\n\n // Temporary workaround as requestAnimationFrame will crash below Lynx 2.15.2.\n function customRequestAnimationFrame(animationFunc: () => void) {\n 'main thread'\n if (temporaryValidVersionCheckForRAF.current) {\n requestAnimationFrame(animationFunc)\n } else {\n setTimeout(animationFunc, 8)\n }\n }\n\n // Calculate current touch delta based on 'startPoint'. The startPoint here should be startBouncingTouch which means this bouncing effect happens during a touch procedure.\n function getCurrentDelta(event: MainThread.TouchEvent) {\n 'main thread'\n if (startTouch.current !== null) {\n if (startBouncingTouch.current === null) {\n return scrollOrientation === 'vertical'\n ? event.touches[0].pageY - startTouch.current[0].pageY\n : normalizedHorizontalValue(\n event.touches[0].pageX - startTouch.current[0].pageX,\n )\n } else {\n return scrollOrientation === 'vertical'\n ? event.touches[0].pageY - startBouncingTouch.current[0].pageY\n : normalizedHorizontalValue(\n event.touches[0].pageX - startBouncingTouch.current[0].pageX,\n )\n }\n }\n return 0\n }\n\n // Key bouncing status judgement.\n function getBouncingStatus() {\n 'main thread'\n // @ts-expect-error Expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const currentPosition = bouncingPositionInfo.current?.bouncingOffset ?? 0\n if (Boolean(toUpper.current) && Boolean(toLower.current)) {\n return alwaysBouncing\n ? bouncingStatus.alwaysBouncing\n : bouncingStatus.noBouncing\n }\n\n // upper bouncing\n const initialLayoutPosition = 0\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] get bouncing status, initialLayoutPosition: ${initialLayoutPosition}, currentPosition: ${currentPosition}`,\n )\n\n if (currentPosition > initialLayoutPosition) {\n return bouncingStatus.upperBouncing\n }\n\n // bottom bouncing\n if (currentPosition < initialLayoutPosition) {\n return bouncingStatus.lowerBouncing\n }\n return bouncingStatus.inScrollingRange\n }\n\n // Whether fling and bouncing back step should be triggered.\n function shouldBounceWhenTouchEnd(status: number) {\n 'main thread'\n if (\n status === bouncingStatus.inScrollingRange\n || status === bouncingStatus.noBouncing\n ) {\n return false\n }\n\n if (\n status === bouncingStatus.upperBouncing\n || status === bouncingStatus.lowerBouncing\n ) {\n return true\n }\n\n if (status === bouncingStatus.alwaysBouncing) {\n return alwaysBouncing\n }\n return false\n }\n\n // Use translate to implement real bouncing effect\n function bouncingSetStyle(offset: number) {\n 'main thread'\n if (Number.isNaN(Number(offset))) {\n mtsLog(\n true,\n '[lynx-ui-scroll-view][useBounce] ERROR! bouncingOffset is NaN',\n )\n return\n }\n // update bouncingPositionInfo first\n if (isEmpty(bouncingPositionInfo.current)) {\n // @ts-expect-error expected\n bouncingPositionInfo.current.velocity = 0\n } else {\n // @ts-expect-error expected\n const timeDiff = Date.now() - bouncingPositionInfo.current.timeStamp\n // @ts-expect-error expected\n const offsetDiff = offset - bouncingPositionInfo.current.bouncingOffset\n || 0\n if (timeDiff > 0) {\n // @ts-expect-error expected\n bouncingPositionInfo.current.velocity = offsetDiff / timeDiff\n }\n // If timeDiff <= 0, we keep the previous velocity to maintain momentum continuity.\n }\n // @ts-expect-error expected\n bouncingPositionInfo.current.bouncingOffset = offset\n // @ts-expect-error expected\n bouncingPositionInfo.current.timeStamp = Date.now()\n // When bouncing effect ends, clear startTouch and bouncingTouchStartPosition\n if (offset === 0 && prevTouch.current !== null) {\n startTouch.current = prevTouch.current\n bouncingTouchStartPosition.current = {}\n }\n // trigger translate\n if (isVertical()) {\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] apply transform, orientation: vertical, rawOffset: ${offset}, containerTransform: translateY(${offset}px)`,\n )\n selectorMT(containerID)?.setStyleProperty(\n 'transform',\n `translateY(${offset}px)`,\n )\n selectorMT(`${containerID}-upperBounceWrapper`)?.setStyleProperty(\n 'transform',\n `translateY(${offset}px)`,\n )\n selectorMT(`${containerID}-lowerBounceWrapper`)?.setStyleProperty(\n 'transform',\n `translateY(${offset}px)`,\n )\n } else {\n const visualOffset = enableRTL.current ? -offset : offset\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] apply transform, orientation: horizontal, rawOffset: ${offset}, enableRTL: ${\n String(enableRTL.current)\n }, visualOffset: ${visualOffset}, containerTransform: translateX(${visualOffset}px)`,\n )\n selectorMT(containerID)?.setStyleProperty(\n 'transform',\n `translateX(${visualOffset}px)`,\n )\n selectorMT(`${containerID}-upperBounceWrapper`)?.setStyleProperty(\n 'transform',\n `translateX(${visualOffset}px)`,\n )\n selectorMT(`${containerID}-lowerBounceWrapper`)?.setStyleProperty(\n 'transform',\n `translateX(${visualOffset}px)`,\n )\n }\n }\n\n function onScrollToBouncesJS(info: ScrollToBouncesInfo) {\n if (enableBounces && onScrollToBounces) {\n onScrollToBounces(info)\n }\n }\n\n // send the scrollToBounces event\n function triggerScrollToBouncesEvent(isUpper: boolean) {\n 'main thread'\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] trigger scrollToBounces, direction: ${\n isUpper ? 'upper' : 'lower'\n }`,\n )\n\n const info: ScrollToBouncesInfo = {\n direction: isUpper ? 'upper' : 'lower',\n }\n runOnBackground(onScrollToBouncesJS)(info)\n }\n\n function rubberEffect(isNegative: 1 | -1, delta: number) {\n 'main thread'\n const scrollViewFrameSize = isVertical() ? height.current : width.current\n // If the touchStartPosition is not zero, it means this rubber effect happens during a touch or another bouncing effect. So the real 'start delta' should be recalculated.\n const touchStartPosition = Math.abs(\n Number(\n isEmpty(startTouchBouncingDelta.current)\n ? bouncingTouchStartPosition.current\n : startTouchBouncingDelta.current,\n ),\n )\n // This deltaYForTouchStartPosition is the inverse function of rubberEffect function\n const deltaYForTouchStartPosition =\n (scrollViewFrameSize * touchStartPosition)\n / ((scrollViewFrameSize - touchStartPosition) * rubberC.current) || 0\n // Here it calculate the next touchDelta. deltaYForNextPosition = (touch point where bouncing happens + corresponding touch delta where previous bouncing position locates)\n // This isNegative is used to handle the upper/lower bounce. RubberEffect function is different in the range (-inf,0) and [0, inf). We only use the [0, inf) part.\n const deltaYForNextPosition = bouncingTouchStartPosition.current\n ? deltaYForTouchStartPosition + isNegative * delta\n : isNegative * delta\n // Real calculation. Note that we don't use the raw touchDelta for calculating, instead, we use deltaYForNextPosition.\n const rubberBandingDistance = Math.max(\n 0,\n (1.0\n - 1.0\n / ((deltaYForNextPosition * rubberC.current) / scrollViewFrameSize\n + 1.0))\n * scrollViewFrameSize,\n )\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] rubber effect, scrollViewFrameSize: ${scrollViewFrameSize}, touchStartPosition: ${touchStartPosition}, deltaYForTouchStartPosition: ${deltaYForTouchStartPosition}, deltaYForNextPosition: ${deltaYForNextPosition}, rubberBandingDistance: ${rubberBandingDistance}`,\n )\n\n bouncingSetStyle(isNegative * rubberBandingDistance)\n }\n\n function triggerRubberEffectIfCrossingEdge(event: MainThread.TouchEvent) {\n 'main thread'\n const delta = getCurrentDelta(event)\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] check crossing edge, delta: ${delta}, toUpper: ${\n String(toUpper.current)\n }, toLower: ${String(toLower.current)}`,\n )\n\n // Crossing top range\n if (\n toUpper.current === true && delta > 0\n && (singleSidedBounce.current === 'both'\n || singleSidedBounce.current === 'upper')\n ) {\n enableScroll(false)\n rubberEffect(delta > 0 ? 1 : -1, delta)\n }\n\n // Crossing bottom range\n if (\n toLower.current === true && delta < 0\n && (singleSidedBounce.current === 'both'\n || singleSidedBounce.current === 'lower')\n ) {\n enableScroll(false)\n rubberEffect(delta > 0 ? 1 : -1, delta)\n }\n enableScroll(true)\n }\n\n // return true if scrollToBounces should be sent\n function isOverTriggerDistance() {\n 'main thread'\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const bouncingTop: number = bouncingPositionInfo.current.bouncingOffset ?? 0\n const triggerDistance =\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset > 0\n ? startBounceTriggerDistance\n : endBounceTriggerDistance\n const delta = Math.abs(bouncingTop) - Math.abs(triggerDistance)\n return delta > threshold()\n }\n\n function bouncingBack() {\n 'main thread'\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] fling forward end',\n )\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] bounce back starts',\n )\n\n // step3: bounce back\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const C1 = bouncingPositionInfo.current.bouncingOffset ?? 0\n const startTime = Date.now()\n const touchingEndBouncingBackFrame = () => {\n if (Boolean(touchingEndBouncingBackEnableFlag.current) === false) {\n return\n }\n const currentTime = Date.now() - startTime\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touching end bouncing back frame',\n )\n\n // critical damping\n const C2 = beta.current * C1\n const easedDistance = (C1 + C2 * (currentTime / 1000))\n * Math.pow(Math.E, -beta.current * (currentTime / 1000))\n bouncingSetStyle(easedDistance)\n if (Math.abs(easedDistance) < threshold()) {\n // Make sure it backs to 0\n bouncingSetStyle(0)\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] bounce back ends',\n )\n } else {\n customRequestAnimationFrame(touchingEndBouncingBackFrame)\n }\n }\n\n customRequestAnimationFrame(touchingEndBouncingBackFrame)\n touchingEndBouncingBackEnableFlag.current = true\n }\n\n // bindtouchstart. Save startTouch and bouncingPosition if a bouncing effect is happening.\n function bounceableTouchStart(event: MainThread.TouchEvent) {\n 'main thread'\n startTouch.current = event.touches\n mtsLog(debugLogEnabled, '[lynx-ui-scroll-view][useBounce] touch start')\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n bouncingTouchStartPosition.current =\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset ?? 0\n // reset all animation flags. No animation should play during a touch.\n touchEndFrameEnableFlag.current = false\n touchingEndBouncingBackEnableFlag.current = false\n flingEndWithBouncingEnableFlag.current = false\n }\n\n function bounceableTouchMove(event: MainThread.TouchEvent) {\n 'main thread'\n prevTouch.current = event.touches\n if (startTouch.current === null) {\n // It means current situation is illegal. A touchMove event happens without a touchStart event beforehand. Or a touchMove event happens after a touchEnd event.\n mtsLog(true, '[lynx-ui-scroll-view][useBounce] ERROR! touch not started')\n } else {\n const delta = getCurrentDelta(event)\n const currentBouncingStatus = getBouncingStatus()\n // Judge the status and trigger rubberEffect. The TouchMove should only consider rubberEffect and nothing else.\n switch (currentBouncingStatus) {\n case bouncingStatus.upperBouncing: {\n enableScroll(false)\n rubberEffect(1, delta)\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touch move upper bouncing',\n )\n break\n }\n case bouncingStatus.lowerBouncing: {\n enableScroll(false)\n rubberEffect(-1, delta)\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touch move lower bouncing',\n )\n break\n }\n case bouncingStatus.alwaysBouncing: {\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touch move always bouncing',\n )\n if (alwaysBouncing) {\n triggerRubberEffectIfCrossingEdge(event)\n }\n break\n }\n case bouncingStatus.inScrollingRange: {\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touch move in scrolling range',\n )\n triggerRubberEffectIfCrossingEdge(event)\n break\n }\n default:\n break\n }\n }\n }\n\n // bindtouchend. In touchEnd event the fling forward animation and bouncingBack animation should be triggered if necessary.\n function bounceableTouchEnd() {\n 'main thread'\n // Reset the state. The touch information should be reset, and we should no longer ban the enable-scroll.\n clearTouchInfo()\n enableScroll(true)\n mtsLog(debugLogEnabled, '[lynx-ui-scroll-view][useBounce] touch end')\n if (shouldBounceWhenTouchEnd(getBouncingStatus())) {\n const startTime = Date.now()\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const dragEndVelocity = bouncingPositionInfo.current?.velocity\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const dragEndPosition = bouncingPositionInfo.current?.bouncingOffset ?? 0\n // Send scrolltobounces event.\n if (isOverTriggerDistance()) {\n triggerScrollToBouncesEvent(\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset > 0,\n )\n }\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n let currentVelocity: number = dragEndVelocity\n const touchEndProcessFrame = () => {\n if (Boolean(touchEndFrameEnableFlag.current) === false) {\n return\n }\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] touch end process frame',\n )\n if (Math.abs(currentVelocity) <= threshold()) {\n // If the velocity is already under threshold, skip fling and start step3: bounce back.\n bouncingBack()\n } else {\n // If the drag end with a velocity, start fling to consume it.\n // step 2: fling down\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] fling down start',\n )\n // This function is obtained by integrating the velocity function with a deceleration rate of flingDeceleratingRate.\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const distance: number = dragEndPosition\n + (dragEndVelocity\n * (Math.pow(\n flingDeceleratingRate.current,\n Date.now() - startTime,\n )\n - 1))\n / Math.log(flingDeceleratingRate.current)\n bouncingSetStyle(distance)\n currentVelocity = dragEndVelocity\n * Math.pow(flingDeceleratingRate.current, Date.now() - startTime)\n if (touchEndFrameEnableFlag.current) {\n customRequestAnimationFrame(touchEndProcessFrame)\n }\n }\n }\n customRequestAnimationFrame(touchEndProcessFrame)\n touchEndFrameEnableFlag.current = true\n }\n }\n\n // Save the bindscroll info and calculate velocity.\n function bounceableHandleScroll(event: ScrollEvent) {\n 'main thread'\n scrollX.current = event.detail.scrollLeft\n scrollY.current = event.detail.scrollTop\n if (!isEmpty(prevScroll.current)) {\n const prev = prevScroll.current as {\n timestamp: number\n detail: { scrollTop: number, scrollLeft: number }\n }\n const timeDuration = Date.now() - prev.timestamp\n if (timeDuration > 0) {\n const deltaY = isVertical()\n ? event.detail.scrollTop - prev.detail.scrollTop\n : normalizedHorizontalValue(\n event.detail.scrollLeft - prev.detail.scrollLeft,\n )\n const velocity = deltaY / timeDuration\n if (Number.isFinite(velocity)) {\n scrollVelocity.current = velocity\n }\n }\n }\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] handle scroll near edge, scrollLeft: ${event.detail.scrollLeft}, scrollTop: ${event.detail.scrollTop}, velocity: ${scrollVelocity.current}`,\n )\n prevScroll.current = event\n }\n\n function onUpperDisexposure(_event: CommonEvent) {\n 'main thread'\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] upper disexposure',\n )\n toUpper.current = false\n }\n\n // Handle scrolltoupper event.\n function onUpperExposure(_event: CommonEvent) {\n 'main thread'\n mtsLog(debugLogEnabled, '[lynx-ui-scroll-view][useBounce] upper exposure')\n toUpper.current = true\n if (\n singleSidedBounce.current !== 'upper'\n && singleSidedBounce.current !== 'both'\n ) {\n return\n }\n if (prevScroll.current) {\n // reaches edge during touch\n startBouncingTouch.current = prevTouch.current\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n startTouchBouncingDelta.current =\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset ?? 0\n } else if (Math.abs(scrollVelocity.current) > threshold()) {\n // reaches edge during fling\n const velocity = scrollVelocity.current\n let currentVelocity = velocity\n const startTime = Date.now()\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] fling to upper event start, velocity: ${velocity}`,\n )\n let sentScrollToBouncesEvent = false // only sent scrollToBounces once\n const flingEndWithBouncingFrame = () => {\n if (Boolean(flingEndWithBouncingEnableFlag.current) === false) {\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] flingEndWithBouncingEnableFlag early return',\n )\n return\n }\n if (Math.abs(currentVelocity) <= threshold()) {\n flingEndWithBouncingEnableFlag.current = false\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] fling to upper event end',\n )\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] bouncing to upper event start',\n )\n bouncingBack()\n } else {\n // step 1: fling\n const distance = (currentVelocity\n * (Math.pow(flingDeceleratingRate.current, Date.now() - startTime)\n - 1))\n / Math.log(flingDeceleratingRate.current)\n bouncingSetStyle(-distance)\n if (!sentScrollToBouncesEvent && isOverTriggerDistance()) {\n triggerScrollToBouncesEvent(\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset > 0,\n )\n sentScrollToBouncesEvent = true\n }\n currentVelocity = velocity\n * Math.pow(flingDeceleratingRate.current, Date.now() - startTime)\n if (flingEndWithBouncingEnableFlag.current) {\n customRequestAnimationFrame(flingEndWithBouncingFrame)\n }\n }\n }\n customRequestAnimationFrame(flingEndWithBouncingFrame)\n flingEndWithBouncingEnableFlag.current = true\n }\n }\n\n function onLowerDisexposure(_event: CommonEvent) {\n 'main thread'\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] lower disexposure',\n )\n toLower.current = false\n }\n\n function onLowerExposure(_event: CommonEvent) {\n 'main thread'\n mtsLog(debugLogEnabled, '[lynx-ui-scroll-view][useBounce] lower exposure')\n toLower.current = true\n if (\n singleSidedBounce.current !== 'lower'\n && singleSidedBounce.current !== 'both'\n ) {\n return\n }\n // reaches lower during dragging\n if (prevTouch.current !== null) {\n startBouncingTouch.current = prevTouch.current\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n startTouchBouncingDelta.current =\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset ?? 0\n } else if (enableBounceEventInFling && scrollVelocity.current > 0) {\n const velocity = scrollVelocity.current\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] lower velocity: ${velocity}`,\n )\n\n // scroll to end with velocity, start bouncing effect\n if (Math.abs(velocity) > threshold()) {\n let currentVelocity = velocity\n const startTime = Date.now()\n mtsLog(\n debugLogEnabled,\n `[lynx-ui-scroll-view][useBounce] fling to lower event start, velocity: ${velocity}`,\n )\n let sentScrollToBouncesEvent = false // only sent scrollToBounces once\n const flingEndWithBouncingFrame = () => {\n if (Boolean(flingEndWithBouncingEnableFlag.current) === false) {\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] flingEndWithBouncingEnableFlag early return',\n )\n return\n }\n if (Math.abs(currentVelocity) <= threshold()) {\n flingEndWithBouncingEnableFlag.current = false\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] fling to lower event end',\n )\n mtsLog(\n debugLogEnabled,\n '[lynx-ui-scroll-view][useBounce] bouncing to lower event start',\n )\n bouncingBack()\n } else {\n // step 1: fling\n const distance = (currentVelocity\n * (Math.pow(\n flingDeceleratingRate.current,\n Date.now() - startTime,\n )\n - 1))\n / Math.log(flingDeceleratingRate.current)\n bouncingSetStyle(-distance)\n if (!sentScrollToBouncesEvent && isOverTriggerDistance()) {\n triggerScrollToBouncesEvent(\n // @ts-expect-error expected\n bouncingPositionInfo.current?.bouncingOffset > 0,\n )\n sentScrollToBouncesEvent = true\n }\n currentVelocity = velocity\n * Math.pow(flingDeceleratingRate.current, Date.now() - startTime)\n if (flingEndWithBouncingEnableFlag) {\n customRequestAnimationFrame(flingEndWithBouncingFrame)\n }\n }\n }\n customRequestAnimationFrame(flingEndWithBouncingFrame)\n flingEndWithBouncingEnableFlag.current = true\n }\n }\n }\n\n // Used to get the size of scroll container.\n function bounceableLayoutChange(event: CommonEvent) {\n 'main thread'\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n height.current = (isAndroid() ? event.params?.height : event.detail?.height)\n ?? 0\n // @ts-expect-error expected\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n width.current = (isAndroid() ? event.params?.width : event.detail?.width)\n ?? 0\n }\n\n return {\n 'main-thread:bindtouchstart': bounceableTouchStart,\n 'main-thread:bindtouchend': bounceableTouchEnd,\n 'main-thread:bindtouchmove': bounceableTouchMove,\n 'main-thread:bindlayoutchange': bounceableLayoutChange,\n 'main-thread:bindscroll': bounceableHandleScroll,\n onUpperExposure,\n onUpperDisexposure,\n onLowerExposure,\n onLowerDisexposure,\n }\n}\n"],"names":["useBounce","options","rubberC","useMainThreadRef","flingDeceleratingRate","beta","debugLogEnabled","Boolean","singleSidedBounce","startTouch","prevTouch","scrollVelocity","bouncingPositionInfo","startBouncingTouch","startTouchBouncingDelta","bouncingTouchStartPosition","prevScroll","height","SystemInfo","width","scrollX","scrollY","touchEndFrameEnableFlag","touchingEndBouncingBackEnableFlag","flingEndWithBouncingEnableFlag","toUpper","toLower","containerID","enableBounces","onScrollToBounces","alwaysBouncing","scrollOrientation","enableRTL","enableBounceEventInFling","startBounceTriggerDistance","endBounceTriggerDistance","temporaryValidVersionCheckForRAF","log","bouncingStatus","isVertical","threshold","Number","normalizedHorizontalValue","value","isAndroid","isEmpty","obj","Object","enableScroll","enable","selectorMT","clearTouchInfo","mtsLog","customRequestAnimationFrame","animationFunc","requestAnimationFrame","setTimeout","getCurrentDelta","event","getBouncingStatus","currentPosition","initialLayoutPosition","shouldBounceWhenTouchEnd","status","bouncingSetStyle","offset","timeDiff","Date","offsetDiff","visualOffset","String","onScrollToBouncesJS","info","triggerScrollToBouncesEvent","isUpper","runOnBackground","rubberEffect","isNegative","delta","scrollViewFrameSize","touchStartPosition","Math","deltaYForTouchStartPosition","deltaYForNextPosition","rubberBandingDistance","triggerRubberEffectIfCrossingEdge","isOverTriggerDistance","bouncingTop","triggerDistance","bouncingBack","C1","startTime","touchingEndBouncingBackFrame","currentTime","C2","easedDistance","bounceableTouchStart","bounceableTouchMove","currentBouncingStatus","bounceableTouchEnd","dragEndVelocity","dragEndPosition","currentVelocity","touchEndProcessFrame","distance","bounceableHandleScroll","prev","timeDuration","deltaY","velocity","onUpperDisexposure","_event","onUpperExposure","sentScrollToBouncesEvent","flingEndWithBouncingFrame","onLowerDisexposure","onLowerExposure","bounceableLayoutChange"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lynx-js/lynx-ui-scroll-view",
|
|
3
|
-
"version": "3.
|
|
3
|
+
"version": "3.143.0",
|
|
4
4
|
"repository": {
|
|
5
5
|
"type": "git",
|
|
6
6
|
"url": "git+https://github.com/lynx-family/lynx-ui.git",
|
|
@@ -16,18 +16,19 @@
|
|
|
16
16
|
"module": "./dist/index.jsx",
|
|
17
17
|
"types": "./dist/index.d.ts",
|
|
18
18
|
"files": [
|
|
19
|
-
"src
|
|
19
|
+
"src",
|
|
20
|
+
"!src/**/__tests__/**",
|
|
21
|
+
"!src/**/*.test.*",
|
|
20
22
|
"README.md",
|
|
23
|
+
"SKILL.md",
|
|
21
24
|
"CHANGELOG.md",
|
|
22
25
|
"LICENSE",
|
|
23
|
-
"tsconfig.docs.json",
|
|
24
|
-
"tsconfig.json",
|
|
25
26
|
"dist/**"
|
|
26
27
|
],
|
|
27
28
|
"dependencies": {
|
|
28
29
|
"@lynx-js/gesture-runtime": "2.1.1",
|
|
29
|
-
"@lynx-js/lynx-ui-common": "3.
|
|
30
|
-
"@lynx-js/lynx-ui-lazy-component": "3.
|
|
30
|
+
"@lynx-js/lynx-ui-common": "3.143.0",
|
|
31
|
+
"@lynx-js/lynx-ui-lazy-component": "3.143.0"
|
|
31
32
|
},
|
|
32
33
|
"devDependencies": {
|
|
33
34
|
"@lynx-js/react": "0.123.1",
|
|
@@ -39,7 +40,7 @@
|
|
|
39
40
|
"peerDependencies": {
|
|
40
41
|
"@lynx-js/react": ">=0.100.0",
|
|
41
42
|
"@lynx-js/types": "*",
|
|
42
|
-
"@types/react": "
|
|
43
|
+
"@types/react": ">=18"
|
|
43
44
|
},
|
|
44
45
|
"publishConfig": {
|
|
45
46
|
"access": "public"
|
package/src/hooks/useBounce.tsx
CHANGED
|
@@ -28,7 +28,7 @@ export interface BounceableBasicProps {
|
|
|
28
28
|
onScrollToBounces?: (e: ScrollToBouncesInfo) => void
|
|
29
29
|
}
|
|
30
30
|
|
|
31
|
-
export interface
|
|
31
|
+
export interface UseBounceOptions {
|
|
32
32
|
bounceableOptions: BounceableBasicProps
|
|
33
33
|
debugLog?: boolean
|
|
34
34
|
enableRTL?: boolean
|
|
@@ -55,9 +55,10 @@ export interface BounceHandlers {
|
|
|
55
55
|
}
|
|
56
56
|
|
|
57
57
|
/** @deprecated Use `BounceHandlers` instead. */
|
|
58
|
+
// eslint-disable-next-line @typescript-eslint/naming-convention -- Preserve the deprecated public alias for compatibility.
|
|
58
59
|
export type bounceHandlers = BounceHandlers
|
|
59
60
|
|
|
60
|
-
export function useBounce(options:
|
|
61
|
+
export function useBounce(options: UseBounceOptions): BounceHandlers {
|
|
61
62
|
// Control the damping coefficient during rubber effect. The smaller it is, the harder the spring effect.
|
|
62
63
|
const rubberC = useMainThreadRef(0.55)
|
|
63
64
|
// Control the fling deceleration coefficient during dropdown. The smaller it is, the faster it stops.
|
package/tsconfig.docs.json
DELETED