viewpager是一个常用的android组件,不过通常我们使用viewpager的时候不能实现左右无限循环滑动,在滑到边界的时候会看到一个不能翻页的动画,可能影响用户体验。此外,某些区域性的viewpager(例如展示广告或者公告之类的viewpager),可能需要自动轮播的效果,即用户在不用滑动的情况下就能够看到其他页面的信息。
为此我查阅了网络上现有的一些关于实现这样效果的例子,但都不是很满意,经过反复实验,在这里总结并分享给大家,希望能有所帮助。
循环滑动效果的实现:pageradapter
我们知道viewpager自带的滑动效果非常出色,因此我们基本不需要处理这个滑动,只处理内容的显示。而内容的显示是由adapter控制的,因此这里重点就是这个adapter了。为简单起见,本例的每个view直接是一张图片。下面是adapter的代码:
private class imageadapter extends pageradapter{
private arraylist<imageview> viewlist;
public imageadapter(arraylist<imageview> viewlist) {
this.viewlist = viewlist;
}
@override
public int getcount() {
//设置成最大,使用户看不到边界
return integer.max_value;
public boolean isviewfromobject(view arg0, object arg1) {
return arg0==arg1;
@override
public void destroyitem(viewgroup container, int position,
object object) {
//warning:不要在这里调用removeview
}
public object instantiateitem(viewgroup container, int position) {
//对viewpager页号求模取出view列表中要显示的项
position %= viewlist.size();
if (position<0){
position = viewlist.size()+position;
}
imageview view = viewlist.get(position);
//如果view已经在之前添加到了一个父组件,则必须先remove,否则会抛出illegalstateexception。
viewparent vp =view.getparent();
if (vp!=null){
viewgroup parent = (viewgroup)vp;
parent.removeview(view);
container.addview(view);
//add listeners here if necessary
return view;
}
这里有几个地方需要注意:
getcount() 方法的返回值:这个值直接关系到viewpager的“边界”,因此当我们把它设置为integer.max_value之后,用户基本就看不到这个边界了(估计滑到这里的时候电池已经挂了吧o_o)。当然,通常情况下设置为100倍实际内容个数也是可以的,之前看的某个实现就是这么干的。
instantiateitem() 方法position的处理:由于我们设置了count为 integer.max_value,因此这个position的取值范围很大很大,但我们实际要显示的内容肯定没这么多(往往只有几项),所以这里肯定会有求模操作。但是,简单的求模会出现问题:考虑用户向左滑的情形,则position可能会出现负值。所以我们需要对负值再处理一次,使其落在正确的区间内。
instantiateitem() 方法父组件的处理:通常我们会直接addview,但这里如果直接这样写,则会抛出illegalstateexception。假设一共有三个view,则当用户滑到第四个的时候就会触发这个异常,原因是我们试图把一个有父组件的view添加到另一个组件。但是,如果直接写成下面这样:
(viewgroup)view.getparent().removeview(view);
则又会因为一开始的时候组件并没有父组件而抛出nullpointerexception。因此,需要进行一次判断。也就是上面的代码。
destroyitem() 方法:由于我们在instantiateitem()方法中已经处理了remove的逻辑,因此这里并不需要处理。实际上,实验表明这里如果加上了remove的调用,则会出现viewpager的内容为空的情况。
轮播效果的实现:使用handler进行更新
这里我定义了一个handler来处理viewpager的轮播。所谓的“轮播”效果实现起来是这样的:每隔一定时间(这里是3秒)切换一次显示的页面。通过控制各页面以一定顺序循环播放,就达到了轮播的效果。为此,我们可以使用handler的sendemptymessagedelayed()方法来实现定时更新,并
注意用户也可能会对带有轮播效果的viewpager手动进行滑动操作,因此我认为用户这时候是希望查看指定页面的,这时候应该取消轮播。下面是这个handler的实现:
private static class imagehandler extends handler{
/**
* 请求更新显示的view。
*/
protected static final int msg_update_image = 1;
* 请求暂停轮播。
protected static final int msg_keep_silent = 2;
* 请求恢复轮播。
protected static final int msg_break_silent = 3;
* 记录最新的页号,当用户手动滑动时需要记录新页号,否则会使轮播的页面出错。
* 例如当前如果在第一页,本来准备播放的是第二页,而这时候用户滑动到了末页,
* 则应该播放的是第一页,如果继续按照原来的第二页播放,则逻辑上有问题。
protected static final int msg_page_changed = 4;
//轮播间隔时间
protected static final long msg_delay = 3000;
//使用弱引用避免handler泄露.这里的泛型参数可以不是activity,也可以是fragment等
private weakreference<mainactivity> weakreference;
private int currentitem = 0;
protected imagehandler(weakreference<mainactivity> wk){
weakreference = wk;
public void handlemessage(message msg) {
super.handlemessage(msg);
log.d(log_tag, "receive message " + msg.what);
mainactivity activity = weakreference.get();
if (activity==null){
//activity已经回收,无需再处理ui了
return ;
}
//检查消息队列并移除未发送的消息,这主要是避免在复杂环境下消息出现重复等问题。
if (activity.handler.hasmessages(msg_update_image)){
activity.handler.removemessages(msg_update_image);
switch (msg.what) {
case msg_update_image:
currentitem++;
activity.viewpager.setcurrentitem(currentitem);
//准备下次播放
activity.handler.sendemptymessagedelayed(msg_update_image, msg_delay);
break;
case msg_keep_silent:
//只要不发送消息就暂停了
case msg_break_silent:
case msg_page_changed:
//记录当前的页号,避免播放的时候页面显示不正确。
currentitem = msg.arg1;
default:
}
集成代码:mainactivity
下面是mainactivity的代码,主要是加载view和对viewpager进行初始化设置。因为代码量比较少,重要的部分已经加了注释,就不赘述了
public class mainactivity extends activity {
private static final string log_tag = "mainactivity";
private imagehandler handler = new imagehandler(new weakreference<mainactivity>(this));
private viewpager viewpager;
@override
protected void oncreate(bundle savedinstancestate) {
super.oncreate(savedinstancestate);
setcontentview(r.layout.activity_main);
//初始化iewpager的内容
viewpager = (viewpager) findviewbyid(r.id.main_viewpager);
layoutinflater inflater = layoutinflater.from(this);
imageview view1 = (imageview) inflater.inflate(r.layout.item, null);
imageview view2 = (imageview) inflater.inflate(r.layout.item, null);
imageview view3 = (imageview) inflater.inflate(r.layout.item, null);
view1.setimageresource(r.drawable.ics);
view2.setimageresource(r.drawable.jellybean);
view3.setimageresource(r.drawable.kitkat);
arraylist<imageview> views = new arraylist<imageview>();
views.add(view1);
views.add(view2);
views.add(view3);
viewpager.setadapter(new imageadapter(views));
viewpager.setonpagechangelistener(new viewpager.onpagechangelistener() {
//配合adapter的currentitem字段进行设置。
@override
public void onpageselected(int arg0) {
handler.sendmessage(message.obtain(handler, imagehandler.msg_page_changed, arg0, 0));
public void onpagescrolled(int arg0, float arg1, int arg2) {
//覆写该方法实现轮播效果的暂停和恢复
public void onpagescrollstatechanged(int arg0) {
switch (arg0) {
case viewpager.scroll_state_dragging:
handler.sendemptymessage(imagehandler.msg_keep_silent);
break;
case viewpager.scroll_state_idle:
handler.sendemptymessagedelayed(imagehandler.msg_update_image, imagehandler.msg_delay);
default:
}
});
viewpager.setcurrentitem(integer.max_value/2);//默认在中间,使用户看不到边界
//开始轮播效果
handler.sendemptymessagedelayed(imagehandler.msg_update_image, imagehandler.msg_delay);
}//end of oncreate
}//e