鸿蒙NEXT开发土司工具类（ArkTs）

鸿蒙布道师2025-04-06 19:22
复制代码 
import promptAction from '@ohos.promptAction';

/**
 * TODO Toast默认样式参数
 * author: 鸿蒙布道师
 * since: 2025/04/02
 */
export class ToastConfig {
  duration: number = 2000; // 显示时长(1500ms-10000ms)
  duration_short: number = 1500; // 显示时长(1500ms)
  duration_long: number = 10000; // 显示时长(10000ms)
  showMode: promptAction.ToastShowMode = promptAction.ToastShowMode.DEFAULT; // 是否显示在应用之上
  alignment?: Alignment; // 对齐方式，默认值：undefined，默认底部偏上位置
  bottom: string | number = '80vp'; // 设置弹窗底部边框距离导航条的高度
  offset: Offset = { dx: 0, dy: 0 }; // 在对齐方式上的偏移，默认值：{dx:0, dy:0}
  textColor: ResourceColor = Color.White; // 文本提示框文本颜色，默认值：Color.Black
  backgroundColor: ResourceColor = '#CC000000'; // 文本提示框背板颜色，默认值：Color.Transparent
  backgroundBlurStyle: BlurStyle = BlurStyle.NONE; // 文本提示框背板模糊材质，默认值：BlurStyle.COMPONENT_ULTRA_THICK
  shadow: ShadowOptions | ShadowStyle = ShadowStyle.OUTER_DEFAULT_MD; // 文本提示框背板阴影，默认值：ShadowStyle.OUTER_DEFAULT_MD
}

/**
 * TODO Toast基本参数类
 * author: 鸿蒙布道师
 * since: 2025/04/02
 */
export class ToastOptions {
  duration?: number; // 显示时长(1500ms-10000ms)
  showMode?: promptAction.ToastShowMode; // 是否显示在应用之上
  alignment?: Alignment; // 对齐方式，默认值：undefined，默认底部偏上位置
  bottom?: string | number; // 设置弹窗底部边框距离导航条的高度
  offset?: Offset; // 在对齐方式上的偏移，默认值：{dx:0, dy:0}
  textColor?: ResourceColor; // 文本提示框文本颜色，默认值：Color.Black
  backgroundColor?: ResourceColor; // 文本提示框背板颜色，默认值：Color.Transparent
  backgroundBlurStyle?: BlurStyle; // 文本提示框背板模糊材质，默认值：BlurStyle.COMPONENT_ULTRA_THICK
  shadow?: ShadowOptions | ShadowStyle; // 文本提示框背板阴影，默认值：ShadowStyle.OUTER_DEFAULT_MD
}

/**
 * TODO 土司工具类
 * author: 鸿蒙布道师
 * since: 2025/04/02
 */
export class ToastUtil {
  private static defaultConfig: ToastConfig = new ToastConfig(); // 默认样式

  /**
   * 设置默认统一样式
   * @param configs 回调函数，用于修改默认配置
   */
  static setDefaultConfig(configs: (config: ToastConfig) => void): void {
    configs(ToastUtil.defaultConfig);
  }

  /**
   * 弹出土司，默认时长为2s，距离底部默认为80vp
   * @param message 提示消息
   * @param options 可选参数（显示时长、距离屏幕底部的位置、是否显示在应用之上等）
   */
  static showToast(message: string | Resource, options: ToastOptions = {}): void {
    ToastUtil.show(message, options, 0);
  }

  /**
   * 弹出土司，时长为1.5s，距离底部默认为80vp
   * @param message 提示消息
   * @param options 可选参数（距离屏幕底部的位置、是否显示在应用之上等）
   */
  static showShort(message: string | Resource, options: ToastOptions = {}): void {
    ToastUtil.show(message, options, 1);
  }

  /**
   * 弹出土司，时长为10s，距离底部默认为80vp
   * @param message 提示消息
   * @param options 可选参数（距离屏幕底部的位置、是否显示在应用之上等）
   */
  static showLong(message: string | Resource, options: ToastOptions = {}): void {
    ToastUtil.show(message, options, 2);
  }

  /**
   * 内部方法：统一处理 Toast 的显示逻辑
   * @param message 提示消息
   * @param options 可选参数
   * @param type 类型标识（0: 默认，1: 短时间，2: 长时间）
   */
  private static show(message: string | Resource, options: ToastOptions, type: number): void {
    if (!message || (typeof message === 'string' && message.trim() === '')) {
      console.warn('ToastUtil: Empty or invalid message provided.');
      return;
    }

    const finalOptions = ToastUtil.initToastDefault(options, type);

    promptAction.showToast({
      message,
      duration: finalOptions.duration,
      showMode: finalOptions.showMode,
      alignment: finalOptions.alignment,
      bottom: finalOptions.bottom,
      offset: finalOptions.offset,
      textColor: finalOptions.textColor,
      backgroundColor: finalOptions.backgroundColor,
      backgroundBlurStyle: finalOptions.backgroundBlurStyle,
      shadow: finalOptions.shadow,
    });
  }

