@capgo/capacitor-pretty-toast

中文文档
8.1.28发布于 2026/11/02MPL-2.0TypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 4.1万

土著第一漂亮土司通知 capacitor和网络

中文使用文档
文档目录19 节
  1. *免费开始*
  2. 主要特点
  3. 安装
  4. 使用量
  5. API 密码
  6. 显示(...)
  7. 成功(...)
  8. 错误(...)
  9. 信息(...)
  10. 警告(...)
  11. 装入(...)
  12. 更新(...)
  13. 承诺(...)
  14. 开除(...)
  15. 全部删除( C)
  16. 接口
  17. 类型异名
  18. 示例应用
  19. 发展

@ capgo/ 电容- pretty- toast

在您的 Capacitor app 中显示美丽的吐司通知, 上面有 iOS 和 Android 的土生土长 和 网页上的 DOM 渲染器 。 一样 toast.* API作为反应-内在- pretty-toast.

Capgo - Build Capacitor apps with AI, ship updates instantly

队长:在几分钟内将修正推给您的 Capacitor 用户,在没有Mac的情况下构建已签名的iOS和Android apps,并在一击中回滚.

*免费开始*

14天无限自由审判. 不需要信用卡

🤖 建筑与AI编码代理? 安装 Capgo 技能 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 @capgo/capacitor-pretty-toast 在您的电容应用程序中: npx skills add Cap-go/capgo-skills。然后问你的经纪人: 加上@capgo/capor- pretty-toast到我的Capacitor应用上并把它接上 代理设置指南 • 妇女 主机磁共振

Animated Pretty Toast demo on an external device

主要特点

  • 备选案文数字 : success(), (中文(简体) ), error(), (中文(简体) ), info(), (中文(简体) ), warning(), (中文(简体) ), loading() 完全习惯 show()。 。 。 .
  • 保证祝酒词数字 : promise() 显示装入,然后在您的承诺到期时成功或出错.
  • 实时更新数字 : update() 换个敬酒的地方, dismiss() 财务报告和审定财务报表 dismissAll() 关上他们.
  • 排队: 默认情况下的土司队列,以及 force 把新吐司放在第一位, 并显示它当 现在的吐司解散.
  • 图标: 符号图标和原始SVG通过 icon,并图像 URI 通过 iconSource。 。 。 .
  • 平台: iOS,Android和Web. 互联网档案馆的存檔,存档日期2013-12-02.

这个包保留了熟悉的 toast.* 从地表从 react-native-pretty-toast,但作为电容插件的船舶:

  • iOS和Android上本土覆盖.
  • a 网上DOM渲染器.
  • 队列中, force, (中文(简体) ), update, (中文(简体) ), dismiss, (中文(简体) ), dismissAll,以及 promise
  • 符号图标,原始 SVG 通过 icon,并且基于 URI 的图像通过 iconSource

安装

您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :

npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins

