30. 【Android教程】吐司提示：Toast 的使用方法

news2025/1/11 18:33:05

在使用 Android 手机的时候，有没有遇到过如图中这种类型的消息提示？

这个在 Android 中被称为 Toast，用来短暂的展示一些简短的提示信息。相比弹窗来讲它对用户的打扰更小，在提示一段时间之后会自动消失，通常用来提示当前的状态或者一些不太重要的信息。接下来我们先看看 Toast 的相关特性然后一起动手编写一些与 Toasts 相关的示例代码。

1. Toast 的特性

其实大家在使用 Android 手机的时候大致能够了解 Toast 的特征，这里简单归纳一下：

用来展示简短消息提示的控件
会在短暂展示之后自动消失
Toast 不会阻塞 Activiity 或者 Fragment 的运行
比较适合用来给用户的某个操作做一个反馈

2. Toast 的使用方法

Toast 直接继承自 Object，相当于是一个比较原始的控件，封装的也比较友好，我们先来看看 Toast 可用的 API 及相关参数

2.1 Toast 常用 API

public static Toast makeText(Context context, CharSequence text, int duration)：
用于创建一个 Toast 并设置具体的提示文案及展示时长
public void show()：
顾名思义，触发 Toast 的展示
public void setMargin(float horizontal, float vertical)：
用于设置 Toast 垂直方向和水平方向上的间距
public void setView(View view)：
自定义展示的布局样式

2.2 Toast 中的常量参数

public static final int LENGTH_LONG：
长时间展示，大约维持 3.5 秒
public static final int LENGTH_SHORT：
短时间展示，大约维持 2 秒

2.3 如何创建

调用 Toast 的静态方法makeText：传入Context、字符串文案、显示时长即可创建一个 Toast。为了避免内存泄露，这里的 Context 建议使用getApplicationContext()来获取 App 的 Context 传入，如下：

Toast toast = Toast.makeText(getApplicationContext(),"MYBJ Android Study",Toast.LENGTH_LONG);

调用 Toast 的show()方法

toast.show();

我们可以将以上两句串联起来，如下：

Toast.makeText(getApplicationContext(),"MYBJ Android Study",Toast.LENGTH_LONG).show();

3. 设置 Toast 在屏幕中的位置

按照第 2 小节的方式 show 出来的 Toast 默认会在屏幕的底部中间位置展示，如果想要不走寻常路，可以通过接口setGravity(int gravity, int x, int y)改变 Toast 展示的位置，参数如下：

int gravity：
第一个参数表示重心，和 Layout 里面的 gravity 类似，我们可以直接使用 Gravity.java 类里面的常量来设置。有以下四种可选项：
- Gravity.BOTTOM
- Gravity.RIGHT
- Gravity.LEFT
- Gravity.TOP

当然我们也可以同时设置两个值，中间用“|”隔开，如Gravity.TOP|Gravity.LEFT表示左上方向。

int x：
设置水平方向上的距离，这个距离的参照是左边还是右边依赖第一个参数gravity
int y：
设置垂直方向上的距离，这个距离的参照是顶部还是底部依赖于第一个参数gravity的设置

如果设置 gravity 为 Gravity.CENTER，x 为 100，y 为 200。那么最后 show 出来的示意图如下：

4. Toast 的使用示例

本节我们用 Toast 实现一个“农药”提示，有两个 Button，点击会触发一个短暂的消息提示。代码比较简单，首先在布局中加入两个 Button：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:padding="10dp"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <Button
        android:id="@+id/dont_wave"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="猥琐发育，别浪" />

    <Button
        android:id="@+id/hold_on_we_can_win"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="稳住，我们能赢" />
</LinearLayout>

接着在 Java 代码中注册监听器，在点击不同 Button 的时候弹出不同的 Toast 提示信息：


package com.emercy.myapplication;

import android.app.Activity;
import android.os.Bundle;
import android.view.Gravity;
import android.view.LayoutInflater;
import android.view.View;
import android.widget.LinearLayout;
import android.widget.TextView;
import android.widget.Toast;


public class MainActivity extends Activity implements View.OnClickListener {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        findViewById(R.id.dont_wave).setOnClickListener(this);
        findViewById(R.id.hold_on_we_can_win).setOnClickListener(this);


    }

    @Override
    public void onClick(View v) {
        showToast(((TextView) v).getText().toString());
    }

    private void showToast(String text) {
        LinearLayout layout = (LinearLayout) LayoutInflater.from(this).inflate(R.layout.toast, null);
        TextView textView = layout.findViewById(R.id.text);
        textView.setText(text);
        Toast toast = new Toast(this);
        toast.setView(layout);
        toast.setDuration(Toast.LENGTH_SHORT);
        toast.setGravity(Gravity.TOP, 0, 500);

        toast.show();
    }
}

可以看到在创建 Toast 之后，通过setView方法设置了一个 LinearLayout 类型的 View 对象。通过这种方式就可以自定义一个展示样式，最后编写 Toast 的布局样式代码：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:gravity="bottom"
    android:layout_height="match_parent"
    android:orientation="horizontal">

    <ImageView
        android:layout_width="50dp"
        android:layout_height="50dp"
        android:src="@mipmap/mc" />

    <TextView
        android:id="@+id/text"
        android:layout_marginLeft="10dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="30sp" />
</LinearLayout>

XML 文件中我们横向放置了一个图片和一个文本，对应的是游戏人物和提示语，然后在点击的时候弹出此样式的 Toast。最终编译运行效果如下：

Toast 示例