藏在爱意中的玫瑰——CustomDialog自定义对话框

        前言        

        隐墨是开发的CustomDialog组件以其独特的设计和智能的交互,在小镇上广受好评。在一次项目调试中,她遇到了他,一位同样热爱编程的男子。他的出现,就像是隐墨代码中缺失的那一行,让整个程序更加完美。

        他们一起在小镇的夜晚下,讨论着CustomDialog的每一个细节,从按钮的样式到对话框的动态效果,每一次的交流都让他们的关系更加紧密。他的逻辑思维与隐墨的创意碰撞,使得CustomDialog不仅功能强大,更充满了情感与生命力。

        在一个特别的夜晚,他通过CustomDialog向隐墨展示了一段特别的代码,当隐墨点击对话框时,屏幕上缓缓展开一幅由代码编织的画卷,上面写着:“在千万行代码中,我找到了你,我的隐墨。”这份浪漫的告白,如同他们共同编写的程序一样,精准而深情。


        一:CustomDialog基本属性

         1.1 基本概念和特性

        CustomDialog是鸿蒙操作系统(HarmonyOS)中的一个组件,它允许开发者创建高度可定制的自定义对话框。这些对话框可以用于多种用途,包括但不限于显示警告、确认操作、广告、中奖通知以及软件更新 等。开发者可以通过CustomDialogController类显示自定义弹窗,使得开发者可以根据应用的具体需求来设计对话框的外观和行为。

               CustomDialog的关键特性:

  • 自定义内容和布局:开发者可以通过定义结构体来构建对话框的内容,包括文本、图片、按钮等,从而实现完全自定义的对话框设计。
  • 事件处理:CustomDialog支持通过按钮等组件与用户交互,并可以定义回调函数来响应用户的操作,如点击确认或取消按钮。
  • 动画效果:可以通过设置动画参数来控制对话框的显示和隐藏效果,增强用户体验。
  • 样式定制:开发者可以自定义对话框的样式,包括背景色、圆角、阴影等,以匹配应用的整体设计。
  • 复杂交互:CustomDialog可以实现多层弹窗的嵌套,以及弹窗之间的联动操作,提供更为复杂的用户交互体验

        1.2 创建自定义弹窗

                        创建的步骤:

  1. 使用@CustomDialog装饰器装饰自定义弹窗,可在此装饰器内自定义弹窗内容。

  2. 创建构造器,与装饰器呼应相连。

  3. 点击与onClick事件绑定的组件使弹窗弹出。

@CustomDialog
struct CustomDialogExample {

  //创建一个自定义对话框(CustomDialog)的控制器实例。
  //CustomDialogController 是负责管理和控制自定义对话框显示、隐藏以及其他行为的类。

  // builder构造器使用回调函数作为入参,请注意使用this绑定问题
  // 如build: custombuilder({ callback: ()=> {...}})。
  // 若在builder构造器中监听数据变化请使用@Link,其他方式如@Prop、@ObjectLink不适用此场景。

  controller: CustomDialogController = new CustomDialogController({
    builder: CustomDialogExample({}),
  })


  build() {
    Column() {
      Text('我是内容')
        .fontSize(20)
        .margin({ top: 10, bottom: 10 })
    }
  }
}

@Entry
@Component
struct CustomDialogUser {

  //dialogController:创建一个CustomDialogController实例,用于控制自定义对话框的显示与隐藏。

  // builder: CustomDialogExample():
  // 设置CustomDialogController的builder属性为CustomDialogExample,即自定义对话框的构建者。
  // CustomDialogExample是一个组件,它定义了对话框的内容和布局

  dialogController: CustomDialogController = new CustomDialogController({
    builder: CustomDialogExample(),
  })

  build() {
    Column() {
      Button('打开新世界的大门')
        .onClick(() => {
          this.dialogController.open()   //显示与dialogController关联的自定义对话框。
        })
    }
    .height('100%')
    .width('100%')
    .justifyContent(FlexAlign.Center)
  }
}

        实现的具体效果为

        

        1.3 弹窗的交互

                        创建的步骤

  1. @CustomDialog装饰器内添加按钮,同时添加数据函数。但让调用者自己实现函数

  2. 页面内需要在构造器内进行接收,同时创建相应的函数操作

  3. 弹窗通过定义openAnimation控制弹窗出现动画的持续时间,速度等参数。

    • duration: 动画的持续时间,单位为毫秒。
    • curve: 动画的执行曲线,Curve.Friction表示一种非线性动画曲线,类似物理摩擦效果
    • delay: 动画开始前的延迟时间,单位为毫秒。
    • layMode: 动画播放模式,PlayMode.Alternate表示动画将正反交替播放
    • onFinish: 动画完成时的回调函数,此处输出“play end”到控制台。

        4. 设置弹窗的相应的自定义的动画和样式


