Repolode
提交项目
realrashid

realrashid/sweet-alert

Laravel 扩展包，用流畅的 PHP API 把 JavaScript 弹窗替换为基于 SweetAlert2 的提示框、Toast 和输入框。

在 GitHub 查看官网
Star
1,157
Fork
166
未关闭 Issue
9
最近提交
22天前

这是什么？

Laravel SweetAlert 是一个 Laravel 扩展包，用 SweetAlert2 弹窗替代浏览器原生的 JavaScript 弹框。开发者在控制器中通过链式构建器 API 触发提示，页面加载后在浏览器中显示。

包内提供三类构建器：AlertBuilder 用于模态对话框，ToastBuilder 用于轻量通知，InputBuilder 用于收集用户输入。它还包含 PHP 8.3+ 枚举（提示类型、输入类型、位置）以及全局 alert() 辅助函数。可与 Blade 布局、Livewire（通过 Trait 以浏览器事件形式派发）以及 Inertia.js（通过中间件）集成。

此外，data-confirm 属性可加在链接或表单上，在操作执行前要求用户确认，无需编写额外 JavaScript。包中的 artisan 命令可将 v7 项目迁移到 v8，并支持 --dry-run 预览改动。

核心功能

  • 01流畅的构建器 API，支持提示框、Toast 和输入框
  • 02Blade 指令，在布局中渲染提示
  • 03Livewire Trait，以浏览器事件派发提示
  • 04Inertia.js 中间件，向 Vue 或 React 共享提示
  • 05data-confirm 属性，为链接和表单添加确认步骤
  • 06artisan 命令支持从 v7 升级，并可预览改动

适用场景

  • 在 Laravel 应用中表单提交后显示成功或错误提示
  • 在删除等危险操作前请求用户确认
  • 在 Livewire 组件中弹出 Toast 通知
  • 通过模态框收集简单的用户输入

快速上手

  1. 1

    使用 Composer 安装该包

    composer require realrashid/sweet-alert
  2. 2

    运行包的安装命令

    php artisan alert:install
  3. 3

    在布局文件中添加 @sweetAlert Blade 指令

使用前须知

  • 需要 PHP 8.3+ 和 Laravel，不适用于其他技术栈。

标签

#laravel#php#popup#dialog#sweetalert2#toast#livewire#inertia#confirmation-dialog#laravel-package

常见问题

sweet-alert 是什么？
Laravel 扩展包，用流畅的 PHP API 把 JavaScript 弹窗替换为基于 SweetAlert2 的提示框、Toast 和输入框。 Laravel SweetAlert 是一个 Laravel 扩展包，用 SweetAlert2 弹窗替代浏览器原生的 JavaScript 弹框。开发者在控制器中通过链式构建器 API 触发提示，页面加载后在浏览器中显示。
sweet-alert 可以免费使用吗？用的什么许可证？
sweet-alert 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
sweet-alert 还在维护吗？
活跃维护中。sweet-alert 最近一次提交是在 2026年10月16日。
sweet-alert 适合用来做什么？
在 Laravel 应用中表单提交后显示成功或错误提示 在删除等危险操作前请求用户确认 在 Livewire 组件中弹出 Toast 通知 通过模态框收集简单的用户输入
sweet-alert 怎么安装和运行？
使用 Composer 安装该包: composer require realrashid/sweet-alert 运行包的安装命令: php artisan alert:install 在布局文件中添加 @sweetAlert Blade 指令
在哪里获取 sweet-alert？
源代码和安装说明在 GitHub 上：https://github.com/realrashid/sweet-alert

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目