> 文档中心 > HarmonyOS应用开发:响应式布局-媒体查询

HarmonyOS应用开发:响应式布局-媒体查询

一、导入模块

import mediaquery from '@ohos.mediaquery'

二、设置媒体查询条件,并保存返回的条件监听句柄

listener = mediaquery.matchMediaSync('(orientation: landscape)')

三、通过条件监听句柄listener去注册回调函数

onPortrait(mediaQueryResult) {    if (mediaQueryResult.matches) { // do something here    } else { // do something here    }}listener.on('change', onPortrait)

媒体类型(media-type)

类型 说明
screen 按屏幕相关参数进行媒体查询。

媒体查询条件语法规则

[media-type] [and|not|only] [(media-feature)]

媒体逻辑操作

and、or、not、only用于构成复杂媒体查询,也可以通过comma(,)将其组合起来

在MediaQuery Level 4中引入了范围查询,使其能够使用max-,min-的同时,也支持了=,操作符。

类型 说明
<= 小于等于,例如:screen and (50 <= height)。
>= 大于等于,例如:screen and (600 >= height)。
< 小于,例如:screen and (50 < height)。
> 大于,例如:screen and (600 > height)。

媒体特征(media-feature)

 

类型 说明
height 应用页面显示区域的高度。
min-height 应用页面显示区域的最小高度。
max-height 应用页面显示区域的最大高度。
width 应用页面显示区域的宽度。
min-width 应用页面显示区域的最小宽度。
max-width 应用页面显示区域的最大宽度。
resolution 设备的分辨率,支持dpi,dppx和dpcm单位。其中:
- dpi表示每英寸中物理像素个数,1dpi≈0.39dpcm;
- dpcm表示每厘米上的物理像素个数,1dpcm ≈ 2.54dpi;
- dppx表示每个px中的物理像素数(此单位按96px=1英寸为基准,与页面中的px单位计算方式不同),1dppx = 96dpi。
min-resolution 设备的最小分辨率。
max-resolution 设备的最大分辨率。
orientation 屏幕的方向。
可选值:
- orientation: portrait(设备竖屏)
- orientation: landscape(设备横屏)
device-height 设备的高度。
min-device-height 设备的最小高度。
max-device-height 设备的最大高度。
device-width 设备的宽度。
min-device-width 设备的最小宽度。
max-device-width 设备的最大宽度。
round-screen 屏幕类型,圆形屏幕为true, 非圆形屏幕为 false。
dark-mode 系统为深色模式时为true,否则为false。

场景示例

通过使用媒体查询实现当屏幕发生横竖屏切换,给页面文本应用不同的内容和样式。

import mediaquery from '@ohos.mediaquery'let portraitFunc = null@Entry@Componentstruct MediaQueryExample {  @State color: string = '#DB7093'  @State text: string = 'Portrait'  @State fontSize: number = 24  listener = mediaquery.matchMediaSync('(orientation: landscape)')  onPortrait(mediaQueryResult) {    if (mediaQueryResult.matches) {      this.color = '#FFD700'      this.text = 'Landscape'    } else {      this.color = '#DB7093'      this.text = 'Portrait'    }  }  aboutToAppear() {    portraitFunc = this.onPortrait.bind(this) // 绑定当前应用实例    this.listener.on('change', portraitFunc)  }  build() {    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {      Text(this.text).fontSize(50).fontColor(this.color)    }    .width('100%').height('100%')  }}