custom_toast.gif

Toast是向用户显示简短消息的简便方法。它的实现可以简化至一行代码，如下所示：

Toast.makeText(this, "显示 [预设] 浮动式讯息总览", Toast.LENGTH_SHORT).show()

但是，除了简单地显示句子之外，你有没有探索过其他功能？

开发人员实际上可以通过设置自定义布局来定制Toast，并在应用程序窗口 (Window) 中定义位置。

此外，如果你的 app 是为视障人士而设，必须留意Talkback的处理 Toast 的處理手法！

本文将涵盖To​​ast的以下属性的四个函数：

• 自定义布局
• 持续时间
• 偏移位置
• 水平和垂直边距

---

属性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。

combined_toast.gif

实行代码：

class CustomToast(context: Context) : Toast(context) {
  init {
    // ...
    duration = Toast.LENGTH_LONG // 3.5s (3500ms)
    duration = Toast.LENGTH_SHORT // 2.0s (2000ms)
  }
}

Toast源代码的第70-73行, 代码连结

source code.png

虽然没有关于上述两种选择的定义的文档，但NotificationManagerService源代码清楚地表明了长度。 （感谢StackOverflow的解答）

NotificationManagerService源代码的第75-78行, 代码连结

NotificationManagerService source code.png

---

属性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

gravity_toast_v2.gif

左上角显示的示例代码：

class CustomToast(context: Context) : Toast(context) {
  init {
    // ...
    val gravity = Gravity.START or Gravity.TOP
    val horizo​​ntalOffset = 0
    val verticalOffset = 0
    setGravity(gravity, horizo​​ntalOffset, verticalOffset)
  }
}

以下是Toast位置与相应的重力按位组合之间的映射的完整列表：

image.png

---

那么，setGravity函数中使用的 horizo​​​​ntalOffset 和 verticalOffset 的含义是什么？

Android中坐标系统

image.png

在Android中，坐标系统的原点始终是左上角。水平轴由x值表示，其从左向右增加。垂直轴由y值表示，其从顶部到底部增加。
因此，可以设置这些值以将Toast从其原始位置移开。见下面Toast水平和垂直偏移的例子：

offset.gif

---

属性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 horizo​​ntalMarginPercentage = 0.1f
    val verticalMarginPercentage = 0.2f
    setMargin(horizo​​ntalMarginPercentage, verticalMarginPercentage)
  }
}

---

视障人士使用时所遇到的问题

根据Google官方文档，Toast无论如何都无法被 focus ( 注视 )。换句话说，Android TalkBack辅助功能工具无法阅读Toast上所显示的消息。另外，Android TalkBack辅助功能工在某些生产商的设备中是称为“语音助手”。

image.png

要了解有关Talkback的更多信息，请参考：语音助手的官方文档

---

吐司的局限

image.png

Toast是一个超级简单的小部件，没有监听器可以通知开发人员它的状态。例如，与DialogFragment不同，当Toast从屏幕淡出时，Toast没有onCancelListener（）来通知。请参考DialogFragment 有关 onCancelListener的官方文档

---

结论

除了简单地显示消息之外，Toast还有许多其他功能。

• 吐司可以：
  • 显示自定义布局，例如使用 <ImageView>
  • 显示有​​两个不同的持续时间，即2.0s和3.5s
  • 在屏幕上显示自定义位置，其重力和x-y偏移的组合
  • 显示双向边距
• 吐司不能：
  • 被安卓系统所注视，这给视力受损者带来了巨大的不便。
  • 通知应用程序有关其当前状态，例如当 Toast 从萤幕中消失的时刻

---

进一步阅读：

1. 吐司类概述
2. Toast功能和属性定义
3. 吐司开源代码

---

谢谢您阅读本文。希望这篇文章能启发你的思维 ! 😉