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

商道如狼道  金牌会员 | 昨天 06:25 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题
楼主

主题 992|帖子 992|积分 2976

  1. import promptAction from '@ohos.promptAction';
  3. /**
  4. * TODO Toast默认样式参数
  5. * author: 鸿蒙布道师
  6. * since: 2025/04/02
  7. */
  8. export class ToastConfig {
  9.   duration: number = 2000; // 显示时长(1500ms-10000ms)
  10.   duration_short: number = 1500; // 显示时长(1500ms)
  11.   duration_long: number = 10000; // 显示时长(10000ms)
  12.   showMode: promptAction.ToastShowMode = promptAction.ToastShowMode.DEFAULT; // 是否显示在应用之上
  13.   alignment?: Alignment; // 对齐方式，默认值：undefined，默认底部偏上位置
  14.   bottom: string | number = '80vp'; // 设置弹窗底部边框距离导航条的高度
  15.   offset: Offset = { dx: 0, dy: 0 }; // 在对齐方式上的偏移，默认值：{dx:0, dy:0}
  16.   textColor: ResourceColor = Color.White; // 文本提示框文本颜色，默认值：Color.Black
  17.   backgroundColor: ResourceColor = '#CC000000'; // 文本提示框背板颜色，默认值：Color.Transparent
  18.   backgroundBlurStyle: BlurStyle = BlurStyle.NONE; // 文本提示框背板模糊材质，默认值：BlurStyle.COMPONENT_ULTRA_THICK
  19.   shadow: ShadowOptions | ShadowStyle = ShadowStyle.OUTER_DEFAULT_MD; // 文本提示框背板阴影，默认值：ShadowStyle.OUTER_DEFAULT_MD
  20. }
  22. /**
  23. * TODO Toast基本参数类
  24. * author: 鸿蒙布道师
  25. * since: 2025/04/02
  26. */
  27. export class ToastOptions {
  28.   duration?: number; // 显示时长(1500ms-10000ms)
  29.   showMode?: promptAction.ToastShowMode; // 是否显示在应用之上
  30.   alignment?: Alignment; // 对齐方式，默认值：undefined，默认底部偏上位置
  31.   bottom?: string | number; // 设置弹窗底部边框距离导航条的高度
  32.   offset?: Offset; // 在对齐方式上的偏移，默认值：{dx:0, dy:0}
  33.   textColor?: ResourceColor; // 文本提示框文本颜色，默认值：Color.Black
  34.   backgroundColor?: ResourceColor; // 文本提示框背板颜色，默认值：Color.Transparent
  35.   backgroundBlurStyle?: BlurStyle; // 文本提示框背板模糊材质，默认值：BlurStyle.COMPONENT_ULTRA_THICK
  36.   shadow?: ShadowOptions | ShadowStyle; // 文本提示框背板阴影，默认值：ShadowStyle.OUTER_DEFAULT_MD
  37. }
  39. /**
  40. * TODO 土司工具类
  41. * author: 鸿蒙布道师
  42. * since: 2025/04/02
  43. */
  44. export class ToastUtil {
  45.   private static defaultConfig: ToastConfig = new ToastConfig(); // 默认样式
  47.   /**
  48.    * 设置默认统一样式
  49.    * @param configs 回调函数，用于修改默认配置
  50.    */
  51.   static setDefaultConfig(configs: (config: ToastConfig) => void): void {
  52.     configs(ToastUtil.defaultConfig);
  53.   }
  55.   /**
  56.    * 弹出土司，默认时长为2s，距离底部默认为80vp
  57.    * @param message 提示消息
  58.    * @param options 可选参数（显示时长、距离屏幕底部的位置、是否显示在应用之上等）
  59.    */
  60.   static showToast(message: string | Resource, options: ToastOptions = {}): void {
  61.     ToastUtil.show(message, options, 0);
  62.   }
  64.   /**
  65.    * 弹出土司，时长为1.5s，距离底部默认为80vp
  66.    * @param message 提示消息
  67.    * @param options 可选参数（距离屏幕底部的位置、是否显示在应用之上等）
  68.    */
  69.   static showShort(message: string | Resource, options: ToastOptions = {}): void {
  70.     ToastUtil.show(message, options, 1);
  71.   }
  73.   /**
  74.    * 弹出土司，时长为10s，距离底部默认为80vp
  75.    * @param message 提示消息
  76.    * @param options 可选参数（距离屏幕底部的位置、是否显示在应用之上等）
  77.    */
  78.   static showLong(message: string | Resource, options: ToastOptions = {}): void {
  79.     ToastUtil.show(message, options, 2);
  80.   }
  82.   /**
  83.    * 内部方法：统一处理 Toast 的显示逻辑
  84.    * @param message 提示消息
  85.    * @param options 可选参数
  86.    * @param type 类型标识（0: 默认，1: 短时间，2: 长时间）
  87.    */
  88.   private static show(message: string | Resource, options: ToastOptions, type: number): void {
  89.     if (!message || (typeof message === 'string' && message.trim() === '')) {
  90.       console.warn('ToastUtil: Empty or invalid message provided.');
  91.       return;
  92.     }
  94.     const finalOptions = ToastUtil.initToastDefault(options, type);
  96.     promptAction.showToast({
  97.       message,
  98.       duration: finalOptions.duration,
  99.       showMode: finalOptions.showMode,
  100.       alignment: finalOptions.alignment,
  101.       bottom: finalOptions.bottom,
  102.       offset: finalOptions.offset,
  103.       textColor: finalOptions.textColor,
  104.       backgroundColor: finalOptions.backgroundColor,
  105.       backgroundBlurStyle: finalOptions.backgroundBlurStyle,
  106.       shadow: finalOptions.shadow,
  107.     });
  108.   }
  110.   /**
  111.    * 初始化 ToastOptions 参数
  112.    * @param options 用户传入的选项
  113.    * @param type 类型标识（0: 默认，1: 短时间，2: 长时间）
  114.    * @returns 合并后的完整选项
  115.    */
  116.   private static initToastDefault(options: ToastOptions, type: number): ToastOptions {
  117.     const defaultDuration =
  118.       type === 1 ? ToastUtil.defaultConfig.duration_short :
  119.         type === 2 ? ToastUtil.defaultConfig.duration_long :
  120.         ToastUtil.defaultConfig.duration;
  122.     return {
  123.       duration: options.duration ?? defaultDuration,
  124.       showMode: options.showMode ?? ToastUtil.defaultConfig.showMode,
  125.       alignment: options.alignment ?? ToastUtil.defaultConfig.alignment,
  126.       bottom: options.bottom ?? ToastUtil.defaultConfig.bottom,
  127.       offset: options.offset ?? ToastUtil.defaultConfig.offset,
  128.       textColor: options.textColor ?? ToastUtil.defaultConfig.textColor,
  129.       backgroundColor: options.backgroundColor ?? ToastUtil.defaultConfig.backgroundColor,
  130.       backgroundBlurStyle: options.backgroundBlurStyle ?? ToastUtil.defaultConfig.backgroundBlurStyle,
  131.       shadow: options.shadow ?? ToastUtil.defaultConfig.shadow,
  132.     };
  133.   }
  134. }