然后使用下列提示:

Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-pretty-toast` plugin in my project.

如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:

bun add @capgo/capacitor-pretty-toast

然后同步本地平台 :

bunx cap sync

使用量

import { toast } from '@capgo/capacitor-pretty-toast';

toast.success('Saved', {
  message: 'Your changes are already on disk.',
});

const id = toast.loading('Uploading', {
  message: 'This toast stays visible until you update it.',
});

setTimeout(() => {
  toast.update(id, {
    title: 'Upload complete',
    message: 'Updated in place without replaying the enter animation.',
    icon: 'checkmark.circle.fill',
    autoDismiss: true,
  });
}, 1500);

API 密码

公共土司控制器被曝光为 toast。 。 。 .

显示(...)

show(config: ToastConfig, options?: ShowOptions | undefined) => string

显示自定义的敬酒并返回其ID.

参数类型
configToastConfig
optionsShowOptions

回返情况: string


成功(...)

success(title: string, config?: ToastConfig | undefined, options?: ShowOptions | undefined) => string

祝你们成功.

参数类型
titlestring
configToastConfig
optionsShowOptions

回返情况: string


错误(...)

error(title: string, config?: ToastConfig | undefined, options?: ShowOptions | undefined) => string

显示一个错误的烤面包.

参数类型
titlestring
configToastConfig
optionsShowOptions

回返情况: string


信息(...)

info(title: string, config?: ToastConfig | undefined, options?: ShowOptions | undefined) => string

展示一个信息祝酒.

参数类型
titlestring
configToastConfig
optionsShowOptions

回返情况: string


警告(...)

warning(title: string, config?: ToastConfig | undefined, options?: ShowOptions | undefined) => string

来个警告祝酒词.

参数类型
titlestring
configToastConfig
optionsShowOptions

回返情况: string


装入(...)

loading(title: string, config?: ToastConfig | undefined, options?: ShowOptions | undefined) => string

举起手来 装入土司不会自动解除.

参数类型
titlestring
configToastConfig
optionsShowOptions

回返情况: string


更新(...)

update(id: string, partial: ToastConfig) => void

以 id 更新现有的祝酒词 .

参数类型
idstring
partialToastConfig

承诺(...)

promise<T>(promise: Promise<T>, messages: PromiseMessages<T>) => Promise<T>

在等待承诺时显示加载祝酒, 然后更新其成功或出错 .

参数类型
promisePromise<T>
messagesPromiseMessages<T>

回返情况: Promise<T>


开除(...)

dismiss(id?: string | undefined) => void

以身份解除一个土司, 或目前的土司 当没有身份证明时.

参数类型
idstring

全部删除( C)

dismissAll() => void

解除现在的祝酒词 并清除队列.


接口

土司组合

Prop类型说明
idstring可选稳定土司ID。 省略时返回生成的 id .
iconstring接受类似 SF- symbol 的标识符或原始 SVG 标记。 SVG 模式仅在字符串开始时启用 &lt;svg 修补后.
iconSourceIconSourceURI类似图像源. 支助 https://, (中文(简体) ), http://, (中文(简体) ), file://,绝对文件路径, data: URL( URL) , (中文), blob: URL,或 网络 { uri }。 。 。 . iconSource 总是胜出 icon。 。 。 .
titlestring主吐司头衔.
messagestring二级祝酒词.
durationnumber自动解除延迟数以毫秒计.
autoDismissboolean土司是否在之后就放弃了 duration。 。 。 .
enableSwipeDismissboolean是否在本地覆盖上启用了刷相到发相 .
accentColorstringCSS风格的口音颜色被本地/网络渲染器所使用.
strokeColorstringCSS风格的边框/中风颜色.
disableBackdropSamplingboolean禁用土司后面的Android/iOS背景取样.
actionToastAction可选动作按钮配置 .
accessibilityAnnouncementstring土司显示时, 将文字宣布为辅助技术 .
onPress(() => void)烤面包的时候叫的 吐司总是会丢掉的.
onShow(() => void)当吐司显出时调用.
onHide(() => void)土司解散后打电话来.
onAutoDismiss(() => void)当吐司被其计时器解聘时召去.

敬酒行动

Prop类型说明
labelstring为本地/网络动作按钮显示文本 .
onPress() => void按下动作按钮时调用 .

显示选项

Prop类型说明
forceboolean解除现在的祝酒词 立即展示这个.

类型异名

图标来源

string | { uri: string }

承诺

{ loading: string | ToastConfig; success: string | ((value: T) => string | ToastConfig); error: string | ((error: unknown) => string | ToastConfig); }

注释:

  • Raw SVG 只能通过 icon。 。 。 .
  • iconSource 总是优先于 icon。 。 。 .
  • toast.loading() 默认 autoDismiss 改为 false。 。 。 .

示例应用

重罚包括: example-app/,一个基于 Vite 的 Capacitor 应用程序,其演示用于:

  • 每个 toast.* 方法
  • 队列和 force
  • 现场直播 update
  • dismiss 财务报告和审定财务报表 dismissAll
  • promise
  • 符号图标
  • 原始 SVG 图标
  • 远程和数据-URL iconSource 数值
  • 可重复捕获模式 ?demo=hero, (中文(简体) ), ?demo=flow,以及 ?demo=update

?demo=flow 是 README 视频中使用的 promo 出入口形态. 运出视频既显示Android剪接路径,也显示以岛为中心并排的路径.

本地运行 :

cd example-app
bun install
bun run start

发展

bun install
bun run build
bun test
bun run verify

版本与发布记录

@capgo/capacitor-pretty-toast 共发布 29 个版本,首次发布于 2026/05/21;过去 12 个月发布了 29 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.1.28latest2026/11/027 天前
8.1.272026/10/1525 天前
8.1.262026/10/1426 天前
8.1.252026/10/1326 天前
8.1.242026/10/1327 天前
8.1.232026/10/1228 天前

关于 @capgo/capacitor-pretty-toast 的常见问题

@capgo/capacitor-pretty-toast 是什么?

土著第一漂亮土司通知 capacitor和网络

如何安装 @capgo/capacitor-pretty-toast?

在项目目录运行 npm install @capgo/capacitor-pretty-toast,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capgo/capacitor-pretty-toast 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capgo/capacitor-pretty-toast 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capgo/capacitor-pretty-toast 可以商用吗?

@capgo/capacitor-pretty-toast 使用 MPL-2.0 许可。弱 Copyleft:可以商用,也可以和闭源代码一起使用;但如果分发时修改了 MPL 授权的文件,这些文件的修改需以 MPL 开源。以上为概括,不构成法律意见,请以许可原文为准。

@capgo/capacitor-pretty-toast 的下载量有多少?

根据 npm 官方下载统计,@capgo/capacitor-pretty-toast 在 2026/10/09 – 2026/11/07 这 30 天内被下载 40,849 次,日均约 1,362 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capgo/capacitor-pretty-toast 还在维护吗?

最新版本 8.1.28 发布于 2026/11/02(7 天前);至今共发布 29 个版本,其中过去 12 个月发布了 29 个;首次发布于 2026/05/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。