鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.mediaquery (媒体查询)

鸿蒙5.0版开发:UI界面-@ohos.mediaquery (媒体查询) 提供根据不同媒体类型定义不同的样式。 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


@ohos.mediaquery (媒体查询)

提供根据不同媒体类型定义不同的样式。

说明

从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

该模块不支持在UIAbility的文件声明处使用,即不能在UIAbility的生命周期中调用,需要在创建组件实例后使用。

本模块功能依赖UI的执行上下文,不可在UI上下文不明确的地方使用,参见UIContext说明。

从API version 10开始,可以通过使用UIContext中的getMediaQuery方法获取当前UI上下文关联的MediaQuery对象。

导入模块

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

mediaquery.matchMediaSync

matchMediaSync(condition: string): MediaQueryListener

设置媒体查询的查询条件,并返回对应的监听句柄。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
conditionstring是媒体事件的匹配条件,具体可参考媒体查询语法规则。

返回值:

类型说明
MediaQueryListener媒体事件监听句柄,用于注册和去注册监听回调。

示例:

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

let listener:mediaquery.MediaQueryListener = mediaquery.matchMediaSync('(orientation: landscape)'); //监听横屏事件

MediaQueryListener

媒体查询的句柄,并包含了申请句柄时的首次查询结果。媒体查询根据设置的条件语句,比如'(width <= 600vp)',比较系统信息,若首次查询时相关信息未初始化,matches返回false。

继承自MediaQueryResult。

卡片能力: 从API version 12开始,该类型支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

on('change')

on(type: 'change', callback: Callback<MediaQueryResult>): void

通过句柄向对应的查询条件注册回调,当媒体属性发生变更时会触发该回调。

说明

注册的回调中不允许进一步调用on或off。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
typestring是必须填写字符串'change'。
callbackCallback<MediaQueryResult>是向媒体查询注册的回调

示例:

详见off示例。

off('change')

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

通过句柄向对应的查询条件取消注册回调,当媒体属性发生变更时不再触发指定的回调。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
typestring是必须填写字符串'change'。
callbackCallback<MediaQueryResult>否需要去注册的回调,如果参数缺省则去注册该句柄下所有的回调。

示例:

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

let listener = mediaquery.matchMediaSync('(orientation: landscape)'); //监听横屏事件
function onPortrait(mediaQueryResult:mediaquery.MediaQueryResult) {
if (mediaQueryResult.matches) {
  // do something here
} else {
  // do something here
}
}
listener.on('change', onPortrait) // 注册回调
listener.off('change', onPortrait) // 去取消注册回调

MediaQueryResult

用于执行媒体查询操作。

卡片能力: 从API version 12开始,该类型支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

属性

名称类型可读可写说明
matchesboolean是否是否符合匹配条件。
mediastring是否媒体事件的匹配条件。

示例

说明

推荐通过使用UIContext中的getMediaQuery方法获取当前UI上下文关联的MediaQuery对象。

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

