在 CodeIgniter 中使用 jQuery

创建有效且实用的 Web 2.0 界面

了解使用 jQuery 改善您的 CodeIgniter 应用程序的可用性有多么简单。通过利用 CodeIgniter 的基于 MVC 的框架和 jQuery 对 Asynchronous JavaScript and XML (Ajax) 交互的支持,了解如何快速、高效地创建更有效的 UI。

Kevin Howard Goldberg, CTO, imagistic

http://www.ibm.com/developerworks/i/p-khgoldberg.jpgKevin Howard Goldberg 在高科技产业具有 20 多年的从业经验,现居住在美国加州 Westlake Village,是一名技术总监、作者和顾问。他目前是 imagistic 公司的 CTO,这是一家获过奖的数字营销和技术公司,这家公司是他在 1997 年与别人共同成立的。作为一个 Web 开发和技术专家,他在 Santa Monica College Computer Science Advisory Board 服务并曾在 Film Roman、Lionsgate 和 Philips Interactive Media 担任过高管。他是 XML: Visual QuickStart Guide (2nd Edition)(PeachPit Press,2008 年)一书的作者。可以通过 http://kehogo.com/contact 联系他。



2010 年 12 月 06 日

CodeIgniter 是使用 PHP 编写的一款流行的轻量级开源框架,基于 Model-View-Controller (MVC) 架构模式。jQuery 是快速、轻量级、开源 JavaScript 库,专门用于简化 HTML 页面操作和 Ajax 集成。当将两者结合使用时,它们就为快速开发可用 Web 站点和应用程序提供了强有力的基础。

试用 DB2 Express 9 数据库服务器的免费版本

DB2 Express-C 的设计初衷就是可以在几分钟之内启动并运行,它易于安装且是内置式的,包括自管理特性,以及 DB2 for Linux, UNIX, and Windows 的所有核心功能,例如 pureXML™。DB2 Express-C 提供了与其他 DB2 Express 版本相同的核心数据服务器基本特性,为使用 C/C++、Java™、.NET®、PHP、Ruby on Rails、Python 和其他编程语言构建和部署应用程序提供了坚实的基础。

本文展示了如何将这两个系统集成到一个单一框架中,以及如何使用 jQuery 改善现有 Web 应用程序的 UI。本文假设您已经安装了 CodeIgniter 版本 1.7.2 或更高版本以及 MySQL 版本 4.1 或更高版本,并且对这两者有较好的理解。此外,您需要 jQuery 库版本 1.4.2 或更高版本。如果首次接触 CodeIgniter 或是需要复习一下,那么请参见 参考资料 中的链接以获得更多信息。

Web 2.0:对 Ajax 使用 jQuery

Web 2.0 的一个重要方面就是用户体验更加类似于桌面应用程序的用户体验。具体来讲,与 Web 页面的交互不要求与 Web 服务器进行 “视觉沟通” — 例如,单击 Submit,等待 Web 服务器处理提交的信息,然后使用更新后的内容刷新整个 Web 页面。相反,只有更新后的内容会被刷新,而页面的其余部分保持不变。

这种 “submission-less” 过程通过使用 Ajax 实现,Ajax 使 Web 开发人员在不需要刷新页面的情况下在 Web 客户机(浏览器)和 Web 服务器之间传输信息。更妙的是,这种信息传输的触发不需要用户直接干预。

当一个 Web 页面使用 Ajax 时,它将异步向 Web 服务器发送或从其中接收数据。所传输的数据采用普通文本形式,因此,可以具有许多不同的格式,比如 XML、HTML、JSON,或仅仅是文本。

实际的数据传输通过 JavaScript 和称为 XMLHttpRequest 的 API 完成,而这个过程正是 jQuery 发挥作用的地方。jQuery 库极大地简化了使用 Ajax 的过程。并且,不仅简化了 Ajax 的使用,而且还简化了更新数据的显示。(如果您曾经尝试过用 JavaScript 传输 HTML DOM,您就能够真正体会到这个过程变得有多么容易!)


