OpenHarmony实战开发-如何实现内容边缘渐变的效果

介绍

本案例介绍组件内容边缘渐变的实现，通常用于提示长列表滑动到边缘的场景。

效果预览图

使用说明

滑动列表的图片，当一侧边缘有渐变色时表示还没有滑动到边缘，该侧仍有内容可以浏览，当滑动到边缘时，渐变色消失。

实现思路

1.创建要显示的底层页面。

List({ space: Const.EXAMPLE_IMAGE_GAP }) {
  ForEach(this.textArray, () => {
    ListItem() {
      Image($r("app.media.fadingedge_example1"))
        .width($r('app.integer.fadingedge_example_image_width'))
        .height($r('app.integer.fadingedge_example_image_height'))
        .borderRadius($r('app.integer.fadingedge_example_image_border_radius'))
    }
  }, (item: number) => item.toString())
}
.listDirection(Axis.Horizontal)
.width($r('app.string.fadingedge_fill_size'))
.height($r('app.integer.fadingedge_list_height'))
.overlay(this.fadingOverlay())
.edgeEffect(EdgeEffect.None)
.scrollBar(BarState.Off)

2.创建遮罩层自定义组件，实现见渐变边缘的效果。结合通用属性overlay和linearGradient实现渐变效果。

@Builder
fadingOverlay() {
  Column()
    .width($r('app.string.fadingedge_fill_size'))
    .height($r('app.integer.fadingedge_list_height'))
      // TODO: 知识点: linearGradient 可以设置指定范围内的颜色渐变效果
    .linearGradient({
      angle: Const.OVERLAY_LINEAR_GRADIENT_ANGLE,
      colors: [
        [this.linearGradientBeginColor, Const.OVERLAY_LINEAR_GRADIENT_COLOR_POS[0]],
        [Const.BEGIN_COLOR, Const.OVERLAY_LINEAR_GRADIENT_COLOR_POS[1]],
        [Const.BEGIN_COLOR, Const.OVERLAY_LINEAR_GRADIENT_COLOR_POS[2]],
        [this.linearGradientEndColor, Const.OVERLAY_LINEAR_GRADIENT_COLOR_POS[3]],
      ]
    })
    .animation({
      curve: Curve.Ease,
      duration: Const.DURATION
    })
    .hitTestBehavior(HitTestMode.Transparent)
}

3.通过list组件的onReachStart和onReachEnd接口触发边缘渐变的改变。

.onReachStart(() => {
  this.linearGradientBeginColor = Const.BEGIN_COLOR;
  this.linearGradientEndColor = Const.END_COLOR;
})
.onReachEnd(() => {
  this.linearGradientBeginColor = Const.END_COLOR;
  this.linearGradientEndColor = Const.BEGIN_COLOR;
})

高性能知识点

不涉及

工程结构&模块类型

fadingedge                  // HAR类型
    ├─common
    |   ├─Constants.ets     // 项目中的常量
    ├─mainpage
    |   ├─MainPage.ets      // 入口主页

模块依赖

• 路由模块
• utils

参考资料

• linearGradient
• overlay

如果大家还没有掌握鸿蒙，现在想要在最短的时间里吃透它，我这边特意整理了《鸿蒙语法ArkTS、TypeScript、ArkUI、教学视频》以及《鸿蒙生态应用开发白皮书V2.0PDF》《鸿蒙开发学习手册》（共计890页）鸿蒙开发资料等…希望对大家有所帮助：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

鸿蒙语法ArkTS、TypeScript、ArkUI等…视频教程：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

OpenHarmony APP开发教程步骤：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

鸿蒙生态应用开发白皮书V2.0PDF：https://docs.qq.com/doc/DZVVkRGRUd3pHSnFG

南北双向高工技能基础：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

应用开发中高级就业技术：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

全网首发-工业级 南向设备开发就业技术：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

《鸿蒙开发学习手册》：

如何快速入门：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.基本概念
2.构建第一个ArkTS应用
3.……

开发基础知识：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……

基于ArkTS 开发：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……