自定义ListView FastScroller滑块图片以及 android:fastScrollEnabled="true" 不起作用

wx1qq1com

墨衍会员 · AI 创作全网分发码龄17年

关注

转载最新推荐文章于 2026-03-05 00:32:53 发布 1w 阅读 AI 写同款· GEO 优化 ›

AI权益加码！Claude Code、Cursor等20+工具免费用！购周边限时加赠Coding Plan Lite，畅享主流AI工具！学习进阶更高效！阅读详情

使用ListView FastScroller，默认滑块和自定义滑块图片的样子：

设置快速滚动属性很容易，只需在布局的xml文件里设置属性即可：

<ListView android:id="@+id/listView" android:layout_width="fill_parent"
android:layout_height="fill_parent" android:fastScrollEnabled="true"
android:focusable="true" />

但是有时候会发现设置属性无效，滚动ListView并未出现滑块。原因是该属性生效有最小记录限制。当ListView记录能够在4屏以内显示（也就是说滚动4页）就不会出现滑块。可能是api设计者认为这么少的记录不需要快速滚动。

我的依据是android源代码，见FastScroller的常量声明：

// Minimum number of pages to justify showing a fast scroll thumb
private static int MIN_PAGES = 4;

以及：

// Are there enough pages to require fast scroll? Recompute only if total count changes
        if (mItemCount != totalItemCount && visibleItemCount > 0) {
            mItemCount = totalItemCount;
            mLongList = mItemCount / visibleItemCount >= MIN_PAGES;
}

通篇查看了ListView及其超累AbsListView，都未找到自定义图片的设置接口。看来是没打算让开发者更改了。但是用户要求我们自定义这个图片。那只能用非常手段了。

经过分析发现，该图片是ListView超类AbsListView的一个成员mFastScroller对象的成员mThumbDrawable。这里mThumbDrawable是Drawable类型的。mFastScroller是FastScroller类型，这个类型比较麻烦，类的声明没有modifier，也就是default（package），只能供包内的类调用。

因此反射代码写的稍微麻烦一些：

try {
    Field f = AbsListView.class.getDeclaredField("mFastScroller");
    f.setAccessible(true);
    Object o=f.get(listView);
    f=f.getType().getDeclaredField("mThumbDrawable");
    f.setAccessible(true);
    Drawable drawable=(Drawable) f.get(o);
    drawable=getResources().getDrawable(R.drawable.icon);
    f.set(o,drawable);
    Toast.makeText(this, f.getType().getName(), 1000).show();
} catch (Exception e) {
    throw new RuntimeException(e);
}

这样就可以改变默认的滑块图片了。

源代码见：