HarmonyOS鸿蒙学习基础篇 - 通用事件_harmony onappear和ondisappear

admin 管理员组

文章数量: 887021

先自我介绍一下，小编浙江大学毕业，去过华为、字节跳动等大厂，目前阿里P7

深知大多数程序员，想要提升技能，往往是自己摸索成长，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年最新HarmonyOS鸿蒙全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上鸿蒙开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

如果你需要这些资料，可以添加V获取：vip204888 （备注鸿蒙）

正文

| target8+ | EventTarget | 触发事件的元素对象显示区域。 |
| source8+ | SourceType | 事件输入设备。 |

TouchObject对象说明

示例

// 使用 @Entry 装饰器表示这个组件是整个应用的主入口
// 使用 @Component 装饰器表示这个组件是 Flutter 应用的一部分
@Entry
@Component
struct TouchExample {
// 定义一个名为 text 的状态变量，类型为 string，初始值为空字符串
@State
text: string = ‘’

// 定义一个名为 eventType 的状态变量，类型为 string，初始值为空字符串
@State
eventType: string = ‘’

// build 方法是一个特殊的方法，在 Flutter 中用于构建和渲染组件
build() {
// Column 是一个垂直布局容器，用于放置其他组件
Column() {
// 第一个 Button 组件，高度为 40，宽度为 100
Button(‘Touch’).height(40).width(100)
// .onTouch 方法定义了当 Button 被触摸时触发的动作
.onTouch((event: TouchEvent) => {
// 根据触摸事件类型更新 eventType 状态变量
if (event.type === TouchType.Down) {
this.eventType = ‘Down’
} else if (event.type === TouchType.Up) {
this.eventType = ‘Up’
} else if (event.type === TouchType.Move) {
this.eventType = ‘Move’
}
// 更新 text 状态变量，显示触摸事件的详细信息
this.text = ‘TouchType:’ + this.eventType + '\nDistance between touch point and touch element:\nx: ’

• event.touches[0].x + ‘\n’ + 'y: ’ + event.touches[0].y + ‘\nComponent globalPos:(’
• event.target.area.globalPosition.x + ‘,’ + event.target.area.globalPosition.y + ‘)\nwidth:’
• event.target.area.width + ‘\nheight:’ + event.target.area.height
  })
  // 第二个 Button 组件，高度为 50，宽度为 200，外边距为 20
  Button(‘Touch’).height(50).width(200).margin(20)
  // 与第一个 Button 组件的触摸事件处理相同
  .onTouch((event: TouchEvent) => {
  if (event.type === TouchType.Down) {
  this.eventType = ‘Down’
  } else if (event.type === TouchType.Up) {
  this.eventType = ‘Up’
  } else if (event.type === TouchType.Move) {
  this.eventType = ‘Move’
  }
  this.text = ‘TouchType:’ + this.eventType + '\nDistance between touch point and touch element:\nx: ’
• event.touches[0].x + ‘\n’ + 'y: ’ + event.touches[0].y + ‘\nComponent globalPos:(’
• event.target.area.globalPosition.x + ‘,’ + event.target.area.globalPosition.y + ‘)\nwidth:’
• event.target.area.width + ‘\nheight:’ + event.target.area.height
  })
  // Text 组件显示 text 状态变量的值，即触摸事件的详细信息
  Text(this.text)
  // 设置 Column 的宽度为 ‘100%’，设置内边距为 30（用于增加布局间距）
  }.width(‘100%’).padding(30)
  } // build 方法结束，表示组件构建完成
  } // TouchExample 结构体定义结束

四、挂载卸载事件

挂载卸载事件指组件从组件树上挂载、卸载时触发的事件。

事件

示例

// 导入ohos的promptAction模块，用于显示提示信息
import promptAction from ‘@ohos.promptAction’;

// 使用@Entry装饰器表示这个组件是整个应用的主入口
// 使用@Component装饰器表示这个组件是Flutter应用的一部分
@Entry
@Component
struct AppearExample {
// 定义一个名为isShow的状态变量，类型为boolean，初始值为true
@State
isShow: boolean = true;

// 定义一个名为changeAppear的状态变量，类型为string，初始值为’点我卸载挂载组件’
@State
changeAppear: string = ‘点我卸载挂载组件’;

// 定义一个私有变量myText，类型为string，初始值为’Text for onAppear’
private myText: string = ‘Text for onAppear’;

// build方法是一个特殊的方法，在Flutter中用于构建和渲染组件
build() {
// 创建一个Column垂直布局容器，用于放置其他组件
Column() {
// 创建一个Button组件，显示changeAppear变量的值
// 当点击这个按钮时，将触发onClick函数，切换isShow的值
Button(this.changeAppear)
.onClick(() => {
this.isShow = !this.isShow;
})
.margin(15); // 设置按钮的外边距为15
// 如果isShow为true，即显示下面的Text组件
if (this.isShow) {
// 创建一个Text组件，显示myText变量的值，字体大小为26，加粗
Text(this.myText).fontSize(26).fontWeight(FontWeight.Bold)
// 当这个Text组件首次显示时，触发onAppear函数，显示提示信息’The text is shown’
.onAppear(() => {
promptAction.showToast({
message: ‘The text is shown’,
duration: 2000 // 提示信息的显示时间为2000毫秒（2秒）
});
})
// 当这个Text组件被隐藏时，触发onDisAppear函数，显示提示信息’The text is hidden’
.onDisAppear(() => {
promptAction.showToast({
message: ‘The text is hidden’,
duration: 2000 // 提示信息的显示时间为2000毫秒（2秒）
});
});
} // if条件结束
} // Column组件结束
// 设置padding为30，设置宽度为100%，即占据整个屏幕宽度
.padding(30).width(‘100%’);
} // build方法结束，表示组件构建完成
} // AppearExample结构体定义结束

