鴻蒙開發(fā)UI界面——@ohos.mediaquery (媒體查詢)

導入模塊

import mediaquery from '@ohos.mediaquery'

mediaquery.matchMediaSync

matchMediaSync(condition: string): MediaQueryListener

設置媒體查詢的查詢條件，并返回對應的監(jiān)聽句柄。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

參數(shù)：

返回值：

示例：

let listener = mediaquery.matchMediaSync(‘(orientation: landscape)’); //監(jiān)聽橫屏事件

MediaQueryListener

媒體查詢的句柄，并包含了申請句柄時的首次查詢結果。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

屬性

on

on(type: ‘change’, callback: Callback): void

通過句柄向對應的查詢條件注冊回調，當媒體屬性發(fā)生變更時會觸發(fā)該回調。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

參數(shù)：

示例：

詳見off示例。

off

off(type: ‘change’, callback?: Callback): void

通過句柄向對應的查詢條件取消注冊回調，當媒體屬性發(fā)生變更時不在觸發(fā)指定的回調。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

示例：

import mediaquery from '@ohos.mediaquery'
  
  let listener = mediaquery.matchMediaSync('(orientation: landscape)'); //監(jiān)聽橫屏事件
  function onPortrait(mediaQueryResult) {
      if (mediaQueryResult.matches) {
          // do something here
      } else {
          // do something here
      }
  }
  listener.on('change', onPortrait) // 注冊回調
  listener.off('change', onPortrait) // 取消注冊回調

MediaQueryResult

用于執(zhí)行媒體查詢操作。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

屬性

示例

import mediaquery from '@ohos.mediaquery'


@Entry
@Component
struct MediaQueryExample {
  @State color: string = '#DB7093'
  @State text: string = 'Portrait'
  listener = mediaquery.matchMediaSync('(orientation: landscape)')

  onPortrait(mediaQueryResult) {
    if (mediaQueryResult.matches) {
      this.color = '#FFD700'
      this.text = 'Landscape'
    } else {
      this.color = '#DB7093'
      this.text = 'Portrait'
    }
  }

  aboutToAppear() {
    let portraitFunc = this.onPortrait.bind(this) // bind current js instance
    this.listener.on('change', portraitFunc)
  }

  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Text(this.text).fontSize(24).fontColor(this.color)
    }
    .width('100%').height('100%')
  }
}


審核編輯 黃宇

HT