小伙伴你好，可以通过封装一个 Toast 工具类，使用 PromptAction 来统一管理 showToast 和 closeToast 等方法。

详细说明

封装 Toast 工具类统一管理弹窗

方案说明：通过封装一个工具类，使用私有变量管理 PromptAction 实例，统一提供 showToast 和 closeToast 等方法，便于在项目中统一管理和使用 Toast 提示功能。详细使用指南请参考：PromptAction API 参考。

实现步骤：

  1. 导入模块

  导入语句：

import { UIContext, PromptAction } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';

  2. 封装 Toast 工具类

  代码示例：

import { UIContext, PromptAction } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';

/**
 * Toast 显示选项接口
 */
interface ToastOptions {
  message: string;
  duration?: number;
  bottom?: string | number;
}

/**
 * Toast 工具类
 * 统一管理 showToast 和 closeToast 等方法
 */
class ToastUtil {
  private static instance: ToastUtil;
  private promptAction: PromptAction | null = null;

  /**
   * 获取单例实例
   *
   * @returns ToastUtil 单例实例
   */
  static getInstance(): ToastUtil {
    if (!ToastUtil.instance) {
      ToastUtil.instance = new ToastUtil();
    }
    return ToastUtil.instance;
  }

  /**
   * 设置 UIContext，用于获取 PromptAction 实例
   *
   * @param context UIContext 实例
   */
  setUIContext(context: UIContext): void {
    try {
      this.promptAction = context.getPromptAction();
    } catch (err) {
      const be = err as BusinessError;
      console.error(`获取 PromptAction 失败: code = ${be.code}, message = ${be.message}`);
      this.promptAction = null;
    }
  }

  /**
   * 显示 Toast 提示
   *
   * @param options Toast 显示选项
   * @returns Promise<number> 返回 toastId，用于后续关闭
   */
  async showToast(options: ToastOptions): Promise<number> {
    if (!this.promptAction) {
      console.error('PromptAction 未设置，无法显示 Toast');
      throw new Error('PromptAction 未设置');
    }

    try {
      // API 18+ 推荐使用 openToast，返回 toastId
      const toastId = await this.promptAction.openToast({
        message: options.message,
        duration: options.duration || 2000,
        bottom: options.bottom || '80vp'
      });
      return toastId;
    } catch (err) {
      const be = err as BusinessError;
      console.error(`显示 Toast 失败: code = ${be.code}, message = ${be.message}`);
      throw new Error(err);
    }
  }

  /**
   * 显示简单文本 Toast（兼容旧版本）
   *
   * @param message 提示信息
   * @param duration 显示时长（毫秒），默认 2000ms
   */
  showSimpleToast(message: string, duration: number = 2000): void {
    if (!this.promptAction) {
      console.error('PromptAction 未设置，无法显示 Toast');
      return;
    }

    try {
      // 兼容旧版本 API，使用 showToast（API 18+ 已弃用）
      this.promptAction.showToast({
        message: message,
        duration: duration
      });
    } catch (err) {
      const be = err as BusinessError;
      console.error(`显示 Toast 失败: code = ${be.code}, message = ${be.message}`);
    }
  }

  /**
   * 关闭指定的 Toast
   *
   * @param toastId Toast ID，由 showToast 返回
   */
  closeToast(toastId: number): void {
    if (!this.promptAction) {
      console.error('PromptAction 未设置，无法关闭 Toast');
      return;
    }

    try {
      this.promptAction.closeToast(toastId);
    } catch (err) {
      const be = err as BusinessError;
      console.error(`关闭 Toast 失败: code = ${be.code}, message = ${be.message}`);
    }
  }

  /**
   * 显示成功提示
   *
   * @param message 提示信息
   * @returns Promise<number> 返回 toastId
   */
  async showSuccess(message: string): Promise<number> {
    return this.showToast({
      message: `✓ ${message}`,
      duration: 2000
    });
  }

  /**
   * 显示错误提示
   *
   * @param message 提示信息
   * @returns Promise<number> 返回 toastId
   */
  async showError(message: string): Promise<number> {
    return this.showToast({
      message: `✗ ${message}`,
      duration: 3000
    });
  }

  /**
   * 显示加载提示
   *
   * @param message 提示信息，默认为"加载中..."
   * @returns Promise<number> 返回 toastId，可用于后续关闭
   */
  async showLoading(message: string = '加载中...'): Promise<number> {
    return this.showToast({
      message: message,
      duration: 10000 // 加载提示显示时间较长
    });
  }
}

