安卓客化--浮动式讯息总览|安卓客化--浮动式讯息总览 (Toast) 安卓客化--浮动式讯息总览(T

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

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

但是，除了简单地显示句子之外，你有没有探索过其他功能？
【安卓客化--浮动式讯息总览|安卓客化--浮动式讯息总览 (Toast)】开发人员实际上可以通过设置自定义布局来定制Toast，并在应用程序窗口 (Window) 中定义位置。
此外，如果你的 app 是为视障人士而设，必须留意Talkback的处理 Toast 的處理手法！
本文将涵盖To??ast的以下属性的四个函数：

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

属性1：自定义布局 (Custom Layout) 以下是自定义布局xml文件：

以下是自定义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(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还有许多其他功能。

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

进一步阅读：