目录

如何绘制有图片超出弹窗边框的弹窗

问题现象

如何实现如下图所示这一类弹窗,使图片超出弹窗上边框。

背景知识

解决方案

对于使用@Builder自定义构建函数作为UI内容的弹窗来说,都有一种通用的方法设置上述效果。基本思路是:将整个弹窗UI内容的根容器组件设为透明背景,实际显示可见UI内容的容器作为子组件放置这个透明背景的父容器中,与图像堆叠而成。图像的一部分显示在有可见UI内容的容器上,一部分显示在透明背景上。

这种堆叠布局可以采用Stack堆叠布局实现,也可以使用zIndex设置显示层级,同时margin控制布局上移的方式实现。以下分别以openCustomDialog全局自定义弹窗和bindSheet半模态弹窗两种弹窗为例,分别展示两种方法的具体实现。

两种场景的完整示例代码如下:

import { ComponentContent, LengthMetrics } from '@kit.ArkUI';

@Entry
@Component
struct DialogOverflow {
  build() {
    Column({ space: 20 }) {
      Scene1()
      Scene2()
    }
    .width('100%')
    .height('100%')
    .alignItems(HorizontalAlign.Center)
    .justifyContent(FlexAlign.Center)
  }
}

@Builder
function customDialogBuilder(close: () => void) {
  Stack() {
    Column() {
      Row() {
        SymbolGlyph($r('sys.symbol.xmark'))
          .onClick(() => {
            close();
          })
      }
      .width('100%')
      .height(20)
      .justifyContent(FlexAlign.End)

      Text('Test').fontSize(24).margin({ top: 30, bottom: 10 })

      Button('关闭弹窗').onClick(() => {
        close();
      })
    }
    .borderRadius(8)
    .padding(10)
    .margin({ top: 40 })  // 留出图片占位
    .backgroundColor(Color.White)
    .width('100%')
    .height('auto')

    Image($r('app.media.startIcon'))
      .width(80)
  }
  .alignContent(Alignment.Top)
  .margin({ right: 20, left: 20 })
  .backgroundColor(Color.Transparent)
}

@Component
struct Scene1 {
  build() {
    Button("场景一")
      .onClick(() => {
        let uiContext = this.getUIContext();
        let contentNode = new ComponentContent(uiContext, wrapBuilder(customDialogBuilder), () => {
          uiContext.getPromptAction().closeCustomDialog(contentNode);
        });
        uiContext.getPromptAction().openCustomDialog(contentNode);
      })
  }
}

@Builder
export function customBindSheet() {
  Column() {
    Image($r('app.media.startIcon'))
      .width(80)
      .clip(false)
      .margin({ left: 10 })
        // 设置图片的层级为最高,显示在最上层
      .zIndex(999)
    Row() {
      Blank()
      Image($r('app.media.startIcon'))
        .height(25)
        .width(25)
        .margin({ top: 10, right: 10 })
    }
    // 设置图片的层级为最低,显示在图片下层
    .zIndex(1)
    // 设置容器向上偏移
    .margin({ top: -40 })
    .borderRadius({ topLeft: 20, topRight: 20 })
    .width('100%')
    .height(380)
    .backgroundColor(Color.White)
    .alignItems(VerticalAlign.Top)
    .justifyContent(FlexAlign.SpaceBetween)
  }
  .width('100%')
  .height('100%')
  // 设置column的背景色为透明色
  .backgroundColor(Color.Transparent)
  .justifyContent(FlexAlign.Start)
  .alignItems(HorizontalAlign.Start)
}

@Component
struct Scene2 {
  @State isShow: boolean = false;
  sheetHeight: number = 400;

  build() {
    Button("场景二")
      .onClick(() => {
        this.isShow = true;
      })
      .bindSheet($$this.isShow, customBindSheet(), {
        height: this.sheetHeight,
        // 设置bindSheet的背景色为透明色
        backgroundColor: '#00000000',
        // 隐藏bindSheet自带的关闭按钮
        showClose: false,
        radius: LengthMetrics.vp(0),
      })
  }
}