前言
隐墨是开发的CustomDialog组件以其独特的设计和智能的交互,在小镇上广受好评。在一次项目调试中,她遇到了他,一位同样热爱编程的男子。他的出现,就像是隐墨代码中缺失的那一行,让整个程序更加完美。
他们一起在小镇的夜晚下,讨论着CustomDialog的每一个细节,从按钮的样式到对话框的动态效果,每一次的交流都让他们的关系更加紧密。他的逻辑思维与隐墨的创意碰撞,使得CustomDialog不仅功能强大,更充满了情感与生命力。
在一个特别的夜晚,他通过CustomDialog向隐墨展示了一段特别的代码,当隐墨点击对话框时,屏幕上缓缓展开一幅由代码编织的画卷,上面写着:“在千万行代码中,我找到了你,我的隐墨。”这份浪漫的告白,如同他们共同编写的程序一样,精准而深情。
一:CustomDialog基本属性
1.1 基本概念和特性
CustomDialog是鸿蒙操作系统(HarmonyOS)中的一个组件,它允许开发者创建高度可定制的自定义对话框。这些对话框可以用于多种用途,包括但不限于显示警告、确认操作、广告、中奖通知以及软件更新 等。开发者可以通过CustomDialogController类显示自定义弹窗,使得开发者可以根据应用的具体需求来设计对话框的外观和行为。
CustomDialog的关键特性:
- 自定义内容和布局:开发者可以通过定义结构体来构建对话框的内容,包括文本、图片、按钮等,从而实现完全自定义的对话框设计。
- 事件处理:CustomDialog支持通过按钮等组件与用户交互,并可以定义回调函数来响应用户的操作,如点击确认或取消按钮。
- 动画效果:可以通过设置动画参数来控制对话框的显示和隐藏效果,增强用户体验。
- 样式定制:开发者可以自定义对话框的样式,包括背景色、圆角、阴影等,以匹配应用的整体设计。
- 复杂交互:CustomDialog可以实现多层弹窗的嵌套,以及弹窗之间的联动操作,提供更为复杂的用户交互体验
1.2 创建自定义弹窗
创建的步骤:
-
使用@CustomDialog装饰器装饰自定义弹窗,可在此装饰器内自定义弹窗内容。
-
创建构造器,与装饰器呼应相连。
-
点击与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 弹窗的交互
创建的步骤:
-
在@CustomDialog装饰器内添加按钮,同时添加数据函数。但让调用者自己实现函数
-
页面内需要在构造器内进行接收,同时创建相应的函数操作。
-
弹窗通过定义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 实现效果
后言:
"有志者,事竟成,破釜沉舟,百二秦关终属楚。" —— 范晔《后汉书》