@Entry
@Component
struct MediaQueryExample {
@State color: string = '#DB7093'
@State text: string = 'Portrait'
listener = mediaquery.matchMediaSync('(orientation: landscape)') // 建议使用 this.getUIContext().getMediaQuery().matchMediaSync()接口

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

aboutToAppear() {
let portraitFunc = (mediaQueryResult: mediaquery.MediaQueryResult): void => this.onPortrait(mediaQueryResult)
// 绑定回调函数
this.listener.on('change', portraitFunc);
}

aboutToDisappear() {
// 解绑listener中注册的回调函数
this.listener.off('change');
}

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

鸿蒙Harmony实战开发:JS组件通用媒体查询规范 针对设备和应用的属性信息,可以设计出相匹配的布局样式。 阅读详情

相关推荐

鸿蒙NEXT开发:ArkUI框架UI界面-@ohos.mediaquery (媒体查询)

提供根据不同媒体类型定义不同的样式。

ZPYQAQ的博客 668

鸿蒙:使用媒体查询监听屏幕方向、切换横竖屏

【代码】鸿蒙:使用媒体查询监听屏幕方向、切换横竖屏。

2501_91974903的博客 402

ABB机器人姿态与四元数(笔记)

通常使用机器人作业时,机器人的法兰轴(5轴)往往是垂直与作业平面的,此时需要将机器人的姿态调整(示教)到垂直于工作平面的状态,然后记录当前的姿态,作为之后作业的参考标准姿态。不同机器人表示控件姿态的方式不一样,但也无外乎3中:旋转矩阵、欧拉角和四元数。 ABB机器人使用的是四元数(可转欧拉角)作为机器人控件姿态的表示方式。这里主要是记录在不通过示教的方式下,如何定义四元数,使机器人达到垂直于工作平面的姿态。 5轴竖直向下(常用):此时,各轴角度为 [0,0,0,0,9...

Zythonista的博客 1万+

【鸿蒙next开发】ArkUI框架:UI界面-@ohos.mediaquery (媒体查询)

提供根据不同媒体类型定义不同的样式。

m0_73088370的博客 763

SOLIDWORKS无法获得下列许可 无效的使用许可号码(-8,544,0) 解决办法大全

SOLIDWORKS无法获得下列许可 无效的使用许可号码(-8,544,0) 解决办法大全。版本:SolidWorks2021。电脑:惠普战66四代。软件安装不困难!

qq_43596278的博客 11万+

Vivado 2018.3 安装步骤及 license 获取

本文的主要内容是介绍 Vivado 2018.3 版本的安装步骤及其 license 的获取与加载。

西岸贤 4万+

HarmonyOS实战开发-横竖屏切换

本实例展示如何使用媒体查询,通过@ohos.mediaquery 接口完成在不同设备上显示不同的界面效果。

m0_70749039的博客 1319

快速搭建SpringBoot3+Vue3+ElementPlus管理系统

快速搭建SpringBoot3+Vue3管理系统前端项目搭建(默认开发环境:node20,Jdk17)创建项目并下载依赖--执行以下命令 前端项目搭建(默认开发环境:node20,Jdk17) 创建项目并下载依赖–执行以下命令 创建项目 yarn create vite admin-vue --template 2.下载依赖(也可按需下载) yarn add echarts --save yarn add vue-router --save yarn add element-plus --save y

adingyb的博客 2817

鸿蒙 ArkTS 响应式间距布局实战:MediaQuery 动态赋值 SizedBox/EdgeInsets 完整指南

鸿蒙 ArkTS 响应式间距布局指南 摘要 本文介绍鸿蒙 ArkTS 中实现响应式间距布局的完整方案。通过构建响应式断点系统(XS/SM/MD/LG/XL)和间距等级映射(gapXxs-gapXxl),配合 display.on('change') 监听屏幕变化,实现了类似 Flutter MediaQuery + SizedBox/EdgeInsets 的响应式布局能力。 核心内容包括: 设计响应式断点系统(360/600/840/1200vp 分界点) 创建间距等级映射表,不同断点对应不同间距值 使用

m0_73447796的博客 246

win11重装系统简易教程-小白也可以上手!

本文介绍一下win11系统重装的各个步骤,也作为记录供自己后面查看。附上我之前参考的一位知乎大神写的重装win10系统文章的地址本文用到的工具全部是,不需要下载第三方镜像文件(不是说这个不好,只是第三方的软件或镜像文件网上非常多,琳琅满目,小白需要筛选甄别,直接用官方的就比较省心,大神请自便~)

Sddqa的博客 1万+

5分钟搞定Unity+Visual Studio开发环境配置(含C#游戏开发工作负载)

本文提供了一份详细的Unity与Visual Studio开发环境配置指南,帮助开发者在5分钟内完成C#游戏开发工作负载的设置。从Unity Hub安装到Visual Studio关键组件选择,再到常见问题排查,全面覆盖环境搭建的各个环节,显著提升游戏开发效率。

weixin_29014237的博客 251

Flutter for OpenHarmony 实战:基于HarmonyOS ArkTS API 24堆叠布局实现

使用无状态组件构建堆叠布局,提高性能参数化设计:通过构造函数参数实现组件的灵活配置组合模式:将多个小型组件组合成功能完整的大型组件版本兼容性:确保Flutter、ohos_flutter插件、HarmonyOS SDK版本兼容渐进式适配:从核心功能开始,逐步适配平台特定功能充分测试:在真实鸿蒙设备上进行全面测试性能监控:持续监控应用性能,及时优化。

2301_77888392的博客 324

【考试大纲】中级多媒体应用设计师考试大纲

中级多媒体应用设计师考试大纲

邓邓子的博客 384

HarmonyOS 5.0跨设备开发实战与优化

分布式计算技术通过将任务分解到多个设备协同处理,实现了资源的高效利用与用户体验的无缝衔接。其核心原理在于分布式数据管理、软总线通信和设备虚拟化等技术栈的融合。在移动互联网时代,这种技术能显著降低开发复杂度,提升多端一致性,特别适合智能家居、移动办公等需要跨设备联动的场景。以HarmonyOS 5.0为例,其分布式能力支持一套代码适配手机、平板和PC多终端,通过ArkTS语言和响应式布局实现高效开发。开发者借助DevEco Studio工具链,可快速构建具备实时数据同步、设备自适应UI等特性的应用,实测显示其

weixin_33795806的博客 352

2026.3.9:具身智能之GraspNet:Ubuntu24.04安装GraspNet

本文详细介绍了在Ubuntu24.04系统下安装GraspNet具身智能框架的全过程。主要包括:1) 创建Python3.9虚拟环境;2) 安装CUDA12.8和PyTorch2.7.0等基础依赖;3) 编译安装pointnet2、knn和graspnetAPI三个核心组件;4) 修改源码适配新版PyTorch;5) 下载预训练权重并成功运行demo。安装过程中特别提示了可能遇到的报错处理方案,最终在GPU环境下实现了GraspNet的部署运行。整个流程涵盖了从环境配置到项目运行的完整步骤,为具身智能研究者

