\Bootstrap\Components\Table

Usage

Instantiate the Table by passing the data. Note that the global $_ui is used here to create the instance.

// sample data from your db
$data = [
    ['id' => 1, 'name' => 'Jovanni Lo', 'email' => 'lodev09@gmail.com'],
    ['id' => 2, 'name' => 'foo', 'email' => 'bar@email.com']
];

$table = $_ui->create_table($data);

// continued below...

Options

Table::options

You can configure the table during initialization.

Example:

// during init
$table = $_ui->create_table($data, ['bordered' => true]);

// after init
$table->options('bordered', true);

Cells

Using the cell property, you can control the values of each row/column by passing static configuration or callbacks (closure). FOr example:

// changing class of a cell
$table->cell = [
    'name' => [
        'class' => 'text-primary',
        'url' => '#docs',
        // ... so much more
    ],
    // can also be a closure
    'username' => function($row, $index, $value) {
        // plog($row)
        return '<strong>@'.$row['username'].'</strong>';
    }
];
 // can be also done individually like so
 $table->cell('email', ['url' => 'mailto:{{email}}']);

 // continued below...

Columns

The col property is where you can configure each column from your data like adding custom class, renaming, etc. This will basically modify the output <th>. For example:

// define the columns
// note that columns that are not defined here will be hidden
// to avoid this behaviour, you can use the $table->col(column, value) way
$table->col = [
    'name' => [
        'title' => 'Name',
        'class' => 'bg-primary text-white',
        'attr' => ['style' => 'font-weight: bold;']
    ],
    'username' => '@' // this will rename the column to '@'
];

// can also pass the configuration like this:
$table->col('username', '@');

// continued below...

Other properties

• Table::data - Sets the data source.

• Table::row - Configure a row given an index. Use Table:each(row) if you don't know which index to modify.

  $table->row(1, ['class' => 'bg-primary text-white']);

• Table::each('row', callback) - Accepts a callback that will be called for each row.

  $table->each('row', function($row) {
      return [
          'class' => 'bg-primary text-white'
      ];
  })

• Table::id - Sets the id attribute of the <table>

• Table::hide - Sets the column visibility. Note that this will use the class d-none.

  $table->hide('id', true);

• Table::hidden - Same as Table::hide but accepts array of hidden columns.

• Table::class - Sets the class attribute of the <table>

Styling

To learn more about styling the <table>, see Basic Tables demo.

Print

Finally, once you configured your table, you can now html_print it!

$table->print_html();

Credits

\Bootstrap\Components\Table is part of the lodev09/bootstrap-php package created by @lodev09.