uni-app怎么使用vw和vh进行布局

千磊小哥_1776

千磊小哥_1776

2026-11-06

223人浏览

原创

vw/vh在uni-app中仅H5端原生支持,需正确配置viewport;小程序等平台不支持,须用rpx或动态计算降级适配,且需按平台条件切换样式。

uni-app怎么使用vw和vh进行布局

vw 和 vh 在 uni-app 中可以直接用,但必须搭配 viewport 正确配置,否则在小程序端会失效或表现异常。

uni-app 中 vw/vh 的生效前提

uni-app 的 H5 端默认支持 vw/vh,但微信小程序、App(vue 页面)、快应用等平台不原生支持 CSS 视口单位——它们的渲染引擎(WebView 或小程序视图层)不解析 100vw 这类值,会直接当无效样式丢弃。

  • ✅ H5 端:只要 设置合理(如 width=device-width, initial-scale=1.0),vw/vh 可直接使用
  • ❌ 微信小程序:编译后会被忽略,width: 100vw 等同于没写
  • ⚠️ App 端(vue 页面):部分 Android WebView 版本支持有限,iOS WKWebView 支持较好,但仍有兼容性波动

所以不能“写了就跑”,得先确认目标平台是否真能识别。

如何让 vw/vh 在多端真正可用

核心思路是:H5 用原生 vw/vh,非 H5 平台降级为 rpx 或动态计算。uni-app 不提供自动转换,需手动处理。

  • 用 uni.getSystemInfoSync().platform 判断当前平台,在 style 或 class 上做条件切换
  • 在 pages.json 的 h5 > css 配置中启用 postcss-px-to-viewport 插件,把设计稿 px 转成 vw(仅对 H5 生效)
  • 避免在 scoped 样式里混用 vw 和 rpx,容易因编译顺序导致单位被错误覆盖
  • 慎用 vh 做全屏高度:微信小程序中 100vh ≠ 屏幕可视区高(常被导航栏/状态栏截断),建议用 100% + flex 布局替代

示例:适配 H5 和小程序的宽度声明

uni-app
uni-app

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

下载
<view :class="{ 'h5-full': isH5, 'mp-full': !isH5 }"></view><style>
.h5-full { width: 100vw; }
.mp-full { width: 750rpx; }
</style><script>
export default {
  data() {
    return {
      isH5: uni.getSystemInfoSync().platform === 'h5'
    }
  }
}
</script>

vw/vh 与 rpx 的关键区别和选型建议

rpx 是 uni-app 自研单位,以 750px 设计稿宽度为基准;vw 是 CSS 标准单位,以当前设备可视区宽度为 100%。二者逻辑不同,不能混用或简单换算。

  • 100rpx = (屏幕宽度 / 750) * 100px,只跟宽度有关,且固定按 750 基准缩放
  • 100vw = 屏幕可视区宽度的 100%,跟设备实际 window.innerWidth 绑定,横竖屏切换时自动响应
  • 做横竖屏适配时,vmin/vmax 比 rpx 更可靠(例如 width: 90vmin 表示取宽高中较小值的 90%)
  • 字体大小慎用 vw:小屏下易过小,推荐用 rem + 动态根字体或 uView 的 u-text 组件控制最小字号

容易被忽略的坑:viewport 元素缺失与缩放干扰

H5 端若没正确设置 ,vw 会基于错误的视口宽度计算,比如页面被强制缩放后,100vw 可能只有物理宽度的 50%。

  • 确保 manifest.json > h5 > template 中的 HTML 模板包含:
  • 禁用 user-scalable=yes,否则用户双指缩放会破坏 vw 布局比例
  • 不要在 JS 中调用 document.body.style.zoom 或修改 transform: scale(),这会让 vw 值失准
  • 调试时用 Chrome DevTools 的 Device Toolbar 模拟不同设备,注意右上角是否显示 “Responsive” —— 若显示 “Desktop”,vw 仍按桌面视口算,不是移动端效果

真正跨端稳定的布局,往往不是单靠某一个单位,而是根据平台能力分层兜底:H5 用 vw,小程序用 rpx,App(nvue)用 px + flex,再辅以运行时平台判断。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

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

相关专题

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

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

2023.08.11

2843

5

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

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

2023.10.09

6223

6

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

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

2024.03.19

7130

13

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

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

2024.03.22

6958

10

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

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

2024.05.22

983

5

css3教程
css3教程

php中文网为大家提供css3教程合集,CSS3的语法是建立在CSS原先版本基础上的,它允许使用者在标签中指定特定的HTML元素而不必使用多余的class、ID或JavaScript。php中文网还为大家带来css3的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2100

10

有哪些css3渐变属性
有哪些css3渐变属性

css3中渐变属性有linear-gradient、radial-gradient、conic-gradient、repeating-linear-gradient、repeating-radial-gradient等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.01

3386

5

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

0

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

0

12

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习