FullScreen 全屏引导

17:06

说明

挂载后自动弹出的全屏升级提示，基于 ux-modal 覆盖导航栏与底部 tabbar，用于展示新版本内容。取消与确认都会调用 uni.navigateBack() 返回上一页，适合作为独立页面在版本更新后展示。

兼容性

平台	支持情况
App	✅ 支持
H5	✅ 支持（依赖页面栈）
微信小程序	✅ 支持（依赖页面栈）

示例

基础用法

点击按钮动态挂载组件即自动弹起，标题缺省取组件库本地化默认文案；取消或确认将执行返回上一页。

查看源码

<template>
    <ux-button type="primary" shape="round" text="触发升级弹窗" @click="open" />
    <ux-full-screen v-if="visible" :show="false" content="本次更新优化了启动速度，修复了若干已知问题。" />
</template>

<script setup lang="uts">
const visible = ref(false);

const open = () => {
    visible.value = true;
};
</script>

自定义标题

通过 title 覆盖默认标题，content 展示升级内容。

查看源码

<template>
    <ux-button type="warning" shape="round" text="自定义标题弹窗" @click="open" />
    <ux-full-screen v-if="visible" title="重要更新" content="v1.1.0 新增多主题与暗黑模式支持，优化了大数据量渲染性能。" />
</template>

<script setup lang="uts">
const visible = ref(false);

const open = () => {
    visible.value = true;
};
</script>

API

Props

属性	说明	类型	默认值	版本
customStyle	自定义根节点样式	String	''	-
customClass	自定义根节点样式类	String	''	-
show	是否显示弹窗，默认 false（挂载后自动置为显示）	Boolean	false	-
title	弹窗标题，不传取本地化默认文案	String	''	-
content	升级内容，默认空	String	''	-

Events

ux-full-screen 无事件。

Slots

ux-full-screen 无插槽。

注意事项

1. 组件挂载即自动显示；show 只在初始化时读取，之后修改该属性不会同步弹窗状态，需要重新显示请重新挂载（如用 v-if）。
2. 取消与确认都执行 uni.navigateBack()，不会派发事件；需要区分按钮行为时应在页面层或二次封装中处理。
3. 必须作为独立页面挂载（路由页或 v-if 动态挂载），页面栈为空时 navigateBack() 不会生效。
4. title 不传取本地化 uFullScreen.title，确认按钮文案取 uFullScreen.upgrade；content 为空时只显示标题。
5. H5 / 小程序直接访问该页且没有上一页时，返回操作会失败，进入前应确保存在可返回的页面栈。