diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/NestedScroll.gif b/zh-cn/application-dev/reference/arkui-ts/figures/NestedScroll.gif
new file mode 100644
index 0000000000000000000000000000000000000000..4d8b706114c0bca1218f13085c7890d46c96ab28
Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/NestedScroll.gif differ
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md
index c22e5d29375618f101b422f54b18bd7e8206f665..e42eeb0ae4deebc2b34425ef3540f436fe660b77 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md
@@ -63,6 +63,7 @@ List(value:{space?: number, initialIndex?: number})
| 名称 | 功能描述 |
| -------- | -------- |
| onItemDelete(index: number) => boolean | 列表项删除时触发。 |
+| onScrollBegin9+(dx: number, dy: number) => { dxRemain: number, dyRemain: number } | 滚动开始事件回调。
参数：
- dx：即将发生的水平方向滚动量。
- dy：即将发生的竖向方向滚动量。
返回值：
- dxRemain：水平方向滚动剩余量。
- dyRemain：竖直方向滚动剩余量。 |
| onScrollIndex(firstIndex: number, lastIndex: number) => void | 当前列表显示的起始位置和终止位置发生变化时触发。 |
> **说明：**
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
index 35557ef46076d2c2ea6c1d1cd4d146e3934e17a2..7adf41f484b9c26ce78810d87ecd8bf6a6e401a1 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
@@ -42,10 +42,14 @@ Scroll(scroller?: Scroller)
| 名称 | 功能描述 |
| ---------------------------------------- | ----------------------------- |
+| onScrollBegin9+(dx: number, dy: number) => { dxRemain: number, dyRemain: number } | 滚动开始事件回调。
参数：
- dx：即将发生的水平方向滚动量。
- dy：即将发生的竖向方向滚动量。
返回值：
- dxRemain：水平方向滚动剩余量。
- dyRemain：竖直方向滚动剩余量。 |
| onScroll(xOffset: number, yOffset: number) => void | 滚动事件回调, 返回滚动时水平、竖直方向偏移量。 |
| onScrollEdge(side: Edge) => void | 滚动到边缘事件回调。 |
| onScrollEnd() => void | 滚动停止事件回调。 |
+> **说明：**
+> 若通过onScrollBegin事件和scrollBy方法实现容器嵌套滚动，需设置子滚动节点的EdgeEffect为None。如Scroll嵌套List滚动时，List组件的edgeEffect属性需设置为EdgeEffect.None。
+
## Scroller
可滚动容器组件的控制器，可以将此组件绑定至容器组件，然后通过它控制容器组件的滚动，目前支持绑定到List和Scroll组件上。
@@ -103,7 +107,7 @@ scrollPage(value: { next: boolean, direction?: Axis }): void
### currentOffset
-scroller.currentOffset(): Object
+currentOffset(): Object
返回当前的滚动偏移量。
@@ -117,7 +121,7 @@ scroller.currentOffset(): Object
### scrollToIndex
-scroller.scrollToIndex(value: number): void
+scrollToIndex(value: number): void
滑动到指定Index。
@@ -133,6 +137,25 @@ scroller.scrollToIndex(value: number): void
| value | number | 是 | - | 要滑动到的列表项在列表中的索引值。 |
+### scrollBy
+
+scrollBy(dx: Length, dy: Length): void
+
+
+滑动指定距离。
+
+
+> **说明：**
+> 仅支持Scroll组件。
+
+
+- 参数
+ | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+ | ----- | ------ | ---- | ---- | ----------------- |
+ | dx | Length | 是 | - | 水平方向滚动距离。 |
+ | dy | Length | 是 | - | 竖直方向滚动距离。 |
+
+
## 示例
```ts
@@ -188,3 +211,58 @@ struct ScrollExample {
```
+
+
+```ts
+@Entry
+@Component
+struct NestedScroll {
+ @State listPosition: number = 0 // 0代表滚动到List顶部，1代表中间值，2代表滚动到List底部。
+ private arr: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+ private scroller: Scroller = new Scroller()
+
+ build() {
+ Flex() {
+ Scroll(this.scroller) {
+ Column() {
+ Text("Scroll Area")
+ .width("100%").height("40%").backgroundColor(0X330000FF)
+ .fontSize(16).textAlign(TextAlign.Center)
+
+ List({ space: 20 }) {
+ ForEach(this.arr, (item) => {
+ ListItem() {
+ Text("ListItem" + item)
+ .width("100%").height("100%").borderRadius(15)
+ .fontSize(16).textAlign(TextAlign.Center).backgroundColor(Color.White)
+ }.width("100%").height(100)
+ }, item => item)
+ }
+ .width("100%").height("50%").edgeEffect(EdgeEffect.None)
+ .onReachStart(() => {
+ this.listPosition = 0
+ })
+ .onReachEnd(() => {
+ this.listPosition = 2
+ })
+ .onScrollBegin((dx: number, dy: number) => {
+ if ((this.listPosition == 0 && dy >= 0) || (this.listPosition == 2 && dy <= 0)) {
+ this.scroller.scrollBy(0, -dy)
+ return { dxRemain: dx, dyRemain: 0 }
+ }
+ this.listPosition = 1;
+ return { dxRemain: dx, dyRemain: dy }
+ })
+
+ Text("Scroll Area")
+ .width("100%").height("40%").backgroundColor(0X330000FF)
+ .fontSize(16).textAlign(TextAlign.Center)
+ }
+ }
+ .width("100%").height("100%")
+ }.width('100%').height('100%').backgroundColor(0xDCDCDC).padding(20)
+ }
+}
+```
+
+
\ No newline at end of file