在 android webview 中，可通过结合 webviewclient 与 webchromeclient 实现“首屏渲染即隐藏进度条”，避免因图片、脚本等资源延迟导致进度条长时间显示。
在 android webview 中，可通过结合 webviewclient 与 webchromeclient 实现“首屏渲染即隐藏进度条”，避免因图片、脚本等资源延迟导致进度条长时间显示。
默认情况下，许多开发者仅使用 WebViewClient 的 onPageStarted() 和 onPageFinished() 控制进度条——但这会导致进度条一直显示到所有子资源（如 CSS、JS、图片）全部加载完毕，用户体验滞后。而真正符合“首屏即响应”体验的做法是：在页面主文档加载完成、首次渲染触发时立即隐藏进度条，这恰好对应 WebChromeClient.onProgressChanged() 中进度达到某个阈值（如 10% 或首次大于 0）的时机。
✅ 正确实现步骤（Kotlin 示例）
webView.apply {
// 1. 设置 WebViewClient：监听页面生命周期
webViewClient = object : WebViewClient() {
override fun onPageStarted(view: WebView?, url: String?, favicon: Bitmap?) {
progressBar.visibility = View.VISIBLE
}
// 注意：此处不依赖 onPageFinished 隐藏进度条！
}
// 2. 设置 WebChromeClient：监听加载进度变化
webChromeClient = object : WebChromeClient() {
private var isFirstProgress = true
override fun onProgressChanged(view: WebView?, newProgress: Int) {
super.onProgressChanged(view, newProgress)
// 方案一：首次进度更新（newProgress > 0）即隐藏（推荐用于“首字节到达即反馈”）
if (isFirstProgress && newProgress > 0) {
progressBar.visibility = View.GONE
isFirstProgress = false
}
// 方案二（备选）：当进度 ≥ 10%，视为首屏关键资源已就绪
// if (isFirstProgress && newProgress >= 10) {
// progressBar.visibility = View.GONE
// isFirstProgress = false
// }
}
}
}
⚠️ 注意事项
-
onProgressChanged()由 Chromium 内核在主线程回调，无需额外线程切换，但应避免执行耗时操作； -
isFirstProgress标志位必须为private成员变量（不可用局部变量），确保状态跨回调持久； -
onPageFinished()仍可用于清理逻辑（如埋点上报、启用交互），但不应再用于控制 UI 显示/隐藏； - 若需兼容旧版 WebView（API onPageStarted() +
onProgressChanged()，避免仅靠onProgressChanged()在极少数机型上首次回调缺失； - 进度条隐藏后，建议保留
WebView的setBackgroundColor(Color.TRANSPARENT)或占位图，防止白屏闪烁。
通过该方案，进度条将在 HTML 主文档解析开始、浏览器触发首次绘制前即消失，显著提升用户感知的加载速度，是现代 Hybrid 应用中推荐的轻量级加载反馈策略。
