Skip to content

yizems/CountDownButton

Repository files navigation

CountDownButton

倒计时按钮-每次做发送验证码之类的倒计时按钮都 要写半天,要么就是复制,偶尔还复制错误,这次直接封装起来,以后不用那么麻烦了

1 效果图

image image image image

2 使用方法

  • 和正常button一样使用,只不过文字和背景色不再生效
  • 有四种状态,正常,准备,计时中,计时结束
  • 点击事件的监听设置和平常Button一样
  • 如果在计时中点击事件不会执行,只有正常和计时结束状态才会执行
 <cn.yzl.countdownbutton.CountDownButton
        android:layout_width="120dp"
        android:layout_height="50dp"
        app:end_text="重新发送"
        app:end_text_color="#228899"
        app:show_prepare="false"
        app:normal_bg="@drawable/bg_count_button_default"
        app:normal_text="发送"
        app:normal_text_color="#000000"
        app:prepare_bg="@drawable/bg_count_button_default"
        app:prepare_text="正在发送"
        app:prepare_text_color="#88ff11"
        app:max_count="10"
        app:timer_bg="@drawable/bg_count_button_aa"
        app:timer_text="重新获取(00)s"
        app:timer_text_color="#3F51B5" />
  • 如果有准备状态,准备结束后通过下面的方法可以开始计时
  • start() 开始计时
  • restart() 计时;
  • 添加进度监听 CountDownListener

提供一个主题

<!--倒计时按钮-->
    <style name="CountDownButton">
        <item name="android:textScaleX">1.0</item>
        <item name="android:padding">0dp</item>
        <item name="android:textSize">14dp</item>
        <item name="android:minHeight">0dp</item>
        <item name="android:minWidth">0dp</item>
        <item name="android:layout_height">35dp</item>
        <item name="android:layout_width">100dp</item>
        <item name="end_text">重新获取</item>
        <item name="end_text_color">#C22639</item>
        <item name="max_count">60</item>
        <item name="normal_bg">@drawable/bg_countdownbutton_normal</item>
        <item name="normal_text">获取验证码</item>
        <item name="normal_text_color">#C22639</item>
        <item name="prepare_bg">@drawable/bg_countdownbutton_normal</item>
        <item name="prepare_text">正在发送</item>
        <item name="prepare_text_color">#C22639</item>
        <item name="show_prepare">false</item>
        <item name="timer_bg">@drawable/bg_countdownbutton_gray</item>
        <item name="timer_text">重新获取(00)s</item>
        <item name="timer_text_color">@color/white</item>
    </style>

3 属性说明

  • show_prepare是否显示准备阶段字体样式,false不显示
  • max_count 可以理解为 从多少开始倒计时,单位秒
  • timer_text:00代表着要替换的数字,结合效果图理解
  • 其他的看名字就知道什么意思了

4 依赖

//工程gradle
allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}
//module
 dependencies {
	        compile 'com.github.yizeliang:CountDownButton:1.9'
	}
	

依赖于compileOnly 'androidx.appcompat:appcompat:1.0.0'

5 更新日志

2.0 取消 prepare 阶段,发送验证码成功后,直接调用start()方法

1.9

  • showPrepared:改变hasPrepared阶段逻辑,不应该直接计时,应该是是否显示此阶段的文字样式,

1.8

  • 修复 准备状态依旧执行点击监听的方法
  • 并且删除以前的release

1.7

  • 取消timespace属性

LICENSE

MIT License

Copyright (c) 2021 yizems

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.