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

uni-app怎么取消页面的全屏显示设置

小敏君_8224

小敏君_8224

发布时间:2026-10-15 13:06:38

|

413人浏览过

|

来源于php中文网

原创

取消 uni-app 全屏需显式调用 plus.navigator.setFullscreen(false) 并还原系统 UI,App 端必须在 onHide/onUnload 中执行且包裹 #ifdef APP-PLUS;pages.json 中 navigationStyle 需设为 "default",H5 端须配对调用 document.exitFullscreen() 并清除相关样式。

uni-app怎么取消页面的全屏显示设置

取消 uni-app 页面的全屏显示,核心在于「关掉之前设的全屏动作」+「还原被移除的系统 UI 区域」。只改 pages.json 或只调一个 API 都不能真正退出全屏——尤其在 App 端,plus.navigator.setFullscreen(true) 是有状态的,不显式关闭,它就一直生效。

App 端必须调用 plus.navigator.setFullscreen(false)

这是最常被忽略的一环:设置了全屏后,若没在页面离开前还原,其他页面也会被强制全屏(比如从视频页返回首页,首页顶部突然空白)。setFullscreen(false) 不是“可选善后”,而是必要清理动作。

  • 必须放在 onHide 或 onUnload 中调用,不能等到 onDestroy——后者在 App 端可能已不触发
  • 必须包裹 #ifdef APP-PLUS,否则 H5 和小程序会报 plus is not defined
  • 如果之前还调了 plus.navigator.hideSystemNavigation(),这里也得配对调 plus.navigator.showSystemNavigation(),但注意:该方法在小米 HyperOS、OPPO ColorOS 14+ 上已失效,调了也没反应,属于系统限制

pages.json 里别留 navigationStyle: "custom"

这个配置不是“页面级开关”,而是“全局导航栏控制权移交”。一旦设为 "custom",所有未显式覆盖该字段的子页面都会继承——即使你没写,它也默认生效。所以取消全屏,得主动还原。

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • 在目标页面的 style 节点下,明确写 "navigationStyle": "default"(不是删掉这行)
  • 配套把 "app-plus": { "titleNView": false } 改成 true 或直接删掉该字段,否则部分 Android 机型仍会渲染空白 title 区域
  • 如果是在 globalStyle 里全局设的 navigationStyle: "custom",那必须逐页在 pageStyle 中覆盖,不能依赖“不写就默认”

H5 端没有真全屏,只有视觉模拟,退出也靠 DOM 还原

H5 的所谓“全屏”本质是 requestFullscreen() 对某个元素的调用,它受浏览器策略严格限制:必须由用户手势触发、不可自动进入/退出、且只能作用于当前激活的 iframe 或 <body>。uni-app 框架本身不封装这一行为,得自己处理。

  • 如果用了 document.documentElement.requestFullscreen(),退出时必须对应调 document.exitFullscreen()
  • 别指望 screen.orientation.unlock() 能起效——uni-app H5 环境下该 API 多数静默失败或抛 DOMException
  • 页面样式上,记得清除之前加的 padding-top: 0 !important 或 height: 100vh 类样式,否则内容会顶到顶部被截断

最容易踩的坑是:以为改回 pages.json 就完事,结果真机上全屏状态还在;或者 H5 端点了退出按钮却没调 exitFullscreen(),导致地址栏卡死不出现。全屏不是“配置态”,而是“运行时状态”,退出必须靠代码显式归零。

热门AI工具

更多
豆包大模型

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

WorkBuddy

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

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

切问学术

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

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

立刻MV
立刻MV Hot

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

DeepSeek

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

相关专题

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

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

2463

2023.08.11

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

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

5343

2023.10.09

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

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

6370

2024.03.19

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

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

5978

2024.03.22

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

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

843

2024.05.22

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

0

2026.10.16

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

0

2026.10.15

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

0

2026.10.15

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

0

2026.10.15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

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

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