Table类提供的功能使您能够从数组或数据库结果集中自动生成HTML表格。

• 使用表类

• 初始化类

• 例子

• 改变你的表的外观

• 类参考

使用表类

初始化类

像CodeIgniter中的大多数其他类一样，Table类在您的控制器中使用以下$this->load->library()方法进行初始化：

$this->load->library('table');

加载后，表格库对象将可用：

$this->table

例子

下面是一个示例，展示如何从多维数组创建表。请注意，第一个数组索引将成为表格标题（或者您可以使用set_heading()下面函数参考中描述的方法设置您自己的标题）。

$this->load->library('table');$data = array( array('Name', 'Color', 'Size'), array('Fred', 'Blue', 'Small'), array('Mary', 'Red', 'Large'), array('John', 'Green', 'Medium'));echo $this->table->generate($data);

以下是从数据库查询结果创建的表的示例。表类将根据表名称自动生成标题（或者您可以使用set_heading()下面的类参考中描述的方法设置您自己的标题）。

$this->load->library('table');$query = $this->db->query('SELECT * FROM my_table');echo $this->table->generate($query);

下面是一个示例，显示如何使用离散参数创建表格：

$this->load->library('table');$this->table->set_heading('Name', 'Color', 'Size');$this->table->add_row('Fred', 'Blue', 'Small');$this->table->add_row('Mary', 'Red', 'Large');$this->table->add_row('John', 'Green', 'Medium');echo $this->table->generate();

这里是相同的例子，除了各个参数之外，还使用了数组：

$this->load->library('table');$this->table->set_heading(array('Name', 'Color', 'Size'));$this->table->add_row(array('Fred', 'Blue', 'Small'));$this->table->add_row(array('Mary', 'Red', 'Large'));$this->table->add_row(array('John', 'Green', 'Medium'));echo $this->table->generate();

改变你的表的外观

Table类允许您设置一个表格模板，您可以使用该模板指定布局的设计。这是模板原型：

$template = array( 'table_open' => '', 'thead_open' => '', 'thead_close' => '', 'heading_row_start' => '', 'heading_row_end' => '', 'heading_cell_start' => '', 'tbody_open' => '', 'tbody_close' => '', 'row_start' => '', 'row_end' => '', 'cell_start' => '', 'row_alt_start' => '', 'row_alt_end' => '', 'cell_alt_start' => '', 'table_close' => '
', 'heading_cell_end' => '
', 'cell_end' => '
', 'cell_alt_end' => '
');$this->table->set_template($template);

注意

您会注意到模板中有两组“行”块。这些允许您创建交替的行颜色或与行数据的每次迭代交替的设计元素。

您无需提交完整的模板。如果您只需要更改部分布局，则可以简单地提交这些元素。在这个例子中，只有表格打开标签正在改变：

$template = array( 'table_open' => '');$this->table->set_template($template);

           

            
您也可以在配置文件中为这些设置默认值。
           
          

           

            
类参考
           
          

           

            
class CI_Table$function = NULL
           
          

           

            
允许您指定一个本机PHP函数或一个有效的函数数组对象以应用于所有单元数据。
           
          

           

            
$this->load->library('table');$this->table->set_heading('Name', 'Color', 'Size');$this->table->add_row('Fred', 'Blue', 'Small');$this->table->function = 'htmlspecialchars';echo $this->table->generate();
           
          

           

            
在上面的例子中，所有单元格数据都将通过PHPhtmlspecialchars()函数运行，导致：
           
          

           

            

           

            
generate([$table_data = NULL])
           
          

           

            

             

           
          
          
          
          
          
          
          
          
Fred
<strong>Blue</strong>
Small
           
          
          
          

              

               

                

                 

                  
参数：
                 
                

                 

                  
$ table_data（mixed） - 用来填充表格行的数据
                 
               
              
              

               

                

                 

                  
返回：
                 
                

                 

                  
HTML表格
                 
               
               

                

                 

                  
返回类型：
                 
                

                 

                  
串