组件区域变化事件指组件显示的尺寸、位置等发生变化时触发的事件。
说明:
从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
onAreaChange
onAreaChange(event: (oldValue: Area, newValue: Area) => void)
组件区域变化时触发该回调。仅会响应由布局变化所导致的组件大小、位置发生变化时的回调。由绘制变化所导致的渲染属性变化不会响应回调,如translate、offset。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
oldValue | Area | 是 | 返回目标元素变化之前的宽高以及目标元素相对父元素和页面左上角的坐标位置。 |
newValue | Area | 是 | 返回目标元素变化之后的宽高以及目标元素相对父元素和页面左上角的坐标位置。 |
示例
// xxx.ets
@Entry
@Component
struct AreaExample {
@State value: string = 'Text'
@State sizeValue: string = ''
build() {
Column() {
Text(this.value)
.backgro