tencent cloud

腾讯云超级应用服务

动态与公告
【2025年1月2日】关于腾讯云小程序平台更名为腾讯云超级应用服务的公告
控制台更新动态
Android SDK 更新动态
iOS SDK 更新动态
Flutter 更新动态
IDE 更新动态
基础库更新动态
产品简介
产品概述
产品优势
应用场景
购买指南
计费概述
按量计费(后付费)
续费指引
停服说明
快速入门
套餐管理
概述
控制台账号管理
存储配置
加速配置
品牌化配置
平台功能
控制台登录
用户和权限体系
小程序管理
小游戏管理
应用管理
商业化
平台管理
用户管理
团队管理
运营管理
安全中心
代码接入指引
Demo 及 SDK 获取
Android
iOS
Flutter
App 服务端接入指南
GUID 生成规则
小程序开发指南
小程序介绍与开发环境
小程序代码组成
指南
框架
组件
API
服务端
JS SDK
基础库
IDE 使用指南
小游戏开发指南
指南
API
服务端
实践教程
小程序登录实践教程
小程序订阅消息实践教程
支付相关实践教程
广告接入实践教程
小游戏订阅消息实践教程
相关协议
数据处理和安全协议

小程序加载 Loading 页

PDF
聚焦模式
字号
最后更新时间: 2025-07-04 17:33:27

定制小程序 Loading 视图

小程序打开过程中有检查更新和启动加载 Loading 动画,这两种 Loading 动画都支持自定义。

1. 定制小程序检查更新 Loading 视图

默认检查更新的 Loading 动画如下图所示:



可以通过重写 AbsMiniUiProxy 的 updateLoadingView 方法实现。
API 描述如下:
说明:
updateLoadingView 方法的返回值是 IMiniLoading 类型的实例。
IMiniLoading的方法说明:
create 创建一个 Loading 视图;
show 展示 Loading 效果时回调;
stop 停止 Loading 效果时回调。
/**
* 自定义小程序检查更新loading页面
* 调用环境:主进程
*
* @param context
* @return
*/
public abstract IMiniLoading updateLoadingView(Context context);
示例代码:
@Override
public IMiniLoading updateLoadingView(Context context) {
return new IMiniLoading() {
@Override
public View create() {
return LayoutInflater.from(context).inflate(R.layout.applet_activity_custom_update_loading, null);
}

@Override
public void show(View v) {

}

@Override
public void stop(View v) {

}
};
}

2.定制小程序加载 Loading 视图


可以通过重写 AbsMiniUiProxy 的 startLoadingView 方法实现。
API 描述如下:
说明:
startLoadingView方法的返回值是IMiniLoading类型的实例。
IMiniLoading的方法说明:
create 创建一个 Loading 视图;
show 展示 Loading 效果时回调;
stop 停止 Loading 效果时回调。
/**
* 自定义小程序加载loading页面
* 调用环境:子进程
*
* @param activityWeakRef Activity引用
* @param app 小程序信息
* @return 返回小程序loading UI
*/
public abstract IMiniLoading startLoadingView(WeakReference<Activity> activityWeakRef, MiniAppLoading app);
示例代码:
@Override
public IMiniLoading startLoadingView(Context context) {
return new IMiniLoading() {
@Override
public View create() {
return LayoutInflater.from(context).inflate(R.layout.applet_activity_custom_start_loading, null);
}

@Override
public void show(View v) {

}

@Override
public void stop(View v) {

}
};
}

3.隐藏 Loading 页面的胶囊按钮

默认小程序加载页面,右上角会有胶囊按钮展示,可以通过重写 AbsMiniUiProxy 的 hideLoadingCapsule 方法控制胶囊按钮的隐藏和显示。
胶囊按钮示意图:

API说明:返回值为 true 表示隐藏 Loading 页面的胶囊按钮,false 表示不隐藏(默认值)。
/**
* 是否隐藏小程序加载loading页面右上角胶囊
*
* @return true:隐藏;false:不隐藏(默认值)
*/
boolean hideLoadingCapsule();


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