@CustomDialog
struct CustomDialogExample {

  //调用者去实现函数
  cancel?: () => void
  confirm?: () => void
  controller: CustomDialogController = new CustomDialogController({
    builder: CustomDialogExample({})
  })

  build() {
    Column() {
      Text('我是内容').fontSize(20).margin({ top: 10, bottom: 10 })
      Flex({ justifyContent: FlexAlign.SpaceAround }) {
        Button('cancel')
          .onClick(() => {
            this.controller.close()
            if (this.cancel) {
              this.cancel()
            }
          }).backgroundColor(0xffffff).fontColor(Color.Black)
        Button('confirm')
          .onClick(() => {
            this.controller.close()
            if (this.confirm) {
              this.confirm()
            }
          }).backgroundColor(0xffffff).fontColor(Color.Red)
      }.margin({ bottom: 10 })
    }
  }
}

@Entry
@Component
struct CustomDialogUser {
  dialogController: CustomDialogController = new CustomDialogController({
    builder: CustomDialogExample({
      cancel: ()=> { this.onCancel() },
      confirm: ()=> { this.onAccept() },
    }),
    openAnimation: {
      duration: 1200,
      curve: Curve.Friction,
      delay: 500,
      playMode: PlayMode.Alternate,
      onFinish: () => {
        console.info('play end')
      }
    },
    alignment: DialogAlignment.Center,
    offset: { dx: 0, dy: -20 },
    gridCount: 4,
    customStyle: false,
    backgroundColor: 0xd9ffffff,
    cornerRadius: 20,
    width: '80%',
    borderWidth: 1,
    borderStyle: BorderStyle.Dashed,//使用borderStyle属性,需要和borderWidth属性一起使用
    borderColor: Color.Blue,//使用borderColor属性,需要和borderWidth属性一起使用
    shadow: ({ radius: 20, color: Color.Grey, offsetX: 50, offsetY: 0}),
  })

  onCancel() {
    console.info('Callback when the first button is clicked')
  }

  onAccept() {
    console.info('Callback when the second button is clicked')
  }

  build() {
    Column() {
      Button('点击就有弹窗')
        .fontSize(20)
        .onClick(() => {
          this.dialogController.open()
        })
        .width(200)
    }
    .width('100%').height("100%")
    .justifyContent(FlexAlign.Center)
  }
}

        1.4 嵌套的定义弹窗        

        通过第一个弹窗打开第二个弹窗时,最好将第二个弹窗定义在第一个弹窗的父组件处,通过父组件传给第一个弹窗的回调来打开第二个弹窗。

        由于自定义弹窗在状态管理侧有父子关系,如果将第二个弹窗定义在第一个弹窗内,那么当父组件(第一个弹窗)被销毁(关闭)时,子组件(第二个弹窗)内无法再继续创建新的组件。

@CustomDialog
struct CustomDialogExampleTwo {
  
  //controllerTwo: 可选属性,用于控制外部的CustomDialogController
  controllerTwo?: CustomDialogController = new CustomDialogController({
    builder:CustomDialogExampleTwo({})
  })

  @State message: string = "I'm the second dialog box."
  @State showIf: boolean = false;
  build() {
    Column() {
      // 可以显示格外的内容
      if (this.showIf) {
        Text("Text")
          .fontSize(30)
          .height(100)
      }
      Text(this.message)
        .fontSize(30)
        .height(100)
      Button("Create Text")
        .onClick(()=>{
          this.showIf = true;
        })
      Button ('Close Second Dialog Box')
        .onClick(() => {
          if (this.controllerTwo != undefined) {
            this.controllerTwo.close()
          }
        })
        .margin(20)
    }
  }
}
@CustomDialog
struct CustomDialogExample {
  openSecondBox?: ()=>void
  controller?: CustomDialogController

  build() {
    Column() {
      Button ('Open Second Dialog Box and close this box')
        .onClick(() => {
          this.controller!.close();
          this.openSecondBox!();
        })
        .margin(20)
    }.borderRadius(10)
  }
}
@Entry
@Component
struct CustomDialogUser {
  @State inputValue: string = 'Click Me'
  dialogController: CustomDialogController | null = new CustomDialogController({
    builder: CustomDialogExample({
      openSecondBox: ()=>{
        if (this.dialogControllerTwo != null) {
          this.dialogControllerTwo.open()
        }
      }
    }),
    cancel: this.exitApp,
    autoCancel: true,
    alignment: DialogAlignment.Bottom,
    offset: { dx: 0, dy: -20 },
    gridCount: 4,
    customStyle: false
  })
  dialogControllerTwo: CustomDialogController | null = new CustomDialogController({
    builder: CustomDialogExampleTwo(),
    alignment: DialogAlignment.Bottom,
    offset: { dx: 0, dy: -25 } })