  /**
   * 初始化 ToastOptions 参数
   * @param options 用户传入的选项
   * @param type 类型标识（0: 默认，1: 短时间，2: 长时间）
   * @returns 合并后的完整选项
   */
  private static initToastDefault(options: ToastOptions, type: number): ToastOptions {
    const defaultDuration =
      type === 1 ? ToastUtil.defaultConfig.duration_short :
        type === 2 ? ToastUtil.defaultConfig.duration_long :
        ToastUtil.defaultConfig.duration;

    return {
      duration: options.duration ?? defaultDuration,
      showMode: options.showMode ?? ToastUtil.defaultConfig.showMode,
      alignment: options.alignment ?? ToastUtil.defaultConfig.alignment,
      bottom: options.bottom ?? ToastUtil.defaultConfig.bottom,
      offset: options.offset ?? ToastUtil.defaultConfig.offset,
      textColor: options.textColor ?? ToastUtil.defaultConfig.textColor,
      backgroundColor: options.backgroundColor ?? ToastUtil.defaultConfig.backgroundColor,
      backgroundBlurStyle: options.backgroundBlurStyle ?? ToastUtil.defaultConfig.backgroundBlurStyle,
      shadow: options.shadow ?? ToastUtil.defaultConfig.shadow,
    };
  }
}

代码如下：

TypeScript 复制代码 
import promptAction from '@ohos.promptAction';

/**
 * TODO Toast默认样式参数
 * author: 鸿蒙布道师
 * since: 2025/04/02
 */
export class ToastConfig {
  duration: number = 2000; // 显示时长(1500ms-10000ms)
  duration_short: number = 1500; // 显示时长(1500ms)
  duration_long: number = 10000; // 显示时长(10000ms)
  showMode: promptAction.ToastShowMode = promptAction.ToastShowMode.DEFAULT; // 是否显示在应用之上
  alignment?: Alignment; // 对齐方式，默认值：undefined，默认底部偏上位置
  bottom: string | number = '80vp'; // 设置弹窗底部边框距离导航条的高度
  offset: Offset = { dx: 0, dy: 0 }; // 在对齐方式上的偏移，默认值：{dx:0, dy:0}
  textColor: ResourceColor = Color.White; // 文本提示框文本颜色，默认值：Color.Black
  backgroundColor: ResourceColor = '#CC000000'; // 文本提示框背板颜色，默认值：Color.Transparent
  backgroundBlurStyle: BlurStyle = BlurStyle.NONE; // 文本提示框背板模糊材质，默认值：BlurStyle.COMPONENT_ULTRA_THICK
  shadow: ShadowOptions | ShadowStyle = ShadowStyle.OUTER_DEFAULT_MD; // 文本提示框背板阴影，默认值：ShadowStyle.OUTER_DEFAULT_MD
}

/**
 * TODO Toast基本参数类
 * author: 鸿蒙布道师
 * since: 2025/04/02
 */
export class ToastOptions {
  duration?: number; // 显示时长(1500ms-10000ms)
  showMode?: promptAction.ToastShowMode; // 是否显示在应用之上
  alignment?: Alignment; // 对齐方式，默认值：undefined，默认底部偏上位置
  bottom?: string | number; // 设置弹窗底部边框距离导航条的高度
  offset?: Offset; // 在对齐方式上的偏移，默认值：{dx:0, dy:0}
  textColor?: ResourceColor; // 文本提示框文本颜色，默认值：Color.Black
  backgroundColor?: ResourceColor; // 文本提示框背板颜色，默认值：Color.Transparent
  backgroundBlurStyle?: BlurStyle; // 文本提示框背板模糊材质，默认值：BlurStyle.COMPONENT_ULTRA_THICK
  shadow?: ShadowOptions | ShadowStyle; // 文本提示框背板阴影，默认值：ShadowStyle.OUTER_DEFAULT_MD
}

/**
 * TODO 土司工具类
 * author: 鸿蒙布道师
 * since: 2025/04/02
 */
export class ToastUtil {
  private static defaultConfig: ToastConfig = new ToastConfig(); // 默认样式

  /**
   * 设置默认统一样式
   * @param configs 回调函数，用于修改默认配置
   */
  static setDefaultConfig(configs: (config: ToastConfig) => void): void {
    configs(ToastUtil.defaultConfig);
  }