export default ToastUtil;

  3. 在组件中使用

  代码示例：

import ToastUtil from '../utils/ToastUtil';

@ComponentV2
struct ToastTestPage {
  private toastId: number | null = null;

  /**
   * 组件挂载时设置 UIContext
   */
  aboutToAppear(): void {
    const toastUtil = ToastUtil.getInstance();
    toastUtil.setUIContext(this.getUIContext());
  }

  /**
   * 显示简单提示
   */
  showSimpleMessage(): void {
    const toastUtil = ToastUtil.getInstance();
    toastUtil.showSimpleToast('操作成功');
  }

  /**
   * 显示可控制的 Toast
   */
  async showControllableToast(): Promise<void> {
    const toastUtil = ToastUtil.getInstance();
    try {
      // 显示 Toast 并获取 toastId
      this.toastId = await toastUtil.showToast({
        message: '正在处理中...',
        duration: 5000
      });
      console.info('Toast ID:', this.toastId);
    } catch (err) {
      console.error('显示 Toast 失败:', err);
    }
  }

  /**
   * 提前关闭 Toast
   */
  closeCurrentToast(): void {
    if (this.toastId !== null) {
      const toastUtil = ToastUtil.getInstance();
      toastUtil.closeToast(this.toastId);
      this.toastId = null;
    }
  }

  /**
   * 显示成功提示
   */
  async showSuccessMessage(): Promise<void> {
    const toastUtil = ToastUtil.getInstance();
    await toastUtil.showSuccess('保存成功');
  }

  /**
   * 显示错误提示
   */
  async showErrorMessage(): Promise<void> {
    const toastUtil = ToastUtil.getInstance();
    await toastUtil.showError('操作失败，请重试');
  }

  /**
   * 显示加载提示并自动关闭
   */
  async showLoadingAndClose(): Promise<void> {
    const toastUtil = ToastUtil.getInstance();
    const toastId = await toastUtil.showLoading('正在加载数据...');
    
    // 模拟异步操作
    setTimeout(() => {
      toastUtil.closeToast(toastId);
      toastUtil.showSuccess('加载完成');
    }, 2000);
  }

  build() {
    Column() {
      Button('显示简单提示')
        .onClick(() => {
          this.showSimpleMessage();
        })
        .margin({ bottom: 10 })

      Button('显示可控制 Toast')
        .onClick(() => {
          this.showControllableToast();
        })
        .margin({ bottom: 10 })

      Button('关闭当前 Toast')
        .onClick(() => {
          this.closeCurrentToast();
        })
        .margin({ bottom: 10 })

      Button('显示成功提示')
        .onClick(() => {
          this.showSuccessMessage();
        })
        .margin({ bottom: 10 })

      Button('显示错误提示')
        .onClick(() => {
          this.showErrorMessage();
        })
        .margin({ bottom: 10 })

      Button('显示加载提示')
        .onClick(() => {
          this.showLoadingAndClose();
        })
    }
    .width('100%')
    .height('100%')
    .padding(20)
    .justifyContent(FlexAlign.Center)
  }
}

注意事项

• UIContext 设置：必须在组件中调用 setUIContext() 设置 UIContext，否则无法获取 PromptAction 实例。建议在 aboutToAppear() 生命周期中设置。
• API 版本兼容性：
  • openToast 和 closeToast 方法需要 API version 18+
  • showToast 方法在 API 18+ 中已弃用，但为了兼容旧版本，工具类中提供了 showSimpleToast 方法
  • 建议优先使用 showToast 方法（内部使用 openToast），可以获取 toastId 进行控制
• Toast ID 管理：
  • showToast 返回的 toastId 需要保存，才能通过 closeToast 关闭
  • 如果不需要手动关闭，可以使用 showSimpleToast 方法
  • 建议在组件中保存 toastId，在组件销毁时关闭未关闭的 Toast
• 错误处理：
  • 所有方法都包含错误处理，失败时会输出错误日志
  • showToast 方法会抛出异常，调用时需要处理异常
  • showSimpleToast 和 closeToast 方法失败时只输出日志，不会抛出异常
• 使用场景：
  • 简单提示：使用 showSimpleToast 或便捷方法 showSuccess、showError
  • 需要控制关闭：使用 showToast 获取 toastId，然后调用 closeToast
  • 加载提示：使用 showLoading 显示长时间提示，操作完成后调用 closeToast 关闭

参考文档

• PromptAction API 参考
• showToast API 参考
• closeToast API 参考
• openToast API 参考