tencent cloud

小程序加载 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();


帮助和支持

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

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

文档反馈