共计 4534 个字符,预计需要花费 12 分钟才能阅读完成。
4.1【HarmonyOS 鸿蒙开发】组件 ScrollView
作者:韩茹
公司:程序咖(北京)科技有限公司
鸿蒙巴士专栏作家
ScrollView 是一种带滚动性能的组件,它采纳滑动的形式在无限的区域内显示更多的内容。
一、反对的 XML 属性
ScrollView 的共有 XML 属性继承自:StackLayout
ScrollView 的自有 XML 属性见下表:
属性名称 | 中文形容 | 取值 | 取值阐明 | 应用案例 |
---|---|---|---|---|
match_viewport | 是否拉伸匹配 | boolean 类型 | 能够间接设置 true/false,也能够援用 boolean 资源。 | ohos:match_viewport=”true” ohos:match_viewport=”$boolean:true” |
rebound_effect | 回弹成果 | boolean 类型 | 能够间接设置 true/false,也能够援用 boolean 资源。 | ohos:rebound_effect=”true” ohos:rebound_effect=”$boolean:true” |
二、创立 ScrollView
在 layout 目录下的 xml 文件中创立 ScrollView,ScrollView 的展现须要布局反对,此处以 DirectionalLayout 为例。
<?xml version="1.0" encoding="utf-8"?>
<DirectionalLayout
xmlns:ohos="http://schemas.huawei.com/res/ohos"
ohos:height="match_parent"
ohos:width="match_parent"
ohos:alignment="center"
ohos:orientation="vertical">
<ScrollView
ohos:id="$+id:scrollview"
ohos:height="500vp"
ohos:width="300vp"
ohos:background_element="#FFDEAD"
ohos:top_margin="32vp"
ohos:bottom_padding="16vp"
ohos:layout_alignment="horizontal_center">
<DirectionalLayout
ohos:height="match_content"
ohos:width="match_content">
<Image
ohos:width="300vp"
ohos:height="match_content"
ohos:top_margin="16vp"
ohos:image_src="$media:mengmao"/>
<!-- 搁置任意须要展现的组件 -->
...
</DirectionalLayout>
</ScrollView>
</DirectionalLayout>
预览一下成果:
<img src=”https://img.chengxuka.com/ScrollViewyunxing1.gif” alt=”ScrollViewyunxing1″ style=”zoom:50%;” />
三、设置 ScrollView
ScrollView 的速度、滚动、回弹等罕用罕用办法如下:
办法 | 作用 |
---|---|
doFling(int velocityX, int velocityY)doFlingX(int velocityX)doFlingY(int velocityY) | 设置 X 轴和 Y 轴滚动的初始速度,单位(px) |
fluentScrollBy(int dx, int dy)fluentScrollByX(int dx)fluentScrollByY(int dy) | 依据像素数平滑滚动到指定地位,单位(px) |
fluentScrollTo(int x, int y)fluentScrollXTo(int x)fluentScrollYTo(int y) | 依据指定坐标平滑滚动到指定地位,单位(px) |
setReboundEffect(boolean enabled) | 设置是否启用回弹成果,默认 false |
setReboundEffectParams(int overscrollPercent, float overscrollRate, int remainVisiblePercent)setReboundEffectParams(ReboundEffectParams reboundEffectParams)setOverscrollPercent(int overscrollPercent)setOverscrollRate(float overscrollRate)setRemainVisiblePercent(int remainVisiblePercent) | 配置回弹成果 overscrollPercent:适度滚动百分比,默认值 40overscrollRate:适度滚动率,默认值 0.6remainVisiblePercent:应放弃可见内容的最小百分比,默认值 20 |
1、滚动指定的间隔,默认单位是 px。
//1. 获取 scrollview 对象
ScrollView scrollView = (ScrollView) findComponentById(ResourceTable.Id_scrollview);
//2. 点击
scrollView.setClickedListener(component -> {
// 点击一下,沿 y 轴将内容平滑地滚动了指定数量的像素。scrollView.fluentScrollByY(500);
});
预览成果:
<img src=”https://img.chengxuka.com/ScrollViewyunxing2.gif” alt=”ScrollViewyunxing2″ style=”zoom:50%;” />
每点击一下,y 轴上就滚动 500px。
2、滚动到指定的坐标地位。默认单位是 px
// 点击一下,沿 y 轴将内容平滑地滚动了指定数量的像素。// scrollView.fluentScrollByY(500);
// 点击一下,沿 y 轴将内容平滑地滚动到指定的坐标地位。scrollView.fluentScrollYTo(500);
// 留神以上两个办法的区别:fluentScrollByY(500) 是滚动了 500px,每次滚动的间隔是 500px,再点击还是会滚动 500px,// 而 fluentScrollYTo(500),是固定的就滚动到 500px 这个地位。
预览成果:点击一下滚动到 y 轴 500px 的地位。再点击也是一样的,除非滑动。
<img src=”https://img.chengxuka.com/ScrollViewyunxing3.gif” alt=”ScrollViewyunxing3″ style=”zoom:50%;” />
留神以上两个办法的区别:
fluentScrollByY(500) 是滚动了 500px,每次滚动的间隔是 500px,再点击还是会滚动 500px,
而 fluentScrollYTo(500),是固定的就滚动到 500px 这个地位。
3、设置布局方向:ScrollView 本身没有设置布局方向的属性,所以须要在其子布局中设置。以横向布局 horizontal 为例:
<ScrollView
...
>
<DirectionalLayout
...
ohos:orientation="horizontal">
...
</DirectionalLayout>
</Scrollview>
咱们在 layout 目录下,从新创立一个 layout 布局文件:demo1_scrollview.xml。
<?xml version="1.0" encoding="utf-8"?>
<DirectionalLayout
xmlns:ohos="http://schemas.huawei.com/res/ohos"
ohos:height="match_parent"
ohos:width="match_parent"
ohos:alignment="center"
ohos:orientation="vertical">
<ScrollView
ohos:id="$+id:scrollview2"
ohos:height="match_content"
ohos:width="250vp"
ohos:background_element="#FFDEAD"
ohos:padding="16vp"
ohos:layout_alignment="horizontal_center">
<DirectionalLayout
ohos:height="match_content"
ohos:width="match_content"
ohos:orientation="horizontal"
>
<Image
ohos:width="300vp"
ohos:height="match_content"
ohos:margin="10vp"
ohos:image_src="$media:wallper"/>
<Image
ohos:width="300vp"
ohos:height="match_content"
ohos:margin="10vp"
ohos:image_src="$media:wallper"/>
<Image
ohos:width="300vp"
ohos:height="match_content"
ohos:margin="10vp"
ohos:image_src="$media:wallper"/>
</DirectionalLayout>
</ScrollView>
</DirectionalLayout>
预览成果:
<img src=”https://img.chengxuka.com/ScrollViewyunxing4.gif” alt=”ScrollViewyunxing4″ style=”zoom:50%;” />
4、设置回弹成果。
在 xml 布局中设置:
<ScrollView
...
ohos:rebound_effect="true">
...
</ScrollView>
在 Java 代码中设置:
scrollView.setReboundEffect(true);
预览成果:
<img src=”https://img.chengxuka.com/ScrollViewyunxing5.gif” alt=”ScrollViewyunxing5″ style=”zoom:50%;” />
5、设置缩放匹配成果。
指定滚动组件是否容许拉伸其组件以填充其视口。
在 xml 中设置:
<ScrollView
...
ohos:match_viewport="true">
...
</ScrollView>
在 Java 代码中设置:
scrollView.setMatchViewportEnabled(true);
更多内容:
1、社区:鸿蒙巴士 https://www.harmonybus.net/
2、公众号:HarmonyBus
3、技术交换 QQ 群:714518656
4、视频课:https://www.chengxuka.com