Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
df527752
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看板
未验证
提交
df527752
编写于
8月 28, 2023
作者:
王
王关
提交者:
Gitee
8月 28, 2023
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
将scrollState链接到list的scrollState
Signed-off-by:
N
王关
<
wangguan27@huawei.com
>
上级
8db1bb1f
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
2 addition
and
12 deletion
+2
-12
zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md
...n/application-dev/reference/arkui-ts/ts-container-grid.md
+2
-12
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md
浏览文件 @
df527752
...
...
@@ -118,12 +118,12 @@ Grid组件根据rowsTemplate、columnsTemplate属性的设置情况,可分为
| onItemDragLeave(event: (event: ItemDragInfo, itemIndex: number) => void) | 拖拽离开网格元素时触发。
<br/>
- event: 见
[
ItemDragInfo对象说明
](
#itemdraginfo对象说明
)
。
<br/>
- itemIndex: 拖拽离开的网格元素索引值。 |
| onItemDrop(event: (event: ItemDragInfo, itemIndex: number, insertIndex: number, isSuccess: boolean) => void) | 绑定该事件的网格元素可作为拖拽释放目标,当在网格元素内停止拖拽时触发。
<br/>
- event: 见
[
ItemDragInfo对象说明
](
#itemdraginfo对象说明
)
。
<br/>
- itemIndex: 拖拽起始位置。
<br/>
- insertIndex: 拖拽插入位置。
<br/>
- isSuccess: 是否成功释放。 |
| onScrollBarUpdate(event: (index: number, offset: number) => ComputedBarAttribute) | 当前网格显示的起始位置item发生变化时触发,可通过该回调设置滚动条的位置及长度。
<br/>
- index: 当前显示的网格起始位置的索引值。
<br/>
- offset: 当前显示的网格起始位置元素相对网格显示起始位置的偏移。
<br/>
- ComputedBarAttribute: 见
[
ComputedBarAttribute对象说明
](
#computedbarattribute对象说明
)
。 |
| onScroll
<sup>
10+
</sup>
(event: (scrollOffset: number, scrollState: ScrollState) => void) | 网格滑动时触发。
<br/>
- scrollOffset: 每帧滚动的偏移量,Grid的内容向上滚动时偏移量为正,向下滚动时偏移量为负。
<br/>
-
[
scrollState
](
#scrollstate枚举说明
)
: 当前滑动状态。 |
| onScroll
<sup>
10+
</sup>
(event: (scrollOffset: number, scrollState: ScrollState) => void) | 网格滑动时触发。
<br/>
- scrollOffset: 每帧滚动的偏移量,Grid的内容向上滚动时偏移量为正,向下滚动时偏移量为负。
<br/>
-
[
scrollState
](
ts-container-list.md
#scrollstate枚举说明
)
: 当前滑动状态。 |
| onReachStart
<sup>
10+
</sup>
(event: () => void) | 网格到达起始位置时触发。
<br/>
**说明:**
<br>
Grid初始化时如果initialIndex为0会触发一次,Grid滚动到起始位置时触发一次。Grid边缘效果为弹簧效果时,划动经过起始位置时触发一次,回弹回起始位置时再触发一次。 |
| onReachEnd
<sup>
10+
</sup>
(event: () => void) | 网格到底末尾位置时触发。
<br/>
**说明:**
<br/>
Grid边缘效果为弹簧效果时,划动经过末尾位置时触发一次,回弹回末尾位置时再触发一次。 |
| onScrollFrameBegin
<sup>
10+
</sup>
(event: (offset: number, state: ScrollState) => { offsetRemain }) | 网格开始滑动时触发,事件参数传入即将发生的滑动量,事件处理函数中可根据应用场景计算实际需要的滑动量并作为事件处理函数的返回值返回,网格将按照返回值的实际滑动量进行滑动。
<br/>
\-
offset:即将发生的滑动量,单位vp。
<br/>
\-
state:当前滑动状态。
<br/>
- offsetRemain:实际滑动量,单位vp。
<br/>
触发该事件的条件:手指拖动Grid、Grid惯性划动时每帧开始时触发;Grid超出边缘回弹、使用滚动控制器的滚动不会触发。
<br/>
**说明:**
<br/>
当gridDirection的值为Axis.Vertical时,返回垂直方向滑动量,当gridDirection的值为Axis.Horizontal时,返回水平方向滑动量。 |
| onScrollStart
<sup>
10+
</sup>
(event: () => void) | 网格滑动开始时触发。手指拖动网格或网格的滚动条触发的滑动开始时,会触发该事件。使用
[
Scroller
](
ts-container-scroll.md#scroller
)
滑动控制器触发的带动画的滑动,动画开始时会触发该事件。 |
| onScrollStop
<sup>
10+
</sup>
(event: () => void) | 网格滑动停止时触发。手
拖动网格或网格的滚动条触发的滑动,手
离开屏幕并且滑动停止时会触发该事件;使用
[
Scroller
](
ts-container-scroll.md#scroller
)
滑动控制器触发的带动画的滑动,动画停止会触发该事件。 |
| onScrollStop
<sup>
10+
</sup>
(event: () => void) | 网格滑动停止时触发。手
指拖动网格或网格的滚动条触发的滑动,手指
离开屏幕并且滑动停止时会触发该事件;使用
[
Scroller
](
ts-container-scroll.md#scroller
)
滑动控制器触发的带动画的滑动,动画停止会触发该事件。 |
## ItemDragInfo对象说明
...
...
@@ -139,16 +139,6 @@ Grid组件根据rowsTemplate、columnsTemplate属性的设置情况,可分为
| totalOffset | number | Grid内容相对显示区域的总偏移。 |
| totalLength | number | Grid内容总长度。 |
## ScrollState枚举说明
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------ | ---------------------------------------- |
| Idle | 空闲状态。使用控制器提供的方法控制滚动时触发,拖动滚动条滚动时触发。
<br/>
**说明:**
<br/>
从API version 10开始,调整为滚动状态回归空闲时触发,控制器提供的无动画方法控制滚动时触发。 |
| Scroll | 滚动状态。使用手指拖动List滚动时触发。
<br/>
**说明:**
<br/>
从API version 10开始,拖动滚动条滚动和滚动鼠标滚轮时也会触发。 |
| Fling | 惯性滚动状态。快速划动松手后进行惯性滚动和划动到边缘回弹时触发。
<br/>
**说明:**
<br/>
从API version 10开始,由动画控制的滚动都触发。包括快速划动松手后的惯性滚动,划动到边缘回弹的滚动,快速拖动内置滚动条松手后的惯性滚动,使用滚动控制器提供的带动画的方法控制的滚动。 |
## 示例
### 示例1
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录