fullScreen 压窗屏

所谓压窗屏，是指遮罩能盖住原生导航栏和底部tabbar栏的弹窗，一般用于在APP端弹出升级应用弹框，或者其他需要增强型弹窗的场景。

提示

这里的做法是在本页面打开一个新页面，同时在pages.json中配置本页面的背景为百分百透明，这样即可达到压窗效果。
由于只有APP支持设置页面背景透明度，故只有APP支持本组件做法，非APP端不支持。

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序
√xxxxxx

基本使用

本组件只是提供参考思路和注意事项，因为每个人在弹窗需要实现的逻辑和样式都是不一样的，请参考本文档思路，自行实行相关功能。

首先，我们需要pages.josn中声明一个页面用于弹窗：

  1. // pages.json
  3. "pages": [
  4.     {
  5.         "path": "uview-ui/components/u-full-screen/u-full-screen",
  6.         "style": {
  7.             "navigationStyle": "custom",  // 取消本页面的导航栏
  8.             "app-plus": {
  9.                 "animationType": "fade-in", // 设置fade-in淡入动画，为最合理的动画类型
  10.                 "background": "transparent", // 背景透明
  11.                 "backgroundColor": "rgba(0,0,0,0)", // 背景透明
  12.                 "popGesture": "none" // 关闭IOS屏幕左边滑动关闭当前页面的功能
  13.             }
  14.         }
  15.     }
  16. ]

通过上面的配置，我们得到了一个页面：

  • 这个页面去掉了导航栏
  • 页面进入的时候，是采用淡入动画的形式
  • 并且此页面的背景是百分比透明度，这样可以看到底层页面的内容
  • 移除在iOS上左滑手势，避免本页被左滑关闭

触发压窗屏

我们在父页面(当前页面)通过路由方法，打开一个新页面(上面配置的压窗屏页面)，由于它是一个普通的页面，故可以通过常规方法传递参数。

  1. export default {
  2.     onLoad() {
  3.         // 也可以在onShow生命周期打开，此为uView封装的请求方法
  4.         this.$u.route("/uview-ui/components/u-full-screen/u-full-screen?id=1");
  5.     }
  6. }

定义压窗屏内容

当我们触发(打开)了压窗屏页面之后，将会有一个新的，背景透明的页面覆盖在本页面上，由于我们的终极目标就是要做一个弹窗，让其遮罩盖住”父页面”的导航栏和 Tabbar栏，所以这里我们可以使用uView的Popup 弹出层组件，并且将popup组件的mode参数设置center，即中部弹出的形式。

下方示例为打开一个Modal 模态框组件的示例，此组件内部用的也是popup组件。

  1. <template>
  2.     <u-modal v-model="show" :show-cancel-button="true" confirm-text="升级"
  3.         title="发现新版本" @cancel="cancel" @confirm="confirm"
  4.     >
  5.         <view class="u-update-content">
  6.             <rich-text :nodes="content"></rich-text>
  7.         </view>
  8.     </u-modal>
  9. </template>
  11. <script>
  12.     export default {
  13.         data() {
  14.             return {
  15.                 show: true,
  16.                 // 传递给uni-app"rich-text"组件的内容，可以使用"<br>"进行换行
  17.                 content: `
  18.                     1. 修复badge组件的size参数无效问题<br>
  19.                     2. 新增Modal模态框组件<br>
  20.                     3. 新增压窗屏组件，可以在APP上以弹窗的形式遮盖导航栏和底部tabbar<br>
  21.                     4. 修复键盘组件在微信小程序上遮罩无效的问题
  22.                 `,
  23.             }
  24.         },
  25.         onShow() {
  26.             this.show = true;
  27.         },
  28.         methods: {
  29.             cancel() {
  30.                 this.closeModal();
  31.             },
  32.             confirm() {
  33.                 this.closeModal();
  34.             },
  35.             closeModal() {
  36.                 uni.navigateBack();
  37.             }
  38.         }
  39.     }
  40. </script>
  42. <style scoped lang="scss">
  43.     .u-full-content {
  44.         background-color: #00C777;
  45.     }
  47.     .u-update-content {
  48.         font-size: 26rpx;
  49.         color: $u-content-color;
  50.         line-height: 1.7;
  51.         padding: 30rpx;
  52.     }
  53. </style>

上面有一个需要注意的点，我们打开”压窗”弹窗后，可能需要通过一些按钮来关闭弹窗，这里关闭弹窗的本质意义是关闭弹出的页面(压窗屏弹框)，所以用的是uni-app带的 关闭页面的接口uni.navigateBack()，见上方示例。

注意事项

由于压窗屏其实也是一个普通的页面的，当我们关闭弹窗(顶层页面)，”父页面”(上一个页面)就会显示出来，意味着会进入onShow生命周期，如有相关特定逻辑需要 处理，可关注此处。

由于弹窗打开的实际是一个页面，而不是一个组件，所以我们无法通过props的形式传递参数，有如下方式可以行进两个页面之间的通信：

  • 父页面通过URL参数的形式将参数传递给弹窗
  • 当弹窗内进行某些操作之后，可以通过uni.$emit的方式发送事件，父页面中通过uni.$on的形式接收事件和参数，达到通信的效果
  • 通过Vuex的形式共享变量