  /**
   * 弹出土司，默认时长为2s，距离底部默认为80vp
   * @param message 提示消息
   * @param options 可选参数（显示时长、距离屏幕底部的位置、是否显示在应用之上等）
   */
  static showToast(message: string | Resource, options: ToastOptions = {}): void {
    ToastUtil.show(message, options, 0);
  }

  /**
   * 弹出土司，时长为1.5s，距离底部默认为80vp
   * @param message 提示消息
   * @param options 可选参数（距离屏幕底部的位置、是否显示在应用之上等）
   */
  static showShort(message: string | Resource, options: ToastOptions = {}): void {
    ToastUtil.show(message, options, 1);
  }

  /**
   * 弹出土司，时长为10s，距离底部默认为80vp
   * @param message 提示消息
   * @param options 可选参数（距离屏幕底部的位置、是否显示在应用之上等）
   */
  static showLong(message: string | Resource, options: ToastOptions = {}): void {
    ToastUtil.show(message, options, 2);
  }

  /**
   * 内部方法：统一处理 Toast 的显示逻辑
   * @param message 提示消息
   * @param options 可选参数
   * @param type 类型标识（0: 默认，1: 短时间，2: 长时间）
   */
  private static show(message: string | Resource, options: ToastOptions, type: number): void {
    if (!message || (typeof message === 'string' && message.trim() === '')) {
      console.warn('ToastUtil: Empty or invalid message provided.');
      return;
    }

    const finalOptions = ToastUtil.initToastDefault(options, type);

    promptAction.showToast({
      message,
      duration: finalOptions.duration,
      showMode: finalOptions.showMode,
      alignment: finalOptions.alignment,
      bottom: finalOptions.bottom,
      offset: finalOptions.offset,
      textColor: finalOptions.textColor,
      backgroundColor: finalOptions.backgroundColor,
      backgroundBlurStyle: finalOptions.backgroundBlurStyle,
      shadow: finalOptions.shadow,
    });
  }

  /**
   * 初始化 ToastOptions 参数
   * @param options 用户传入的选项
   * @param type 类型标识（0: 默认，1: 短时间，2: 长时间）
   * @returns 合并后的完整选项
   */
  private static initToastDefault(options: ToastOptions, type: number): ToastOptions {
    const defaultDuration =
      type === 1 ? ToastUtil.defaultConfig.duration_short :
        type === 2 ? ToastUtil.defaultConfig.duration_long :
        ToastUtil.defaultConfig.duration;

    return {
      duration: options.duration ?? defaultDuration,
      showMode: options.showMode ?? ToastUtil.defaultConfig.showMode,
      alignment: options.alignment ?? ToastUtil.defaultConfig.alignment,
      bottom: options.bottom ?? ToastUtil.defaultConfig.bottom,
      offset: options.offset ?? ToastUtil.defaultConfig.offset,
      textColor: options.textColor ?? ToastUtil.defaultConfig.textColor,
      backgroundColor: options.backgroundColor ?? ToastUtil.defaultConfig.backgroundColor,
      backgroundBlurStyle: options.backgroundBlurStyle ?? ToastUtil.defaultConfig.backgroundBlurStyle,
      shadow: options.shadow ?? ToastUtil.defaultConfig.shadow,
    };
  }
}
相关推荐
CYRUS_STUDIO几秒前
Frida Stalker Trace 指令跟踪&寄存器变化监控
android·逆向·汇编语言
bst@微胖子22 分钟前
Flutter之设计与主题&字体
android·flutter
深圳之光2 小时前
增加android 禁用相机后摄的接口
android·数码相机
行墨3 小时前
Kotlin常用集合
android
程序员老刘3 小时前
谨慎升级macOS 15.4，规避 ITMS-90048 错误
flutter·macos·ios
小胖子情白3 小时前
《x嘟牛App登录认证机制的技术实现分析》
android
塞尔维亚大汉3 小时前
鸿蒙南向开发 ——轻量系统芯片移植指南(二)
物联网·嵌入式·harmonyos
wodongx1233 小时前
Android Studio安装配置
android·ide·android studio
李元豪4 小时前
华为面试，机器学习深度学习知识点：
机器学习·华为·面试
90后的晨仔4 小时前
iOS 蓝牙开发基础知识梳理
ios
热门推荐
01生活电子常识--删除谷歌浏览器搜索记录02我决定放弃搞 Java 了03如何在WPS和Word/Excel中直接使用DeepSeek功能04DeepSeek RAGFlow构建本地知识库系统05DeepSeek各版本说明与优缺点分析06从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑07汽车上的各种质量：整备质量、总质量、装载质量、簧上质量、簧下质量08RAG 实践- Ollama+RagFlow 部署本地知识库09本地化部署AI知识库：基于Ollama+DeepSeek+AnythingLLM保姆级教程10基于Matlab的疲劳检测系统设计与实现