rarths/csparkles

PHP 用于显示消息的类

v1.0 2015-04-28 12:17 UTC

This package is not auto-updated.

Last update: 2024-09-28 17:25:11 UTC


README

Build Status Build Status

背景

本模块是在BTH的PHPMVC课程中以作业的形式制作的。该模块受到了Phalcon框架中使用的flash类的启发。消息存储在会话中,以便在重定向期间保持活跃。

安装

  • 通过 packagist 使用composer安装(推荐)或直接将其克隆到您的项目中。如果您选择克隆,请确保csparkles.php已自动加载。

  • 通过依赖注入将Sparkles添加到您的项目中,并确保已启动会话。

$di->set('sparkles', function () use ($di) {
    $sparkles = new \Rarths\Sparkles\CSparkles();
    $sparkles->setDI($di);
    return $sparkles;
});
  • 将flash.css包含到您的CSS配置中或使用您自己的CSS类。有关IE支持的详细信息,请参阅附加内容。要添加自定义CSS类,请将'error'、'success'、'notice'作为参数传递给Sparkles。留空以使用默认值。
$di->set('sparkles', function () use ($di) {
    $sparkles = new \Rarths\Sparkles\CSparkles(array(
    	'error' 	=> 'custom-error-message-class',
    	'success' 	=> 'custom-success-message-class',
    	'notice' 	=> 'custom-notice-message-class',
	));
    $sparkles->setDI($di);
    return $sparkles;
});
  • 使用此行添加要闪现的消息
$app->sparkles->flash('error', 'Oh sparkles! You have to watch out somewhere..');
  • 要在视图中输出消息,请使用以下内容。
$messages = $this->sparkles->output();
if (!empty($messages)) {
	echo '<div class="top-flash">';
	foreach ($messages as $key => $message) {
		echo $message;
	}
	echo '</div>';
}

附加内容

  • 如果您使用的是默认的顶部闪现,那么将其输出放在页脚是一个好主意。这样,您可以确保不会遗漏任何闪现消息。

  • 消息使用CSS3动画在5秒内消失。CSS3动画在IE 10+中得到支持。

  • 消息看起来像这样 这个

  • 有问题?请随时联系我(瑞典语或英语)

由Robin Hansson(robin@rarths.net

许可证

此软件是免费软件,并附带MIT许可证。

待办事项

  • 开始吧 ;)

历史

v2.0 添加了PHPUnit测试

 .   
..:  Copyright 2015 by Robin Hansson robin@rarths.net)