在开发一个需要实时通知的 YII 2 项目时,我遇到了一个棘手的问题:如何高效地向用户展示系统消息和通知。传统的弹窗和提示框效果不够理想,用户体验较差。经过一番探索,我找到了 gbksoft/yii2-toastr 这个插件,它不仅解决了我的问题,还大大提升了用户体验。
gbksoft/yii2-toastr 是 Yii 2 的一个扩展,它封装了 Toastr 插件,使其以 Yii 小部件的形式呈现,简化了 ajax 通知的实现。通过这个插件,我可以轻松地在页面上显示通知,提升用户的交互体验。
使用 composer 安装这个扩展非常简单,只需运行以下命令:
php composer.phar require --prefer-dist gbksoft/yii2-toastr "*"
或者在你的 composer.json 文件的 require 部分添加:
"gbksoft/yii2-toastr": "*"
安装后,你可以通过以下方式在代码中使用它:
<?= gbksoftyii2toastrToastr::widget([ 'toastType' => 'error', 'message' => 'This is an error.', 'customStyle' => false ]);?>
这个插件提供了两个主要的小部件,分别是 ToastrFlash 和 ToastrAjaxFeed。
ToastrFlash 可以显示 Yii 的闪存消息,样式类似于 Toastr 通知。例如:
<?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"); ?>
然后在视图中使用:
<?= gbksoftyii2toastrToastrFlash::widget([ 'options' => [ 'positionClass' => 'toast-bottom-left' ] ]);?>
ToastrAjaxFeed 可以从 AJAX URL 获取通知,例如:
<?= gbksoftyii2toastrToastrAjaxFeed::widget([ 'feedUrl' => yiihelpersUrl::toRoute('/user/profile/notification-feed'), 'interval' => 5000, 'options' => [ 'positionClass' => 'toast-bottom-left' ] ]);?>
在控制器中,你需要返回一个类似于下面的数组:
public function actionNotificationFeed(){ $ret = [ [ 'type' => 'error', 'message' => 'error message', 'title' => 'Hey!' ], [ 'type' => 'info', 'message' => 'another message', 'title' => 'Hello' ] ]; return yiihelpersJson::encode($ret); }
使用 gbksoft/yii2-toastr 后,我的项目中的通知变得更加直观和友好,用户反馈也非常积极。这个插件不仅解决了我的实际问题,还展示了 Composer 在管理依赖和简化开发流程方面的强大优势。无论是处理闪存消息还是实时 AJAX 通知,gbksoft/yii2-toastr 都表现出色,是 Yii 2 开发者的一个有力工具。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END