README

本包是一个用PHP编写的Bootstrap 3动态表格生成器。本包已完全测试，并准备好使用。

安装

要运行本包，首先需要在应用程序中包含Bootstrap 3。更多信息请参阅：此链接。

下一步是通过Composer安装此包。编辑项目中的composer.json文件，添加"jacopo/bootstrap-3-table-generator": "dev-master"作为依赖项。

"require": {
	"jacopo/bootstrap-3-table-generator": "dev-master"
},
"minimum-stability" : "dev"

接下来，在终端中更新Composer

composer update

完成。您已成功安装Bootstrap 3表格生成器！

用法

要使用本包，您需要引入Jacopo\Bootstrap3Table\BootstrapTable。以下是一个快速使用此工具的示例

use Jacopo\Bootstrap3Table\BootstrapTable;

// create the generator class
$table = new BootstrapTable();
// set the configuration
$table->setConfig(array("table-hover"=>false, "table-condensed"=>true, "table-striped"=>true ) );
// set header content (optional)
$table->setHeader(array("firstCol") );
// add table row
$table->addRows(array("cell1","cell2"), array("custom-class1"));
// you can also add a bigger row
$table->addRows(array("cell1","cell2","cell3"));
// or add a smaller row
$table->addRows(array("cell1"));

// setup extra custom css classes for the table
$table->setTableExtraClasses(array("extra-table"));
// print the table
echo $table; // equals to echo $table->getHtml();

方法概述

可用的方法有

setConfig：设置表格的基本配置。接受一个选项数组。可用的选项有

table-striped：为任何表格行添加斑马纹。 table-bordered：为表格添加边框和圆角。 table-hover：在表格行上启用悬停状态。 table-condensed：通过减半单元格填充使表格更紧凑。 table-responsive：使表格响应式。 id：设置表格的ID。

您还可以为<table>标签添加额外的CSS类。为此，您需要设置setTableExtraClasses()方法。

示例

$table = new BootstrapTable();
$table->setTableExtraClasses(array("extra-custom-class") );

setHeader：此方法设置文件头部，唯一的参数是包含每个<th>数据的数组。设置头部是可选的，如果未设置，则不会显示头部。

示例

$table = new BootstrapTable();
$table->setHeader(array("First header column data") );

addRows：向表格添加一行数据。接受两个参数：第一个是数据数组，第二个是添加到<tr>标签的额外CSS类数组。

示例

$table = new BootstrapTable();
$table->addRows(array("First data column data"), array("custom-class1") );

动态大小

请注意，您不必设置表格的大小，您可以添加任意多的行，表格大小将自动调整！

打印表格

当您完成设置表格后，只需执行echo $table即可看到作为HTML的表格。如果您更喜欢，可以使用table->getHtml()方法获取表格的HTML字符串。