现有的 CodeIgniter 应用程序

为了演示对 CodeIgniter 使用 jQuery 的威力和简单性,本文将带领您改善一个现有 Web 应用程序的 UI。该应用程序旨在帮助教师管理课堂活动以及每位家长的参与。教师首先从一个经董事会批准的选项列表中选择课堂活动,然后为每个活动安排一个日期。然后,学生家长登录站点并输入他们的孩子的联系信息。他们可以查看课堂活动列表并选择其参与程度(比如采购、帮助筹备、协助或充当一名活动负责人)。

注意:该系统可以很轻松地应用以支持儿童运动队、YMCA 小组等等。

对于本文,应用程序的数据库加载了大约 100 项活动、5 名家长和一名老师。家长的用户名为 parent1,parent2,……,parent5。教师的用户名为 teacher,并且所有的密码均为 ibm。您将需要 下载 Web 应用程序和数据库并在一个 Web 服务器上安装它们,以继续本文内容。应用程序要求 CodeIgniter 框架作为服务器的根。


设置 jQuery

要开始使用 jQuery,首先下载 library(参见 参考资料 获得链接)。为每个版本提供了两个文件:一个未压缩的文件和一个 “缩小的” 文件(这种经过高度压缩的版本可快速加载,但是难以跟踪)。我建议对开发使用未压缩版本,在生产中使用缩小版。

接下来,将 jQuery 库文件放到 Web 服务器的根目录下的 .assets/js 文件夹。然后,在同一个文件夹中创建名为 global.js 的新文件,如清单 1 所示。这将是您放置完整应用程序的 JavaScript 代码的位置。

清单 1. 使用 jQuery 的 “Hello World”
/* Global JavaScript File for working with jQuery library */

// execute when the HTML file's (document object model: DOM) has loaded
$(document).ready(function() {

  alert ('Hello World');
	
});

对本文而言 — 以及大部分应用程序 — 许多 jQuery 代码将位于 $(document).ready() 函数中。该函数只有在 HTML 文件的 DOM 完成加载后才会自动触发。

如果应用程序要加载所有这些文件,那么编辑 ./system/application/views/template.php 文件,如清单 2 所示。

清单 2. 加载 jQuery 和全局 JavaScript 文件
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />

<link href="/assets/css/screen.css" rel="stylesheet" type="text/css" />

<!--  the following two lines load the jQuery library and JavaScript files -->
<script src="/assets/js/jquery-1.4.2.js" type="text/javascript"></script>
<script src="/assets/js/global.js" type="text/javascript"></script>

<title><?php echo $title;?></title>
</head>

现在,导航到 Web 站点的索引页面。当页面加载时,一个 JavaScript 警告将显示 “Hello World”。


对 CodeIgniter 使用 jQuery 和 Ajax

准备好 jQuery 库和 global.js 文件后,您就可以开始改善您的应用程序的界面了。如果还没有的话,那么花几分钟的时间作为家长和教师登录,熟悉一下这些活动如何在系统中工作。

自动用户名验证

您将改进的第一个 UI 部分是 Registration 页面。目前,检验用户名是否已被使用是在用户提交页面后完成的。然而,通过使用 Ajax,您可以运行服务器端验证并返回结果,无需任何页面提交。

为此,将代码绑定到用户名字段的 onblur() 事件,该事件将在用户光标离开字段时触发。清单 3 展示了更新后的 global.js 文件。

清单 3. 检查用户名是否已被注册
/* Global JavaScript File for working with jQuery library */

// execute when the HTML file's (document object model: DOM) has loaded
$(document).ready(function() {

  /* USERNAME VALIDATION */
  // use element id=username 
  // bind our function to the element's onblur event
  $('#username').blur(function() {

    // get the value from the username field                              
    var username = $('#username').val();
    
    // Ajax request sent to the CodeIgniter controller "ajax" method "username_taken"
    // post the username field's value
    $.post('/index.php/ajax/username_taken',
      { 'username':username },

      // when the Web server responds to the request
      function(result) {
        // clear any message that may have already been written
        $('#bad_username').replaceWith('');
        
        // if the result is TRUE write a message to the page
        if (result) {
          $('#username').after('<div id="bad_username" style="color:red;">' +
            '<p>(That Username is already taken. Please choose another.)</p></div>');
        }
      }
    );
  });  

});

jQuery 中的 $

在 jQuery 中,美元符号($)实际上是用于创建新 jQuery 对象的别名。因此,JavaScript 变量 this 不同于 jQuery 对象 $(this),后者从 JavaScript 变量中创建。对于熟悉在变量前面加 $ 的 PHP 开发人员来说,$ 尤其令人感到困惑。如果代码出现问题,那么务必要检查一下 $ 的使用。

该代码使用 ID 为 username 的 DOM 元素创建了一个 jQuery 对象。随后调用 jQuery blur() 方法,后者将一个函数绑定到用户名字段的 onblur() 事件。此函数使用 Ajax 将用户名字段中的一个值提交到名为 ajax 的 CodeIgniter 控制器及其方法 username_taken 中。接着,将根据 Ajax post 的结果清除现有的错误消息,显示或不显示错误消息。

接下来,在 ./system/application/controllers 中,创建一个名为 ajax.php, 的文件,该文件由 jQuery Ajax .post() 方法引用。清单 4 展示了该控制器的源代码。(注意,将控制器命名为 ajax 没有什么特别的地方。可以将其命名为任何名称,只要 .post() 方法中的 URL 指向正确的控制器)。

清单 4. 处理 Ajax 请求的 CodeIgniter 控制器
<?php

class Ajax extends Controller {

  public function Ajax() {
  
    parent::Controller(); 
  }

  public function username_taken()
  {
    $this->load->model('MUser', '', TRUE);
    $username = trim($_POST['username']);
    // if the username exists return a 1 indicating true
    if ($this->MUser->username_exists($username)) {
      echo '1';
    }
  }

}

/* End of file ajax.php */
/* Location: ./system/application/controllers/ajax.php */

注意,username_taken() 方法并没有返回 值。相反,它回传了其响应,而这一点非常重要。jQuery Ajax 请求将数据发布到 Web 页面并使用结果页面的数据;并没有通过编程方式触及该方法本身。

现在,您的第一个 Ajax 函数已经完成。导航到 Registration 页面并用任何已经被使用的用户名进行注册,查看相应的错误消息。

有趣的是,jQuery 代码在编写时出现了一个意外的结果。Ajax 函数被绑定到字段且 ID 为 username,这将把用户名字段包含到 Login 页面。清单 5 展示了如何修改 jQuery 对象以使其只绑定到 registration_form 表单中的用户名字段。

清单 5. 限定正确的用户名字段
  /* USERNAME VALIDATION */
  // use element id=username within the element id=registration_form
  // bind our function to the element's onblur event
  $('#registration_form').find('#username').blur(function() {

无缝状态更新和保存

下一项 UI 改进发生在 Class Activity 清单页面。家长要表示他或她将参见某项活动,只需单击相应的单选按钮,然后单击 save 链接以提交页面。对 UI 的改进就是避免单击 save 链接,因而也避免了页面提交。

首先,将以下代码添加到 global.js 文件。这些代码被放在清单 6、清单 7 和清单 8 中,以使描述更简单。

清单 6. 使用 jQuery 获得相关元素值
  /* AUTOSAVE PARTICIPATION */
  // use input element name=participation_type_id and type=radio
  // bind our function to the element's onclick event
  $('input[name=participation_type_id]:radio').click(function() {
    
    var participation_type_id = this.value;

    // create global variables for use below
    var class_activity_id, user_id;
    
    // get the form's two hidden input elements 
    // each is a sibling of the parent of the clicked radio button
    // store their values in the global variables
    var hidden_elements = $(this).parent().siblings('input:hidden');
    $(hidden_elements).map(function() {
      if (this.name == 'class_activity_id') {
        class_activity_id = this.value;
      }
      if (this.name == 'user_id') {
        user_id = this.value;
      }
    });

jQuery 和 DOM 结构

尽管 jQuery 隐藏了许多 DOM 导航的复杂性,但它并不是万能的。特别是,您将需要了解文档元素之间的层次结构关系,从而更有效地使用 jQuery 。

该函数被绑定到任何名为 participation_type_id 的单选按钮的 onclick() 事件。它获得被单击的单选按钮的值。然后,使用一组链接的方法返回隐藏的表单元素。map() 方法通过其函数传递每个元素,检索 class_activity_iduser_id 值。

对用于设置家长参与的值进行标识后,代码将执行一个 Ajax 请求以保存此信息,如清单 7 所示。服务器对该请求的响应不会回传任何数据,因此 jQuery 响应函数为空(并且实际上可以被移除)。

清单 7. 向 CodeIgniter 发布一个 Ajax 请求
    // Ajax request to CodeIgniter controller "ajax" method "update_user_participation"
    // post the user_id, class_activity_id and participation_type_id fields' values
    $.post('/index.php/ajax/update_user_participation',
      { 'user_id':user_id, 
        'class_activity_id':class_activity_id, 
        'participation_type_id':participation_type_id },
      // when the Web server responds to the request
      function(result) { }
    );

最后,使用 jQuery next() 方法将单选按钮旁边的文本修改为相应的颜色,以针对不同的字符串。代码如清单 8 所示。

清单 8. 动态修改单选按钮文本的颜色
    // set the text next to the clicked radio button to red
    $(this).next().css("color", "red");

    // set the text next to the remaining radio buttons to black
    var other_r_buttons = $(this).siblings('input[name=participation_type_id]:radio');
    $(other_r_buttons).map(function() {
      $(this).next().css("color", "black");
    });

  });

现在已经编写好 jQuery 代码,您需要在 ajax 控制器中创建 update_user_participation() 方法,如清单 9 所示。

清单 9. 在 CodeIgniter 中处理用户参与
  public function update_user_participation()
  {
    $this->load->model('MActivity', '', TRUE);
    $this->MActivity->set_user_participation($_POST);
  }

该方法使用已在 MActivity 模型中找到的 set_user_participation() 方法,它将获取 Ajax 请求发出的变量。

最后,在 ./system/application/controller/activity.php 中注释掉保存链接,如清单 10 所示。

清单 10. 删除没有用的保存链接
          '<span style="style="white-space: nowrap;">'.
          $participation_type_buttons.'&nbsp;&nbsp;'.
          /* the save link is no longer needed
            '<a href="" onclick="document.forms[\'form_'.$activity->id.'\'].submit();
return false;">save</a>'. */
          '</span>'.
          '</form>';

您现在可以修改家长参与,并且不需要页面刷新即可自动保存。

自动提示输入字段

最有效且使用范围最广的一项 Ajax 应用就是自动提示或自动完成功能。以教师身份登录,并单击 Manage Class Activities。要添加一项活动,用户必须向下滚动长活动列表。要改善 UI,在 ./system/application/views/activity_master_listing.php 文件的顶部向 autosuggest 函数添加一个输入字段绑定,如清单 11 所示。这样做将允许教师更轻松地从所有未安排的活动中进行选择。

清单 11. 添加一个自动提示输入字段
<div id="select_anchor">
  <a href="" onclick="$('#select_anchor').hide(100); 
    $('#select_activity').show(100);
    return false;">
    Select an unscheduled Activity to add >></a>
  <br /><br />
</div>
<div id="select_activity" class="requested_activity" style="display:none;">
  <table>
    <caption>&nbsp;Select an unscheduled Activity</caption>
    <tr class="odd_row_add">
      <td>
        Begin by typing a few letters of an activity name<br />
        then select from the resulting list<br />
        <br />
        <input type="text" value="" id="class_activity" 
          onkeyup="autosuggest(this.value);" class="autosuggest_input" />
        <div class="autosuggest" id="autosuggest_list"></div>
      </td>
    </tr>
  </table>
</div>

注意绑定到 JavaScript onclick() 事件的两个 jQuery 对象和方法。记住,jQuery 只是一个 JavaScript 库,因此可以在整个应用程序中与 JavaScript 无缝交互,而不仅仅是在 $(document).ready() 函数中。

接下来,在 global.js 文件的 $(document).ready() 函数之外,实现以下 JavaScript 函数。它一定是 class_activity 输入字段的 onkeyup() 事件。源代码如清单 12 所示。

清单 12. 使用 jQuery 实现自动提示
/* AUTOSUGGEST SEARCH */
// triggered by input field onkeyup
function autosuggest(str){
  // if there's no text to search, hide the list div
  if (str.length == 0) {
    $('#autosuggest_list').fadeOut(500);
  } else {
    // first show the loading animation
    $('#class_activity').addClass('loading');
    
    // Ajax request to CodeIgniter controller "ajax" method "autosuggest"
    // post the str parameter value
    $.post('/index.php/ajax/autosuggest',
      { 'str':str },
      function(result) {
        // if there is a result, fill the list div, fade it in 
        // then remove the loading animation
        if(result) {
          $('#autosuggest_list').html(result);
          $('#autosuggest_list').fadeIn(500);
          $('#class_activity').removeClass('loading');
      }
    });
  }
}

注意,尽管此函数不在 $(document).ready() 函数内,但是它仍然使用 jQuery 对象和方法。它的 jQuery .post() 方法调用 Ajax 控制器的 autosuggest() 方法,后者回传 autosuggest 结果的无序列表。清单 13 显示了代码。

清单 13. 检索和回传自动提示结果
  public function autosuggest()
  {
    // escapes single and double quotes
    $str = addslashes($_POST['str']);
    
    $this->load->model('MActivity', '', TRUE);
    $unscheduled_activities_qry = $this->MActivity->find_unscheduled_activities($str);
    
    // echo a list where each li has a set_activity function bound to its onclick() event
    echo '<ul>';
    foreach ($unscheduled_activities_qry->result() as $activity) {
      echo '<li onclick="set_activity(\''.addslashes($activity->name).'\'';
      echo ', '.$activity->id.');">'.$activity->name.'</li>'; 
    }
    echo '</ul>';
  }

接下来,添加 find_unscheduled_activities() 方法以从数据库返回 autosuggest 结果。清单 14 显示了 ./system/application/models/mactivity.php 中的代码。

清单 14. 在数据库中查询未安排的活动
  // Finds all unscheduled activities that match the passed string
  function find_unscheduled_activities($str)
  {
    $this->db->select('id, name
        FROM master_activity 
        WHERE name LIKE \''.$str.'%\'
          AND id NOT IN 
            (SELECT master_activity_id FROM class_activity)
          ORDER BY name', FALSE);
    return $this->db->get();
  }

您还需要对 autosuggest <div> 应用样式并将其列成表,从而使 UI 更清晰、更便于单击列表元素。样式被添加到 ./assets/css/screen.css,如清单 15 所示。

清单 15. 使自动提示列表更清晰、更易于单击
/***************/
/* Autosuggest */

.autosuggest {
  border:1px solid #000000;
  display:none;
  overflow:hidden;
  padding:0px;
  position:absolute;
  width:200px;
  z-index:1;
}

.autosuggest ul li {
  background-color:#FFFFFF;
  cursor:pointer;
  display:block;
  list-style:none;
  padding:5px;
  white-space:nowrap;
}

.autosuggest ul li:hover {
  background-color:#316AC5;
  color:#FFFFFF;
}

.loading{
  background-image:url('../img/indicator.gif');
  background-position:right;
  background-repeat:no-repeat;
}

.autosuggest_input {
  width:200px;
}

.table_header_add {
  background-color:#FFCC66;
}

.odd_row_add {
  background-color:#FFCC66;
}

您现在已经完成了一半工作。您可以将字符输入到字段,检索一组匹配的活动。现在,实现用于选择、显示和保存课堂活动的代码。首先向 global.js 文件添加两个函数,用于设置活动名字段并显示一行活动信息。清单 16 展示了这两个函数的源代码。

清单 16. 获得并显示所选活动
/* AUTOSUGGEST SET ACTIVITY */
// triggered by an onclick from any of the li's in the autosuggest list
// set the class_acitity field, wait and fade the autosuggest list
// then display the activity details
function set_activity(activity_name, master_activity_id) {
  $('#class_activity').val(activity_name);
  setTimeout("$('#autosuggest_list').fadeOut(500);", 250);
  display_activity_details(master_activity_id);
}

/* AUTOSUGGEST DISPLAY ACTIVITY DETAILS */
// called by set_activity()
// get the HTML to display and display it
function display_activity_details(master_activity_id) {
  
  // Ajax request to CodeIgniter controller "ajax" method "get_activity_html"
  // post the master_class_activity parameter values
  $.post('/index.php/ajax/get_activity_html',
    { 'master_activity_id':master_activity_id },
    // when the Web server responds to the request
    // replace the innerHTML of the select_activity element
    function(result) { 
      $('#select_activity').html(result);
    }
  );
}

代码还使用 Ajax 获得显示所选活动的表行。使用清单 17 的代码生成它的 HTML。

清单 17. 回传显示活动的 HTML 表
  public function get_activity_html()
  {
    $this->load->model('MActivity', '', TRUE);
    $this->load->library('table');

    $requested_activity_id = $_POST['master_activity_id'];
    $requested_activity_qry = 
      $this->MActivity->get_requested_master_activity($requested_activity_id);

    // code leveraged from /controllers/activity.php manage_class_listing() method
    // generate HTML table from query results
    $tmpl = array (
      'table_open' => '<table>',
      'heading_row_start' => '<tr class="table_header_add">',
      'row_start' => '<tr class="odd_row_add">' 
    );
    $this->table->set_template($tmpl); 
    
    $this->table->set_caption('&nbsp;Add this Activity'); 

    $this->table->set_empty("&nbsp;"); 
    
    $this->table->set_heading('<span class="date_column">Date</span>',
                  '<span class="activity_name_column">Activity Name</span>',
                  '<span class="address_column">Address</span>',
                  'City', 'Details');
    
    $table_row = array();

    foreach ($requested_activity_qry->result() as $activity)
    {
      $m_id = $activity->master_activity_id;

      $table_row = NULL;

      $table_row[] = ''.
        '<form action="" name="form_'.$m_id.'" method="post">'.
        '<input type="hidden" name="master_activity_id" value="'.$m_id.'"/> '.
        '<input type="text" name="activity_date" size="12" /> '.
        '<input type="hidden" name="action" value="save" /> '.
        '</form>'.
        '<span class="help-text">format: MM-DD-YYYY</span><br/>'.
        '<a href="" onclick="document.forms[\'form_'.$m_id.'\'].submit();'.
        'return false;">save</a>';


      $table_row[] = '<input type="text" value="'.$activity->name.
        '" id="class_activity" onkeyup="autosuggest(this.value);"'.
        'class="autosuggest_input" />'.
        '<div class="autosuggest" id="autosuggest_list"></div>';
      $table_row[] = htmlspecialchars($activity->address);
      $table_row[] = htmlspecialchars($activity->city);
      $table_row[] = htmlspecialchars($activity->details);

      $this->table->add_row($table_row);
    }    
      
    $requested_activities_table = $this->table->generate();

    echo $requested_activities_table;
  }

}

这段代码在活动控制器中使用,并且只进行了少量修改,包括回传最终表(而不是返回表)。需要使用来自 ./system/application/models/mactivity.php 的如清单 18 所示的 SQL 查询。

清单 18. 返回所请求的主活动
  // Returns a single master activity record
  public function get_requested_master_activity($id)
  {
    $this->db->select('id as master_activity_id, name, address, city, details');
    $this->db->where('id', $id);
    return $this->db->get('master_activity');
  }

最后,尽管您可能已经添加了一项新的活动,但您还需要删除未安排的活动并按照升序重新对列表排序。MActivity 模型的更新后的 SQL 代码如清单 19 所示。

清单 19. 只返回未安排的活动
  // Retrieve all master activity records
  function list_class_activities($activity_id)
  {
    // get all records
    if (!$activity_id) {
      $this->db->select('ma.id as master_activity_id, ma.name, 
                ma.address, ma.city, 
                ma.details, ca.id as class_activity_id, ca.date
            FROM master_activity ma
            /*LEFT*/ JOIN class_activity ca ON ca.master_activity_id = ma.id
            ORDER BY ca.date /*DESC*/, ma.name', FALSE);
      return $this->db->get();
    // get all records except the one being requested
    } else {
      $this->db->select('ma.id as master_activity_id, ma.name, 
                ma.address, ma.city, 
                ma.details, ca.id as class_activity_id, ca.date
            FROM (SELECT * FROM master_activity 
              WHERE master_activity.id != '.$activity_id.') ma
            /*LEFT*/ JOIN class_activity ca ON ca.master_activity_id = ma.id
            ORDER BY ca.date /*DESC*/, ma.name', FALSE);
      return $this->db->get();
    }
  }

使用可视日历进行日期选择

最后一项 UI 改进是使用一个可视日历替换用于输入日期的文本输入字段。为此,使用 jQuery UI Datepicker,这是来自 jQuery UI 库(jQuery 库的一个开源扩展)的一个流行插件。更新 ./system/application/views/template.php 文件,如清单 20 所示。

清单 20. 包括 jQuery UI Datepicker
<!-- including the jQuery UI Datepicker and styles -->
<script src="http://ajax.googleapis.com/ajax/libs/jqueryui/1.7.2/jquery-ui.min.js"
  type="text/javascript"></script>
<link href="/assets/css/jquery-ui-1.7.2.custom.css" rel="stylesheet" type="text/css" />
<style type="text/css">
  /* jQuery UI sizing override */
  .ui-widget {font-size:1em;}
</style>

注意,不需要下载该库,<script> 标记引用了 http://ajax.googleapis.com,这是可供许多库(jQuery UI)使用的免费存储库。CSS 文件和映像已被配置为仅包含必要的样式(http://jqueryui.com/download)。最后,jQuery UI 库在构建时假设正文字体的大小为 62.5%,因此可以覆盖默认设置来适当地调整大小。

Datepicker 将绑定到 HTML 内的一个 CSS 类或 ID。对于活动编辑函数,在 ./system/application/controllers/activity.php 中大概 210 行的位置向日期输入字段分配一个名为 date-picker 的类。代码如清单 21 所示。

清单 21. 分配 date-picker 类以进行编辑
          // add the date-picker class to the date input field
          '<input type="text" name="activity_date" size="12" value="'.
            date('m/d/Y', strtotime($activity->date)).'" class="date-picker" /> '.
          '<input type="hidden" name="action" value="update" /> '.
          '</form>'.
          '<span class="help-text">format: MM/DD/YYYY</span><br/>'.

对于活动添加函数,在 ./system/application/controllers/ajax.php 中大约 83 行的位置向日期输入字段分配同一个类,如清单 22 所示。

清单 22. 分配 date-picker 类以实现添加
        // add the date-picker class to the date input field
        '<input type="text" name="activity_date" size="12" class="date-picker" /> '.
        '<input type="hidden" name="action" value="save" /> '.
        '</form>'.
        '<span class="help-text">format: MM/DD/YYYY</span><br/>'.

最后,绑定 Datepicker 从而在添加或编辑一项课堂活动时显示出来。将放置在 global.js 文件的 $(document).ready() 函数内部的代码如清单 23 所示。

清单 23. 将 Datepicker 绑定到类
  /* jQUERY UI CALENDAR PLUGIN */
  // bind the Datepicker to the date-picker class
  $(".date-picker").datepicker();

现在尝试编辑课堂活动。当将光标放到日期输入字段时,将出现一个日历,允许您为活动选择一个日期。但是,在尝试添加一项活动时不会出现日历。这是因为活动添加 HTML 是在文档已加载完成(使用 Ajax)后编写的,因此 Datepicker 不会绑定到它的日期输入字段。要解决这个问题,需要在 Ajax 函数编写完 HTML 后将 Datepicker 绑定到日期输入字段。对 global.js 文件中的 display_activity_details() 函数的修改如清单 24 所示。

清单 24. 将 Datepicker 绑定到添加日期字段
    function(result) { 
      $('#select_activity').html(result);

      // because the add datepicker is not loaded with the DOM
      // manually add it after the date input field is written
      $(".date-picker").datepicker();
    }

现在,您可以使用 Datepicker 日历添加一个课堂活动。


结束语

加入 My developerWorks 上的 Web 开发组

My developerWorks Web 开发组 中与其他开发人员讨论与 Web 开发有关的话题并分享资源。

还不是 My developerWorks 的一员?立刻加入!

在本文中,您已了解到如何通过 jQuery 集成 DOM 操作以及通过 Ajax 实现无缝集成,从而极大地改进了应用程序的 UI。并且在许多情况下,实现这些改进的代码通常都很简单。现在,您可能希望进一步接受挑战,使用 Ajax 以内联的方式显示课堂活动,或者是实现在阅读本文时想到的任何其他 UI 想法,从而进一步改进应用程序。


下载

描述名字大小
创建 classroom 数据库的 SQL 文件classroom_database.zip15KB
包括 CodeIgniter 文件在内的完整初始代码库source_w_codeigniter.zip411KB
本文的初始 MVC 文件source_only.zip23KB
jQuery 库 v1.4.2jquery_library.zip45KB
jQuery UI Datepicker 所需的 CSS 文件jquery_datepicker.zip53KB
包括 CodeIgniter 文件在内的完整最终代码库final_source_w_codeigniter.zip515KB
本文的最终 MVC 文件final_source_only.zip124KB

参考资料

学习

获得产品和技术

  • CodeIgniter:下载 CodeIgniter 的最新版本。
  • MySQL:下载 MySQL 的最新版本。
  • jQuery:进一步了解并下载 jQuery 库的最新版本。
  • jQuery UI:了解更多并从 jQuery UI Web 站点下载更多小部件。
  • IBM 产品评估版:下载这些版本并开始使用来自 DB2®、Lotus®、Rational®、Tivoli® 和 WebSphere® 的应用程序开发工具和中间件产品。

讨论

条评论

developerWorks: 登录

标有星(*)号的字段是必填字段。


需要一个 IBM ID?
忘记 IBM ID?


忘记密码?
更改您的密码

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件

 


在您首次登录 developerWorks 时,会为您创建一份个人概要。您的个人概要中的信息(您的姓名、国家/地区,以及公司名称)是公开显示的,而且会随着您发布的任何内容一起显示,除非您选择隐藏您的公司名称。您可以随时更新您的 IBM 帐户。

所有提交的信息确保安全。

选择您的昵称



当您初次登录到 developerWorks 时,将会为您创建一份概要信息,您需要指定一个昵称。您的昵称将和您在 developerWorks 发布的内容显示在一起。

昵称长度在 3 至 31 个字符之间。 您的昵称在 developerWorks 社区中必须是唯一的,并且出于隐私保护的原因,不能是您的电子邮件地址。

标有星(*)号的字段是必填字段。

(昵称长度在 3 至 31 个字符之间)

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件.

 


所有提交的信息确保安全。


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Web development
ArticleID=594356
ArticleTitle=在 CodeIgniter 中使用 jQuery
publish-date=12062010