README

这是为 Yii 2 开发的 Toastr 扩展。它将 Toastr 插件封装在 Yii 小部件中，使得实现 AJAX 通知变得简单。

安装

安装此扩展的首选方式是通过 composer。

运行以下命令之一：

php composer.phar require --prefer-dist gbksoft/yii2-toastr "*"

或添加

"gbksoft/yii2-toastr": "*"

到您的 composer.json 文件的 require 部分中。

使用方法

扩展安装后，您可以通过在代码中简单使用它来测试扩展是否工作：

<?= \gbksoft\yii2toastr\Toastr::widget([
    'toastType' => 'error',
    'message' => 'This is an error.',
    'customStyle' => false
]);?>

有两个主要的实用小部件

ToastrFlash

以 toastr 通知样式显示 Yii 的闪存消息

<?php
$session = \Yii::$app->getSession();
$session->setFlash('error', "msg1");
$session->setFlash('danger', "msg2");
$session->setFlash('warning', "msg3");
$session->setFlash('info', "msg4");
$session->setFlash('success', "msg5");
?>

<?= \gbksoft\yii2toastr\ToastrFlash::widget([
    'options' => [
        'positionClass' => 'toast-bottom-left'
    ]
]);?>

ToastrAjaxFeed

从 AJAX URL 获取通知

<?= \gbksoft\yii2toastr\ToastrAjaxFeed::widget([
    'feedUrl' => yii\helpers\Url::toRoute('/user/profile/notification-feed'),
    'interval' => 5000,
    'options' => [
        'positionClass' => 'toast-bottom-left'
    ]
]);?>

AJAX 控制器应返回类似以下的数组：

public function actionNotificationFeed(){
    $ret = [
        [
            'type' => 'error',
            'message' => 'error message',
            'title' => 'Hey!'
        ],
        [
            'type' => 'info',
            'message' => 'another message',
            'title' => 'Hello'
        ]
    ];
    return \yii\helpers\Json::encode($ret);
}