Android开发&可实现信息滚动的控件——RollTextView

RollTextView


说明：一个可以滚动的布局，可以在首页显示新闻消息等，可自定义每次显示的数目，动画时间等...



原理：RollTextView继承RecyclerView，因此实际上并非是TextView，而是ViewGroup，在控件内容重写的定时器，保证按照某种约束进行滚动。


源码可参考github地址：rolltextview

1、准备步骤

在项目build.gradle中添加依赖：

compile 'com.knowledge.mnlin:rolltextview:0.0.1'

若项目依赖有冲突，则可以屏蔽该库中依赖的资源

compile ('com.knowledge.mnlin:rolltextview:0.0.1'){
    exclude group:'com.android.support', module:'recyclerview-v7'

    ...

}

如果提示找不到依赖文件，可能时jcenter未及时通过，可以依赖私人仓库

//Project的build.gradle文件
allprojects {
    repositories {

        ... 

        maven { url "https://dl.bintray.com/lovingning/maven"}
    }
}

2、简单使用

1、在需要显示滚动信息的layout文件中添加控件；

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/activity_splash"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="false"
    android:orientation="vertical">

    <View
        android:layout_marginTop="100dp"
        android:background="@color/red"
        android:layout_width="match_parent"
        android:layout_height="1px"/>

    <com.knowledge.mnlin.RollTextView
        android:id="@+id/rtv_temp"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"/>

    <View
        android:background="@color/red"
        android:layout_width="match_parent"
        android:layout_height="1px"/>

</LinearLayout>

2、在Activity或Fragment中初始化数据

RollTextView rollTextView = findViewById(R.id.rtv_temp);
rollTextView.refreshData(Arrays.asList("0000000"
                , "1111111111111111111111111111111111111111111111111111"
                , "22222"
                , "3333333"
                , "444444"
                , "55555"
                , "6666666"
                , "777777"
                , "888888"
                , "99999999"));

3、进阶属性

可设属性总览：

rollTextView.setAppearCount(3)//设置每次显示的数量
        .setInterval(2000)//设置滚动的间隔时间，以毫秒为单位
        .setOrderVisible(true)//设置显示序号的view是否可见
        .setEndText("查看", true)//设置尾部文字是否可见
        .setLayoutResource(R.layout.item_roll_text_view)//为item自定义layout,但必须遵循规定
        .setRollDirection(1)//设置滚动的方向，0为向上滚动，1为向下滚动，2为向右滚动，3为向左滚动
        //设置itemClick监听器
        .setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
                Logger.e("点击位置：" + position);
            }
        })
        //设置数据源，接收一个list，显示内容时调用其toString方法，因此数据内容不可为null
        .refreshData(Arrays.asList("0000000"
                , "1111111111111111111111111111111111111111111111111111"
                , "22222"
                , "3333333"
                , "444444"
                , "55555"
                , "6666666"
                , "777777"
                , "888888"
                , "99999999"));

1、使用setAppearCount

该方法可以设置每次显示的条目，默认情况下，只显示一条信息。
在滚动方向为水平时，只能显示一条信息。

2、setInterval

设置滚动时间间隔，默认情况下为2000ms

3、setOrderVisible与setEndText

默认情况下，会为每条信息添加序号，并在尾部添加lable：“更多”，可通过方法关闭显示效果

4、setLayoutResource自定义item布局

如果不满足预设的item-layout文件，可以自定义xml布局；

• 定义布局时尽量不要做过多修改，避免滑动失败；
• 自定义布局中必须有三个AppCompatTextView子view，并且id分别为：tv_left、tv_center、tv_right。
• 定义布局时，root布局上不要使用margin*属性**，避免滚动时错位。

系统默认的xml文件为：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:minHeight="@dimen/prefer_view_height"
    android:orientation="horizontal">

    <android.support.v7.widget.AppCompatTextView
        android:id="@+id/tv_left"
        android:layout_width="@dimen/prefer_view_height"
        android:layout_height="match_parent"
        android:gravity="center_vertical"
        android:paddingLeft="@dimen/prefer_view_padding_vertical"
        android:text="1."/>

    <android.support.v7.widget.AppCompatTextView
        android:id="@+id/tv_center"
        style="@style/TextViewStandard"
        android:layout_width="0dp"
        android:layout_height="match_parent"
        android:layout_weight="1"
        android:ellipsize="marquee"
        android:gravity="center_vertical"
        android:marqueeRepeatLimit="marquee_forever"
        android:singleLine="true"
        android:text="很多内容很多内容很多内容很多内容很多内容很多内容很多内容"/>

    <android.support.v7.widget.AppCompatTextView
        android:id="@+id/tv_right"
        style="@style/TextViewStandard"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:text="详情"/>
</LinearLayout>

5、使用setRollDirection设置滚动方向

默认情况下，控件从下向上滚动；当然可以通过该方法来设置滚动的方向：

• 0 表示向上滚动
• 1 表示向下滚动
• 2 表示向右滚动
• 3 表示向左滚动

6、refreshData

refreshData方法需要在初始化的最后执行，该方法会将之前所有的设置进行apply，然后再次刷新动画。
因此务必保证：refreshData必须调用并且最后调用

7、主动开启或关闭动画

库中已经对动画的运行与停止自定义了处理方法，在控件不可见时，动画会自动关闭，且控件可以手动滑动。若有特殊需求需要控件停止或启动动画，可以主动调用方法：
* startAnimation() 开启动画
* stopAnimation() 关闭动画

4、显示效果

1、简单模式

2、多行模式

3、水平滚动