拥抱具身智能,昇腾Ascend C 207

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

Flutter画中画功能在鸿蒙系统的适配实践

画中画(Picture-in-Picture)是一种常见的多媒体交互模式,允许应用在后台以小窗口形式继续播放内容。在跨平台开发框架Flutter中,通过平台通道与原生系统交互实现这一功能。本文以pip_ios三方库的鸿蒙系统适配为例,详解如何解决分布式架构下的UI渲染差异、权限管理等技术难点。适配过程中需要处理鸿蒙特有的WindowStage窗口管理机制,实现iOS风格的手势交互,并优化内存管理策略。该方案不仅适用于视频类应用,也可扩展至直播、视频会议等需要多任务处理的场景,为Flutter生态的跨平台能力

dezhen7015的博客 457

文档:亲测可用解决vnc灰屏,黑屏,鼠标大黑叉情况

主要解决vnc-viewer灰屏,黑屏,鼠标大黑叉等现象,详细见文档。

Flutter for OpenHarmony 实战:HarmonyOS ArkTS API 24 图片悬浮放大镜

放大镜组件是一个有状态组件,定义了三个可选参数:图片地址、放大倍数和放大镜半径。这些参数都提供了合理的默认值,使用户可以在不传任何参数的情况下直接使用组件。图片地址默认指向 picsum.photos 的随机图片服务,尺寸为 800x600 像素放大倍数默认为 2.0 倍,即放大镜中的图像是原图的两倍大小放大镜半径默认为 100.0 逻辑像素,即放大镜直径为 200 像素这些参数被声明为final,这是 Flutter 组件的最佳实践。

2301_79516858的博客 391

蓝牙模块HM-10手册

蓝牙模块HM-10手册,该手册对蓝牙模块HM-10进行了详细的介绍和使用方法以及一些AT指令。

Flutter for OpenHarmony 实战:基于HarmonyOS ArkTS API 24聚合多源公开API数据,构建统一数据可视化中心

核心组件Container:用于布局和样式设置Card:卡片式容器,提供阴影和圆角效果:高效的网格布局构建器:水平滚动视图Column:垂直布局Row:水平布局SizedBox:设置固定大小的空白区域SafeArea:避免内容被系统UI遮挡:弹出对话框Icon:图标组件Text:文本组件:手势检测组件应用场景这些基础组件构成了应用的UI骨架,从布局结构到交互元素,都依赖于这些组件的灵活组合。通过合理使用这些组件,构建了美观、响应式的数字资产仪表盘界面。

2301_77888392的博客 417

HarmonyOS ArkTS 实战:实现一个校园疫苗接种与健康管理应用

疫苗接种通知接种时间预约健康状况打卡接种记录查询核酸结果查询校医院预约健康码展示体温上报就医记录健康统计id: number;id: number;实现了疫苗预约、接种记录、健康打卡、体温上报、健康码等功能。掌握了时间线布局、健康数据管理、状态颜色区分等。后续可加入运动计步、睡眠监测、体检报告、心理咨询预约、医保查询等功能。