复制代码
代码如下：
 
  1. import promptAction from '@ohos.promptAction';
  3. /**
  4. * TODO Toast默认样式参数
  5. * author: 鸿蒙布道师
  6. * since: 2025/04/02
  7. */
  8. export class ToastConfig {
  9.   duration: number = 2000; // 显示时长(1500ms-10000ms)
  10.   duration_short: number = 1500; // 显示时长(1500ms)
  11.   duration_long: number = 10000; // 显示时长(10000ms)
  12.   showMode: promptAction.ToastShowMode = promptAction.ToastShowMode.DEFAULT; // 是否显示在应用之上
  13.   alignment?: Alignment; // 对齐方式，默认值：undefined，默认底部偏上位置
  14.   bottom: string | number = '80vp'; // 设置弹窗底部边框距离导航条的高度
  15.   offset: Offset = { dx: 0, dy: 0 }; // 在对齐方式上的偏移，默认值：{dx:0, dy:0}
  16.   textColor: ResourceColor = Color.White; // 文本提示框文本颜色，默认值：Color.Black
  17.   backgroundColor: ResourceColor = '#CC000000'; // 文本提示框背板颜色，默认值：Color.Transparent
  18.   backgroundBlurStyle: BlurStyle = BlurStyle.NONE; // 文本提示框背板模糊材质，默认值：BlurStyle.COMPONENT_ULTRA_THICK
  19.   shadow: ShadowOptions | ShadowStyle = ShadowStyle.OUTER_DEFAULT_MD; // 文本提示框背板阴影，默认值：ShadowStyle.OUTER_DEFAULT_MD
  20. }
  22. /**
  23. * TODO Toast基本参数类
  24. * author: 鸿蒙布道师
  25. * since: 2025/04/02
  26. */
  27. export class ToastOptions {
  28.   duration?: number; // 显示时长(1500ms-10000ms)
  29.   showMode?: promptAction.ToastShowMode; // 是否显示在应用之上
  30.   alignment?: Alignment; // 对齐方式，默认值：undefined，默认底部偏上位置
  31.   bottom?: string | number; // 设置弹窗底部边框距离导航条的高度
  32.   offset?: Offset; // 在对齐方式上的偏移，默认值：{dx:0, dy:0}
  33.   textColor?: ResourceColor; // 文本提示框文本颜色，默认值：Color.Black
  34.   backgroundColor?: ResourceColor; // 文本提示框背板颜色，默认值：Color.Transparent
  35.   backgroundBlurStyle?: BlurStyle; // 文本提示框背板模糊材质，默认值：BlurStyle.COMPONENT_ULTRA_THICK
  36.   shadow?: ShadowOptions | ShadowStyle; // 文本提示框背板阴影，默认值：ShadowStyle.OUTER_DEFAULT_MD
  37. }
  39. /**
  40. * TODO 土司工具类
  41. * author: 鸿蒙布道师
  42. * since: 2025/04/02
  43. */
  44. export class ToastUtil {
  45.   private static defaultConfig: ToastConfig = new ToastConfig(); // 默认样式
  47.   /**
  48.    * 设置默认统一样式
  49.    * @param configs 回调函数，用于修改默认配置
  50.    */
  51.   static setDefaultConfig(configs: (config: ToastConfig) => void): void {
  52.     configs(ToastUtil.defaultConfig);
  53.   }
  55.   /**
  56.    * 弹出土司，默认时长为2s，距离底部默认为80vp
  57.    * @param message 提示消息
  58.    * @param options 可选参数（显示时长、距离屏幕底部的位置、是否显示在应用之上等）
  59.    */
  60.   static showToast(message: string | Resource, options: ToastOptions = {}): void {
  61.     ToastUtil.show(message, options, 0);
  62.   }
  64.   /**
  65.    * 弹出土司，时长为1.5s，距离底部默认为80vp
  66.    * @param message 提示消息
  67.    * @param options 可选参数（距离屏幕底部的位置、是否显示在应用之上等）
  68.    */
  69.   static showShort(message: string | Resource, options: ToastOptions = {}): void {
  70.     ToastUtil.show(message, options, 1);
  71.   }
  73.   /**
  74.    * 弹出土司，时长为10s，距离底部默认为80vp
  75.    * @param message 提示消息
  76.    * @param options 可选参数（距离屏幕底部的位置、是否显示在应用之上等）
  77.    */
  78.   static showLong(message: string | Resource, options: ToastOptions = {}): void {
  79.     ToastUtil.show(message, options, 2);
  80.   }
  82.   /**
  83.    * 内部方法：统一处理 Toast 的显示逻辑
  84.    * @param message 提示消息
  85.    * @param options 可选参数
  86.    * @param type 类型标识（0: 默认，1: 短时间，2: 长时间）
  87.    */
  88.   private static show(message: string | Resource, options: ToastOptions, type: number): void {
  89.     if (!message || (typeof message === 'string' && message.trim() === '')) {
  90.       console.warn('ToastUtil: Empty or invalid message provided.');
  91.       return;
  92.     }
  94.     const finalOptions = ToastUtil.initToastDefault(options, type);
  96.     promptAction.showToast({
  97.       message,
  98.       duration: finalOptions.duration,
  99.       showMode: finalOptions.showMode,
  100.       alignment: finalOptions.alignment,
  101.       bottom: finalOptions.bottom,
  102.       offset: finalOptions.offset,
  103.       textColor: finalOptions.textColor,
  104.       backgroundColor: finalOptions.backgroundColor,
  105.       backgroundBlurStyle: finalOptions.backgroundBlurStyle,
  106.       shadow: finalOptions.shadow,
  107.     });
  108.   }
  110.   /**
  111.    * 初始化 ToastOptions 参数
  112.    * @param options 用户传入的选项
  113.    * @param type 类型标识（0: 默认，1: 短时间，2: 长时间）
  114.    * @returns 合并后的完整选项
  115.    */
  116.   private static initToastDefault(options: ToastOptions, type: number): ToastOptions {
  117.     const defaultDuration =
  118.       type === 1 ? ToastUtil.defaultConfig.duration_short :
  119.         type === 2 ? ToastUtil.defaultConfig.duration_long :
  120.         ToastUtil.defaultConfig.duration;
  122.     return {
  123.       duration: options.duration ?? defaultDuration,
  124.       showMode: options.showMode ?? ToastUtil.defaultConfig.showMode,
  125.       alignment: options.alignment ?? ToastUtil.defaultConfig.alignment,
  126.       bottom: options.bottom ?? ToastUtil.defaultConfig.bottom,
  127.       offset: options.offset ?? ToastUtil.defaultConfig.offset,
  128.       textColor: options.textColor ?? ToastUtil.defaultConfig.textColor,
  129.       backgroundColor: options.backgroundColor ?? ToastUtil.defaultConfig.backgroundColor,
  130.       backgroundBlurStyle: options.backgroundBlurStyle ?? ToastUtil.defaultConfig.backgroundBlurStyle,
  131.       shadow: options.shadow ?? ToastUtil.defaultConfig.shadow,
  132.     };
  133.   }
  134. }
复制代码


免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
回复

使用道具 举报

0 个回复

倒序浏览
返回列表

快速回复

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

商道如狼道

金牌会员
这个人很懒什么都没写!

楼主热帖

标签云

运维 CIO 存储 服务器
微信订阅号
微信服务号
微信客服
小程序
H5
关于我们 商务合作 网站地图
©Copyright 2022-2024 杭州祥升科技有限公司 版权所有 浙ICP备20004199号
快速回复 返回顶部 返回列表