SwipeRefreshLayout+WebView：如何实现仅顶部触发下拉刷新？

核心思路 #

重写SwipeRefreshLayout的canChildScrollUp()方法，精准判断WebView（及内部嵌套的iframe等容器）是否处于滚动顶部，仅当确实处于顶部时，才允许触发下拉刷新。

具体实现 #

1. 自定义SwipeRefreshLayout #

创建自定义类继承SwipeRefreshLayout，重写关键方法来控制刷新触发条件：

public class CustomSwipeRefreshLayout extends SwipeRefreshLayout {
    private WebView mWebView;

    public CustomSwipeRefreshLayout(Context context) {
        super(context);
    }

    public CustomSwipeRefreshLayout(Context context, AttributeSet attrs) {
        super(context, attrs);
    }

    // 设置需要关联的WebView
    public void setBindWebView(WebView webView) {
        mWebView = webView;
    }

    @Override
    public boolean canChildScrollUp() {
        if (mWebView == null) {
            return super.canChildScrollUp();
        }

        // 先判断WebView自身的滚动位置
        if (mWebView.getScrollY() > 0) {
            return true;
        }

        // 处理iframe等嵌套容器的滚动判断，通过JS获取页面实际滚动状态
        boolean hasScrolled = false;
        try {
            // 注入JS判断整个页面（含iframe）是否偏离顶部
            String jsCheck = "window.scrollY > 0 || document.documentElement.scrollTop > 0 || document.body.scrollTop > 0";
            hasScrolled = (Boolean) mWebView.evaluateJavascript("(" + jsCheck + ")", null);
        } catch (Exception e) {
            e.printStackTrace();
        }

        // 返回true表示子View可向上滚动，不触发下拉刷新
        return hasScrolled;
    }
}

2. 布局中替换为自定义控件 #

在XML布局里替换原生SwipeRefreshLayout：

<com.your.package.name.CustomSwipeRefreshLayout
    android:id="@+id/swipe_refresh"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <WebView
        android:id="@+id/web_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</com.your.package.name.CustomSwipeRefreshLayout>

3. 代码中关联WebView并配置 #

在Activity/Fragment初始化时完成关联和基础配置：

CustomSwipeRefreshLayout swipeRefresh = findViewById(R.id.swipe_refresh);
WebView webView = findViewById(R.id.web_view);
swipeRefresh.setBindWebView(webView);

// 开启JS支持（处理iframe场景必须开启）
WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true);

补充说明 #

• 若你的页面没有嵌套iframe等子滚动容器，可以省略JS判断部分，仅保留mWebView.getScrollY() > 0的判断即可。
• 若加载第三方不可信页面，可根据实际需求调整JS逻辑，避免潜在安全风险。

内容的提问来源于stack exchange，提问作者Uday Pratap Chauhan