Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
69ea9b41
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
69ea9b41
编写于
4月 19, 2023
作者:
O
openharmony_ci
提交者:
Gitee
4月 19, 2023
浏览文件
操作
浏览文件
下载
差异文件
!17146 修复Scroll文档事件说明错误
Merge pull request !17146 from 张荣杰/0411
上级
8bf3d3e6
ac184649
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
3 addition
and
3 deletion
+3
-3
zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
...application-dev/reference/arkui-ts/ts-container-scroll.md
+3
-3
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
浏览文件 @
69ea9b41
...
@@ -33,7 +33,7 @@ Scroll(scroller?: Scroller)
...
@@ -33,7 +33,7 @@ Scroll(scroller?: Scroller)
| scrollable |
[
ScrollDirection
](
#scrolldirection枚举说明
)
| 设置滚动方向。
<br/>
默认值:ScrollDirection.Vertical |
| scrollable |
[
ScrollDirection
](
#scrolldirection枚举说明
)
| 设置滚动方向。
<br/>
默认值:ScrollDirection.Vertical |
| scrollBar |
[
BarState
](
ts-appendix-enums.md#barstate
)
| 设置滚动条状态。
<br/>
默认值:BarState.Auto
<br/>
**说明:**
<br/>
如果容器组件无法滚动,则滚动条不显示。 |
| scrollBar |
[
BarState
](
ts-appendix-enums.md#barstate
)
| 设置滚动条状态。
<br/>
默认值:BarState.Auto
<br/>
**说明:**
<br/>
如果容器组件无法滚动,则滚动条不显示。 |
| scrollBarColor | string
\|
number
\|
[
Color
](
ts-appendix-enums.md#color
)
| 设置滚动条的颜色。 |
| scrollBarColor | string
\|
number
\|
[
Color
](
ts-appendix-enums.md#color
)
| 设置滚动条的颜色。 |
| scrollBarWidth | string
\|
number | 设置滚动条的宽度。
<br/>
默认值:4
<br/>
单位:vp |
| scrollBarWidth | string
\|
number | 设置滚动条的宽度
,不支持百分比设置
。
<br/>
默认值:4
<br/>
单位:vp |
| edgeEffect |
[
EdgeEffect
](
ts-appendix-enums.md#edgeeffect
)
| 设置滑动效果,目前支持的滑动效果参见EdgeEffect的枚举说明。
<br/>
默认值:EdgeEffect.None |
| edgeEffect |
[
EdgeEffect
](
ts-appendix-enums.md#edgeeffect
)
| 设置滑动效果,目前支持的滑动效果参见EdgeEffect的枚举说明。
<br/>
默认值:EdgeEffect.None |
## ScrollDirection枚举说明
## ScrollDirection枚举说明
...
@@ -50,9 +50,9 @@ Scroll(scroller?: Scroller)
...
@@ -50,9 +50,9 @@ Scroll(scroller?: Scroller)
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| onScrollFrameBegin
<sup>
9+
</sup>
(event: (offset: number, state: ScrollState) => { offsetRemain }) | 每帧开始滚动时触发,事件参数传入即将发生的滚动量,事件处理函数中可根据应用场景计算实际需要的滚动量并作为事件处理函数的返回值返回,Scroll将按照返回值的实际滚动量进行滚动。
<br/>
\-
offset:即将发生的滚动量。
<br/>
\-
state:当前滚动状态。
<br/>
- offsetRemain:实际滚动量。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件触发滚动时触发,包括键鼠操作等其他触发滚动的输入设置。
<br/>
2、调用控制器接口时不触发。
<br/>
3、越界回弹不触发。
<br/>
**说明:**
<br/>
支持offsetRemain为负值。
<br/>
若通过onScrollFrameBegine事件和scrollBy方法实现容器嵌套滚动,需设置子滚动节点的EdgeEffect为None。如Scroll嵌套List滚动时,List组件的edgeEffect属性需设置为EdgeEffect.None。 |
| onScrollFrameBegin
<sup>
9+
</sup>
(event: (offset: number, state: ScrollState) => { offsetRemain }) | 每帧开始滚动时触发,事件参数传入即将发生的滚动量,事件处理函数中可根据应用场景计算实际需要的滚动量并作为事件处理函数的返回值返回,Scroll将按照返回值的实际滚动量进行滚动。
<br/>
\-
offset:即将发生的滚动量。
<br/>
\-
state:当前滚动状态。
<br/>
- offsetRemain:实际滚动量。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件触发滚动时触发,包括键鼠操作等其他触发滚动的输入设置。
<br/>
2、调用控制器接口时不触发。
<br/>
3、越界回弹不触发。
<br/>
**说明:**
<br/>
支持offsetRemain为负值。
<br/>
若通过onScrollFrameBegine事件和scrollBy方法实现容器嵌套滚动,需设置子滚动节点的EdgeEffect为None。如Scroll嵌套List滚动时,List组件的edgeEffect属性需设置为EdgeEffect.None。 |
| onScroll(event: (xOffset: number, yOffset: number) => void) | 滚动事件回调,
返回滚动时水平、竖直方向偏移量。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件触发滚动时触发,支持键鼠操作等其他触发滚动的输入设置。
<br/>
2、通过滚动控制器API接口调用。
<br/>
3、越界回弹。 |
| onScroll(event: (xOffset: number, yOffset: number) => void) | 滚动事件回调,
返回滚动时水平、竖直方向偏移量。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件触发滚动时触发,支持键鼠操作等其他触发滚动的输入设置。
<br/>
2、通过滚动控制器API接口调用。
<br/>
3、越界回弹。 |
| onScrollEdge(event: (side: Edge) => void) | 滚动到边缘事件回调。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件
触发滚动
时触发,支持键鼠操作等其他触发滚动的输入设置。
<br/>
2、通过滚动控制器API接口调用。
<br/>
3、越界回弹。 |
| onScrollEdge(event: (side: Edge) => void) | 滚动到边缘事件回调。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件
滚动到边缘
时触发,支持键鼠操作等其他触发滚动的输入设置。
<br/>
2、通过滚动控制器API接口调用。
<br/>
3、越界回弹。 |
| onScrollEnd
<sup>
(deprecated)
</sup>
(event: () => void) | 滚动停止事件回调。
<br>
该事件从API version 9开始废弃,使用onScrollStop事件替代。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件触发滚动后停止,支持键鼠操作等其他触发滚动的输入设置。
<br/>
2、通过滚动控制器API接口调用后停止,带过渡动效。 |
| onScrollEnd
<sup>
(deprecated)
</sup>
(event: () => void) | 滚动停止事件回调。
<br>
该事件从API version 9开始废弃,使用onScrollStop事件替代。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件触发滚动后停止,支持键鼠操作等其他触发滚动的输入设置。
<br/>
2、通过滚动控制器API接口调用后停止,带过渡动效。 |
| onScrollStart
<sup>
9+
</sup>
(event: () => void) | 滚动开始时触发。手指拖动Scroll或拖动Scroll的滚动条触发的滚动开始时,会触发该事件。使用
[
Scroller
](
#scroller
)
滚动控制器触发的带动画的滚动,动画开始时会触发该事件。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件
触发滚动后停止
,支持键鼠操作等其他触发滚动的输入设置。
<br/>
2、通过滚动控制器API接口调用后开始,带过渡动效。 |
| onScrollStart
<sup>
9+
</sup>
(event: () => void) | 滚动开始时触发。手指拖动Scroll或拖动Scroll的滚动条触发的滚动开始时,会触发该事件。使用
[
Scroller
](
#scroller
)
滚动控制器触发的带动画的滚动,动画开始时会触发该事件。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件
开始滚动时触发
,支持键鼠操作等其他触发滚动的输入设置。
<br/>
2、通过滚动控制器API接口调用后开始,带过渡动效。 |
| onScrollStop
<sup>
9+
</sup>
(event: () => void) | 滚动停止时触发。手拖动Scroll或拖动Scroll的滚动条触发的滚动,手离开屏幕并且滚动停止时会触发该事件。使用
[
Scroller
](
#scroller
)
滚动控制器触发的带动画的滚动,动画停止时会触发该事件。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件触发滚动后停止,支持键鼠操作等其他触发滚动的输入设置。
<br/>
2、通过滚动控制器API接口调用后开始,带过渡动效,。 |
| onScrollStop
<sup>
9+
</sup>
(event: () => void) | 滚动停止时触发。手拖动Scroll或拖动Scroll的滚动条触发的滚动,手离开屏幕并且滚动停止时会触发该事件。使用
[
Scroller
](
#scroller
)
滚动控制器触发的带动画的滚动,动画停止时会触发该事件。
<br/>
触发该事件的条件 :
<br/>
1、滚动组件触发滚动后停止,支持键鼠操作等其他触发滚动的输入设置。
<br/>
2、通过滚动控制器API接口调用后开始,带过渡动效,。 |
> **说明:**
> **说明:**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录