2301_80781693的博客 214

Flutter for OpenHarmony 实战:HarmonyOS ArkTS API 24 锚点链接平滑滚动

控制滚动行为和监听滚动事件animateTo:实现平滑滚动效果:监听滚动位置变化offset:获取当前滚动偏移量。

xiaoqi922的博客 205

Flutter for OpenHarmony 实战:HarmonyOS ArkTS API 24 图片懒加载

核心图片懒加载组件,实现了智能的图片加载机制:集成图片懒加载的首页,展示了如何在实际应用中使用懒加载组件MyApp:应用入口组件,配置了应用的主题和首页。

xiaoqi922的博客 192

Flutter for OpenHarmony 实战:HarmonyOS ArkTS API 24 步骤条(Stepper)与表单向导功能

项目使用了 controlsBuilder 来自定义控制按钮。默认的 Stepper 控制按钮样式可能不符合设计需求,通过 controlsBuilder 可以完全自定义按钮的外观和布局。一个主按钮,文字根据当前步骤变化:不是最后一步时显示"下一步",最后一步时显示"提交"一个文本按钮,显示"上一步",只有不是第一步时才显示按钮的回调分别调用 details.onStepContinue 和 details.onStepCancel,即 Stepper 自带的回调。

2301_79516858的博客 428

Flutter for OpenHarmony 实战:HarmonyOS ArkTS API 24 滑块和范围滑块组件实现

本项目实现了单值滑块和范围滑块两个可复用组件,深入展示了 Flutter 组件封装的核心技术和最佳实践。在组件设计方面,两个滑块组件都采用了一致的设计模式:外部传入配置参数,内部维护交互状态,通过回调通知数值变化。这种设计使得组件既具有良好的封装性,又保持了足够的灵活性。组件参数设计合理,提供了常用的配置选项(最小值、最大值、初始值、标签、回调),满足大多数使用场景的需求。

2301_79516858的博客 221

鸿蒙原生 ArkTS 布局详解:Column + alignItems(ItemAlign.Start) 垂直排列实战

HarmonyOS NEXT ArkUI 声明式布局实践:Column + alignItems(ItemAlign.Start) 本文深入解析 HarmonyOS NEXT 中 ArkUI 的 Column 容器布局,重点介绍 alignItems(ItemAlign.Start) 模式的使用方法。主要内容包括: 布局体系概述:对比 Column、Row、Stack 三大容器特点,阐明主轴与交叉轴概念 Column 核心属性: alignItems 控制水平对齐(Start/Left、Center、End

Hhuhkt的博客 1270

Flutter for OpenHarmony 实战:HarmonyOS ArkTS API 24 盲盒”图片展示

精致的模糊揭示动画:使用和双动画协同实现了专业级的盲盒揭开效果,模糊度和透明度同步变化,视觉过渡流畅自然。多状态反馈设计:为不同的状态提供了相应的视觉反馈——未揭开时显示点击提示,揭开过程中显示加载指示器,揭开完成后显示清晰图片,用户体验完整连贯。网格布局集成:以网格形式展示多个盲盒,每个盲盒状态独立,用户可以逐个探索,营造出收集和探索的乐趣。可复用组件设计:盲盒图片封装为独立组件,提供丰富的配置参数,可以方便地集成到各种应用场景中。视觉细节完善。

2301_79516858的博客 506

海岸拾贝与海玻璃工坊HarmonyOS ArkTS API 24可以通过 .fontSize()、.backgroundColor()、.borderRadius() 等方法快速配置样式

在移动互联网与智能穿戴设备高度普及的今天,"习惯养成"已经从一个模糊的自我管理理念,演变为一个可量化、可追踪、可视化的数字化产品赛道。越来越多的人希望借助手中的智能终端,把"早起、冥想、阅读、运动"这些抽象的自律行为,转化为一条条清晰的数据曲线和一张张可触摸的打卡卡片。而鸿蒙生态(HarmonyOS)凭借其跨设备协同、分布式软总线以及声明式 UI 开发框架 ArkUI,为这类注重"轻量化交互 + 即时反馈"的生活方式类应用提供了极为理想的生长土壤。本应用正是一款面向"晨间场景"深度打磨的习惯追踪工具。它聚焦

jin421352的博客 216
上一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.measure (文本计算)
下一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.pluginComponent (PluginComponentManager)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值