squareboat/alert

使用 SweetAlert JS 插件轻松实现 Laravel 的闪存通知。

v1.0.0 2016-10-06 05:54 UTC

This package is auto-updated.

Last update: 2024-09-04 16:24:32 UTC


README

Build Status

使用美丽的 JavaScript 弹窗(sweet-alert)实现 Laravel 的 alert 通知。

安装

通过 Composer 安装

$ composer require squareboat/alert

配置 Laravel

安装操作完成后,只需将服务提供者和外观类添加到您的项目 config/app.php 文件中

服务提供者

SquareBoat\Alert\AlertServiceProvider::class,

外观

'Alert' => SquareBoat\Alert\Facades\Alert::class,

下载并安装 Sweet Alert 库

网站 下载 .js.css

通过 Bower 安装

bower install sweetalert

通过 NPM 安装

npm install sweetalert

最后,将默认的 alert 视图包含到您的布局中

该软件包默认提供已准备好 Bootstrap 的 alert 视图。只需将 alert::message 文件包含到您的 blade 主布局中

@include('alert::message')

或如果您不使用 blade

<?= view('alert::message') ?>

如果您需要修改 alert 消息部分,您可以运行

php artisan vendor:publish

现在该软件包视图将位于 resources/views/vendor/alert 目录。

就这样!喝着咖啡,开始闪烁 alert 消息吧!

用法

在您的控制器中,在您执行重定向之前...

public function create()
{
    // do something awesome...

    alert()->success('Resource created successfully!');

    return redirect()->route('dashboard');
}

所有警报的级别如下

成功

Alert::success('This is a success message.', 'Optional Title');

alert()->success('This is a success message.', 'Optional Title');

基本

Alert::basic('This is a basic message.', 'Mandatory Title');

alert()->basic('This is a basic message.', 'Mandatory Title');

信息

Alert::info('This is an info message.', 'Optional Title');

alert()->info('This is an info message.', 'Optional Title');

警告

Alert::warning('This is a warning message.', 'Optional Title');

alert()->warning('This is a warning message.', 'Optional Title');

错误

Alert::error('This is an error message.', 'Optional Title');

alert()->error('This is an error message.', 'Optional Title');

默认视图

<?php if(session()->has('sweet_alert.alert')) { ?>
    <script>
        if (typeof swal === "function") {
            swal(<?= e(session('sweet_alert.alert')) ?>);
        } else {
            sweet_alert = <?= e(session('sweet_alert.alert')) ?>;
        }
    </script>
<?php } ?>

sweet_alert.alert 会话密钥包含一个 JSON 配置对象,可以直接传递给 Sweet Alert 的 swal() 函数。

默认视图假设您已经通过引用必要的文件初始化了 sweetalert 插件,并使用其 swal() 函数。

如果 swal() 函数未定义,则默认视图声明一个 JavaScript 变量 sweet_alert,您可以在任何地方使用它。

最终考虑

默认情况下,所有警报将在合理的默认秒数后消失。但不用担心,如果您需要指定不同的时间,您可以

alert('Some alert message!')->autoclose(2000);

记住!该数字是以 毫秒 为单位的

此外,如果您需要使 alert 在页面上持续存在,直到用户通过按下确认按钮将其关闭

alert('Force may with you')->important("optional text");

可选文本将显示在按钮中,否则将显示默认文本 确定

许可

MIT 许可证。请参阅 许可文件 了解更多信息。版权所有 © 2016 SquareBoat