在项目中经常需要使用轮转广告的效果,在android-v4版本中提供的ViewPager是一个很好的工具,而一般我们使用Viewpager的时候,都会选择在底部有一排指示物指示当前显示的是哪一个page,这么常用的组合如果每次用都重头写当然是一件很麻烦的事情,有许多博客和开源项目都致力于这项工作,但是他们的工作大都是为了制作类似于启动页的效果,ViewPager全屏显示,或者自己可操作的属性难以满足要求,因此我想把ViewPager和底部的指示物封装在一个自定义的View中,作为一个新的控件在xml中使用,所以自己来实现了一个。
而且,在用自定义视图封装ViewPager时,出现了一个问题,就是ViewPager的所有页不能全部显示的问题,不知道是因为这个问题太简单还是什么其它原因,在网上并没有搜到这个问题的解决方法(事实上连提问的人都没有……),困扰了我半个多星期,终于解决,这一点在正文里会介绍,先来贴一下效果图:
下面来介绍我的实现过程:
首先在res/values/目录下创建attrs.xml文件,用来定义新View自定义的属性:
<?xml version="1.0" encoding="utf-8"?> <resources> <declare-styleable name="MyViewPager"> <attr name="dotsViewHeight" format="dimension" /> <attr name="dotsSpacing" format="dimension" /> <attr name="dotsFocusImage" format="reference" /> <attr name="dotsBlurImage" format="reference" /> <attr name="android:scaleType" /> <attr name="android:gravity" /> <attr name="dotsBackground" format="reference|color" /> <attr name="dotsBgAlpha" format="float" /> <attr name="changeInterval" format="integer" /> </declare-styleable> </resources>
其中:
dotsViewHeight定义底部指示物所在视图(我定义为一个LinearLayout)的高度,也就是示例图中圆圈所在灰色透明部分的高度,默认为40像素;
dotsSpacing定义底部指示物之间的间距,默认为0;
dotsFocusImage定义代表当前页的指示物的样子;
dotsBlurImage定义代表非当前页的指示物的样子;
android:scaleType定义ViewPager中ImageView的scale类型,如果ViewPager中的View不是ImageView,则此属性没有效果,默认为ScaleType.FIT_XY;
android:gravity定义底部指示物在父View(即示例灰色透明部分)的gravity属性;
dotsBackground定义底部指示物的背景颜色或背景图;
dotsBgAlpha定义底部指示物的背景颜色或背景图的透明度,取值为0-1,0代表透明;
changeInteval定义ViewPager自动切换的时间间隔,单位为ms,默认为1000ms(这个地方实际的间隔比设置的要大,不知道是什么原因,望高手解答);
下一步,定义PageAdapter,为ViewPager提供内容:
public class ViewPagerAdapter extends PagerAdapter { private List<View> views = null; private ScaleType scaleType; public ViewPagerAdapter(List<View> views) { this(views, ScaleType.CENTER); } public ViewPagerAdapter(List<View> views, ScaleType scaleType) { super(); this.views = views; this.scaleType = scaleType; }
定义一个views来存储要显示的View,然后定义一个ScaleType来规定如果ViewPager是用来显示ImageView的,ImageView应该怎样呈现在ViewPager当中,如果调用的构造函数不传ScaleType信息,则默认使用ScaleType.CENTER。
根据官方API描述,需要重写PageAdapter的getCount,isViewFromObject,instantiateItem和destroyItem这四个方法,在instantiateItem中设置ScaleType,其它几个方法,都是用官方描述的写法,没有做什么新的改动:
@Override public int getCount() { // TODO Auto-generated method stub return views.size(); } @Override public boolean isViewFromObject(View arg0, Object arg1) { // TODO Auto-generated method stub return arg0 == arg1; } @Override public Object instantiateItem(View container, int position) { // TODO Auto-generated method stub View view = views.get(position); ViewPager viewPager = (ViewPager) container; if (view instanceof ImageView){ ((ImageView) view).setScaleType(scaleType); } viewPager.addView(view, 0); return view; } @Override public void destroyItem(View container, int position, Object object) { // TODO Auto-generated method stub ((ViewPager) container).removeView((View) object); }
下面就是重头戏了,核心类,被封装的底部带指示物的ViewPager,基本思路是自定义一个类继承LinearLayout,在里面加入两个子视图ViewPager和LinearLayout(放置指示物),并且,因为要定期轮转,还实现了Runnable接口,定义了以下的变量:
public class MyViewPager extends LinearLayout implements Runnable { private ViewPager viewPager; private LinearLayout viewDots; private List<ImageView> dots; private List<View> views; private int position = 0; private boolean isContinue = true; private float dotsViewHeight; private float dotsSpacing; private Drawable dotsFocusImage; private Drawable dotsBlurImage; private ScaleType scaleType; private int gravity; private Drawable dotsBackground; private float dotsBgAlpha; private int changeInterval;
viewPager是要显示的ViewPager对象,viewDots是放置指示物的子视图,dots是viewDots上的指示物项,views是ViewPager项,position指示当前正在显示第几张图,isContinue表示可不可以自动轮转(当手指触摸时不轮转),在下面的就是雨attrs.xml中定义的属性相对应的值。作为一个能够在xml布局文件中直接使用的View,必须重写拥有Context和AttributeSet参数的构造函数:
public MyViewPager(Context context, AttributeSet attrs) { super(context, attrs); // TODO Auto-generated constructor stub TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.MyViewPager, 0, 0);
try {
dotsViewHeight = a.getDimension( R.styleable.MyViewPager_dotsViewHeight, 40); //这里依次获取所有的属性值,此处省略,可参看最后附上的全部代码 } finally { a.recycle(); } initView(); }
最后调用的函数initView,用来初始化ViewPager和LinearLayout这两个子视图,同时,如果xml中给指示物设置了背景,在这里进行设置:
@SuppressLint("NewApi") private void initView() { // TODO Auto-generated method stub viewPager = new ViewPager(getContext()); viewDots = new LinearLayout(getContext()); LayoutParams lp = new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT); addView(viewPager, lp); if (dotsBackground != null) { dotsBackground.setAlpha((int) (dotsBgAlpha * 255)); viewDots.setBackground(dotsBackground); } viewDots.setGravity(gravity); addView(viewDots, lp); }
使用这个类时,关键就是创建一个List<View>,并作为参数传进来供ViewPager(PagerAdapter)使用,对外的接口就是这个setViewPagerViews:
public void setViewPagerViews(List<View> views) { this.views = views; addDots(views.size()); viewPager.setAdapter(new ViewPagerAdapter(views, scaleType)); viewPager.setOnPageChangeListener(new OnPageChangeListener() { @Override public void onPageSelected(int index) { // TODO Auto-generated method stub position = index; switchToDot(index); } //override的两个空方法,此处省略 }); viewPager.setOnTouchListener(new OnTouchListener() { @Override public boolean onTouch(View view, MotionEvent motionevent) { // TODO Auto-generated method stub switch (motionevent.getAction()) { case MotionEvent.ACTION_DOWN: case MotionEvent.ACTION_MOVE: isContinue = false; break; case MotionEvent.ACTION_UP: isContinue = true; break; default: isContinue = true; break; } return false; } }); new Thread(this).start(); }
addDots就是在底部添加多少个小点,默认第一个处于被选中状态,关键是OnPageChangeListener的onPageSelected方法,这个方法在viewPager进行切换时调用,做的工作就是把底部的指示物切换到对应的标识上,在这个方法的最后,启动了轮转的线程。
@Override public void run() { // TODO Auto-generated method stub while (true) { if (isContinue) { pageHandler.sendEmptyMessage(position); position = (position + 1) % views.size(); try { Thread.sleep(changeInterval); } catch (InterruptedException e) { // TODO Auto-generated catch block e.printStackTrace(); } } } } Handler pageHandler = new Handler() { @Override public void handleMessage(Message msg) { // TODO Auto-generated method stub viewPager.setCurrentItem(msg.what); super.handleMessage(msg); } };
在这个线程中,每隔固定秒数,就向Handler队列中发送一个消息,内容就是要显示的view项的index,然后再handler中调用viewPager的setCurrentItem方法进行跳转。至此,最核心的类就完成了,但还剩很关键的一个方法,作为一个自定义的View,要重写父类的onLayout方法来对子元素进行布局,就是这一个方法中不当的代码,导致每次只能显示前两张图,因为ViewPager在显示时,会默认初始化当前页和前后页,对于第一张来说,没有前一页,所以初始化了两张,在ViewPager滑动时,每次都会调用onLayout方法,而且,changed参数为false,我已开始只判断changed为true时才进行布局,就造成了上述问题,完整的onLayout代码如下:
@Override protected void onLayout(boolean changed, int l, int t, int r, int b) { // TODO Auto-generated method stub View child = this.getChildAt(0); child.layout(0, 0, getWidth(), getHeight()); if (changed) { child = this.getChildAt(1); child.measure(r - l, (int) dotsViewHeight); child.layout(0, getHeight() - (int) dotsViewHeight, getWidth(), getHeight()); } }
最后,就是如何使用这个类了,首先,在activity的布局文件中声明这个组件:
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:daemon="http://schemas.android.com/apk/res/org.daemon.viewpager" android:layout_width="match_parent" android:layout_height="match_parent" android:background="#666666" > <org.daemon.viewpager.MyViewPager android:id="@+id/my_view_pager" android:layout_width="match_parent" android:layout_height="200dp" daemon:dotsViewHeight="30dp" daemon:dotsFocusImage="@drawable/dot_focused" daemon:dotsBlurImage="@drawable/dot_normal" daemon:dotsSpacing="5dp" daemon:dotsBackground="#999999" daemon:dotsBgAlpha="0.5" daemon:changeInterval="3000" android:scaleType="fitXY" android:gravity="center" /> </RelativeLayout>
然后,在MainActivity中,创建List<View>数组并设置数据:
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); initViewPager(); } private void initViewPager() { views = new ArrayList<View>(); ImageView image = new ImageView(this); image.setImageResource(R.drawable.demo_scroll_image); views.add(image); image = new ImageView(this); image.setImageResource(R.drawable.demo_scroll_image2); views.add(image); image = new ImageView(this); image.setImageResource(R.drawable.demo_coupon_image); views.add(image); image = new ImageView(this); image.setImageResource(R.drawable.demo_scroll_image2); views.add(image); MyViewPager pager = (MyViewPager) findViewById(R.id.my_view_pager); pager.setViewPagerViews(views); }
至此,本示例就全部讲解完了,两个问题,一个就是为什么使用Thread的方法来控制时间间隔,实际值会比设置的值长,是因为Message在排队吗,第二个问题,就是为什么ViewPager滑动时不重新对ViewPager布局,就会不显示任何图,这两个问题还有待大家解答。
源代码下载