在 android webview 中，可通过结合 webviewclient 与 webchromeclient 实现“首屏渲染即隐藏进度条”，避免因图片、脚本等资源延迟导致进度条长时间显示。
在 android webview 中，可通过结合 webviewclient 与 webchromeclient 实现“首屏渲染即隐藏进度条”，避免因图片、脚本等资源延迟导致进度条长时间显示。
默认情况下，许多开发者仅使用 WebViewClient 的 onPageStarted() 和 onPageFinished() 控制进度条——但这会导致进度条一直显示到所有子资源（如 CSS、JS、图片）完全加载完毕，用户体验滞后。若目标是“页面主文档已加载并开始渲染”（即首屏内容可见），应监听 WebChromeClient 的 onProgressChanged()，并在进度首次达到一个合理阈值（如 10% 或 20%）时隐藏进度条，这通常标志着 HTML 解析与 DOM 构建已启动。
以下为 Kotlin 实现示例：
webView.apply {
// 1. 设置 WebViewClient：处理页面导航与生命周期
webViewClient = object : WebViewClient() {
override fun onPageStarted(view: WebView?, url: String?, favicon: Bitmap?) {
super.onPageStarted(view, url, favicon)
progressBar.visibility = View.VISIBLE
}
// 注意：onPageFinished 不再用于隐藏进度条（避免延迟）
}
// 2. 设置 WebChromeClient：监听加载进度变化
webChromeClient = object : WebChromeClient() {
private var isFirstProgressShown = false
override fun onProgressChanged(view: WebView?, newProgress: Int) {
super.onProgressChanged(view, newProgress)
// 首次进度 > 0（或 ≥10%）即视为“开始加载”，立即隐藏进度条
if (!isFirstProgressShown && newProgress > 0) {
progressBar.visibility = View.GONE
isFirstProgressShown = true
}
}
}
}
⚠️ 注意事项：
-
onProgressChanged()的newProgress值范围为 0–100，newProgress > 0表示 WebView 已接收到首个响应字节（HTTP header 或部分 HTML），此时浏览器已开始解析，用户通常可感知内容加载启动； - 若需更严格的“首屏渲染完成”判断（如
DOMContentLoaded），可注入 JavaScript 监听document.readyState，但会增加复杂度，一般newProgress > 0已满足多数场景； - 务必在
onPageStarted()中重置isFirstProgressShown = false（若需支持多次加载），否则后续页面将无法再次触发隐藏逻辑； - 确保
progressBar是 UI 线程安全的控件（上述代码默认在主线程回调中执行）。
总结：通过 WebChromeClient.onProgressChanged() 捕获初始加载信号，配合状态标记，即可精准实现“首次加载即隐藏进度条”，显著提升 WebView 页面的视觉响应速度与用户体验。