五、拖拽事件

拖拽事件指组件被长按后拖拽时触发的事件。

事件

DragItemInfo说明

extraParams说明

用于返回组件在拖拽中需要用到的额外信息。

extraParams是Json对象转换的string字符串，可以通过Json.parse转换的Json对象获取如下属性。

DragEvent说明

示例

// xxx.ets
@Extend(Text) function textStyle () {
.width(‘25%’)
.height(35)
.fontSize(16)
.textAlign(TextAlign.Center)
.backgroundColor(0xAFEEEE)
}

@Entry
@Component
struct DragExample {
@State numbers: string[] = [‘one’, ‘two’, ‘three’, ‘four’, ‘five’, ‘six’]
@State text: string = ‘’
@State bool: boolean = true
@State eventType: string = ‘’
@State appleVisible: Visibility = Visibility.Visible
@State orangeVisible: Visibility = Visibility.Visible
@State bananaVisible: Visibility = Visibility.Visible
private dragList: string[] = [‘apple’, ‘orange’, ‘banana’]
@State fruitVisible: Visibility[] = [Visibility.Visible, Visibility.Visible, Visibility.Visible]
@State idx: number = 0

// 自定义拖拽过程中显示的内容
@Builder pixelMapBuilder() {
Column() {
Text(this.text)
.width(‘50%’)
.height(60)
.fontSize(16)
.borderRadius(10)
.textAlign(TextAlign.Center)
.backgroundColor(Color.Yellow)
}
}

build() {
Column() {
Text(‘There are three Text elements here’)
.fontSize(12)
.fontColor(0xCCCCCC)
.width(‘90%’)
.textAlign(TextAlign.Start)
.margin(5)
Row({ space: 15 }) {
ForEach(this.dragList, (item, index) => {
Text(item)
.textStyle()
.visibility(this.fruitVisible[index])
.onDragStart(() => {
this.bool = true
this.text = item
this.fruitVisible[index] = Visibility.None
return this.pixelMapBuilder
})
.onTouch((event: TouchEvent) => {
if (event.type === TouchType.Down) {
this.eventType = ‘Down’
this.idx = index
}
if (event.type === TouchType.Up) {
this.eventType = ‘Up’
if (this.bool) {
this.fruitVisible[index] = Visibility.Visible
}
}
})
})
}.padding({ top: 10, bottom: 10 }).margin(10)

Text(‘This is a List element’)
.fontSize(12)
.fontColor(0xCCCCCC)
.width(‘90%’)
.textAlign(TextAlign.Start)
.margin(15)
List({ space: 20 }) {
ForEach(this.numbers, (item) => {
ListItem() {
Text(item)
.width(‘100%’)
.height(80)
.fontSize(16)
.borderRadius(10)
.textAlign(TextAlign.Center)
.backgroundColor(0xAFEEEE)
}
}, item => item)
}
.editMode(true)
.height(‘50%’)
.width(‘90%’)
.border({ width: 1 })
.padding(15)
.divider({ strokeWidth: 2, color: 0xFFFFFF, startMargin: 20, endMargin: 20 })
.onDragEnter((event: DragEvent, extraParams: string) => {
console.log('List onDragEnter, ’ + extraParams + ‘X:’ + event.getX() + ‘Y:’ + event.getY())
})
.onDragMove((event: DragEvent, extraParams: string) => {
console.log('List onDragMove, ’ + extraParams + ‘X:’ + event.getX() + ‘Y:’ + event.getY())
})
.onDragLeave((event: DragEvent, extraParams: string) => {
console.log('List onDragLeave, ’ + extraParams + ‘X:’ + event.getX() + ‘Y:’ + event.getY())
})
.onDrop((event: DragEvent, extraParams: string) => {
let jsonString = JSON.parse(extraParams);
if (this.bool) {
// 通过splice方法插入元素
this.numbers.splice(jsonString.insertIndex, 0, this.text)
this.bool = false
}
this.fruitVisible[this.idx] = Visibility.None
})
}.width(‘100%’).height(‘100%’).padding({ top: 20 }).margin({ top: 20 })
}
}

六、按键事件

按键事件指组件与键盘、遥控器等按键设备交互时触发的事件，适用于所有可获焦组件，例如Button。对于Text，Image等默认不可获焦的组件，可以设置focusable属性为true后使用按键事件。

事件

KeyEvent对象说明

示例

@Entry
@Component
struct KeyEventExample {
// 定义一个名为text的状态变量，类型为string，初始值为空字符串
@State
text: string = ‘’;

// 定义一个名为eventType的状态变量，类型为string，初始值为空字符串
@State
eventType: string = ‘’;

// build方法是一个特殊的方法，在Flutter中用于构建和渲染组件
build() {
// 创建一个Column垂直布局容器，用于放置其他组件
Column() {
// 创建一个Button组件，显示文字“KeyEvent”
Button(‘KeyEvent’)
// 当这个按钮接收到键盘事件时，触发onKeyEvent函数
.onKeyEvent((event: KeyEvent) => {
// 如果事件类型是按下（Down）
if (event.type === KeyType.Down) {
// 将eventType设置为’Down’
this.eventType = ‘Down’;
}
// 如果事件类型是释放（Up）
if (event.type === KeyType.Up) {
// 将eventType设置为’Up’
this.eventType = ‘Up’;
}
// 更新text的值，显示按键的类型、键码和键文
this.text = ‘KeyType:’ + this.eventType + ‘\nkeyCode:’ + event.keyCode + ‘\nkeyText:’ + event.keyText;
})
// 创建一个Text组件，显示text的值，并设置内边距为15像素
Text(this.text).padding(15)
// 设置Column的高度为300像素，宽度为100%，即全屏宽度，并设置外边距为35像素
}.height(300).width(‘100%’).padding(35);
}
}

七、焦点事件

焦点事件指页面焦点在可获焦组件间移动时触发的事件，组件可使用焦点事件来处理相关逻辑。

• 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
• 目前仅支持通过外接键盘的tab键、方向键触发。
• 存在默认交互逻辑的组件例如Button、TextInput等，默认即为可获焦，Text、Image等组件则默认状态为不可获焦，不可获焦状态下，无法触发焦点事件，需要设置focusable属性为true才可触发。

事件

示例

@Entry
@Component
struct FocusEventExample {
// 定义三个状态变量，分别表示三个按钮的颜色
@State
oneButtonColor: string = ‘#FFC0CB’;

@State
twoButtonColor: string = ‘#87CEFA’;

@State
threeButtonColor: string = ‘#90EE90’;

build() {
// 创建一个Column垂直布局容器，并设置外边距为20像素
Column({ space: 20 }) {
// 创建一个名为“First Button”的按钮，设置背景颜色为oneButtonColor，宽度为260像素，高度为70像素，字体颜色为黑色，可获取焦点
Button(‘First Button’)
.backgroundColor(this.oneButtonColor)
.width(260)
.height(70)
.fontColor(Color.Black)
.focusable(true)
// 当按钮获得焦点时，将oneButtonColor设置为红色
.onFocus(() => {
this.oneButtonColor = ‘#FF0000’;
})
// 当按钮失去焦点时，将oneButtonColor设置回原来的颜色（#FFC0CB）
.onBlur(() => {
this.oneButtonColor = ‘#FFC0CB’;
});
// 创建一个名为“Second Button”的按钮，设置背景颜色为twoButtonColor，宽度为260像素，高度为70像素，字体颜色为黑色，可获取焦点
Button(‘Second Button’)
.backgroundColor(this.twoButtonColor)
.width(260)
.height(70)
.fontColor(Color.Black)
.focusable(true)
// 当按钮获得焦点时，将twoButtonColor设置为红色
.onFocus(() => {
this.twoButtonColor = ‘#FF0000’;
})
// 当按钮失去焦点时，将twoButtonColor设置回原来的颜色（#87CEFA）
.onBlur(() => {
this.twoButtonColor = ‘#87CEFA’;
});
// 创建一个名为“Third Button”的按钮，设置背景颜色为threeButtonColor，宽度为260像素，高度为70像素，字体颜色为黑色，可获取焦点
Button(‘Third Button’)
.backgroundColor(this.threeButtonColor)
.width(260)
.height(70)
.fontColor(Color.Black)
.focusable(true)
// 当按钮获得焦点时，将threeButtonColor设置为红色
.onFocus(() => {
this.threeButtonColor = ‘#FF0000’;
})
// 当按钮失去焦点时，将threeButtonColor设置回原来的颜色（#90EE90）
.onBlur(() => {
this.threeButtonColor = ‘#90EE90’;
});
}
}
}

八、鼠标事件

在鼠标的单个动作触发多个事件时，事件的顺序是固定的，鼠标事件默认透传。

• 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
• 目前仅支持通过外接鼠标触发。

事件

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip204888 （备注鸿蒙）

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

lur(() => {
this.threeButtonColor = ‘#90EE90’;
});
}
}
}

八、鼠标事件

在鼠标的单个动作触发多个事件时，事件的顺序是固定的，鼠标事件默认透传。

• 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
• 目前仅支持通过外接鼠标触发。

事件

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip204888 （备注鸿蒙）
[外链图片转存中…(img-GVk5SXiG-1713589901018)]

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

本文标签： 鸿蒙 事件 基础 HarmonyOS onappear