logo
积分中心
鸿蒙UI开发——组件阴影效果
头像 蓝亭书序 2026-11-18 13:27:45    发布
0 浏览 0 收藏

1、概 述

ArkUI为组件提供了阴影效果的设置。我们可以通过组件的.shadow属性为组件添加阴影效果。本文对阴影效果的设置做简单介绍。

2、接口介绍

对于普通组件来说,我们可以为其设置.shadow属性,定义如下:


// 为组件添加阴影效果。
shadow(value: ShadowOptions | ShadowStyle)


其中,入参类型为ShadowOptions时,可以指定模糊半径、阴影的颜色、X轴和Y轴的偏移量。入参类型为ShadowStyle时,可指定不同阴影样式。

ShadowOptions含有的属性定义如下:

属性名类型说明
radiusnumber | Resource阴影模糊半径。取值范围:[0, +∞)单位:px。说明:设置小于0的值时,按值为0处理。如需使用vp单位的数值可用vp2px进行转换。如果radius为Resource类型,则传入的值需为number类型。元服务API:从API version 11开始,该接口支持在元服务中使用。
typeShadowType阴影类型。默认为COLOR。
colorColor | string | Resource| ColoringStrategy阴影的颜色。默认为黑色。说明:从API version 11开始,该接口支持使用ColoringStrategy实现智能取色,智能取色功能不支持在ArkTS卡片、textShadow中使用。当前仅支持平均取色和主色取色,智能取色区域为shadow绘制区域。支持使用'average'字符串触发智能平均取色模式,支持使用'primary'字符串触发智能主色模式。
offsetXnumber | Resource阴影的X轴偏移量。默认值:0单位:px。说明:如需使用vp单位的数值可用vp2px进行转换。如果offsetX为Resource类型,则传入的值需为number类型。
offsetYnumber | Resource阴影的Y轴偏移量。默认值:0单位:px说明:如需使用vp单位的数值可用vp2px进行转换。如果offsetY为Resource类型,则传入的值需为number类型。
fill11+boolean阴影是否内部填充。默认为false。说明:textShadow中该字段不生效。

ShadowStyle是一个枚举,定义如下


OUTER_DEFAULT_XS  超小阴影。
OUTER_DEFAULT_SM  小阴影。
OUTER_DEFAULT_MD  中阴影。
OUTER_DEFAULT_LG  大阴影。
OUTER_FLOATING_SM  浮动小阴影。
OUTER_FLOATING_MD  浮动中阴影。


3、示 例

一个示例效果如下:

图片

代码如下(16行代码):


@Entry
@Component
struct ShadowOptionDemo {
  build() {
    Row() {
      Column() {
        Column() {
          Text('shadowOption').fontSize(12)
        }
        .width(100)
        .aspectRatio(1)
        .margin(10)
        .justifyContent(FlexAlign.Center)
        .backgroundColor(Color.White)
        .borderRadius(20)
        .shadow({ radius: 10, color: Color.Gray })

        Column() {
          Text('shadowOption').fontSize(12)
        }
        .width(100)
        .aspectRatio(1)
        .margin(10)
        .justifyContent(FlexAlign.Center)
        .backgroundColor('#a8a888')
        .borderRadius(20)
        .shadow({ radius: 10, color: Color.Gray, offsetX: 20, offsetY: 20 })
      }
      .width('100%')
      .height('100%')
      .justifyContent(FlexAlign.Center)
    }
    .height('100%')
  }
}



©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255