Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
1a8f4de6
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看板
提交
1a8f4de6
编写于
7月 04, 2023
作者:
S
sunjiakun
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
list scroll snap doc
Signed-off-by:
N
sunjiakun
<
sunjiakun3@huawei.com
>
上级
4da3046e
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
11 addition
and
0 deletion
+11
-0
zh-cn/application-dev/reference/arkui-ts/ts-container-list.md
...n/application-dev/reference/arkui-ts/ts-container-list.md
+11
-0
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-container-list.md
浏览文件 @
1a8f4de6
...
...
@@ -63,6 +63,7 @@ List(value?:{space?: number | string, initialIndex?: number, scroller?
| lanes
<sup>
9+
</sup>
| number
\|
[
LengthConstrain
](
ts-types.md#lengthconstrain
)
| 以列模式为例(listDirection为Axis.Vertical):
<br/>
lanes用于决定List组件在交叉轴方向按几列布局。
<br/>
默认值:1
<br/>
规则如下:
<br/>
-
lanes为指定的数量时,根据指定的数量与List组件的交叉轴尺寸除以列数作为列的宽度。
<br/>
-
lanes设置了{minLength,maxLength}时,根据List组件的宽度自适应决定lanes数量(即列数),保证缩放过程中lane的宽度符合{minLength,maxLength}的限制。其中,minLength条件会被优先满足,即优先保证符合ListItem的交叉轴尺寸符合最小限制。
<br/>
-
lanes设置了{minLength,maxLength},如果父组件交叉轴方向尺寸约束为无穷大时,固定按一列排列,列宽度按显示区域内最大的ListItem计算
<br/>
-
ListItemGroup在多列模式下也是独占一行,ListItemGroup中的ListItem按照List组件的lanes属性设置值来布局。
<br/>
-
lanes设置了{minLength,maxLength}时,计算列数会按照ListItemGroup的交叉轴尺寸计算。当ListItemGroup交叉轴尺寸与List交叉轴尺寸不一致时ListItemGroup中的列数与List中的列数可能不一样。
<br/>
该接口支持在ArkTS卡片中使用。 |
| alignListItem
<sup>
9+
</sup>
|
[
ListItemAlign
](
#listitemalign9枚举说明
)
| List交叉轴方向宽度大于ListItem交叉轴宽度
*
lanes时,ListItem在List交叉轴方向的布局方式,默认为首部对齐。
<br/>
默认值:ListItemAlign.Start
<br/>
该接口支持在ArkTS卡片中使用。 |
| sticky
<sup>
9+
</sup>
|
[
StickyStyle
](
#stickystyle9枚举说明
)
| 配合
[
ListItemGroup
](
ts-container-listitemgroup.md
)
组件使用,设置ListItemGroup中header和footer是否要吸顶或吸底。
<br/>
默认值:StickyStyle.None
<br/>
该接口支持在ArkTS卡片中使用。
<br/>
**说明:**
<br/>
sticky属性可以设置为 StickyStyle.Header
\|
StickyStyle.Footer 以同时支持header吸顶和footer吸底。 |
| scrollSnapAlign
<sup>
10+
</sup>
|
[
ScrollSnapAlign
](
#scrollsnapalign10枚举说明
)
| 设置列表项滚动结束对齐效果
<br/>
默认值:ScrollSnapAlign.NONE
<br/>
**说明:**
<br/>
只支持ListItem等高情况下,设置列表项滚动结束对齐效果。 |
| enableScrollInteraction
<sup>
10+
</sup>
| boolean | 设置是否支持滚动手势,当设置为false时,无法通过手指或者鼠标滚动,但不影响控制器的滚动接口。
<br/>
默认值:true |
## ListItemAlign<sup>9+</sup>枚举说明
...
...
@@ -114,6 +115,16 @@ List(value?:{space?: number | string, initialIndex?: number, scroller?
>
> List组件[通用属性clip](ts-universal-attributes-sharp-clipping.md)的默认值为true。
## ScrollSnapAlign<sup>10+</sup>枚举说明
设置列表项滚动结束对齐效果,从API version 10开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------ | ---------------------------------------------------------- |
| NONE | 默认无项目滚动对齐效果。滚动结束列表项何时将无限制地停止。 |
| START | 视图中的第一项将在列表的开头对齐。
<br/>
**说明:**
<br/>
当列表位移至末端,需要将末端的item完整显示,可能出现开头不对齐的情况。 |
| CENTER | 视图中的中间项将在列表中心对齐。
<br/>
**说明:**
<br/>
顶端和末尾的item都可以在列表中心对齐,列表显示可能露出空白。 |
| END | 视图中的最后一项将在列表末尾对齐。
<br/>
**说明:**
<br/>
当列表位移至顶端,需要将顶端的item完整显示,可能出现末尾不对齐的情况。 |
## 事件
| 名称 | 功能描述 |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录