媒體查詢

說(shuō)明： 從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。** **：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導(dǎo)入模塊

import mediaquery from '@ohos.mediaquery'

權(quán)限

無(wú)

mediaquery.matchMediaSync

matchMediaSync(condition: string): MediaQueryListener

設(shè)置媒體查詢的查詢條件，并返回對(duì)應(yīng)的監(jiān)聽句柄。

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
condition	string	是	媒體事件的匹配條件，具體可參考[媒體查詢語(yǔ)法規(guī)則]。

返回值：

類型	說(shuō)明
MediaQueryListener	媒體事件監(jiān)聽句柄，用于注冊(cè)和去注冊(cè)監(jiān)聽回調(diào)。

示例：

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

MediaQueryListener

媒體查詢的句柄，并包含了申請(qǐng)句柄時(shí)的首次查詢結(jié)果。

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

屬性

名稱	參數(shù)類型	可讀	可寫	說(shuō)明
matches	boolean	是	否	是否符合匹配條件。
media	string	是	否	媒體事件的匹配條件。

on

on(type: 'change', callback: Callback): void

通過(guò)句柄向?qū)?yīng)的查詢條件注冊(cè)回調(diào)，當(dāng)媒體屬性發(fā)生變更時(shí)會(huì)觸發(fā)該回調(diào)。

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
type	string	是	必須填寫字符串'change'。
callback	Callback	是	向媒體查詢注冊(cè)的回調(diào)

off

off(type: 'change', callback?: Callback): void

通過(guò)句柄向?qū)?yīng)的查詢條件去注冊(cè)回調(diào)，當(dāng)媒體屬性發(fā)生變更時(shí)不在觸發(fā)指定的回調(diào)。

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
type	boolean	是	必須填寫字符串'change'。
callback	Callback	否	需要去注冊(cè)的回調(diào)，如果參數(shù)缺省則去注冊(cè)該句柄下所有的回調(diào)。

示例：

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) // 注冊(cè)回調(diào)
  listener.off('change', onPortrait) // 去注冊(cè)回調(diào)

MediaQueryResult

屬性

名稱	參數(shù)類型	可讀	可寫	說(shuō)明
matches	boolean	是	否	是否符合匹配條件。
media	string	是	否	媒體事件的匹配條件。`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

搜狗高速瀏覽器截圖20240326151450.png

示例

import mediaquery from '@ohos.mediaquery'

let portraitFunc = null

@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() {
    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%')
  }
}

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問(wèn)題，請(qǐng)聯(lián)系本站處理。舉報(bào)投訴