讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app横竖屏切换 uni-app如何设置和监听屏幕旋转

千宇大大_3791

千宇大大_3791

发布时间:2026-03-16 21:47:31

|

430人浏览过

|

来源于php中文网

原创

uni-app横竖屏配置需按平台区分:manifest.json的screenOrientation仅App生效,pages.json的pageOrientation仅小程序和App部分生效,H5需用uni.onWindowResize监听并配合CSS媒体查询。

uni-app横竖屏切换 uni-app如何设置和监听屏幕旋转

manifest.json 和 pages.json 配置不生效?先看平台限制

uni-app 的横竖屏控制不是“写完就通”,不同端走的是完全不同的机制,配置错地方或跨端误用是第一大坑。

  • manifest.json 中的 screenOrientation 只对 App端 生效,H5 和小程序压根不读这个字段
  • pages.json 里的 pageOrientation 是页面级开关,但仅在小程序(如微信)和 App 端部分生效;H5 完全无视它
  • 微信小程序必须 同时 在 pages.json(页面 style)和 manifest.json(mp-weixin.settings.screenOrientation)里声明方向,缺一不可
  • App 端若只配了 manifest.json 却没在 pages.json 指定某页为 landscape,那该页仍可能被系统强制竖屏(尤其 iOS)

plus.screen.lockOrientation 在 H5 或小程序里报错?检查条件编译

这个 API 是 App端 原生能力,其他平台调用会直接抛 undefined is not a function 或静默失败。

  • 必须用 #ifdef APP-PLUS 包裹,否则 H5 构建时会报错,小程序运行时报 plus is not defined
  • 锁定后不 unlockOrientation(),退出页面时方向会被卡住——下次进其他页也可能横着显示
  • 不要在 onLoad 立即锁,加 setTimeout(..., 300) 更稳:iOS 启动动画未结束时锁方向易失效
  • 别用 landscape 这种简写,必须用标准值:landscape-primary(home 键在右)或 landscape-secondary(home 键在左)

监听屏幕旋转总收不到回调?优先用 uni.onWindowResize

uni.onWindowResize 是目前最通用、跨端可用的方向变化监听方式,比监听 orientationchange 或 resize 更可靠。

  • 它返回的是 windowWidth 和 windowHeight,判断逻辑简单:windowWidth > windowHeight ≈ 横屏(注意:不是 100% 等价于设备 orientation,但对 UI 布局足够)
  • H5 端可额外监听 window.addEventListener('resize'),但需手动 off,否则内存泄漏;uni.onWindowResize 的回调必须在 onUnload 里用 uni.offWindowResize 清理
  • 不要依赖 screen.orientation.type —— H5 兼容性差,iOS Safari 不支持,微信小程序也不暴露该对象
  • 监听到变化后,避免直接操作 DOM;推荐用 setData 或响应式变量触发 @media (orientation: landscape) 样式切换

横屏时布局错乱、文字缩成一团?慎用 rpx + 检查 CSS 媒体查询范围

rpx 在横屏下按宽度等比缩放,但高度没变,容易导致“宽高比例崩坏”;而媒体查询若没写全,也会漏掉关键断点。

  • 视频页、图表页等强横屏场景,建议放弃 rpx,改用 vw/vh 或 % + flex 布局
  • @media (orientation: landscape) 只检测设备方向,不保证窗口尺寸;真要适配宽高比,得补上 @media (min-aspect-ratio: 16/9) 这类规则
  • H5 模拟横屏(用 transform: rotate(90deg))时,务必加 overflow: hidden 到 body,否则出现双滚动条或内容溢出
  • App 端横屏后,statusBar 高度逻辑可能错位,需在锁方向后手动调用 plus.navigator.getStatusBarHeight() 重算
实际项目里最常被忽略的,是「离开横屏页后方向没恢复」和「H5 用 transform 旋转却忘了重设 viewport」。这两个点不出问题则已,一出就是整页白屏或交互失灵。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2743

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5963

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6910

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6678

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

943

2024.05.22

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

60

2026.10.28

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

20

2026.10.28

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

40

2026.10.28

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

140

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn