arkraft/alerts

使用 bootstrap growl 在控制器内创建警报。

1.0 2014-10-27 19:15 UTC

This package is not auto-updated.

Last update: 2024-09-24 03:51:13 UTC


README

Laravel 4 Alerts 提供者,通过使用 Nick Larson 的优秀 bootstrap-growl jQuery 插件,从控制器中添加 Bootstrap 警报。

安装

使用 composer 安装

composer require arkraft/alerts 0.8.0

app/config/app.php 的 providers 数组中注册服务提供者

'Arkraft\Alerts\AlertsServiceProvider'

app/config/app.php 中的别名数组下添加一个别名

'Alerts' => 'Arkraft\Alerts\Alerts',

最后一步是发布资产。在项目根目录中执行以下命令

php artisan asset:publish --path="vendor/arkraft/alerts/src/public/" jquery

这将把 jquery.bootstrap-growl.min.js 添加到您的 public/packages/jquery 目录。用法

现在您可以从控制器中添加警报。以下是一些可能的消息类型

  • Alerts::addInfo
  • Alerts::addSuccess
  • Alerts::addWarning
  • Alerts::addDanger

所有方法都有相同的参数

  • message: 您想要打印的消息
  • title (可选): 消息的标题(将作为粗体字添加到消息之前)
  • configuration (可选): 额外的配置数组 示例
Alerts::addInfo("This is a simple info message", "Info");

将显示以下消息 example info message

显示警报

添加

{{ Alerts::getAlerts() }}

到您的网站 JavaScript 中。

配置

您可以使用以下命令导出默认配置

php artisan config:publish arkraft/alerts

这将把以下数组导出到 'config/packages/arkraft/alerts/config.php'

return array(
    'offset' => '{from: "top", amount: 40}',
    'align' => 'right',
    'width' => 250,
    'delay' => 4000,
    'allowDismiss' => false,
    'stackupSpacing' => 5
);

配置值

  • offset: 包含偏移值的数组,警报将出现在顶部 40px 处
  • align: 可能的值是 right,center 和 left。
  • width: 消息框的宽度
  • delay: 消息消失的延迟,此消息将在消失前停留 4 秒
  • allowDismiss: true 将在警报框的右侧打印一个关闭按钮
  • stackupSpacing: 多个警报框之间的间隔

此配置文件的更改对所有框是全局的。要为单个警报更改配置,您可以像这样使用配置参数

Alerts::addDanger("This is a simple error message", "Error", array("delay" => 0, "allowDismiss" => true, "align" => "center"));

这将显示一条消息,它将停留在屏幕中心,直到通过右侧的关闭按钮关闭。作为参数传递的配置将覆盖默认配置。