当前位置：首页 > article >正文

鸿蒙开发-一多开发之媒体查询功能

article 2025/3/14 20:20:05

在HarmonyOS中，使用ArkTS语法实现响应式布局的媒体查询是一个强大的功能，它允许开发者根据不同的设备特征（如屏幕尺寸、屏幕方向等）动态地调整UI布局和样式。以下是一个使用媒体查询实现响应式布局的实例：

1. 导入必要的模块

首先，需要导入媒体查询相关的模块。在ArkTS中，这通常是通过import语句来完成的。

typescript复制代码

import { mediaquery } from '@kit.ArkUI';

2. 创建媒体查询监听器

接下来，需要创建媒体查询监听器来监听屏幕尺寸的变化。这可以通过mediaquery.matchMediaSync方法来实现，该方法接受一个条件字符串作为参数，并返回一个MediaQueryListener对象。

@Entry
@Component
struct TestPage {
  listenerXS: mediaquery.MediaQueryListener | null = null;
  listenerSM: mediaquery.MediaQueryListener | null = null;
 
  aboutToAppear(): void {
    // 创建监听器，监听不同的屏幕尺寸范围
    this.listenerXS = mediaquery.matchMediaSync('(0vp <= width < 320vp)');
    this.listenerSM = mediaquery.matchMediaSync('(320vp <= width < 600vp)');
 
    // 注册监听器，当屏幕尺寸变化时执行相应的逻辑
    this.listenerXS.on('change', (res: mediaquery.MediaQueryResult) => {
      console.log('changeRes:', JSON.stringify(res));
      // 执行小屏幕下的布局逻辑
    });
 
    this.listenerSM.on('change', (res: mediaquery.MediaQueryResult) => {
      console.log('changeRes:', JSON.stringify(res));
      // 执行中等屏幕下的布局逻辑
    });
  }
 
  // 移除监听器，避免性能浪费
  aboutToDisappear(): void {
    this.listenerXS?.off('change');
    this.listenerSM?.off('change');
  }
 
  build() {
    // 构建UI结构
    Column() {
      // 在这里根据屏幕尺寸动态调整UI布局
    }
    .height('100%')
  }
}

3. 在UI中使用媒体查询结果

在build方法中，可以根据媒体查询的结果动态地调整UI布局。例如，可以使用条件渲染来根据不同的屏幕尺寸显示不同的组件或样式。

build() {
  return Column() {
    if (/* 条件：判断当前屏幕尺寸是否在小屏幕范围内 */) {
      // 小屏幕下的布局
      Text('小屏幕下的内容')
        .fontSize(24)
        .fontWeight(FontWeight.Bold);
    } else if (/* 条件：判断当前屏幕尺寸是否在中等屏幕范围内 */) {
      // 中等屏幕下的布局
      Text('中等屏幕下的内容')
        .fontSize(32)
        .fontWeight(FontWeight.Normal);
    } else {
      // 大屏幕下的布局
      Text('大屏幕下的内容')
        .fontSize(40)
        .fontWeight(FontWeight.Light);
    }
  }
  .height('100%');
}