Android TextView自定义数字滚动动画

背景

在开发需求当中，当有总收益、总用户数等数字要显示时，为了更好的给用户提供展示效果，往往会想加入炫酷的数字滚动动画，使呆板平静的数字变得灵活起来，给人一种增值的直观感受。

简介

NumberRollingView是一个自定义的自带数字滚动动画的TextView，通过使用setContent(String str)方法进行数字字符串设置，传入相应的金额数字字符串（如"9686.86"）或者整数数字字符串（如"968"），设置的数字必须是正数。当显示页面初始化完成的过程中，就可以看到数字滚动的效果了。

效果图：

使用

1.在attr.xml中配置NumberRollingView的自定义属性

<declare-styleable name="NumberRollingView">
  <!--帧数-->
  <attr name="frameNum" format="integer"></attr>
  <!--内容的格式-->
  <attr name="textType">
    <enum name="money" value="0"></enum>
    <enum name="num" value="1"></enum>
  </attr>
  <!--是否设置每三位数字一个逗号-->
  <attr name="useCommaFormat" format="boolean"></attr>
  <!--是否当内容改变的时候使用动画，反之则不使用动画-->
  <attr name="runWhenChange" format="boolean"></attr>
</declare-styleable>

frameNum：动画的帧数，默认为30帧；
textType：内容的格式，有money（金额、两位小数）和num（整数）两种格式，默认为0（金额格式）；
useCommaFormat：是否设置每三位数字一个逗号，默认为true（设置逗号显示）；
runWhenChange：是否当内容改变的时候使用动画，反之则不使用动画，默认为true（内容改变时使用动画）；

2.在XML布局文件中引用View

<com.wiggins.digitalchange.widget.NumberRollingView
  android:id="@+id/tv_money"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"
  android:text="0.00"
  android:textColor="@color/white"
  android:textSize="@dimen/font_max"
  android:textStyle="bold" />

<com.wiggins.digitalchange.widget.NumberRollingView
  android:id="@+id/tv_num"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"
  android:text="0"
  android:textColor="@color/white"
  android:textSize="@dimen/font_max"
  android:textStyle="bold"
  app:textType="num" />

前者是金额数字View，后者是整数数字View。

3.Java文件中调用

tvMoney.setContent("9686.86");
tvNum.setContent("9686");

4.取消数字的自动格式化（设置每三位数字一个逗号）

默认情况下显示的数字经过了格式化处理，设置每三位数字添加一个逗号分隔，这使得数字看起来清晰明了，不会显得臃肿繁杂。如果不想将数字进行格式化处理，可以在布局文件中将useCommaFormat属性设置为false，或者在代码中设置setUseCommaFormat(boolean useCommaFormat)为false，这样显示的数字就不会是带有逗号了。

5.设置无论内容是否改变都要执行滚动动画

默认情况下NumberRollingView会自动判断传入的内容是否有变化，当内容发生变化时执行数字滚动动画，内容未变时不执行数字滚动动画。如果想无论内容是否有变化都要执行滚动动画的话，可以在布局文件中将runWhenChange属性设置为false，或者在代码中设置setRunWhenChange(boolean runWhenChange)为false，这样无论内容是否有变化都会执行滚动动画。

6.设置动画帧数

默认情况下数字滚动动画帧数为30帧，如果需要修改动画帧数，可根据实际需要在在布局文件中将frameNum属性设置为自己想要的帧数，或者在代码中设置setFrameNum(int frameNum)为自己想要的帧数即可。

7.数字字符串格式化（每三位数字添加一个逗号）

/**
 * @param str    字符串只能为两位小数或者整数
 * @param isDecimal 是否是小数
 * @Description 格式化字符串，每三位用逗号隔开
 */
public static String addComma(String str, boolean isDecimal) {
  //先将字符串颠倒顺序
  str = new StringBuilder(str).reverse().toString();
  if (str.equals("0")) {
    return str;
  }
  String str2 = "";
  for (int i = 0; i < str.length(); i++) {
    if (i * 3 + 3 > str.length()) {
      str2 += str.substring(i * 3, str.length());
      break;
    }
    str2 += str.substring(i * 3, i * 3 + 3) + ",";
  }
  if (str2.endsWith(",")) {
    str2 = str2.substring(0, str2.length() - 1);
  }
  //最后再将顺序反转过来
  String temp = new StringBuilder(str2).reverse().toString();
  if (isDecimal) {
    //去掉最后的","
    return temp.substring(0, temp.lastIndexOf(",")) + temp.substring(temp.lastIndexOf(",") + 1, temp.length());
  } else {
    return temp;
  }
}

8.开始金额数字动画的方法

如果传入的金额中包含格式化的字符如","或"-"符号，就将符号去除；将传入的数字进行格式转换，转换为Double类型的金额格式，如果发生转换异常则直接进行显示；同时判断传入的数字大小，如果为0则直接显示，若不为0则设置每帧间隔的大小，发送Message消息给Handler进行内容的更新。

/**
 * @Description 开始金额数字动画的方法
 */
public void startMoneyAnim(String moneyStr) {
  // 如果传入的数字已经格式化了，则将包含的符号去除
  String money = moneyStr.replace(",", "").replace("-", "");
  try {
    finalMoneyNum = Double.parseDouble(money);
    if (finalMoneyNum == 0) {
      // 如果传入的数字为0则直接使用setText()进行显示
      NumberRollingView.this.setText(moneyStr);
      return;
    }
    nowMoneyNum = 0;
    threadPool.execute(new Runnable() {
      @Override
      public void run() {
        Message msg = handler.obtainMessage();
        // 将传入的数字除以帧数，得到每帧间隔的大小
        double size = finalMoneyNum / frameNum;
        msg.what = MONEY_TYPE;
        // 如果每帧的间隔小于0.01，则设置间隔为0.01
        msg.obj = size < 0.01 ? 0.01 : size;
        // 发送消息改变UI
        handler.sendMessage(msg);
      }
    });
  } catch (NumberFormatException e) {
    e.printStackTrace();
    //如果转换Double失败则直接用setText()
    NumberRollingView.this.setText(moneyStr);
  }
}

9.开始数字动画的方法

同上述金额数字一般，先进行格式化符号去除，然后进行类型转换，将其转换为Integer类型的整数格式，如果发生转换异常则直接进行显示；为了更加人性化，我们将传入的数字与帧数作了比较，如果数值小于帧数就直接显示，当然你想不管数字大小都能进行动画展示，只需将下面的帧数间隔的获取稍加改造即可；若大于等于设置的帧数则设置每帧间隔的大小，发送Message消息给Handler进行内容的更新。

/**
 * @Description 开始数字动画的方法
 */
public void startNumAnim(String numStr) {
  // 如果传入的数字已经格式化了，则将包含的符号去除
  String num = numStr.replace(",", "").replace("-", "");
  try {
    finalNum = Integer.parseInt(num);
    if (finalNum < frameNum) {
      // 如果传入的数字比帧数小，则直接使用setText()
      NumberRollingView.this.setText(numStr);
      return;
    }
    // 默认从0开始动画
    nowNum = 0;
    threadPool.execute(new Runnable() {
      @Override
      public void run() {
        Message msg = handler.obtainMessage();
        // 将传入的数字除以帧数，得到每帧间隔的大小
        int temp = finalNum / frameNum;
        msg.what = NUM_TYPE;
        msg.obj = temp;
        // 发送消息改变UI
        handler.sendMessage(msg);
      }
    });
  } catch (NumberFormatException e) {
    e.printStackTrace();
    //如果转换Integer失败则直接用setText
    NumberRollingView.this.setText(numStr);
  }
}

项目地址 ：传送门

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持我们。