HarmonyOS应用开发：Scroll（容器组件）

最新推荐文章于 2025-03-22 09:18:58 发布

「已注销」

最新推荐文章于 2025-03-22 09:18:58 发布

阅读量1.9k

点赞数 25

分类专栏：鸿蒙文章标签： harmonyos 华为鸿蒙系统 android 鸿蒙

本文链接：https://blog.csdn.net/situnanQAQ/article/details/139774115

版权

可滚动的容器组件，当子组件的布局尺寸超过父组件的尺寸时，内容可以滚动。

说明：

该组件从API version 7开始支持。

该组件嵌套List子组件滚动时，若List不设置宽高，则默认全部加载，在对性能有要求的场景下建议指定List的宽高。

该组件滚动的前提是主轴方向大小小于内容大小。

该组件回弹的前提是要有滚动。内容小于一屏时，没有回弹效果。

支持单个子组件。

Scroll(scroller?: Scroller)

参数：

参数名	参数类型	必填	参数描述
scroller	Scroller	否	可滚动组件的控制器。用于与可滚动组件进行绑定。

除支持通用属性外，还支持以下属性：

名称	参数类型	描述
scrollable	ScrollDirection	设置滚动方向。默认值：ScrollDirection.Vertical
scrollBar	BarState	设置滚动条状态。默认值：BarState.Auto 说明：如果容器组件无法滚动，则滚动条不显示。如果容器组件的子组件大小为无穷大，则滚动条不支持拖动和伴随滚动。
scrollBarColor	string \| number \| Color	设置滚动条的颜色。
scrollBarWidth	string \| number	设置滚动条的宽度，不支持百分比设置。默认值：4 单位：vp 说明：如果滚动条的宽度超过其高度，则滚动条的宽度会变为默认值。
scrollSnap10+	ScrollSnapOptions	设置Scroll组件的限位滚动模式。
edgeEffect	EdgeEffect	设置滑动效果，目前支持的滑动效果参见EdgeEffect的枚举说明。默认值：EdgeEffect.None
enableScrollInteraction10+	boolean	设置是否支持滚动手势，当设置为false时，无法通过手指或者鼠标滚动，但不影响控制器的滚动接口。默认值：true
nestedScroll10+	NestedScrollOptions	嵌套滚动选项。设置向前向后两个方向上的嵌套滚动模式，实现与父组件的滚动联动。
friction10+	number \| Resource	设置摩擦系数，手动划动滚动区域时生效，只对惯性滚动过程有影响，对惯性滚动过程中的链式效果有间接影响。默认值：非可穿戴设备为0.6，可穿戴设备为0.9 说明：设置为小于等于0的值时，按默认值处理

名称	描述
Horizontal	仅支持水平方向滚动。
Vertical	仅支持竖直方向滚动。
None	不可滚动。
Free(deprecated)	支持竖直或水平方向滚动从API version 9开始废弃

名称	参数类型	描述
snapAlign	ScrollSnapAlign	设置Scroll组件限位滚动时的对其方式。说明： 1.该属性默认值为ScrollSnapAlign.NONE。 2.该接口仅当snapPagination属性为Dimension时生效，不支持Array<Dimension>。
snapPagination	Dimension \| Array<Dimension>	设置Scroll组件限位滚动时的限位点，限位点即为Scroll组件能滑动停靠的偏移量。说明： 1.当属性为Dimension时，表示每页的大小，系统会安装该大小来自动计算每个限位点的位置：如当Dimension为500时，实际的限位点即为[0,500,1000,1500,...]。 2.当属性为Array<Dimension>时，每个Dimension代表限位点的位置。每个Dimension的范围为[0,可滑动距离]，0和可滑动距离的底部自动成为限位点。 3.当该属性不填或者Dimension为小于等于0的输入时，按异常值，无限位滚动处理。当该属性值为Array<Dimension>数组时，数组中的数值必须为单调递增。 4.当输入为百分比时，实际的大小为Scroll组件的视口与百分比数值之积。
enableSnapToStart	boolean	在Scroll组件限位滚动模式下，该属性设置为false后，运行Scroll在开头和第一个限位点间自由滑动。说明： 1.该属性值默认为true。 2.该属性仅当snapPagination属性为Array<Dimension>时生效，不支持Dimension。