在七个小时的工作之后,askeet程序已经很好了。主页显示问题列表,问题的详细内容显示其答案,用户具有一个配置页面,而各种主题列表也可以由每一页的侧边栏访问。我们社区加强的FAQ处在其正确的方向上,而现在用户还不可以修改数据。
如果web中数据操作的基础是长长的表单,那么今天的AJAX技术可以改变程序的构建方式。而这也同样适用于askeet。在这个指南中,我们将会显示在askeet中添加加强的AJAX交互。其目标就是允许一个已注册的用户声明其对某一个问题的兴趣。
就会显示。他是空的,但是main.css样式表指定其形状与内容:
div#indicator
{
position: absolute;
width: 100px;
height: 40px;
left: 10px;
top: 10px;
z-index: 900;
background: url(/images/indicator.gif) no-repeat 0 0;
}
添加AJAX交互来声明兴趣一个AJAX交互由三部分组成:调用者(一个链接,一个按钮或者是其他的用户启动动作的控件),一个服务器动作,以及页面中向用户显示动作结果的区域。
调用者让我们回到显示的问题。如果我们还记得第四天,一个问题可以在一个问题列表中显示,也可以在问题详细中显示。
这就是将问题标题与兴趣块重构到一个_interested_user.php片段中的原因。再次打开这个片段,添加一个链接允许用户声明其兴趣:
getInterestedUsers() ?>
这个链接所做的不仅是重定向到另一个页面。事实上,如果一个用户已经指定了其对某一个问题的兴趣,他就不可以再一次声明。而且如果这个用户没有被认证,呃,这将是我们后面要讨论的情况。
这个链接是在一个帮助器函数中编写的,这就需要在askeet/apps/frontend/lib/helper/UserHelper.php中创建:
use_helper('Javascript');
function link_to_user_interested($user, $question)
{
if ($user->isAuthenticated())
{
$interested = InterestPeer::retrieveByPk($question->getId(), $user->getSubscriberId());
if ($interested)
{
// already interested
return 'interested!';
}
else
{
// didn't declare interest yet
return link_to_remote('interested?', array(
'url' => 'user/interested?id='.$question->getId(),
'update' => array('success' => 'block_'.$question->getId()),
'loading' => "Element.show('indicator')",
'complete' => "Element.hide('indicator');".visual_effect('highlight', 'mark_'.$question->getId()),
));
}
}
else
{
return link_to('interested?', 'user/login');
}
}
?>
link_to_remote
()函数是AJAX交互的第一个元素:调用者。他声明了当用户点击链接时必须请求哪个动作(在这里为user/interested)以及页面中的哪个区
域必须使用动作结果进行更新。两个事件处理器(loding与complete)被添加进来并且与原型javascript函数相关联。原型库提供了手动
的javascript工具来使用简单的函数调用实现页面中的可视效果。唯一的不足是文档的缺乏,但是源码是相当直接的。
我们选择使用帮助器而不是partial,是因为这个函数的PHP代码要多于HTML代码。
不要忘记在question/_list片段中添加id id="block_getId() ?>"。
$question)) ?>
结果区域link_to_remote() javascript帮助器的update属性指定了结果区域。在这个例子中,user/interested动作的结果将会替换id为block_XX的元素的内容。如果我们还感到迷惑,我们可以查看一下这个模板片段中所集成的内容:
...
...
两段注释的中间区域即为结果区域。这个动作一旦执行,就会替换这些内容。
第二个id(mark_XX)的兴趣是十分明显的。link_to_remote帮助器的完整事件处理器将高亮显示已点击的兴趣的interested_mark
层,在动作返回一个兴趣的增量数。
服务器动作AJAX调用器指向user/interested动作。这个动作必须在Interest表中为当前的问题以及当前的用户创建新的记录。在Symfony中我们可以这样来做:
public function executeInterested()
{
$this->question = QuestionPeer::retrieveByPk($this->getRequestParameter('id'));
$this->forward404Unless($this->question);
$user = $this->getUser()->getSubscriber();
$interest = new Interest();
$interest->setQuestion($this->question);
$interest->setUser($user);
$interest->save();
}
在这里我们要记住,Interest对象的->save()方法已经被修改来增加相关用户的interested_user域。所以对于当前问题感兴趣的用户数目会在动作调用之后自动增加。
那么结果的interestedSuccess.php模板应如何显示呢?
$question)) ?>
他会再一次显示问题模块的_interested_user.php片段。这就是我们编写这个片段的最大好处。
我们必须禁止这个模板的布局(modules/user/config/view.yml):
interestedSuccess:
has_layout: off
最终测试AJAX
兴趣的开发到现在就结束了。我们可以进行相应的测试,在登陆页面输入已存在的用户名与密码,显示问题列表,并且点击'interested?'链接。当请
求发往服务器时就会显示指示器。然后,当服务器应答后增加的数目就会高亮显示。我们可以注意到初始的'interested?'链接现在变为
'interested'并且没有链接,这样就是我们的link_to_interested帮助器所起的作用。
添加一个内联'sign-in'表单我们在前面说到只有注册用户可以声明对某一个问题的兴趣。这就意味着如果一个未授权的用户点击一个'interested?'链接时,必须首先显示登陆页面。
但是等一下。为什么用户要装入一个新的页面来登陆,而失去与他所声明的感兴趣的问题失去联系呢?一个更好的办法就是在页面上动态装入一个登陆页面。这就是我们将要做的工作。
在布局中添加一个隐藏登陆表单打开全局布局(askeet/apps/frontend/templates/layout.php),添加下面的代码(header与content div之间的内容):
Please sign-in first
0.5))) ?>
nickname:
password:
get('referer')
? $sf_params->get('referer') : $sf_request->getUri()) ?>
再一次说明,这个表单默认是隐藏的。referer隐藏标记包含referer请求参数,或者是当前的URI。
当非授权用户点击interested链接时显示表单我们还记得在前面编写的User帮助器吗?现在我们将要来处理非授权用户的情况。打开askeet/lib/helper/UserHelper.php文件,将下面的代码行:
return link_to('interested?', 'user/login');return link_to('interested?', 'user/login');
改为:
return link_to_function('interested?', visual_effect('blind_down', 'login', array('duration' => 0.5)));
当用户为非授权时,'interested?'上的链接会载入一个原型javascript效果(blind_down)来为login id留出空间。
登陆用户user/login动作已经在第五天编写完成了,并且在第六天进行了重构。我们需要再一次进行修改。
public function executeLogin()
{
if ($this->getRequest()->getMethod() != sfRequest::POST)
{
// display the form
$this->getRequest()->getParameterHolder()->set('referer', $this->getRequest()->getReferer());
return sfView::SUCCESS;
}
else
{
// handle the form submission
// redirect to last page
return $this->redirect($this->getRequestParameter('referer', '@homepage'));
}
}
现在的工作已经很完美了,保存的referer将会用户重定向到用户点击以前所在的页面。
现在测试AJAX功能。一个未注册的用户点击时将会显示一个登陆页面而不离开当前页面。如果用户名与密码通过了认证,页面会进行刷新,用户可以点击他之前想要点击的'interested?'链接。
明天见
阅读(1140) | 评论(0) | 转发(0) |