Toast是向用户显示简短消息的简便方法。它的实现可以简化至一行代码，如下所示：
Toast.makeText(this, "显示 [预设] 浮动式讯息总览", Toast.LENGTH_SHORT).show()
但是，除了简单地显示句子之外，你有没有探索过其他功能？
开发人员实际上可以通过设置自定义布局来定制Toast，并在应用程序窗口 (Window) 中定义位置。
此外，如果你的 app 是为视障人士而设，必须留意Talkback的处理 Toast 的處理手法！
本文将涵盖Toast的以下属性的四个函数：
- 自定义布局
- 持续时间
- 偏移位置
- 水平和垂直边距
属性1：自定义布局 (Custom Layout)
以下是自定义布局xml文件：
<?xml version="1.0" encoding="utf-8"?>
<layout>
<TextView
...
android:id="@+id/titleTextView"
android:drawableStart="@drawable/correct"
android:text="This is the message"
android:textStyle="bold"/>
</layout>
以下是自定义Toast的文件：
class CustomToast(context: Context) : Toast(context) {
init {
// 使用 LayoutInflater 来提取一个布局
val view = LayoutInflater.from(context).inflate(R.layout.widget_toast, null)
// 使用 DataBindingUtil 来提取一个布局，如果 app 是使用 DataBinding 方法来编写
val view = DataBindingUtil.inflate<WidgetToastBinding>(LayoutInflater.from(context), R.layout.widget_toast, null, false)
// 设置自定义布局
setView(view)
}
}
setView（view：View） 函数可用于设置Toast的自定义视图。自定义布局可以通过以下任一方式提取：
- LayoutInflater
- DataBindingUtil（如果您使用的是DataBinding）
属性2：持续时间 (Duration)（2.0s Vs 3.5s）
Toast的持续时间仅限于 LENGTH_SHORT 和 LENGTH_LONG。
实行代码：
class CustomToast(context: Context) : Toast(context) {
init {
// ...
duration = Toast.LENGTH_LONG // 3.5s (3500ms)
duration = Toast.LENGTH_SHORT // 2.0s (2000ms)
}
}
Toast源代码的第70-73行, 代码连结
虽然没有关于上述两种选择的定义的文档，但NotificationManagerService源代码清楚地表明了长度。 （感谢StackOverflow的解答）
NotificationManagerService源代码的第75-78行, 代码连结
属性3：重力 (Gravity) + 偏移 (Offset)
可以将重力 (Gravity ) 想像为将 布局 推向该方向的力。它是Integer 类，可以设置为以下7个常量的 bitwise 组合：
- Gravity.START / Gravity.LEFT
- Gravity.END / Gravity.RIGHT
- Gravity.TOP
- Gravity.BOTTOM
- Gravity.CENTER
- Gravity.CENTER_VERTICAL
- Gravity.CENTER_HORIZONTAL
左上角显示的示例代码：
class CustomToast(context: Context) : Toast(context) {
init {
// ...
val gravity = Gravity.START or Gravity.TOP
val horizontalOffset = 0
val verticalOffset = 0
setGravity(gravity, horizontalOffset, verticalOffset)
}
}
以下是Toast位置与相应的重力按位组合之间的映射的完整列表：
那么，setGravity函数中使用的 horizontalOffset 和 verticalOffset 的含义是什么？
Android中坐标系统
在Android中，坐标系统的原点始终是左上角。水平轴由x值表示，其从左向右增加。垂直轴由y值表示，其从顶部到底部增加。
因此，可以设置这些值以将Toast从其原始位置移开。见下面Toast水平和垂直偏移的例子：
属性4：边际移位
乍一看，很容易忽略 setMargin() 函数中使用的参数单位。与ViewGroup.MarginLayoutParams不同，它不使用像素作为单位。它实际上代表容器宽度或高度的百分比。
setMargin显示与上面显示的setGravity函数中使用的水平和垂直偏移类似的行为。但是，它适用于双向，即顶部和底部/左右两侧。
以下扩展功能可以帮助您计算正确的百分比：
// 由 dp 转换成 px
fun Int.toPx(): Int {
val metrics = Resources.getSystem().displayMetrics
val px = this * (metrics.densityDpi / 160f)
return Math.round(px)
}
// 获取屏幕尺寸
fun Context.screenDimension(): Point {
val windowManager = getSystemService(Context.WINDOW_SERVICE) as WindowManager // Either getting WindowManager from Activity or Application context
val display = windowManager.getDefaultDisplay()
val size = Point()
display.getSize(size)
return size
}
fun Context.screenWidth(): Int = screenDimension().x
fun Context.screenHeight(): Int = screenDimension().y
用法：
class CustomToast(context: Context) : Toast(context) {
init {
val horizontalMarginPercentage = 0.1f
val verticalMarginPercentage = 0.2f
setMargin(horizontalMarginPercentage, verticalMarginPercentage)
}
}
视障人士使用时所遇到的问题
根据Google官方文档，Toast无论如何都无法被 focus ( 注视 )。换句话说，Android TalkBack辅助功能工具无法阅读Toast上所显示的消息。另外，Android TalkBack辅助功能工在某些生产商的设备中是称为“语音助手”。
要了解有关Talkback的更多信息，请参考：语音助手的官方文档
吐司的局限
Toast是一个超级简单的小部件，没有监听器可以通知开发人员它的状态。例如，与DialogFragment不同，当Toast从屏幕淡出时，Toast没有onCancelListener（）来通知。请参考DialogFragment 有关 onCancelListener的官方文档
结论
除了简单地显示消息之外，Toast还有许多其他功能。
- 吐司可以：
- 显示自定义布局，例如使用 <ImageView>
- 显示有两个不同的持续时间，即2.0s和3.5s
- 在屏幕上显示自定义位置，其重力和x-y偏移的组合
- 显示双向边距
- 吐司不能：
- 被安卓系统所注视，这给视力受损者带来了巨大的不便。
- 通知应用程序有关其当前状态，例如当 Toast 从萤幕中消失的时刻
进一步阅读：
谢谢您阅读本文。希望这篇文章能启发你的思维 ! 😉
