ArkUI子系统Changelog

cl.arkui.1 组件的阴影模糊半径规格变更

访问级别

公开接口

变更原因

修改阴影模糊半径生效范围，使shadow属性中的所有阴影类型新增支持模糊半径为0时的阴影能力。

变更影响

此变更涉及应用适配。

变更前：通过shadow属性添加阴影效果，将参数ShadowOptions中的阴影模糊半径radius设置为0时，无阴影；设置为负数时按0处理，无阴影。

变更后：通过shadow属性添加阴影效果，将参数ShadowOptions中的阴影模糊半径radius设置为0时，存在阴影但不存在模糊效果；设置为负数时，无阴影。

例如使用以下代码片段，通过shadow设置Column组件的边框阴影效果，变更前radius设置0和-1效果一致，变更后radius设置0且带有偏移量OffsetX或OffsetY时会有无模糊阴影显示。

// xxx.ets
@Entry
@Component
struct Index {
  private shadowValue: Array<ShadowOptions> = [
    { radius: -1 },
    { radius: -1, offsetX: 20, offsetY: 20 },
    { radius: 0 },
    { radius: 0, offsetX: 20, offsetY: 20 },
    { radius: 50 },
    { radius: 50, offsetX: 20, offsetY: 20 },
  ];

  build() {
    Column() {
      Row({ space: 10 }) {
        Column({ space: 20 }) {
          Text('ShadowType.Color')

          ForEach(this.shadowValue, (shadow: ShadowOptions) => {
            Column()
              .width(100)
              .height(50)
              .borderRadius(10)
              .backgroundColor(Color.Pink)
              .shadow({
                radius: shadow.radius,
                color: Color.Green,
                offsetX: shadow.offsetX,
                offsetY: shadow.offsetY
              })
          })
        }
        
        Column({ space: 20 }) {
          Text('ShadowType.Blur')

          ForEach(this.shadowValue, (shadow: ShadowOptions) => {
            Column()
              .width(100)
              .height(50)
              .borderRadius(10)
              .backgroundColor(Color.Pink)
              .shadow({
                radius: shadow.radius,
                type: ShadowType.BLUR,
                offsetX: shadow.offsetX,
                offsetY: shadow.offsetY
              })
          })
        }
      }
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Center)
    .alignItems(HorizontalAlign.Center)
  }
}