【转】自定义ListView FastScroller滑块图片

关注

转载最新推荐文章于 2026-01-09 06:53:55 发布 6.5k 阅读 AI 写同款· GEO 优化 ›

Android ListView 快速滚动滑块自定义全解析：从反射实现到官方兼容方案本文探讨了Android开发中ListView快速滚动滑块的自定义实现方法。首先分析了默认滑块仅在长列表显示的局限性，提出通过自定义增强视觉一致性。重点对比了两种方案：早期使用反射修改mThumbDrawable（仅适用于API18及以下），以及推荐使用Android5.0+官方样式属性安全定制。文章详细介绍了XML样式定义、主题配置方法，并强调多版本兼容测试的重要性。最后建议开发者优先采用官方方案，在保证稳定性的同时优化用户体验，避免过度定制影响可用性。阅读详情

自定义ListView FastScroller滑块图片

使用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);
}

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

属性名称	描述
android:background	设置背景色/背景图片。可以通过以下两种方法设置背景为透明：”@android:color/transparent”和”@null”。注意TextView默认是透明的，不用写此属性，但是Buttom/ImageButton/ImageView想透明的话就得写这个属性了。
android:clickable	是否响应点击事件。
android:contentDescription	设置View的备注说明，作为一种辅助功能提供，为一些没有文字描述的View提供说明，如ImageButton。这里在界面上不会有效果，自己在程序中控制，可临时放一点字符串数据。
android:drawingCacheQuality	设置绘图时半透明质量。有以下值可设置：auto（默认，由框架决定）/high（高质量，使用较高的颜色深度，消耗更多的内存）/low（低质量，使用较低的颜色深度，但是用更少的内存）。
android:duplicateParentState	如果设置此属性，将直接从父容器中获取绘图状态（光标，按下等）。见下面代码部分，注意根据目前测试情况仅仅是获取绘图状态，而没有获取事件，也就是你点一下LinearLayout时Button有被点击的效果，但是不执行点击事件。
android:fadingEdge	设置拉滚动条时，边框渐变的放向。none（边框颜色不变），horizontal（水平方向颜色变淡），vertical（垂直方向颜色变淡）。参照fadingEdgeLength的效果图
android:fadingEdgeLength	设置边框渐变的长度。
android:fitsSystemWindows	设置布局调整时是否考虑系统窗口（如状态栏）
android:focusable	设置是否获得焦点。若有requestFocus()被调用时，后者优先处理。注意在表单中想设置某一个如EditText获取焦点，光设置这个是不行的，需要将这个EditText前面的focusable都设置为false才行。在Touch模式下获取焦点需要设置focusableInTouchMode为true。
android:focusableInTouchMode	设置在Touch模式下View是否能取得焦点。
android:hapticFeedbackEnabled	设置长按时是否接受其他触摸反馈事件。这里模拟器没有试出效果，难道是多点触摸？找不到资料可以找找performHapticFeedback或HapticFeedback这个关键字的资料看看。
android:id	给当前View设置一个在当前layout.xml中的唯一编号，可以通过调用View.findViewById() 或Activity.findViewById()根据这个编号查找到对应的View。不同的layout.xml之间定义相同的id不会冲突。格式如”@+id/btnName”
android:isScrollContainer	设置当前View为滚动容器。这里没有测试出效果来，ListView/ GridView/ ScrollView根本就不用设置这个属性，而EdidText设置android:scrollbars也能出滚动条。
android:keepScreenOn	View在可见的情况下是否保持唤醒状态。常在LinearLayout使用该属性，但是模拟器这里没有效果。
android:longClickable	设置是否响应长按事件.
android:minHeight	设置视图最小高度
android:minWidth	设置视图最小宽度度
android:nextFocusDown	设置下方指定视图获得下一个焦点。焦点移动是基于一个在给定方向查找最近邻居的算法。如果指定视图不存在，移动焦点时将报运行时错误。可以设置imeOptions= actionDone，这样输入完即跳到下一个焦点。
android:nextFocusLeft	设置左边指定视图获得下一个焦点。
android:nextFocusRight	设置右边指定视图获得下一个焦点。
android:nextFocusUp	设置上方指定视图获得下一个焦点。
android:onClick	点击时从上下文中调用指定的方法。这里指定一个方法名称，一般在Activity定义符合如下参数和返回值的函数并将方法名字符串指定为该值即可： public void onClickButton(View view) android:onClick=” onClickButton”
android:padding	设置上下左右的边距，以像素为单位填充空白。
android:paddingBottom	设置底部的边距，以像素为单位填充空白。
android:paddingLeft	设置左边的边距，以像素为单位填充空白。
android:paddingRight	设置右边的边距，以像素为单位填充空白。.
android:paddingTop	设置上方的边距，以像素为单位填充空白。
android:saveEnabled	设置是否在窗口冻结时（如旋转屏幕）保存View的数据，默认为true，但是前提是你需要设置id才能自动保存，参见这里。
android:scrollX	以像素为单位设置水平方向滚动的的偏移值，在GridView中可看的这个效果。
android:scrollY	以像素为单位设置垂直方向滚动的的偏移值
android:scrollbarAlwaysDrawHorizontalTrack	设置是否始终显示垂直滚动条。这里用ScrollView、ListView测试均没有效果。
android:scrollbarAlwaysDrawVerticalTrack	设置是否始终显示垂直滚动条。这里用ScrollView、ListView测试均没有效果。
android:scrollbarDefaultDelayBeforeFade	设置N毫秒后开始淡化，以毫秒为单位。
android:scrollbarFadeDuration	设置滚动条淡出效果（从有到慢慢的变淡直至消失）时间，以毫秒为单位。Android2.2中滚动条滚动完之后会消失，再滚动又会出来，在1.5、1.6版本里面会一直显示着。
android:scrollbarSize	设置滚动条的宽度。
android:scrollbarStyle	设置滚动条的风格和位置。设置值：insideOverlay、insideInset、outsideOverlay、outsideInset。这里没有试出太多效果，以下依次是outsideOverlay与outsideInset效果截图比较：
android:scrollbarThumbHorizontal	设置水平滚动条的drawable（如颜色）。
android:scrollbarThumbVertical	设置垂直滚动条的drawable（如颜色）.
android:scrollbarTrackHorizontal	设置水平滚动条背景（轨迹）的色drawable（如颜色）
android:scrollbarTrackVertical	设置垂直滚动条背景（轨迹）的drawable注意直接设置颜色值如”android:color/white”将得出很难看的效果，甚至都不理解这个属性了，这里可以参见ApiDemos里res/drawable/ scrollbar_vertical_thumb.xml和scrollbar_vertical_track.xml，设置代码为：android:scrollbarTrackVertical ="@drawable/scrollbar_vertical_track"
android:scrollbars	设置滚动条显示。none（隐藏），horizontal（水平），vertical（垂直）。见下列代码演示使用该属性让EditText内有滚动条。但是其他容器如LinearLayout设置了但是没有效果。
android:soundEffectsEnabled	设置点击或触摸时是否有声音效果
android:tag	设置一个文本标签。可以通过View.getTag()或 for with View.findViewWithTag()检索含有该标签字符串的View。但一般最好通过ID来查询View，因为它的速度更快，并且允许编译时类型检查。
android:visibility	设置是否显示View。设置值：visible（默认值