The first parameter is an array collection (like db results, or array of array) for table data:

$data = array(
 array("name"  => "John", "email" => "john@doe.com", "group" => "guests"),
 array(...)
);
$table = Html::table($data);

The second parameter is an associative (or not) array of properties you want to expose in the table.

• If you provide an associative array, keys are properties, and values are header names
• If you provide an simple array, properties are values. However, if autoheader attribute is set to true, the class will also use values for header names

$props = array("name" => "First Name", "email" => "Email address", "group" => "Group name");
$table = Html::table($data, $props);

The third parameter represents html attributes, were you can set module level ones:

• condensed, striped, hover and bordered: add table-* css class to the table if set to true
• autoheader: show properties names as table header names
• alternator: a | separated string to generates css classes for each row

$table = Html::table($data, $props, array("bordered" => true, "alternator" => "success|info|warning"))

Once data are set, you may need to customize how is rendered the table.

Lets start with caption:

$table->caption("Registered users", array("class" => "muted"));

header. The callback provide current header value, all table properties, and html attributes:

$table->header("name", function($value, $properties, &$attributes){
	return Html::icon("chevron-down")." ".$value;
});

With the cell method, you set how is rendered a specific cell:

$table->cell("group", function($value, $row, &$attributes){
	return Html::label($value, ($value === "banned") ? "important" : "info");
});

The row method lets you customize the entire row by reference if needed:

$table->row(function(&$row, $index, &$attributes){
	$attributes["class"] = ($index % 2 ) ? "info" : "warning";
	$row["email"] = Html::mail_to($row["email"]);
});

The prepend or append methods allow you to create new columns. First parameter is the property name, second parameter the header title:

$table->prepend("icon", "Online", function($value, $row, $attributes){
	return Html::icon("eye-open");
});
$table->append("actions", "", function(){
	return Html::button("#", "")->tooltip("Edit");
});

The before or after methods allow you to add a column brefore / after a specific property (first parameter):

$table->after("name", "length", "Length", function($value, $row, $attributes){
	return Html::badge(strlen($row["name"]));
});

Finnaly, add a footer for our table. The colspan is set automatically if you provide a string, or an array smaller than the number of cols:

$text = "Total of ".count($data)." users registered"; // can be an array
$table->footer(text, array("class" => "text-success"));