liuxuanhai / android_textbannerview

一个Android文字轮播控件，又名跑马灯；已经实现了可垂直跑、可水平跑的跑马灯，几行代码集成！

Android文字轮播控件

现在的绝大数APP特别是类似淘宝京东等这些大型APP都有文字轮播界面，实现循环轮播多个广告词等功能；这种控件俗称“跑马灯”，而TextBannerView已经实现了可垂直跑、可水平跑的跑马灯了。

效果图

Download Apk

Attributes属性（TextBannerView布局文件中调用）

Attributes	forma	describe
setInterval	integer	文字切换时间间隔,默认3000
setAnimDuration	integer	动画持续时间，默认1500
setTextSize	dimension	设置文字尺寸
setTextColor	color	设置文字颜色,默认黑色
setSingleLine	boolean	是否为显示单行
setGravity		文字显示位置,默认左边居中；可设置left、center、right
setDirection		文字轮播方向，默认水平从右到左轮播：right_to_left；还可以设置left_to_right（从左到右轮播）、bottom_to_top（从底部到顶部轮播）、top_to_bottom（从顶部到底部轮播）

方法

方法名	描述	版本限制
setDatas(List datas)	设置数据，类型：List	无
startViewAnimator()	设置开始文字切换（默认自动）	无
stopViewAnimator()	设置暂停文字切换	无
setItemOnClickListener(listener)	设置点击监听事件回调	无
setDatasWithDrawableIcon()	设置带图标的数据；第一个参数：数据 。第二参数：drawable. 第三参数drawable尺寸。第四参数图标位置(仅支持Gravity.LEFT、Gravity.TOP、Gravity.RIGHT、Gravity.BOTTOM)	1.0.2开始

使用步骤

Step 1.依赖TextBannerView

Gradle

dependencies{
    compile 'com.superluo:textbannerview:1.0.3'  //最新版本
}

或者引用本地lib

compile project(':textbannerlibrary')

Maven

<dependency>
  <groupId>com.superluo</groupId>
  <artifactId>textbannerview</artifactId>
  <version>1.0.3</version>
  <type>pom</type>
</dependency>

Step 2.在布局文件中添加TextBannerView，可以设置自定义属性

<com.superluo.textbannerlibrary.TextBannerView
        android:id="@+id/tv_banner"
        android:layout_width="match_parent"
        android:layout_height="38dp"
        android:background="#cc8ac6"
        app:setGravity="right"
        app:setTextColor="#fff"/>

• 点击可参考更多自定义属性

Step 3.在Activity或者Fragment中配置TextBannerView

//初始化TextBannerView
TextBannerView tvBanner = (TextBannerView) findViewById(R.id.tv_banner);

//设置数据
List<String> list = new ArrayList<>();

list.add("学好Java、Android、C#、C、ios、html+css+js");
list.add("走遍天下都不怕！！！！！");
list.add("不是我吹，就怕你做不到，哈哈");
list.add("superluo");
list.add("你是最棒的，奔跑吧孩子！");

//调用setDatas(List<String>)方法后,TextBannerView自动开始轮播
//注意：此方法目前只接受List<String>类型
tvBanner.setDatas(mList);


Drawable drawable = getResources().getDrawable(R.mipmap.ic_launcher);
/**这里可以设置带图标的数据（1.0.2新方法），比setDatas方法多了带图标参数；
第一个参数：数据 。
第二参数：drawable. 
第三参数:drawable尺寸。
第四参数:图标位置仅支持Gravity.LEFT、Gravity.TOP、Gravity.RIGHT、Gravity.BOTTOM
*/
mTvBanner.setDatasWithDrawableIcon(mList,drawable,18, Gravity.LEFT);
        

//设置TextBannerView点击监听事件，返回点击的data数据, 和position位置
tvBanner.setItemOnClickListener(new ITextBannerItemClickListener() {
            @Override
            public void onItemClick(String data, int position) {
                Log.i("点击了：",String.valueOf(position)+">>"+data);
            }
        });

Step 4.在Activity或者Fragment中的onResume()和onStop()方法分别调用startViewAnimator()和stopViewAnimator()，防止返回页面出现文字重影问题！

@override
protected void onResume() {
    super.onResume();
    tvBanner.startViewAnimator();
}

、、、、、、

@override
protected void onStop() {
    super.onStop();
    tvBanner.stopViewAnimator();
}

• 点击可参考更多使用方法

版本历史：

v1.0.3 (2018/7/28)

• 修复用带图的setDatasWithDrawableIcon方法后，布局文件里设置setGravity=left等位置时不起作用问题；
• 添加文字重影问题的方法使用说明；
• 项目工程升级为AndroidStudio3.1.3。

v1.0.2

• 实现文字带drawable图标一起轮播；
• drawable图标可设置在文本的左上右下 共4个方向；
• 修复若干bug.

v1.0.1

• 实现可垂直可水平的跑马灯文字轮播；支持设置切换时间设置、动画过度时间设置、文字颜色大小、文字轮播方向等。

更多开源库请关注：GitHubNotes