coderatio / laranotify
一个功能丰富的Laravel扩展包,将Bootstrap notify jQuery插件转换为动态通知、警报和可阻塞的元素。
Requires
- php: >=5.6.0
- illuminate/support: >=4.0
This package is auto-updated.
Last update: 2024-09-19 13:22:36 UTC
README
这是最先进的Laravel扩展包,可以在屏幕上动态显示美观且优雅的警报消息、可阻塞元素和通知。这是以流畅性为设计理念的——这意味着,您可以链入任意多的方法。提供了许多功能。 查看示例它是建立在Bootstrap notify或growl插件之上的。它包含了插件中所有的方法以及许多额外的先进方法。因此,您需要在项目中安装Bootstrap。然而,自定义模板可以让您的用户有不同的外观。在“模板”部分中了解有关模板自定义的更多信息。
注意: 要开始构建自定义模板,建议您将样本发布到视图目录。发布后,样本模板将被复制到视图文件夹中的laranotify目录。 在此了解有关模板发布的更多信息。
安装
应通过composer安装Laranotify。在您的项目composer.json文件中需要coderatio/laranotify
,或者
在Windows操作系统上,在终端或命令提示符中运行composer require coderatio/laranotify
。
Provider和别名
如果您的Laravel安装版本低于5.5,则需要手动注册服务提供者和别名。在版本5.5及以上中,服务提供者和别名是自动发现的。
要注册包服务提供者和别名,打开您的laravel安装配置目录下的app.php
,然后在提供者数组下复制并粘贴
// Laranotify provider Coderatio\Laranotify\LaranotifyServiceProvider::class,
然后在别名数组中,复制并粘贴
// Laranotify aliases 'Notify' => Coderatio\Laranotify\Facades\Notify::class, 'Laranotify' => Coderatio\Laranotify\Facades\Laranotify::class,
别名是Facades,有助于将非静态方法绑定到包服务类上作为静态方法。例如
Notify::success('This is a message');
发布
该包具有配置和资产文件,需要发布到您的应用公共目录。要发布这些文件,请在命令行中运行;
php artisan vendor:publish --tag=laranotify-required
页眉和页脚
最后,在head标签中调用notify_header()
函数,在bootstrap JavaScript文件之后调用notify_footer()
以在项目中注册laranotify资产。这一步是必需的。
例如
页眉
<head> {{ notify_header() }} </head>
注意: 如果您想使用包含的Bootstrap CSS文件,请将
true
作为参数传递给函数,如下所示:
{{ notify_header(true) }}
页脚
{{ notify_footer() }} </body>
注意: 如果您想使用包含的Bootstrap和jQuery文件,请将
true
作为参数传递给函数,如下所示:
{{ notify_footer(true) }}
为了使这些文件在项目中正确加载,您需要在命令行或提示符中运行php artisan vendor:publish --tag=laranotify-foundations
。
通过Facades使用
Notify::message ('I am a simple notification from laranotify'); // You've just created your first notification.
然后可以链入其他方法。例如,如果您想更改延迟时间,可以这样操作
Notify::success('I am a simple notification from laranotify')->delay(6000); // 6000 = 6secs.
我们提供了两个Facades以方便使用。您可以选择使用其中的任何一个。
通过辅助函数使用
提供了两个辅助函数以帮助您快速开始。辅助函数返回包服务类的实例。
/** * @param (string) $message */ notify();
此辅助函数只接受一个参数,即您的消息。您可以使用消息方法或通知类型方法(例如错误、信息等)通过链式调用辅助函数和许多其他操作。
/** * @param (string) $message */ laranotify();
与上面的notify辅助函数相同。
notify('Hello World'); // OR laranotify('Hello World');
将在屏幕上以默认的Bootstrap信息提示类型显示 Hello World
。
要显示不同类型的提示,例如错误提示,可以将错误方法链式调用到一个辅助方法或类型方法,并传递任何Bootstrap提示类或您的自定义类。例如:
notify()->error('There was an error!'); // OR notify('There was an error!')->type('danger');
演示
模态类型通知。
致谢
我们非常感谢Bootstrap notify或growl插件的创作者Robert McIntosh。没有他,这个出色的包就不会存在。
文档
完整文档可以在这里找到:此处。
版权 & 许可
MIT许可(MIT)版权(c)2018 Coderatio
在此,免费许可任何获得此软件及其相关文档副本(“软件”)的人,以无限制地处理该软件,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本,并允许向软件提供的人执行上述操作,前提是遵守以下条件:
上述版权声明和本许可声明应包含在软件的所有副本或实质性部分中。
软件按“原样”提供,不提供任何形式的保证,无论是明示的、暗示的,包括但不限于适销性、适用于特定目的和非侵权的保证。在任何情况下,作者或版权所有者不对任何索赔、损害或其他责任承担责任,无论是由合同、侵权或其他行为引起的,无论是由软件本身、使用或以其他方式与软件相关的。