  aboutToDisappear() {
    this.dialogController = null
    this.dialogControllerTwo = null
  }

  onCancel() {
    console.info('Callback when the first button is clicked')
  }

  onAccept() {
    console.info('Callback when the second button is clicked')
  }

  exitApp() {
    console.info('Click the callback in the blank area')
  }
  build() {
    Column() {
      Button(this.inputValue)
        .onClick(() => {
          if (this.dialogController != null) {
            this.dialogController.open()
          }
        }).backgroundColor(0x317aff)
    }.width('100%').margin({ top: 5 })
  }
}


        二: CustomDialog实践练习

        2.1 CustomDialog 修饰自定义弹窗

@CustomDialog
export default struct UserPrivacyDialog {

  //使用@CustomDialog装饰器装饰自定义弹窗,此装饰器内进行自定义内容(也就是弹框内容)
  controller: CustomDialogController = new CustomDialogController({builder: UserPrivacyDialog({})})

  //调用者去实现函数
  confirm?: () => void

  cancel?: () => void

  build() {
    Column({space:CommonConstants.SPACE_10}){
      // 1.标题
      Text($r('app.string.user_privacy_title')).fontSize(20).fontWeight(CommonConstants.FONT_WEIGHT_700)

      // 2.内容
      Text($r('app.string.user_privacy_content'))

      // 3.按钮
      Button($r('app.string.agree_label'))
        .width(150)
        .backgroundColor($r('app.color.primary_color'))
        .onClick(()=>{
          // 3.1 调用相应的函数
          if(this.confirm){
            this.confirm()
          }
          this.controller.close()   //关闭弹窗
        })

      Button($r('app.string.refuse_label'))
        .width(150)
        .backgroundColor($r('app.color.lightest_primary_color'))
        .fontColor($r('app.color.light_gray'))
        .onClick(()=>{
          if(this.cancel){
            this.cancel()
          }
          this.controller.close()
        })
    }
    .width('100%')
    .padding(15)
  }
}

        2.2 主页面的引用

@Entry
@Component
struct WelcomePage {

  context = getContext(this) as common.UIAbilityContext

  //页面内需要在构造器内进行接收,同时创建相应的函数操作
  controller: CustomDialogController = new CustomDialogController({
    builder: UserPrivacyDialog({
      confirm: (): void => this.onConfirm(),
      cancel: (): void => this.exitApp()
    })
  })

  async aboutToAppear() {

    //1.1 加载用户首选项
    let isAgree = await PreferenceUtil.getPreferenceValue(PREF_KEY,false)   //默认值就为false
    if(isAgree) {
      this.jumpToIndex()
    } else {
      //1.2 不同意弹窗打开
      this.controller.open()
    }
  }

  jumpToIndex(){
    //设置进入的延迟时间
    setTimeout(()=>{
      router.replaceUrl({
        url:'pages/Index'
      })
    },1000)  //1秒以后进行跳转
  }

  onConfirm() {
    //2.1. 保存首选项
    PreferenceUtil.putPreferenceValue(PREF_KEY,true)
    //2.2 跳转到首页
    this.jumpToIndex()
  }

  exitApp() {
    //1.退出app,自我毁灭
    this.context.terminateSelf()
  }

  build() {
    Column({ space: 10 }) {
      //1. 中央logan
      Row() {
        Image($r('app.media.home_slogan')).width(250)
      }.layoutWeight(1)

      //2. logan的标志
      Image($r('app.media.home_logo')).width(150)

      //3. 文字的描述
      Row() {
        Text('黑马健康支持').fontSize(12).opacity(0.8).fontColor(Color.White)
        Text('IPv6')//3.1 设置相应的边框样式
          .opacityWhiteText(0.8, 12)
          .border({
            style: BorderStyle.Solid,
            width: 1,
            color: Color.White,
            radius: 15
          })
          .padding({ left: 5, right: 5 })
        Text('网络').opacityWhiteText(0.8, 12)
      }

      Text(`'减更多'指给黑马健康App希望通过软件工具的形式,帮助更多用户实现身材管理`)
        .opacityWhiteText(0.6)

      Text('浙ICP备0000000号')
        .opacityWhiteText(0.6)
        .margin({ bottom: 20 })

    }
    .height('100%')
    .width('100%')
    .backgroundColor($r('app.color.welcome_page_background'))
  }
}

//将相同的属性进行封装
@Extend(Text) function opacityWhiteText(opacity:number,fontSize: number=10) {
  .fontSize(fontSize)
  .opacity(opacity)
  .fontColor(Color.White)
}

        2.3 实现效果


        后言:

         "有志者,事竟成,破釜沉舟,百二秦关终属楚。" —— 范晔《后汉书》

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值