Skip to content

Latest commit

 

History

History
80 lines (64 loc) · 2.75 KB

readme_zh.md

File metadata and controls

80 lines (64 loc) · 2.75 KB
Raw

UniversalToast：一个简洁优雅的toast组件，支持点击&安全

features

  • 优雅 & 灵活
  • 可点击 & 可随意设置显示时长（通过WimdowManager添加view实现）
  • 主动避免android 7.0使用toast可能出现的BadTokenException

Usages

  • step 1 : 添加依赖
allprojects {
    repositories {
        ......
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    ......
    compile 'com.github.bboylin:UniversalToast:v1.0.4'
}
  • step 2 : api类似原生toast
UniversalToast.makeText(context, text, duration).show();
UniversalToast.makeText(context, text, duration,type).show();

duration 应该是UniversalToast.LENGTH_LONG 和UniversalToast.LENGTH_SHORT其中之一, type 应该是 UniversalToast.UNIVERSAL , UniversalToast.EMPHASIZE , UniversalToast.CLICKABLE 三者之一 , 未指定则默认为 UniversalToast.UNIVERSAL.

从左到右依次为UNIVERSAL，EMPHASIZE，CLICKABLE样式的toast，图标文字可设置。

  • 更多API:

设置duration和设置动画的方法被废弃掉了，因为：

  • 不建议自己修改toast显示时长
  • 在android framework里限制了windowAnimations必须是系统动画。
//example
UniversalToast.makeText(context, text, UniversalToast.LENGTH_SHORT, UniversalToast.CLICKABLE)
              .setGravity(gravity,xOffset,yOffset)
              .setBackground(drawable)//设置背景
              .setColor(R.color.my_color)//设置背景色
              .setIcon(R.drawable.my_ic)// 设置icon，未调用的话icon不可见(gone)
              .setClickCallBack(text,R.drawable.my_btn,onClickListener) //设置点击listener
              .show();

有三种默认的图标提供，用showSuccess(),showWarning() ， showError()代替show()即可采用对应的图标。

从左到右依次为 : showSuccess ， showWarning ， showError 的图标（这里只展示了EMPHASIZE类型的toast，CLICKABLE和UNIVERSAL亦可）

注意:

由于Android 8.0对悬浮窗权限的限制，使用可点击的toast(即UniversalToast.CLICKABLE)必须允许悬浮窗权限:

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

关于如何动态申请权限请参考demo。 Android 8.0以下不动态申请权限的话依然可以弹出可点击的toast，但是manifest里还是需要静态申请。

minSdkVersion>=14

to do :

  • icon支持动画

感谢 : ToastCompat