名称 | 类型 | 说明 |
|---|---|---|
position | 目标元素左上角在以父元素为基准的组件坐标系中的位置。 | |
globalPosition | Position | 目标元素左上角在当前窗口坐标系中的位置。 |
import { window } from '@kit.ArkUI';
interface T {
x: string,
y: string
}
@Entry
@Component
struct AreaExample {
@State sizeValue: string = '';
@State pos: T | undefined = undefined;
@State statusBarHeight: number = 0;
aboutToAppear(): void {
let type1 = window.AvoidAreaType.TYPE_SYSTEM;
window.getLastWindow(this.getUIContext().getHostContext())
.then((data) => {
// 获取系统默认区域,一般包括状态栏、导航栏
let avoidArea1 = data.getWindowAvoidArea(type1);
// 顶部状态栏高度
this.statusBarHeight = avoidArea1.topRect.height;
});
}
build() {
Column() {
Row() {
Text('目标组件')
.fontSize(20)
.fontWeight(FontWeight.Bold)
.onAreaChange((oldValue: Area, newValue: Area) => {
this.sizeValue = `${Number(newValue.globalPosition.y).toFixed()}vp。`;
this.pos = {
x: Number(newValue.position.x).toFixed(),
y: Number(newValue.position.y).toFixed()
};
console.info(oldValue.width.toString());
});
}
.width('calc(100% - 32vp)')
.height(200)
.backgroundColor('#f1f3f5')
.margin({
left: 16,
right: 16
})
.alignItems(VerticalAlign.Center)
.justifyContent(FlexAlign.Center);
Column() {
Text(`通过getLastWindow获取顶部状态栏高度:${this.getUIContext().px2vp(this.statusBarHeight).toFixed()}vp。`)
.width('100%');
Divider().height(22).color('#182431').opacity(0.6);
Text(`通过onAreaChange获取目标组件距离屏幕顶部的距离:${this.sizeValue}`).width('100%');
Text(`通过onAreaChange获取目标组件距离父元素的位置:${JSON.stringify(this.pos)}。`).width('100%');
}
.margin({ top: 30, left: 16, right: 16});
}
.width('100%').height('100%');
}
} 示例实现效果图如下:

名称 | 类型 | 说明 |
|---|---|---|
localOffset | 组件相对于父组件信息。 | |
screenOffset | Offset | 组件相对于屏幕信息。 |
@Entry
@Component
struct AreaExample2 {
@State localOffset: string = '';
@State screenOffset: string = '';
aboutToAppear(): void {
this.init();
}
// 初始化方法:获取初始位置
init() {
// 绑定指定组件,返回对应的监听句柄
let observer = this.getUIContext().getUIInspector().createComponentObserver('target');
// 通过句柄向对应的查询条件注册回调,当组件布局完成时会触发该回调。type:必须填写字符串'layout'或'draw'。layout:组件布局完成。draw:组件绘制送显完成。
observer.on('layout', () => {
let node = this.getUIContext().getComponentUtils().getRectangleById('target');
if (node) {
this.localOffset = JSON.stringify(node.localOffset);
this.screenOffset = JSON.stringify(node.screenOffset);
}
// 通过句柄向对应的查询条件取消注册回调,当组件布局完成时不再触发指定的回调。
observer.off('layout');
});
}
build() {
Column() {
Row() {
Text('目标组件')
.fontSize(20)
.fontWeight(FontWeight.Bold)
.key('target');
}
.width('calc(100% - 32vp)')
.height(200)
.backgroundColor('#f1f3f5')
.margin({
left: 16,
right: 16
})
.alignItems(VerticalAlign.Center)
.justifyContent(FlexAlign.Center);
Column() {
Text(`通过getRectangleById获取目标组件相对于屏幕信息:${this.screenOffset}。`).width('100%');
Text(`通过getRectangleById获取目标组件距离父元素的位置:${this.localOffset}。`).width('100%');
}
.margin({ top: 30, left: 16, right: 16});
}
.width('100%').height('100%');
}
} 示例实现效果图如下:
