基于CodeIgniter和jQuery实现动态表格数据筛选教程（筛选.表格.教程.动态.数据...）

wufei123 发布于 2025-09-02 阅读（12）

基于CodeIgniter和jQuery实现动态表格数据筛选教程

本教程详细介绍了如何在CodeIgniter框架下，利用jQuery和AJAX技术实现表格数据的实时动态筛选功能。通过前端下拉菜单的change事件触发AJAX请求，将筛选条件发送至后端控制器，后端查询数据库并返回JSON格式数据，前端接收后动态更新表格内容，从而提供无刷新、交互性强的用户体验。

在现代web应用中，用户对交互性和响应速度的要求越来越高。传统的表单提交方式在进行数据筛选时会导致页面刷新，影响用户体验。通过结合ajax（asynchronous javascript and xml）技术，我们可以实现无需刷新页面的实时数据过滤功能。本教程将以codeigniter框架为例，详细讲解如何利用jquery库实现这一功能，包括前端视图层、后端控制器层和数据模型层的实现细节。

核心概念概览

在深入实现之前，我们首先理解几个关键概念：

  • AJAX: 允许在不重新加载整个网页的情况下，与服务器交换数据并更新部分网页内容。
  • CodeIgniter (MVC): 一个轻量级的PHP框架，采用Model-View-Controller（模型-视图-控制器）架构模式，有助于分离应用逻辑、数据处理和用户界面。
  • jQuery: 一个快速、小型且功能丰富的JavaScript库，简化了HTML文档遍历、事件处理、动画和AJAX交互。
  • JSON (JavaScript Object Notation): 一种轻量级的数据交换格式，易于人阅读和编写，也易于机器解析和生成，常用于AJAX请求的数据传输。
前端视图层 (View) 实现

前端视图负责展示数据表格和筛选用的下拉菜单，并监听用户操作，发起AJAX请求。

1. HTML 结构

首先，我们需要一个HTML表格来显示数据，并在表格上方或列头位置放置下拉菜单。为方便JavaScript操作，给下拉菜单添加一个唯一的id。

<!-- 引入 jQuery 库，通常放在 </body> 标签之前 -->
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>

<table>
    <thead>
        <tr>
            <th width="10%">
                Source
                <select id="sourceFilter">
                    <option value="">All</option>
                    <?php if (isset($sources) && $sources) : ?>
                        <?php foreach ($sources as $source) : ?>
                            <option value="<?php echo $source['title']; ?>"><?php echo $source['title']; ?></option>
                        <?php endforeach; ?>
                    <?php endif; ?>
                </select>
            </th>
            <!-- 如果有其他列和筛选器，也类似添加 -->
        </tr>
    </thead>
    <tbody id="dataTableBody">
        <?php
        if (isset($records) && count($records) > 0) {
            foreach ($records as $row) {
        ?>
                <tr>
                    <td><?= $row->source; ?></td>
                    <!-- 其他列的数据 -->
                </tr>
        <?php
            }
        } else {
            echo '<tr><td colspan="1">No records found.</td></tr>';
        }
        ?>
    </tbody>
</table>

2. JavaScript (jQuery) 逻辑

使用jQuery监听下拉菜单的change事件。当用户选择一个选项时，触发AJAX请求到后端，获取过滤后的数据，并动态更新表格内容。

<script>
    $(document).ready(function() {
        // 监听 sourceFilter 下拉菜单的 change 事件
        $('#sourceFilter').on('change', function() {
            // 获取当前选中的值
            var selectedSource = $(this).val();
            // 如果有多个筛选器，可以在这里收集所有筛选器的值
            // var otherFilterValue = $('#otherFilterId').val();

            // 发送 AJAX GET 请求到后端
            $.get('<?php echo base_url('ajax_filter_records'); ?>', {
                source: selectedSource
                // 如果有多个筛选器，可以这样添加参数:
                // other_param: otherFilterValue
            }, function(response) {
                // 解析后端返回的 JSON 字符串
                var records = JSON.parse(response);
                var tableBody = $('#dataTableBody');
                tableBody.empty(); // 清空现有表格内容

                if (records.length > 0) {
                    // 遍历返回的数据，动态生成表格行
                    $.each(records, function(index, record) {
                        var row = '<tr><td>' + record.source + '</td></tr>';
                        // 如果有其他列，需要在这里拼接
                        tableBody.append(row);
                    });
                } else {
                    tableBody.append('<tr><td colspan="1">No records found.</td></tr>');
                }
            }).fail(function(jqXHR, textStatus, errorThrown) {
                // 处理 AJAX 请求失败的情况
                console.error("AJAX request failed: " + textStatus, errorThrown);
                $('#dataTableBody').empty().append('<tr><td colspan="1">Error loading data.</td></tr>');
            });
        });
    });
</script>

注意事项：

  • base_url('ajax_filter_records')：ajax_filter_records是我们在CodeIgniter路由中定义的AJAX请求的URL。
  • JSON.parse(response)：后端返回的数据是JSON字符串，需要使用JSON.parse()将其转换为JavaScript对象数组。
  • tableBody.empty()：在更新表格之前，务必清空现有内容，避免数据重复。
  • 错误处理：fail()回调函数用于处理AJAX请求失败的情况，提升用户体验。
后端控制器层 (Controller) 处理

后端控制器负责接收前端发送的筛选条件，调用模型获取过滤后的数据，并将数据以JSON格式返回给前端。

1. 路由配置

在CodeIgniter的application/config/routes.php文件中，定义一个路由规则，将AJAX请求的URL映射到控制器的一个方法。

// application/config/routes.php
$route['ajax_filter_records'] = 'DataController/filterRecords'; // 映射到 DataController 类的 filterRecords 方法

2. 控制器方法

创建一个控制器（例如DataController.php），并在其中实现filterRecords方法。

// application/controllers/DataController.php
<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class DataController extends CI_Controller {

    public function __construct() {
        parent::__construct();
        // 加载模型，假设你有一个名为 Data_model 的模型
        $this->load->model('Data_model');
    }

    public function filterRecords() {
        // 确保请求是 AJAX 请求，提高安全性
        if (!$this->input->is_ajax_request()) {
            show_404(); // 或者返回错误信息
        }

        // 获取前端通过 GET 请求发送的筛选参数
        $source_filter = $this->input->get('source');
        // 如果有其他筛选参数，也类似获取
        // $other_filter = $this->input->get('other_param');

        // 调用模型方法获取过滤后的数据
        // 传入筛选条件，模型将根据这些条件查询数据库
        $filtered_records = $this->Data_model->getFilteredRecords($source_filter);

        // 设置响应头为 JSON 格式
        $this->output->set_content_type('application/json');
        // 将数据编码为 JSON 字符串并输出
        echo json_encode($filtered_records);
    }
}

注意事项：

  • $this->input->is_ajax_request()：用于判断请求是否为AJAX请求，可以增加一层安全性。
  • $this->input->get('source')：获取GET请求参数中名为source的值。
  • $this->load->model('Data_model')：在控制器构造函数中加载你的数据模型。
  • $this->output->set_content_type('application/json')：告知浏览器响应内容是JSON格式。
  • echo json_encode($filtered_records)：将从模型获取的数据数组转换为JSON字符串并发送回前端。
数据模型层 (Model) 实现

模型层负责与数据库交互，执行实际的筛选查询。

1. 模型方法

创建一个模型（例如Data_model.php），并在其中实现getFilteredRecords方法。

// application/models/Data_model.php
<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Data_model extends CI_Model {

    public function __construct() {
        parent::__construct();
        $this->load->database(); // 加载数据库库
    }

    /**
     * 根据筛选条件获取数据
     * @param string|null $source_filter 源筛选条件
     * @return array 过滤后的记录数组
     */
    public function getFilteredRecords($source_filter = null) {
        $this->db->select('*');
        $this->db->from('your_table_name'); // 替换为你的实际表名

        // 根据筛选条件构建 WHERE 子句
        if (!empty($source_filter)) {
            $this->db->where('source', $source_filter);
        }
        // 如果有其他筛选条件，可以类似添加
        // if (!empty($other_filter)) {
        //     $this->db->where('other_column', $other_filter);
        // }

        $query = $this->db->get();
        return $query->result_array(); // 返回结果为关联数组，便于 JSON 编码
    }
}

注意事项：

  • $this->load->database()：在模型构造函数中加载数据库库。
  • $this->db->where('source', $source_filter)：根据传入的$source_filter构建WHERE条件。当$source_filter为空时（即选择“All”），不添加WHERE条件，从而显示所有记录。
  • $query->result_array()：返回查询结果的数组形式，每个记录是一个关联数组，这非常适合直接用json_encode转换。
整合与多条件筛选

如果存在多个下拉菜单进行多条件筛选，前端需要收集所有下拉菜单的当前值，并作为AJAX请求的参数发送。后端控制器接收这些参数，并将其传递给模型，模型则根据所有有效条件构建更复杂的查询。

前端 (jQuery):

// 假设有多个筛选器：sourceFilter, categoryFilter
$('#sourceFilter, #categoryFilter').on('change', function() {
    var selectedSource = $('#sourceFilter').val();
    var selectedCategory = $('#categoryFilter').val();

    $.get('<?php echo base_url('ajax_filter_records'); ?>', {
        source: selectedSource,
        category: selectedCategory // 添加新的筛选参数
    }, function(response) {
        // ... 处理响应并更新表格 ...
    });
});

后端 (Controller):

public function filterRecords() {
    // ...
    $source_filter = $this->input->get('source');
    $category_filter = $this->input->get('category'); // 获取新的筛选参数

    $filtered_records = $this->Data_model->getFilteredRecords($source_filter, $category_filter);
    // ...
}

后端 (Model):

public function getFilteredRecords($source_filter = null, $category_filter = null) {
    $this->db->select('*');
    $this->db->from('your_table_name');

    if (!empty($source_filter)) {
        $this->db->where('source', $source_filter);
    }
    if (!empty($category_filter)) {
        $this->db->where('category', $category_filter); // 添加新的 WHERE 条件
    }

    $query = $this->db->get();
    return $query->result_array();
}
总结与最佳实践

通过上述步骤，我们成功在CodeIgniter应用中实现了基于AJAX的实时下拉菜单数据筛选功能。为了进一步提升用户体验和系统健壮性，可以考虑以下最佳实践：

  1. 加载指示器: 在AJAX请求发送时显示一个加载动画或文本，请求完成后隐藏，告知用户数据正在加载。
  2. 防抖 (Debouncing) / 节流 (Throttling): 如果有输入框筛选，用户输入过快可能导致大量AJAX请求。使用防抖或节流可以限制请求频率。
  3. 错误处理: 除了基本的fail()回调，还可以向用户显示更友好的错误消息，而不是仅仅在控制台打印错误。
  4. 空数据处理: 当没有记录返回时，在表格中显示“无数据”提示，而不是空表格。
  5. 安全性: 对所有接收自前端的输入进行验证和清理，防止SQL注入、XSS等安全漏洞。CodeIgniter的$this->input->get()方法已经提供了一些XSS过滤功能。
  6. 代码组织: 将复杂的JavaScript逻辑封装到独立的函数或模块中，提高代码的可维护性。

掌握AJAX与CodeIgniter的结合使用，将极大地提升Web应用的交互性和响应速度，为用户提供更流畅、高效的数据浏览体验。

以上就是基于CodeIgniter和jQuery实现动态表格数据筛选教程的详细内容，更多请关注知识资源分享宝库其它相关文章！

标签:  筛选 表格 教程 

相关阅读

发表评论:

◎欢迎参与讨论，请在这里发表您的看法、交流您的观点。

最近发表

标签列表